@tencent-ai/agent-harness 0.2.0-beta.6 → 0.2.0-beta.8

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # 更新记录
 
+## 0.2.0-beta.8
+
+这一版补齐宿主扩展与 MCP 授权，并简化进程内工具注册。
+
+### 主要变化
+
+- 支持通过 `createHarness({ hooks })` 注册 functional hooks，处理新输入、初始上下文、会话启动、工具调用与工具描述；复用同一套 Mods 引擎，异步注册完成后才启用。
+- `tool.describe` 支持 `isDeferred`，可让内置、Host 和 MCP 工具通过 ToolSearch 按需发现，或恢复为直接可见。工具目录按会话、执行轮次隔离，原有审批与参数校验继续生效。
+- `createHarness({ tools: [showWidget, openDocument] })` 直接注册 Host 工具，保留默认内置工具；插件 Agent 声明负责选择当前模式可见的工具。
+- 远端 MCP 支持 OAuth 登录、回调、取消、登出及 token 刷新。宿主负责浏览器与回调交互，凭据仅保存在当前 MCP 挂载的内存中，关闭或重启后需要重新授权。详见 [MCP OAuth](docs/client.md#mcp-oauth)。
+- 完善 hooks 的启动失败、取消和关闭清理，并补齐发布包的类型声明，保持宿主回调的类型推导。
+
+### 接入变更
+
+`createHarness.tools` 不再接受工具名字符串或 preset 对象：
+
+```ts
+const harness = await createHarness({
+    tools: [showWidget, openDocument],
+    hooks: registerDesktopHooks,
+});
+```
+
+原 `preset: 'default', append: [...]` 改为工具定义数组。`tools: []` 现在表示没有 Host 工具，不再禁用内置工具；工具筛选移到插件 Agent 声明。详见 [迁移说明](docs/in-process.md#从旧-tools-配置迁移)。Agent Server 的 `query.options.tools` 和旧 CLI 的工具选择不变；现有 Client JSON-RPC 调用无需迁移。
+
+本版 functional hooks 仅开放 Host 注册；插件目录中的 functional hooks 尚未接入，插件原有 hooks 保持现有行为。
+
+安装精确版本：`npm install @tencent-ai/agent-harness@0.2.0-beta.8`。
+
+## 0.2.0-beta.7
+
+这一版修复历史请求 ID 缺失，以及调整计划后界面一直等待的问题。
+
+- 历史消息保留原请求的 traceId，IDE 恢复会话后仍可完整复制请求 ID。
+- 完整回放和分页回放采用相同规则，关闭会话或重启 Harness 后也保持一致。
+- 历史追踪上下文不传给新执行，实时请求的追踪行为不变。
+- 计划审批选择 Adjust 后正确结束本轮，保持 Plan 模式并等待下一条提问；审批等待和取消行为不变。
+- 支持通过 W3C baggage 传入提问场景，模型请求与遥测正确归因，多轮切换和子任务保持各自归属。
+- Skill 不再列出或执行 CLI 内置控制命令，保留同名的用户、项目和插件技能及提示词命令。
+
+公开 Client 和 JSON-RPC 方法无需迁移。安装精确版本：`npm install @tencent-ai/agent-harness@0.2.0-beta.7`。
+
 ## 0.2.0-beta.6
 
 这一版修复会话 MCP 工具摘要、审批和 Plan 权限恢复。

package/cli/CHANGELOG.md

@@ -7,6 +7,129 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.161.2] - 2026-10-04
+
+### 🔧 功能改进
+
+- **Agent View 列表与侧栏加载提速**：收集 Agent View 列表时不再为每一行打开不存在的 broker 与 display 边车文件（正常作业读取仍会检查当前端点，目录枚举失败时保留原有读取行为）；侧栏不再重复执行首次 Agent Home 加载与紧随其后的冗余兜底轮询，并跳过无关列表渲染与已折叠的隐藏行，页面可见时首次目录加载失败仍按退避重试。
+- **`/btw` 侧问与子 Agent 交互增强**：`/btw` 改为独立侧问面板，仅按 `f` 才把选中的问题升级为带工具的主树 Agent 并向主对话汇报结果；选中的子 Agent 现在可以接收后续文本、排队消息与图片，已完成、失败、停止的 Agent 在选中期间保持可见，离开时保留 30 秒宽限期并支持显式清除。
+- **自动化回归测试跨平台增强（#89304）**：E2E 用例跨平台化并消除外网拓扑依赖，提升 Windows 与类 Unix 系统下的一致性与稳定性。
+
+### 🐛 问题修复
+
+- **Agent View 工作区恢复与重绑**：仅在记录的目录或 Git worktree 能安全还原时恢复缺失的 Agent View 工作区，否则在启动时给出可操作的错误；已退出的 Agent 从侧栏进入时会被显式唤醒，深链与历史会话选择保持只读、不再重载会话文档；停止并重启后，所有已打开的 Agent 页面（含实时事件流）重新绑定到新的 Worker，会话身份保持不变。
+- **Agent View 状态被过期活动覆盖**：逐轮串行化作业与进程注册表的状态更新，避免已完成、失败或手动停止的 Agent 被过期活动覆盖；空闲与回复摘要保持同步，不再闪现中间阶段或重载会话。
+- **后台 Worker 回收**：浏览器保持被动 ACP 或 Jobs SSE 订阅时，已完成与空闲的后台 Worker 也能被回收，同时保留对进行中提问及其他请求的保护；由 Worker 自己用实时会话与任务核对过期活动作业，再重新开始空闲宽限期，而不是依据进程注册表推断空闲。
+- **每轮跟进结果未同步到侧栏**：修复每轮完成的跟进结果未发布到所有打开的侧栏（与上一轮相同的回答被跳过）的问题；只读实时跟随者在会话流重连后可以补齐历史。
+- **通用子 Agent 输入丢失**：修复在父 Agent 模式下运行通用子 Agent 时输入被丢弃、模型收到空消息的问题。
+- **并行子 Agent 工具流归属错误**：修复并行子 Agent 的工具调用内容混入主对话流，以及网页内容分析偶发收到空输入的问题。
+- **工具参数校验提示缺少类型**：延迟工具参数校验失败时展示实际类型和期望类型，同时不回显参数原值。
+- **自定义模型配置提示无法直达**：修复自定义模型缺少接口地址或 API Key 时，客户端重启后错误提示里的「前往配置」无法直达该模型配置页的问题。
+- **工具轮次追踪上下文丢失**：修复工具执行切换追踪上下文时丢失本轮 W3C baggage，导致子 Agent 请求场景回落为默认值的问题。
+- **长会话恢复后任务标题被覆盖**：修复长会话恢复后已命名（含手动重命名）的任务标题被当成未命名会话、用最近一条消息重新生成并覆盖的问题；从会话中途分叉出的新会话仍会生成自己的标题。
+- **运行环境重启后残留失效问题卡片**：stream-json 会话在运行环境重启后回放历史时，已中断的 `AskUserQuestion` 会被标记为已取消，不再留下可操作的失效卡片。
+- **长工具执行后的 Trace 断链**：修复 stream-json 长工具执行期间 drainWait 请求覆盖会话追踪头、导致工具之后的模型请求与响应流脱离当前 Trace 的问题。
+
+## [2.161.1] - 2026-10-02
+
+### 🔧 功能改进
+
+- **历史回放保留 Read 图片引用**：支持在历史回放中保留 Read 工具的图片引用，避免向 CloudAgent 重复传输 base64 图片数据。
+
+### 🐛 问题修复
+
+- **取消对话后续提问上下文丢失**：修复取消对话后继续提问时，上一轮问题和已执行的工具记录未完整进入后续对话的问题；现在会保留这些上下文，并明确告知助手前一轮已中断，避免误将其当作待继续执行的请求。
+- **Server 库 Skill 混入内置命令**：修复 Server 库运行时 Skill 工具混入并尝试执行 CLI 内置控制命令的问题；保留真正的技能，并让提示词命令调用使用当前会话的命令目录。
+- **带尾随数据的图片被判无法处理**：修复部分 PNG / APNG 动图和手机拍摄的 JPEG 在文件末尾带有额外数据时被整张判为无法处理、会话历史里只剩「图片无法处理」且模型收不到图片的问题；这类图片现在会按原样保留在历史中并正常发送给模型。
+- **Server 拒绝执行计划后未结束提问**：Server 在拒绝执行计划后正确结束当前提问，保持 Plan 模式并等待用户继续输入；工具审批等待、自动重试与取消行为保持不变。
+- **Server query 场景元数据未生效**：修复 Server query 的场景元数据未用于模型请求和遥测的问题；复用 W3C baggage，按请求隔离并由子任务继承，保留 CLI 原有的场景默认行为。
+- **Server ACP 历史回放丢失 traceId**：Server 的 ACP 历史回放现在保留原请求的 traceId，恢复会话后仍可复制请求 ID；继续移除历史追踪的传播上下文，不改变实时请求的追踪。
+- **专家团同时汇报导致重复总结**：修复多名成员几乎同时汇报时负责人只看到其中一条就给出最终总结、随后又被其余汇报逐条触发并重复输出的问题；同时到达的汇报现在会一起交给负责人当前这一轮处理。
+- **专家团成员唤醒后消息无人处理**：修复成员被唤醒继续工作后运行期间又收到其他成员消息时，这些消息无人处理、成员一直停在「运行中」导致整个专家团任务无法结束的问题；现在这类消息会在成员当前一轮结束后继续处理。
+- **可信文件操作审批标题显示为通用项**：修复同一文件的推定读取记录干扰可信删除或写入操作、导致沙箱审批标题显示为通用「访问文件」的问题；同路径可信操作覆盖推定读取时恢复「本次会话内允许此目录」选项，真实混合操作仍不提供目录授权。
+- **Web UI 子代理状态误拨主对话**：修复 Web UI 子代理后台输出误入主对话、反复将主智能体状态从空闲拨回运行中导致闪屏的问题。
+- **Windows `/copy` 中文乱码**：修复 Windows 下使用 `/copy` 复制中文等 Unicode 文本乱码的问题，并保留原始换行符。
+- **WSL 粘贴 Windows 剪贴板文本**：修复在 WSL 中通过 Ctrl+V 或 Alt+V 粘贴 Windows 剪贴板文本的问题。
+
+## [2.161.0] - 2026-10-01
+
+### 🎉 新功能
+
+- **新增错误码 4100**：本地自定义模型缺少接口地址或 API Key 时，请求不再发往供应商端点，直接返回 4100 与「前往配置」指引。此前缺少 API Key 会带着账号凭据发出请求，并被误报为「密钥无效」，把配置问题误导成鉴权问题。4100 及其之后统一作为 Agent CLI 错误码区间维护。指向本机回环地址的模型（如 Ollama 本地）本就不需要 API Key，保持原行为不受影响。
+- **上下文监控**：新增常驻上下文占用率显示配置，并支持通过 `CODEBUDDY_SHOW_CONTEXT_USAGE` 环境变量开启。
+- **`/btw` 侧问**：侧问与主会话隔离并保留最近历史，TUI 与 WebUI 支持历史浏览、快捷切换、复制、清空，以及升级为带工具的后台任务。
+- **`/web` 命令**：在默认浏览器中打开当前会话的 Web UI。没有 Web UI 地址的宿主（无 loopback / 远端会话）只提示不可用，不会打开浏览器。
+- **Web UI 每轮积分用量**：每轮对话结束后于回复底部显示本轮共消耗的积分（含子代理与图片、视频生成），刷新页面或打开历史会话后仍可查看。
+
+### 🔧 功能改进
+
+- **长历史会话恢复自适应限流**：会话恢复时按输出积压量自适应限流，避免图片与大附件回放导致进程内存溢出，同时保持正常消费场景的批量输出性能。
+- **Server 生成层装配检查（#135550）**：补齐 Server 生成层中的 MCP 工具策略、模型重试与遥测依赖，保持 Shell 可选注入语义；编译和打包时检查源组件与生成层的依赖声明，保留 Effect 服务图类型，防止组件重构后遗漏接线。
+
+### 🐛 问题修复
+
+- **模型中断后误判空流**：修复模型已输出部分内容、紧接着上游报错时，若两段数据恰好一起到达，已输出内容会被整段丢弃、按「没有任何输出」反复重试并最终提示「上游返回空流」的问题；现在会保留已输出内容并从中断处继续。
+- **`/rewind` 回退工作区外文件失败**：修复会话中写过工作区外文件（如临时目录下的草稿）后，`/rewind` 回退代码直接失败并报 「Checkpoint file destination is outside the workspace」的问题；工作区外的文件现在会被跳过，不再阻塞工作区内文件的回退，回退失败时 rewind 面板会显示原因，不再丢失输入框内容。
+- **后台服务文件变更资源泄漏**：修复后台服务在工作区一次性写入大量文件（如切出新的工作副本、安装依赖）时内存暴涨、失去响应甚至需要重启的问题；同时修复 Web UI 关闭页面或断开连接后，文件监听、进程输出订阅等后台资源不会释放、越积越多的问题。文件树在变更过多时会自动整体刷新。FileChanged 钩子改为按批次依次执行：短时间内同一文件的多次变化会合并为一次触发；一次性变化的文件过多（超过 1000 个）时，这一波变化不再逐个触发钩子，改为记录一条告警。
+- **Server 文件与网络规则审批（#136552）**：Server 文件与网络规则的 ask 审批通过会话 canUseTool 回调交给宿主，修复 Harness 中 Read、Write、Edit 一直等待且不展示审批的问题。取消只清理所属请求，迟到的授权不会带入下一轮；未绑定宿主的 CLI 保留原审批通道。
+- **Server 沙箱备份通道遗漏（#135550）**：修复 Server 原生依赖装配遗漏沙箱备份通道，导致开启文件安全后 Write/Edit 覆盖失败或新建文件未登记备份的问题。同步工具权限、循环调用保护和手动压缩入口的依赖，并增加装配漂移与真实沙箱备份回归。
+- **Server Plan 模式权限（#136158）**：Server 进入 Plan 时保留会话原权限，退出时沿用 ExitPlanMode 恢复；支持宿主在首次挂载前通过 `permissionModeBeforePlan` 传入原模式。普通工具审批将可复用的会话规则传给 canUseTool，Defer 审批展示实际目标工具，授权规则只覆盖该目标。强制审批与高风险命令不提供此会话授权建议。
+- **会话级 MCP 工具描述（#136531）**：会话级 MCP 的 ToolSearch 目录复用 `_meta.shortDescription`，与全局 MCP 目录保持一致；完整描述仍用于工具搜索和调用定义。
+- **skill 名称开头普通文本误触发**：修复在会话中输入以某个已安装 skill 名称开头的普通文本（不带斜杠）时，消息被误判为 skill 命令的问题：此前模型会收到 skill 全文而非用户原话，且下一轮后历史中的用户原始消息也被覆盖。现在只有显式输入 `/skill-name` 才会触发 skill 展开。
+- **TUI 顶部 Web UI 链接**：修复 TUI 顶部栏展示的 Web UI 链接会额外拼接当前会话 id（`?sessionId=...`）的问题，现在直接展示配置的 Web UI 地址。
+- **Web UI 智能体选择串改**：修复 Web UI 中在多个智能体之间切换时，权限模式和模型选择互相串改、切回后又跳成别的值的问题；现在每个智能体各自保留自己的选择，子智能体里的选择也不会再改写全局默认权限。
+- **Web UI 源代码管理刷新（#136936）**：Web UI 源代码管理面板改为变化即推送：文件改动、提交、切换分支后约 0.4 秒内刷新，仓库无变化时不再反复扫描，大仓库下单个文件变化的刷新从约 1.8 秒降到几十毫秒；页面隐藏时暂停、回到页面立即刷新，旧版本服务端自动回退到定时刷新。同时修复含空格或非 ASCII 字符的文件路径、已暂存重命名文件显示异常的问题。
+- **Windows 自动升级卡死**：修复 Windows 上开着 CodeBuddy Code 时自动升级经常失败、并可能让安装残缺的问题：之后执行命令会卡死，只能重启。现在开着窗口也能正常自动升级；万一安装仍然残缺，命令会立即报错并改用普通方式执行，不会再卡死。
+
+## [2.160.0] - 2026-09-29
+
+### 🎉 新功能
+
+- **Web UI 原生智能体视图 v2**：Web UI 改为单条总线（`/api/v1/bus`）复用多路数据流，`journal` 以 `seq/epoch/volatile` 定序，订阅带游标续传、`ack` 即重放结束；游标不可续回时返回 `resync_required`，客户端重取快照后按 `asOfSeq` 重订阅。新增会话快照接口，一次返回消息分页、`inFlightTurn` 与待审批 / 待回答，客户端「先快照后订阅」，运行态只来自快照与 `turn` 事件。目录流改走总线（展示字段投影 diff + 同 tick 合并帧 + 15s volatile keepalive），总线就绪时停用旧 SSE、掉线自动回退；多个 Web UI 页面之间视为对等写者，同一会话可在多个页面同时打开并发送，写入由服务端 run queue 串行，TUI / `--acp` 等非 Web UI 客户端维持原有防双写者语义。行状态设 2.5s 最短停留（需要输入立即切换），默认 Agent 行的忙闲收窄到「本页连接承载主会话」；worker 在 `RUN_FAILED` 回到 idle 但进程仍存活时，job 行落成 `failed` 并冻结终结时间。
+- **Web UI 动态工作流可视化**：启动工作流（如 `/deep-research`）后，对话中出现实时更新的工作流卡片，展示状态、当前阶段、分段进度、agent 完成数与 token 用量；输入框上方在运行期间显示等待状态，结束后自动消失。点击卡片或输入 `/workflows` 可在右侧侧边栏按阶段查看每个 agent 的指令、最近活动与结果，并支持暂停、继续、停止整个工作流或跳过单个 agent。同时修复工作流子任务的中间过程被平铺到主对话中的问题，并补齐工作流相关界面与审批卡片的中英文文案。
+- **沙箱审批规则来源与目录授权**：沙箱审批现在提供实际命中的规则来源，支持客户端查看对应规则或保护机制；支持 macOS 非白名单目录直接删除的允许、询问、禁止设置（默认询问）；文件审批支持当前目录及子目录的会话授权，读、写、删除分别生效。
+- **资料库上传（`LibraryUpload`）**：新增工具，把本机单个文件上传为资料库节点，支持工作区外的文件（附件常在 Documents / 桌面）；打开前解析软链并与 `fstat` 比对防替换，敏感路径由会话权限规则把关（工作区内静默、其余需授权）；上传后节点保持私有，不生成公开分享链接；大文件按流式上传，不整体读入内存。新增 `ProductFeature.LibraryUpload` 灰度开关（默认关闭），同时校验 endpoint 与登录态，关闭时工具不注册。
+- **Server subscribe 支持多种输出格式**：`subscribe` 支持 `openai`、`messages`、`acp-v1` 与 `acp-v2` 四种输出格式。默认保持原有 `messages` 输出；完整 SDK 原始事件通过 `format: 'openai'` 显式选择，现有消费者无需修改；Harness 使用 `acp-v2` 直接投影原生事件，复用历史消息编码，移除 stream-json 中转。旧 CLI 入口保持原有行为。
+- **`$.ui.log` 进入 chat view**：mod-plugin（function hooks）里的 `$.ui.log(text)` 现在会作为一条 assistant-role 消息进入 TUI / Web UI 的会话历史，与用户 / 助手消息同区渲染，语义对齐 function hooks 协议的 transcript 行为。此前 `[mod] <text>` 只写 stderr、TUI 里几乎不可见，现在改为 `<plugin>: <text>` 出现在会话历史里（headless / 无 chat view 的场景仍走 stderr 兜底，可追溯性等价）；`to === 'debug'` 通道保持只走 logger，不进 chat，避免污染 `--print` 的 stdout 契约。
+- **后台工作流报告写回对话**：`/deep-research` 等命令启动的后台工作流完成后，会把最终报告写回对话，并像其他后台任务一样通知主 Agent，可随时按任务编号查看完整结果。
+
+### 🔧 功能改进
+
+- **后台任务完成通知更克制**：调整后台任务完成通知的提示措辞，任务跑完后不再要求助手回头翻查历史消息、自行推断「还有哪些后续步骤要做」，减少任务结束后的无谓额外动作；同时明确这类通知属于系统事件而非用户发言，避免助手把它当成用户的确认或同意后继续执行。取输出的指引保持不变。
+- **`/btw` 与切换小上下文窗口时先压缩**：`/btw` 超过模型上下文上限时会先执行标准 `/compact`，再基于压缩后的上下文回答；TUI `/model` 在切换到较小上下文窗口前复用同一压缩流程；运行中的会话或压缩后仍无法适配目标窗口时会保留当前模型并提示重试。
+- **错误上报带上实际域名（#132873）**：请求失败时，错误明细会带上这次请求实际打到的域名，方便按域名查看错误。
+- **模型输入内存保护可配置（#135093）**：支持通过 `CODEBUDDY_DISABLE_MODEL_INPUT_MEMORY_GUARD=1` 关闭保护，并允许 `/compact` 在内存压力下完成上下文压缩。
+- **后台 Shell 任务的 TaskOutput 默认增量返回**：TaskOutput 默认只返回上次读取后的新增 stdout / stderr，避免轮询时重复消耗上下文；可通过 `full: true` 获取当前累计输出快照。
+- **会话恢复读取更快（#135192）**：使用有界异步分块读取会话尾部，减少逐行回调与插件、MCP 初始化争用事件循环造成的等待，同时避免为中大型会话加载完整文件；会话列表读取增加并发限制，并减少工具描述缓存命中的重复调试日志，降低启动阶段的资源争用和聚合内存峰值。
+
+### 🐛 问题修复
+
+- **内置插件市场不再每次启动重新下载**：安装后会正确记录版本，之后只在市场确实发布了新版本时才重新下载，启动更快、流量更省；同时会自动清理此前因进程中断残留在系统临时目录中的下载文件。
+- **子 Agent 跟随主会话上下文窗口档位（#133811）**：修复 subagent（含 Agent Team 成员）不跟随主 Agent 上下文窗口档位选择的问题：主 Agent 切换到 1M 等档位后，新建或唤醒的 subagent 会自动同步该显式选择；主会话没有显式选择时 subagent 回落到自身模型的默认档，不会误继承主会话按其模型算出的有效预算。
+- **Web UI 会话同步（#133784）**：新建会话、切换会话、链接直开恢复会话时立即显示历史，并实时收到其他端（含命令行）发到该会话的消息；同一会话可在多个网页同时打开并发送，不再提示「此会话正在其他窗口或设备使用中」；修复回合结束后会话偶发一直显示运行中、输入框卡在排队状态；回退对话后刷新页面，已回退的回复不再重新出现。
+- **空流重试等待用量时断连（#124399）**：空流重试等待用量时如果连接断开，这一轮仍会自动重试，不会被当成一条没有正文的正常完成。
+- **工具管控入口下线期间禁用设置不再生效**：智能体工具管控入口下线期间，已保存的工具与 MCP 禁用设置不再生效，避免工具被禁用后无法通过界面恢复。
+- **Agent frontmatter 数字名称兼容（#101095）**：兼容 Agent frontmatter 中未加引号的有限数字名称和描述，避免文件存在但管理目录遗漏。
+- **预热进程激活后读取实时环境**：修复预热进程激活后仍使用待命阶段环境变量和启动参数快照的问题，确保首轮工具描述及运行时配置使用当前会话值。
+- **Product 工具描述模板名被直接发给模型**：修复 `/server` 使用逐轮 Product 时，工具描述模板名被直接发送给模型的问题；模板读取与工具描述缓存遵守执行配置边界，避免并发会话串用同名描述。
+- **沙箱批量删除权限串用（多会话切换）**：默认权限会话不再借用其他会话的 fullAccess 跳过确认，完全访问会话也不会受其他默认权限会话影响而额外请求审批；批量删除审批、保护记录与审计始终归属命令执行的会话，需要确认时会等待用户允许后再重跑，拒绝后保持拦截。
+- **PowerShell / Grep / Monitor 沙箱执行的会话归属**：确保删除保护、审批和后台任务属于实际执行会话；PowerShell 的 Server 沙箱审批复用 canUseTool 回调；取消后不再接受迟到的审批或发起新的 Shell 执行及本机重跑。
+- **上下文压缩摘要污染用户消息身份（#72511）**：修复上下文压缩摘要污染真实用户消息身份，以及内部恢复续跑误触发 Sandbox 初始化和规则同步的问题。
+- **sandbox-cli 输出与退出事件丢失**：修复 sandbox-cli 快速执行时输出和退出事件可能丢失、工具持续等待的问题；管道和 PTY 执行在响应到达时同步注册进程句柄，保留连续到达的输出与退出状态。
+- **Sandbox Shell 懒加载遗漏事件**：Sandbox Shell 在组件初始化时注册反向监听，避免等待会话就绪期间遗漏事件；重启继续复用原监听。
+- **Monitor 与 Bash 一致遵循 `usePty`**：Monitor 与 Bash 一致遵循宿主的 `query.options.usePty` 选择；未指定时保留 CLI 原有行为。
+- **Server 无 prompt 的 compact 请求身份**：修复 Server 无 prompt 的 compact 操作未登记请求身份、导致压缩历史条目的 conversationRequestId 被上一轮覆盖的问题；维护操作复用内核的请求登记机制，与当前 runId 保持一致。
+- **Server ACP 事件状态与关闭清理**：修复 Server ACP 工具参数增量、权限模式变更与重订阅事件状态；恢复读取会话时的 Agent 身份，减少无订阅者时的事件处理，并在关闭时取消 shell 快照进程。
+- **Server 把普通文本中的客户端引用误显示为文件**：实时回显和历史回放保留文本内容，显式资源引用、图片和附件继续还原；旧 CLI 的默认引用解析行为不变。
+- **Server 插件 Agent 组合**：Server 会话复用 CLI 插件 Agent 组合逻辑，正确展开 welcome-mode 与 interaction-mode 的模板，并应用工具声明（包括显式空列表）；插件模板读取遵守会话挂载的 dataFs，多会话模式选择互不影响，普通 CLI 的插件优先级保持不变。
+- **Server 完整 stop 后支持同进程再次 start**：每次构建独立容器与 Effect 服务实例，恢复启动时覆盖的环境配置，并等待旧执行任务结束；关闭失败时拒绝重建。Server 文件锁仅在持锁期间注册退出清理，最后一个锁释放后注销自身监听器，避免 Harness 关闭后在宿主进程留下信号监听。
+- **Server 沙箱「本次会话内允许」串会话（#134978 #134979）**：修复 Server 沙箱「本次会话内允许」未复用或误写到其他会话的问题；审批读写绑定到执行所属 Session，保留命令与工作目录的授权边界；Server 的 canUseTool 传递与 CLI 相同的沙箱展示信息，并复用原有目录授权校验。
+- **Server 关闭崩溃**：等待 shell snapshot 预热回调完成后再释放内嵌 Server 运行时，避免关闭时崩溃。
+- **会话级 MCP 工具未出现在 ToolSearch 清单（#134992）**：修复 `/server` 通过 `query({ mcpServers })` 注入的会话级 MCP 工具默认延迟加载后未出现在 ToolSearch 清单的问题；清单随工具变更、配置替换和移除刷新，并保持会话隔离。
+- **Web UI 工作目录未同步**：修复 Web UI 从 CLI 启动进入后工作目录未同步的问题：默认 Agent（主对话）的家目录跟随当前 CLI 启动目录，不再停留在历史目录；侧栏该行的时间改为显示主会话最近一次用户发言的时间，不再回落成创建日期。
+- **工作流与多任务派生 Agent 未完整继承主会话模式**：修复工作流和多任务派生的 agent 未完整继承主会话模式的问题，并将工作流进度留在工作流视图中；同时恢复主界面通过方向键选中、回车进入普通 Agent 的操作。
+- **大型仓库创建工作树超时残留**：修复在大型仓库中创建工作树耗时过长被中止后，残留的半成品目录与分支导致后续无法正常重新创建的问题；创建工作树的等待时间也相应放宽。
+
 ## [2.159.0] - 2026-09-28
 
 ### 🎉 新功能

package/cli/dist-server/lite/in-memory-session-store.js

@@ -11,7 +11,7 @@ const MAIN_LANE = 'main';
 const FACT_TYPES = new Set([
     'custom-title', 'ai-title', 'file-history-snapshot', 'summary', 'topic',
     'goal-result', 'goal-progress', 'turn-metrics', 'resend-fork-notice', 'acp-terminal-state',
-    'model-usage', 'session-meta',
+    'model-usage', 'credit-usage', 'session-meta',
 ]);
 function isFactEntry(entry) {
     return FACT_TYPES.has(entry.type);