@tencent-ai/agent-sdk 0.3.145 → 0.3.147

package/cli/CHANGELOG.md

@@ -7,6 +7,80 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.95.1] - 2026-05-07
+
+### 🎉 新功能
+
+- **通用 Agent 支持图像生成/编辑**：general-purpose 子 agent 的工具清单新增 ImageGen 和 ImageEdit，可在子任务中直接生成图像或基于已有图像进行编辑；是否可用仍由模型能力 tag 决定。
+
+### 🔧 功能改进
+
+- **Skill 工具描述截断**：采用三阶段均衡截断策略,大量 skills 场景下 Skill 工具描述自动按字符预算收敛,不再无限膨胀。
+  - 单条描述硬上限 250 字符,超长裁剪加省略号
+  - 内置 skills 与官方 bundled skills 永不截断描述
+  - 项目级、插件级、connector 级 skills 不限条数,description 按剩余预算均分截断
+  - 用户级 skills(位于 `~/.codebuddy/skills/`)受全局总数上限(默认 200 条)约束,超出部分不展开描述
+  - 新增 env `CODEBUDDY_SKILL_TOOL_CHAR_BUDGET`(正整数,单位字符)独立控制 Skill 工具描述预算,默认值 8000；未设置时回退读取 `SLASH_COMMAND_TOOL_CHAR_BUDGET`
+  - **破坏性变更**：SlashCommand 工具默认字符预算由 15000 调整为 8000。拥有大量自定义 command 且累计描述超 8000 字符的用户会看到命令列表被提前截断；可设置 env `SLASH_COMMAND_TOOL_CHAR_BUDGET=15000` 恢复原值
+- **MCP 大响应处理**：MCP 工具响应超出 token 上限时不再直接报错中断会话，改为把完整内容保存到会话目录并返回读取指引，模型可按 offset/limit 分段读取。落盘路径形如 `~/.codebuddy/projects/<project-hash>/<session-id>/tool-results/mcp-<server>-<tool>-<timestamp>-<rand>.txt`（子代理场景为 `<parent-session>/subagents/<agent-id>/tool-results/…`）。含图片的响应、无会话上下文、或落盘失败时自动降级为截断模式并保留图片块；可通过环境变量 `CODEBUDDY_DISABLE_MCP_LARGE_OUTPUT_FILES=1` 始终走截断降级。
+- **流式响应超时**：将首 token 等待和流间静默两项默认超时由 10 分钟提升至 20 分钟，避免长上下文请求或慢响应模型在首 token 阶段被误判为连接丢失。可继续通过 `CODEBUDDY_FIRST_TOKEN_TIMEOUT_MS` 与 `CODEBUDDY_STREAM_TIMEOUT_MS` 自定义。
+- **Windows 粘贴体验**：提升 Windows 终端中大段文本和剪贴板内容粘贴的稳定性，减少输入闪烁和内容分片问题。
+- **统一 cancel 清理编排器**：收到 cancel 信号时按六个维度统一清理 session 运行时状态，彻底消除"CLI abort 了但脏状态残留到下一轮 prompt"和"用户取消后 UI'正在压缩上下文'蒙层不消失"类 bug。
+  - 顺序执行：Interaction（reject pending permission/AskUserQuestion deferred）→ Mode（恢复 Plan 模式）→ Todo（保留 3 态 status，通过 metadata 戳 cancel 印记）→ Tool（广播 tool_call_update failed）→ Compact flag（reset isCompressing）→ Progress signal（清 UI 压缩 loading 横幅）
+  - 接入两个底层 cancel 入口：ACP cancel RPC（合流 web-ui handleCancel）与 SDK/Ctrl+C interrupt 信号
+  - SDK / headless 模式下可选依赖缺失自动跳过对应维度，每一步独立 try/catch 错误隔离
+- **内部生成器 agent 不再自动注入 SendMessage 工具**：`compact`、`summaryGenerator`、`terminalTitleGenerator`、`contentAnalyzer`、`promptHookEvaluator`、`insightsAnalyzer`、`memorySelector`、`agentInstructions` 这类用于上下文压缩 / 标题生成 / 摘要生成等内部任务的 agent，永远不参与 team / sub-agent 通讯，不再浪费 prompt token 并污染结构化输出。
+
+### 🐛 问题修复
+
+- **取消压缩后 UI 显示"已完成 ✓" / 仍卡在 shimmer 的状态显示 bug**：用户报告流式压缩中点取消按钮，分隔线 UI 不能正确反映"被取消"语义——要么显示"上下文已压缩 ✓"（误判），要么继续显示"正在压缩..."shimmer（信号未送达 UI）。
+  - 自动 compact 与手动 `/compact` 双路径覆盖：自动路径在 `doBlockingCompaction` cancel 分支双通道写入 session.meta marker + ACP 立即广播；手动路径由 cancel cleanup 编排器检测到压缩中状态时主动广播
+  - 新增 ACP 协议字段 `_meta['codebuddy.ai/compact-cancelled']` 经 `session_info_update` 通道广播给所有 ACP client
+  - Web UI 端 `CompactGroupItem` 加 cancelled 状态视觉（XCircle + 删除线 + 半透明）+ i18n key（zh "历史对话精简已取消" / en "Compaction cancelled"）
+- **ACP 自动压缩静默语义收敛**：自动压缩执行期间触发的内部 abort/error 不再向 ACP 客户端暴露 `stopReason='cancelled'` / `errorMessage`，外部消费方（IDE/Web UI/Desktop）不再看到一次无意义的"已取消"闪现；用户主动 Ctrl-C / ACP cancel 仍正常发 `stopReason='cancelled'`，未被过度静默。
+- **桌面操作工具列表可见性对齐运行时门控**：桌面操作工具在未启用或非 macOS 场景下仍会出现在工具搜索描述里，模型会据此尝试调用后被拒绝；现在列表可见性与运行时门控完全对称，未启用时不再出现在可发现工具清单。
+
+### 📝 文档更新
+
+- **CLI 文档同步**：同步更新 bash-sandboxing、env-vars、hooks、interactive-mode、mcp、plugins-reference、settings、skills 等多语言版本（cn/en/zh），并发布 v2.94.0~v2.94.4 历史版本的 release notes 文档。
+
+## [2.95.0] - 2026-05-01
+
+### 🎉 新功能
+
+- **Agent Team 能力对齐**：
+  - **队员空闲感知**：团队 lead 现在能 per-teammate 查询"当前是否空闲"、等待指定队员空闲（支持超时和 abort signal）、注册"一旦空闲就回调"的钩子；UI/调度/优雅关停等场景无需订阅 stream 即可获知队员状态
+  - **Plan 审批用户体验对齐**：队员在 Plan 模式下结束 plan 时，审批弹窗自动显示在 lead 侧终端，带队员颜色徽章，选项为"通过 / 继续规划 / 退出 Plan 模式"三档（和常规工具审批的"通过 / 永久通过 / 拒绝"语义不同）。此能力开箱即已具备，本次变更新增防回归断言锁定契约
+  - **优雅关停握手 + 超时兜底**：`TeamDelete` / 手动关停队员时，lead 会发送关停请求等待队员响应；若队员在默认 15 秒内无响应，自动强制终止进程，避免队员卡死导致清理流程永挂
+  - **队员进度快照**：实时追踪每个队员跑了多少轮工具调用、累计生成多少文本（粗估），以及最近 10 次工具活动的摘要；未来 TUI/Web UI 可直接展示"队员 X: 12 工具调用, 3.2k tokens, 当前正在用 Bash"。token 数字为粗估，不是精确计费数
+- **新增环境变量**：
+  - `CODEBUDDY_TEAM_IDLE_DETECTION_DISABLED`：设为 `1` 关闭队员空闲感知（默认启用，关闭后空闲等待立即返回 `true` 不阻塞）
+  - `CODEBUDDY_TEAM_SHUTDOWN_GRACEFUL_TIMEOUT_MS`：关停兜底超时毫秒数，默认 `15000`；设为 `0` 禁用强制兜底（纯等待）
+  - `CODEBUDDY_BASH_ASSISTANT_BUDGET_MS`：默认 `0`，`>0` 启用主对话响应预算，主 agent 前台命令超过该时长自动转为后台任务保持对话响应（Bash 与 PowerShell 共享）
+  - `CODEBUDDY_BASH_AUTO_BACKGROUND_DISABLED`：设为 `1` 关闭超时自动后台化，回到旧 SIGTERM 行为（调试用）
+
+### 🔧 功能改进
+
+- **Bash 工具超时自动后台化**：前台命令到 `timeout` 时不再直接发 `SIGTERM` 杀子进程，而是自动转为后台任务继续跑，返回 `task_id` 供模型用 TaskOutput（兼容旧名 BashOutput）拉取后续进度/结果。`yarn install` / `docker build` / `cargo build` / `make` 等冷跑远超默认 timeout 的长命令不再被工具层冤杀。`sleep` 保留原行为（硬上限是等待语义本身）
+- **Bash 工具长命令引导更新**：`tool-bash-description.tpl` 引导更新——长命令（yarn/npm/docker/cargo/make 等）鼓励显式传 `run_in_background: true`，并说明超时不再是"kill"而是"auto-background"的新语义
+- **PowerShell 工具超时自动后台化**：对齐 Bash 工具——前台命令到 `timeout` 时不再直接杀进程，而是自动转为后台任务继续跑，返回 `task_id` 供 TaskOutput 查询。`Invoke-WebRequest` 大文件下载、长 `Copy-Item -Recurse`、经由 PowerShell 调用的构建等冷跑超时不再被工具层冤杀。`Start-Sleep` / `sleep` 保留原行为（PowerShell 大小写不敏感）
+- **PowerShell 工具后台任务状态查询**：显式传 `run_in_background: true` 的后台命令现在完整支持 TaskOutput 查询——以前是 fire-and-forget，task_id 查不到状态；现在可以和 Bash 一样拉取 stdout/stderr/status
+- **PowerShell 工具 Ctrl+B 转后台**：从"未实现"占位符升级为真实功能
+- **会话中断语义对齐**：Bash 与 PowerShell 工具均对齐会话中断语义——外部中断信号区分"用户主动取消"和"内部流程切换"两种；内部流程切换时不再杀掉正在跑的命令，改为尝试转为后台继续跑，避免并发调用 / turn 切换冤杀长命令
+- **主对话响应预算**：Bash 与 PowerShell 工具共享主对话响应预算（env `CODEBUDDY_BASH_ASSISTANT_BUDGET_MS=<ms>` 启用，默认 `0`=关闭），超过该时长的前台命令自动转为后台任务保持对话响应
+
+### 🐛 问题修复
+
+- **PowerShell 后台任务状态更新**：转后台后任务状态现在会根据真实退出码更新为 `completed`/`failed`（之前永远停留在 `running`，TaskOutput 查询看不到最终状态）
+- **PowerShell 后台任务异常回灌**：转后台后若命令晚些时候异常终止，不再冒泡为 Node unhandledRejection 警告，错误详情会回灌到任务的 stderr 输出，供 TaskOutput 查询展示
+- **PowerShell 后台文案语义准确**：转后台的原因现在会在返回文案里准确区分超时 / 主对话预算 / Ctrl+B / 显式后台 / 内部中断五种来源，不再复用相近文案造成语义污染
+
+### 📝 开发体验改进
+
+- `/mr` 命令模板强化两条易错点提示：
+  - 数据源迁移类改动的代码审查必须显式扫所有 reader（按钮回调、useCallback 闭包一次性快照、DI 一次性 get 等），不能只检查订阅者
+  - Changeset 路径强调必须写包级目录 `.changeset/` 而非仓库根目录，避免写错路径导致 CI 识别不到
+
 ## [2.94.4] - 2026-05-01
 
 ### 🐛 问题修复