@tencent-ai/agent-sdk 0.3.237 → 0.3.239

package/cli/CHANGELOG.md

@@ -7,6 +7,43 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.133.1] - 2026-08-08
+
+### 🐛 问题修复
+
+- **遥测归属**：修复本地 CLI 遥测缺少功能模块归属的问题。
+
+## [2.133.0] - 2026-08-06
+
+### 🎉 新功能
+
+- **模型 429/限流自适应重试**：对"生成开始前"的失败（429 / 5xx / 408 / 409）新增指数退避 + jitter + 尊重服务器 `retry-after` 的自动重试，网关重启、瞬时过载等场景不再直接中断整个任务。重试严格发生在流式内容产出之前，绝不重发已产出的流，因此不会放大 token / 计费。额度耗尽类错误不再无谓重试，直接交由模型 fallback（识别自有模型业务码与第三方兼容网关的标准额度话术）；自有模型额外识别内部限频码（14003 / Craft 6000-6008，其中「天」窗口码 6004/6008 直接 fallback），自定义第三方模型只按 HTTP 状态码判定。新增 `CODEBUDDY_MAX_RETRIES`（默认 8，上限 15）控制请求级最大重试次数、`CODEBUDDY_RETRY_WATCHDOG=1` 开启无人值守场景的无限重试（退避封顶 5 分钟）。#77910
+- **stream-json 错误事件补充结构化维度**：headless SDK `-p --output-format stream-json` 模式下，遇到上游错误（如 502 / 429 / 401）时，`result` 事件除原有 `errors: string[]`（纯文本）外，向前兼容地新增 `errors_info: Array<Info | null>`。字段按索引与 `errors` 一一对应，携带 `status`（HTTP 码）、`code`（SDK/业务码）、`category`（错误分类）、`details`（脱敏文案）。字段可选、抽不出结构化维度时整体省略，老消费者只读 `errors` 无感知。
+- **stdio 常驻模式请求耗时观测**：新增「收到 message → 发出模型请求」耗时日志，区分第一次与第 n 次 prompt，便于定位常驻模式下首个 prompt 的启动开销占比。
+
+### 🚀 性能优化
+
+- **stdio 常驻模式首个 prompt 提速（约 3 秒）**：修复 `ModelPromptContextInitializer` 与 rebuild 期的循环等待，改走gate-free 路径 `getModelForContext/getModelsForContext`，语义不变但省掉就绪gate，把首个 prompt 的 `stdinWait` 从约 3042ms 降到毫秒量级。#84036
+- **stdio 常驻模式 MCP 首连冗余同步消除（约 3 秒）**：修复 MCP server 首次连接触发的一次冗余产品配置同步——它在 3 秒防抖后触发、结果无变化却强制 agent 重建，恰好砸进首个 prompt 的就绪收敛窗口。改为短防抖聚合 + server 状态未翻转时跳过同步。#84036
+
+### 🔧 改进优化
+
+- **stdio initialize / resume 握手提速**：`--input-format=stream-json` 非 `-p` 模式下，`getInitializeMetadata` 内`waitConfiguration` 不再等完整 sync 链，仅订阅 configuration observable 的下一个非空值，避免被 activate 后的二次 sync（含云端拉取 200~300ms）拖长；单次 initialize 快照耗时从 200~300ms 降至 <10ms。#82841
+- **遥测归属**：优化 Cloud Agent 多客户端场景下的遥测公共字段归属，使模型请求和关键行为上报优先使用发起端客户端信息。
+- **MCP 连接诊断**：连接失败日志补充 `error.cause` 中的真实原因（TLS/DNS/ECONNREFUSED/代理），不再只有泛化的 `fetch failed`；透传 MCP SDK 的 error/warn 日志并做敏感信息脱敏，提升线上问题定位能力。
+
+### 🐛 问题修复
+
+- **模型吐出畸形工具参数后反复空转**：模型偶尔产出语法非法的工具调用参数（如值未加引号），此前这类调用连同报错反馈会一起被从上下文删除，模型看不到自己错在哪，只能原样重试。现在只要该调用已执行并拿到真实反馈，就保留调用与结果、并把原始参数回显给模型使其自纠；未执行、被中断和输出截断的调用维持原有处理不变。#83827
+- **文件路径参数类型不对时报错信息不可用**：模型偶尔把文件路径参数写成数字等非字符串值，此前会抛出无法理解的错误（形如 `xxx is not a function`）并覆盖掉本该给出的"参数类型不对"提示。现在会明确说明是哪个参数、期望什么类型、实际收到什么；工具执行后的附加处理即使失败也不再改写工具已给出的结果。#83827
+- **/model 模型切换**：修复 `/model` 无法覆盖 `--model` 启动参数的问题。切换主模型后，会话实际使用的模型与场景变体（lite / reasoning）统一跟随当前会话选择，自定义模型切换也完整生效。#82146
+- **TUI 顶部栏模型信息滞后**：修复 `/model` 或模型面板切换模型后执行 `/clear`，顶部栏仍显示旧模型、需再执行一次 `/clear` 才更新的问题。修复后 `/clear` 后立即以最新模型与环境信息渲染。#83255
+- **终端字符集污染导致 TUI 花屏**：外部命令输出或文件内容里的 DEC 画线字符集切换（`ESC ( 0`）与 Locking Shift（`SO`/`SI`）不再泄漏进渲染文本；即使终端已被污染，启动 CLI、按 `Ctrl+L` 刷新或窗口 resize 都会自动复位字符集，退出 CLI 时也补发复位序列。#81441
+- **Windows 终端闪窗**：修复 Windows 上打开 Web UI 后终端窗口每隔几秒闪一下的问题——Git 面板周期性刷新执行的 git 命令未隐藏子进程控制台窗口。#82183
+- **私有 CA 支持**：HTTP/SSE MCP 传输的 fetch 改用与 axios 路径一致的 CA bundle，修复内网私有 CA 网关的 TLS 握手失败。#80975
+- **产品配置端点对齐**：修复产品配置在大配置落盘场景下未正确使用宿主下发的权威服务端点，导致模型清单与实际推理端点不一致的问题；保持预发端点判断不受服务端点修正影响，避免生产环境被误判为预发环境。#83458
+- **启动阶段取消**：修复启动阶段取消请求可能未正确传递到当前运行的问题，避免取消操作在极端时序下丢失或影响后续请求。#84287
+
 ## [2.132.0] - 2026-08-02
 
 ### 🎉 新功能