@tencent-ai/codebuddy-code 2.95.0 → 2.95.1-next.d9e54f0.20260508

package/CHANGELOG.md

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