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

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # 更新记录
 
+## 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 缺失，以及调整计划后界面一直等待的问题。

package/cli/CHANGELOG.md

@@ -7,6 +7,80 @@ 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
 
 ### 🎉 新功能

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);