@tencent-ai/agent-sdk 0.3.163 → 0.3.165

package/cli/CHANGELOG.md

@@ -7,6 +7,65 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.103.0] - 2026-06-04
+
+### 🎉 新功能
+
+- **DeepSeek V4 模型支持**：新增 DeepSeek V4 Pro 和 Flash 两个推理模型，支持 1M 上下文窗口、工具调用和图片理解。
+- **Doctor 诊断面板增强**：新增 Session ID、Trace ID、Request ID 展示，方便问题定位。
+
+### 🔧 改进
+
+- **messageErrorCode 对齐**：新版本 CLI 的 chat 遥测事件中 `messageErrorCode` 与旧版数据口径对齐，使用 10 级优先链映射原始错误到 CBC 业务错误码。
+- **调试环境变量标准化**：统一使用 `CODEBUDDY_DEBUG` / `CODEBUDDY_DEBUG_SDK` 替代旧的 `DEBUG` / `DEBUG_SDK`。
+- **Trace ID 持久化**：新增 `lastConversationTraceId` 字段，确保诊断面板在会话跨回合后仍可展示最近的 Trace ID。
+- **模型切换配置**：每个模型独立声明 `relatedModels.lite` / `relatedModels.reasoning`，移除已无法覆盖新模型场景的 `defaultRelatedModels` 全局兜底,确保各模型在 lite / reasoning 切换时的目标模型符合预期。
+- **沙箱审批超时可配置**：新增 `CBC_SANDBOX_APPROVAL_TIMEOUT_MS` 环境变量，便于测试和调试时自定义沙箱权限拦截等待超时时长（默认 120000ms）。
+
+### 🐛 修复
+
+- **沙箱超时弹窗未消失**：修复沙箱权限拦截等待超时自动拒绝后，Desktop / Web UI 弹窗未同步消失的问题。现在超时拒绝时会广播 `permissionResolved` 事件，前端收到后正确清除弹窗状态。
+- **遥测请求 ID 一致性**：简化对话请求 ID 的处理逻辑，统一其生成来源，移除冗余的兜底分支，避免影响上报数据的一致性。
+- **思考强度同步性能问题**：修复客户端开会话后渲染层与 CLI 之间形成 ACP 反馈环，导致 `session/set_config_option` 在 1.4 秒内被反复调用 200+ 次、单会话日志爆量到数百 MB 的性能问题。在事件源头按 `(配置项, 值)` 维度去重相邻同值广播,避免任何客户端（含未做幂等去重的旧版本）触发重复推送。
+- **ACP 鉴权恢复**：优化 ACP 掉授权后的异常上报与恢复提示，避免客户端收到不完整错误状态。
+- **Compact 边界消息 replay**：修复 compact 后重启 session 时，边界消息 replay 异常导致前端缺失 compact 分割线、history 误改父子链的问题。compact 边界消息现在会下发带 meta 标记的 `agent_message_chunk` 让前端正确渲染 divider；history 重建仅对可恢复的 compact 消息执行修正，避免对纯边界 user message 误改父链。
+- **路径超链接识别**：在 markdown 输出中主动给 POSIX 路径包 OSC 8 超链接，避免 VS Code / iTerm2 等终端在中英文混排场景把前缀汉字当成 URL 的一部分（例如「根因: /data/foo」误识别为「因: /data/foo」）。Cmd / Ctrl+Click 现在能精确跳到目标文件，并支持 `:line[:col]` 锚点。
+- **Backspace 键兼容**：在 iTerm2 / VS Code 内置终端等会把 ⌫ 发送为 `\x7f` 的环境下，按 Backspace 现在能正常向前删除字符，不再走「向后删除」分支。
+
+## [2.102.0] - 2026-06-03
+
+### 🎉 新功能
+
+- **后台任务完成主动推送**：`run_in_background` 的 bash / powershell 任务完成、失败或被终止时，会自动以 `<task-notification>` 形式注入对话流，模型在下一轮即可感知，无需再循环调用 `TaskOutput` / `BashOutput` 轮询。
+
+### 🔧 改进
+
+- **后台任务工具描述同步刷新**：bash / powershell 工具说明明确告知"完成会自动收到通知，不要 sleep/poll loop"，引导模型避免无意义的轮询占用 turn。
+- **网页获取体积限制**：远端 API 请求限制最大返回长度为 100K 字符，超过 15K 字符的内容自动触发 AI 摘要处理，降低上下文占用。
+- **网页获取并发竞争策略**：重构 `fetchWithFallback` 方法，由串行改为并发竞争模式 —— 本地 fetch（30s 超时）与远端 API fetch 并发启动，远端在 20s 内成功返回则采用其结果并取消本地请求；远端超时或失败时直接降级到已并发启动的本地 fetch。最坏总耗时从 `20s + 30s` 串行降为 `max(20s, 本地实际耗时)`。
+- **网页获取缓存机制**：fetch 结果缓存 15 分钟，命中缓存直接复用跳过网络请求。
+- **网页获取可观测性增强**：通过 `GalileoService` 上报 `webfetch.complete` / `webfetch.failed` 结构化事件，attribute 包含 source（cache / api / local）、needsSummary、apiStatus / apiContentLength / apiDurationMs、localStatus / localContentLength / localDurationMs、urlHost / urlPath（去除 querystring/hash）、totalDurationMs 等，失败上报到 logError 便于日志告警。
+- **subagent 埋点补全**：chat_message_send、chat_message_response、chat_tool_action 事件新增 `parentConversationId` 字段，与 chat_request_send 保持一致，支持 subagent / team 调用链路追踪。
+- **chat_message_status 关联字段补全**：新增 `rootRequestId`、`parentConversationId`、`agentName`、`agentType` 字段，与其他事件对齐。
+- **辅助功能埋点过滤**：prompt_suggestion、conversation_topic、context_compact 等辅助功能不再上报 chat_message_send / response，避免噪声。
+- **traceId 全链路打通**：ACP agent 生成 traceId 贯穿 Galileo session / tool 上报，便于端到端追踪单次对话请求。
+- **Tool 三件套日志**：新增 Tool start / success / error 独立上报 hook，支持工具维度的耗时与异常分析。
+- **uid resource attribute**：trace 资源属性中注入用户 ID，提升多用户环境下的日志关联能力。
+
+### 🐛 修复
+
+- **macOS 锁屏 / App Nap 唤醒后消息丢失**：长时间锁屏唤醒后，微信长轮询和企业微信群机器人长连接因系统冻结网络栈出现卡死或僵死连接，导致用户感知"消息丢了"。新增长连接活性看门狗，解冻瞬间自动 abort 卡死请求 / 重建 WebSocket，恢复正常收发；daemon 心跳与唤醒检测定时器同步去除 unref，避免被系统冻结后无法恢复。
+- **权限确认框点击后弹框不消失**：在 IDE 集成场景下，TUI 弹出工具权限确认框，按数字键 / 回车批准后弹框停留不关闭、需 ESC 才能关，但任务实际已开始执行。原因是 approve 路径先 await IDE closeTab RPC、再清空 pending$，IDE 慢响应或断连时 await 阻塞导致弹框无法及时关闭；现已调整为先同步关闭弹框再 fire-and-forget 触发 IDE 端清理，恢复点击即关的预期行为。同时移除 `useToolApprovalNavigation` 中针对 `AskUserQuestion` 的 `setImmediate` 包裹（`setAsk` 本身同步），避免 bypassPermissions 模式下 pending$ 二次 next 引发 effect 重入、`AskPanel` 永不挂载的竞态。
+- **企业策略导致创建任务超时**：暂时关闭 CLI 端的企业自定义模型策略与企业技能上传策略，修复其导致的创建任务超时问题。
+- **模型思考强度切换异常**：修复切换到非思考模型后仍可能携带上一轮思考强度的问题，并过滤非法思考强度配置，避免错误值进入最终请求。
+- **team agent respawn 关联字段丢失**：respawn 时恢复 `rootRequestId` 和 `parentConversationId`，修复 `.meta.json` 缺失导致关联字段丢失的问题。
+- **EditTool 创建新文件死循环**：`old_string=''` 且目标文件不存在时跳过 `hasBeenRead` 校验，让 Edit 工具能像 Write 一样创建新文件。修复此前"Edit 报先 Read，Read 又报文件不存在"的死循环。
+- **EditTool 错误信息附带 file_path**：`Edit error` / "File has not been read yet" / "File has been modified since read" 等错误消息现已带上具体文件绝对路径，并行多文件 Edit 失败时模型 / 用户能直接定位是哪个文件出问题，无需再翻 tool_call args。
+
+### 📝 文档更新
+
+- **故障排查文档新增"权限确认框无响应"章节**：在 troubleshooting 中列出 `[Approve]` / `[Reject]` / `[dequeue]` / `[tool-permission]` 关键日志 TAG 与"现象 → 推断"对照表，便于复现 / 定位同类弹框卡死问题。
+
 ## [2.101.0] - 2026-06-02
 
 ### 🎉 新功能