> ## Documentation Index
> Fetch the complete documentation index at: https://unity.farlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 当前版本

> Locus v0.6.0 (2026-07-17)

## 下载

* [Windows x64](https://github.com/r1n7aro/Locus/releases/download/v0.6.0/locus_0.6.0_x64-setup.exe)
* [Windows x64（系统 Python/Git）](https://github.com/r1n7aro/Locus/releases/download/v0.6.0/locus_0.6.0_x64-without_embed_python_git-setup.exe)
* [GitHub Releases](https://github.com/r1n7aro/Locus/releases)

## 变更列表

### v0.6.0（新增）

* **MCP 服务器接入。** 支持通过 stdio 或 HTTP 连接外部 MCP 服务器，并在 Agent 会话中使用其工具。新增 MCP 设置页管理服务器及其工具；MCP 工具调用在聊天中有确认卡片与状态展示。可从 Claude Desktop、Claude Code、Cursor 的配置导入服务器条目（导入后默认停用）。新增 `/connect` 命令：引导式接入外部软件，在 MCP / CLI / HTTP 三种通道中选型并实测连通。
* **多模型供应商与内置 models.dev 目录。** 自定义模型改为按供应商组织，一个供应商可配置多个模型，取代原来的单端点条目。可从内置的 models.dev 目录一键添加供应商（70 余家服务商、预填官方端点），也可在新的两步弹窗中手动配置，支持逐字段校验。推理参数（如 `enable_thinking`、思考类型）可按模型设置；模型选择器按供应商分组展示自定义模型。已有配置自动迁移，旧模型 id 继续有效。
* **外部技能发现。** 可选发现来自 Claude Code、Codex 与 `.agents` 目录（用户级与工作区级）以及已安装 Claude Code 插件的技能，只读接入、默认关闭。技能激活拆分为「自动注入」与「命令」两条独立通道，可按技能分别控制；外部命令技能支持 `$ARGUMENTS` 与 `$1`–`$9` 参数替换。
* **附加工作目录。** 工作区可通过右键菜单附加额外目录，文件工具可以在这些目录内读写，工作区选择器会内联展示附加路径。
* **Unity 对象预览直接读盘。** Unity 不序列化的文件（Markdown、纯文本、源码、二进制）改为直接从磁盘预览，Unity 尚未导入的资产（例如符号链接目录下 AI 生成的文件）也能正常预览。预览折叠改为可选，资产检视器中保持展开。(#114)
* **聊天选中复制。** 在消息中选中文本后右键，菜单首项为「复制选中内容」。
* **视图日志栏开关。** 视图窗口的日志栏默认隐藏，可在显示设置中开启，设置跨窗口同步。

### v0.6.0（修复）

* Windows 命令行工具体验：托管 Python 的环境变量只作用于 Python 调用，不再影响整个命令环境；命令输出按系统 ANSI 代码页解码，修复中文（GBK）输出乱码；超长输出截断改为保留开头和结尾，不再只留开头。
* 延迟加载的工具改用 Anthropic 原生 tool reference 与 Codex 原生 tool search 装载，取代原有的 meta-tool 激活方式。
* 内置的 Unity Profiler 采样技能默认改为摘要注入，Agent 现在能自动发现并按需加载；此前默认不注入。
* 辅助窗口（计划审阅、diff 审查、各导入窗口等）改走预热的窗口池，打开更快。
* 界面语言包按需加载。
* 会话与知识库数据库在空闲页占比过高时自动 VACUUM，回收磁盘空间。
* 右键菜单统一加上图标并对齐布局。
* 插件开关即时生效于列表，不再等待后端往返。
* 设置页中聚焦的数字输入不再被滚轮误改。

### v0.6.0（移除）

* 移除单端点的自定义模型配置方式，由多模型供应商弹窗取代；已有自定义端点自动迁移。

### v0.5.8（新增）

* **独立计划审阅窗口。** 可在显示设置中选择将计划审批呈现在审批卡或独立窗口；选择独立窗口后会自动打开计划审阅窗口，可审阅 Markdown 计划、批准并开始实现，或附带说明退回修改。

### v0.5.8（修复）

* **已解决 Windows 上 DeepSeek 请求间歇性 HTTP 400。** 将 `schannel` 从 0.1.28 升级到 0.1.29，避免 TLS 1.3 重新协商期间重复发送待处理请求数据并破坏较大的 JSON 请求体，解决 [issue #48](https://github.com/r1n7aro/Locus/issues/48) 集中记录的 `400 Bad Request: Failed to parse the request body as JSON` 问题。([PR #110](https://github.com/r1n7aro/Locus/pull/110))
* **计划审批流程。** 审批卡现在以 Markdown 展示计划，退回说明会随“退回修改”一并发送，批准后的计划与退回反馈会以正确状态保留在会话记录中。空闲会话选择 `/plan` 后会立即进入持续性规划模式。
* 启用 Fast 模式时，支持 Fast 的 Codex 模型会在模型标签中显示 `Fast` 状态。
* **精确编辑工具契约。** `edit` 与 `knowledge_edit` 的公开工具定义现按每次一处精确替换执行。`knowledge_read` 可原样返回 `summary`、`body` 或 `maintenanceRules` 分区，保留空白与空内容，供后续编辑逐字匹配目标分区；已有的历史批量文件编辑调用继续兼容。

### v0.5.7（新增）

* **GPT-5.6 系列与 Fast 模式。** ChatGPT 订阅新增 GPT-5.6 Sol、Terra、Luna，支持 353,400 token 的 Codex 运行时上下文与最高 Max 推理级别；模型选择器新增 Fast 模式，可提高响应速度，同时增加订阅用量。
* **手动重置 Codex 使用限制。** ChatGPT 订阅设置会列出可用的使用限制重置额度与到期日期；确认后可消耗一次额度，手动重置当前符合条件的 Codex 用量周期，并自动刷新配额。
* **聊天输入历史。** 聊天输入框支持通过上下方向键恢复历史用户消息，同时恢复附件与输入意图，并在返回末尾时还原当前草稿。
* **双击快捷键中止响应。** 新增可配置的双击中止响应快捷键，默认使用 Esc；第一次按下会提示，再次按下才会中止当前响应。

### v0.5.7（修复）

* Unity 文档导入支持当前的 `cloudmedia-docs.unity3d.com` 下载域名，并兼容旧 Google Storage 地址。
* Esc 会优先关闭当前预览、弹层和 diff 窗口，再处理全局响应中止快捷键。

### v0.5.6（新增）

* **本地文件导入知识库。** 外部源支持把本地文件或文件夹导入为引用文件夹，两种模式：**实时链接**通过操作系统链接（junction/symlink）直接挂载本地路径，内容始终是磁盘上的最新状态、文档保持只读；**快照导入**一次性复制当前内容，可选择允许 AI 编辑，并支持手动同步源路径变化。其中 Markdown / 文本文档（`.md` / `.markdown` / `.txt`）会进入知识检索。删除实时链接引用只解除链接，不改动源文件。(#85)
* **聊天 LaTeX 公式渲染。** 消息中的 LaTeX 公式以 KaTeX 渲染，识别 `$…$`、`$$…$$`、`\(…\)`、`\[…\]` 定界符。

### v0.5.6（修复）

* chat-completions 请求按序列化后的字节原样发送，请求日志记录的也是同一份字节；当服务商以 JSON 解析错误拒绝请求时，报错会说明请求体很可能在传输途中被损坏（代理、VPN、安全软件或网关），并建议用 curl 重放确认。(#106)
* 长流式回复不再随内容增长越来越卡：正文、思考过程与打字机改为增量追加新内容，不再整段重渲染。
* 流式回复结束的瞬间消息列表不再闪烁。

### v0.5.5（新增）

* **按文件撤回。** 变更面板、diff 审查窗口及新增的行右键菜单支持把单个文件恢复到本轮修改前的快照，不影响撤销栈；若该文件之后还有编辑，会先询问再回滚。(#100)
* **模型请求自动重试。** 连接错误、超时、HTTP 5xx 与 429 限流自动重试，429 遵循 `Retry-After`；仅在尚未流式产出任何内容前重试；次数可在通用设置调整（默认 3，设 0 关闭）。(#101)
* **内联 `<think>` 标签转入思考通道。** chat-completions 与 OpenRouter 路径上，流式正文中的 `<think>…</think>` 片段会从消息正文剥离并作为思考过程展示（默认开启）。
* **子代理限制。** 通用设置新增 `task` 子代理最大嵌套深度与单会话最大并发（默认深度 1）；超限调用会返回错误并说明当前限制。
* **`/dream` 记忆整理技能。** 内置技能：合并重复记忆、修正过期事实、精简记忆索引。

### v0.5.5（修复）

* 自动压缩的保留与请求预算按模型上下文窗口缩放，并识别更多供应商的「prompt 过长」报错，小上下文模型上的压缩现在能收敛。
* 回放历史工具调用时规范化 arguments：空或非法 JSON 变为 `{}` 再发给 chat-completions/OpenRouter 供应商；Codex 路径保持逐字不变。(#94)
* 工作区文件路径改为词法解析，符号链接文件现在能正常打开与定位。(#100)
* 更流畅的长回复流式渲染：已完成的 markdown 块被冻结，流式期间仅重解析尾部。
* 上下文 token 估算不再低估中日韩文本。
* 登录态复查不再重建已打开的标签页；视图预加载，消除首次切换时的闪烁。

### v0.5.4（新增）

* **粘性计划模式。** 计划模式现在是按会话持续的只读模式：Agent 可调研并撰写计划，但在你于对话卡片上批准前不能编辑文件或调用非只读工具。顶部状态栏显示计划模式已启用并提供一键退出；计划期间派生的子代理同样继承只读限制。
* **主日志落盘。** Locus 会把日志（含前端控制台）同时写入滚动文件 `%APPDATA%\locus\logs\locus.log`，崩溃时刷盘。控制台设置新增「定位日志文件」按钮。
* **模型目录更新。** 新增 Fable 5 与 Sonnet 5（1M 上下文），并将 Opus 4.8 设为默认；移除较旧的 Sonnet 4.6、Haiku 4.5 与 Opus 4.7。

### v0.5.4（修复）

* 模型选择器不再显示内部的 `[1m]` 上下文窗口标记。
* 解析 Unity YAML 时，GUID 后紧跟多字节字符不再触发 panic；单引号包裹的标量名称现在能被正确去引号。
* 场景 diff 现在能识别预制体换源与重新挂父级（不再误判为未变化），并跳过逐字节相同的场景目标重建。
* 更快的资产重扫：watcher 对账时不再重新解析未变化的文件；更新后首次启动会重建一次资产数据库（schema v13）。
* 更顺畅的流式输出：缓存诊断/trace 判定、改用更浅的工具调用 watch、批量应用工具结果、稳定消息分组，减少 transcript 的冗余计算。
* 热更新对不安全的改动改为 fail-closed：ref struct 的实例成员、在表达式树内引用的成员、命名空间级 `using` 变更，以及冷 diff 回退。
* 加固 Unity 热更新桥接：应用失败时回滚已下的 detour；重编译完成以编译 epoch 门控，避免请求前的编译误判完成；对正在销毁的 GameObject 跳过组件；并修复收敛竞态与 monitor 停止时的账本交接。

### v0.5.4（移除）

* 移除旧的一次性「计划 → 继续实现」确认卡片；由上述粘性、需批准的计划模式取代。

### v0.5.3（新增）

* **团结引擎（Unity 中国版）支持**：Locus 现在能像识别标准 Unity 一样发现、启动并连接团结引擎编辑器（`Tuanjie.exe`），覆盖进程匹配、原生引擎模块及其 PDB、窗口标题识别。标准 Unity 安装不受影响。
* **新增 Claude 订阅支持**：可登录 Claude 订阅账号，或导入已有的 Claude Code / Codex CLI 登录态（含自定义端点），并在 Anthropic 面板查看订阅剩余额度。
* **网关截断诊断**：Anthropic 请求失败时会记录传输层信息与上游 JSON 解析偏移；当 400 错误疑似为传输中途截断时，Locus 会保存完整的请求字节和一条可直接运行的 `curl`，便于复现并反馈问题。(#48)

### v0.5.3（移除）

* 移除「Claude 订阅已暂停」的提示弹窗及其说明；订阅登录流程已将其取代。

### v0.5.2（新增）

* `unity_code_usages` 的成员查询改为读取资产扫描阶段建立的序列化成员绑定索引：现在能捕获仅按类型串命名（`m_Target: {fileID: 0}`、无 GUID）的断裂/未绑定 UnityEvent 调用，并在整个项目范围内解析 AnimationEvent 函数名，而不再每次查询都重新扫描引用它的场景/预制件以及每个 `.anim` 片段。更新后首次启动会重建一次资产数据库（schema v12）。
* Unity 编辑器解析新增回退到 Unity Hub 安装缓存（`editors-v2.json`），安装在非默认盘符（例如 `D:\` 或 `F:\`）的编辑器现在也能被正确识别。

### v0.5.2（修复）

* Unity 6.5（6000.5）兼容：`GetInstanceID()` 与 `IsLoadingAssetPreview(int)` 变为错误，32 位 InstanceID 被 64 位 EntityId 取代。新增 `LocusObjectIdentity` 垫片，将 EntityId 折叠回低 32 位（保留原有 InstanceID 与通信协议），并按编辑器版本门控已弃用的 build-target API。旧版本编辑器不受影响。(#95)
* 修复中文（CJK）输入导致的资产数据库锁中毒：当搜索词为纯中文，或 `.meta` 文件在 `guid:` 后含中文时，按字节偏移切分会落在多字节字符内部并触发 panic，而该 panic 发生在持有资产数据库锁期间，导致此后所有资产查询失效直至重启。现已改为按字符边界切分。(#97)

### v0.5.2（移除）

* `unity_code_usages` 成员模式不再上报序列化类型串指向其他类的 UnityEvent 调用；现在仅匹配精确的类短名或绑定的脚本 GUID。

### v0.5.1（修复）

* grep 工具改为流式搜索，不再将整个文件读入内存，仅按路径顺序保留前若干个匹配；模式过于宽泛时会提前停止，并说明返回的是不完整、不确定的结果子集。
* 修复在 Unity 嵌入式窗口中点击输入框时的焦点闪烁：仅在目标窗口尚未持有前台时才强制前置，避免覆盖层在失焦与聚焦之间反复跳动。
* 修复 Native Plugin 覆盖层因控制管道名未规范化为完整管道路径而无法连接、覆盖层始终无法挂载的问题。

### v0.5.0（新增）

* 编辑器热更新已实现：Agent 现在能在运行时修改 C# 脚本并实时应用逻辑，能力覆盖主流商业热更新插件。
* Unity IPC 连接已从 C# 插件迁移到使用 Rust 编写的 Native Plugin，可在域重载、Unity 主线程阻塞期间保持连接稳定，并实时上报 Unity 状态。
* C# 编译已从 Unity 进程内迁移到独立的 CoreCLR 进程，旧编译路径暂时保留以作兼容。
* Rust 后端的内存分配器切换为 mimalloc。
* 设置中新增「测试」页面：本版本架构改动较大，可能存在兼容性损失，遇到问题时可运行测试作为参考。
* 向 View Package 暴露了更多 API。

### v0.5.0（修复）

* 资产数据库的性能与正确性优化。
* 修复消息记录在某些情况下隐藏最后一条工具调用的问题。
* grep 工具的路径现按工作区目录解析。