@tencent-ai/agent-sdk 0.3.245-dev.cd0b453.202608251505 → 0.3.246

package/cli/CHANGELOG.md

@@ -7,6 +7,39 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.139.0] - 2026-08-25
+
+### 🎉 新功能
+
+- **结构化答复征询工具 `AskUserForStructuredInput`**：直连 ACP v1 `elicitation/create` 通道，接受说明文字与受限 JSON Schema，让客户端渲染表单收集用户的结构化答复，适合"多字段一次填写""可变长度的逐项授权/连接"等开放形状。默认关闭，需同时设置 `CODEBUDDY_ENABLE_ASK_USER_FOR_STRUCTURED_INPUT=1` 且客户端声明 `capabilities.elicitation.form=true`；参数完全泛化（`message` + `requestedSchema`），业务场景走 `--append-system-prompt`，仓库内置示例 prompt 可跑通 `/cli:debug` 全链路。CBC 内置 Web UI 同步新增卡片渲染器。不影响现有 elicitation 链路。
+
+### 🔧 功能改进
+
+- **`CODEBUDDY_IS_SANDBOX` 真正 full pass**：设置进程环境变量 `CODEBUDDY_IS_SANDBOX=1` 后，`-y` / `--permission-mode bypassPermissions` 跳过 HIGH/CRITICAL 审批，可见模式不变（TUI 显示红色 bypass）；默认 `-y` 仍是安全收敛后的 `bypassPermissions`，不会从 `settings.json` 注入该变量，`permissions.disableBypassPermissionsMode` 仍然生效。
+- **REPL 授权接入统一权限流程**：REPL 工具不再对每次执行硬性要求审批——auto 模式下由分类器读代码自动放行/拦截，普通模式下可被 allow 规则与"本会话允许"豁免；REPL 内危险命令（如 `rm -rf`、强制推送主分支等）与敏感文件访问会被拦截并回报错误。
+- **REPL 前台执行进度展示对齐 Bash**：不再显示会反复重置的孤立 `...running Ns ago` 条目，改为单行聚合进度（单调递增运行时长 + 子工具摘要 + 累积输出），内部子工具流式刷新被抑制；执行结束后结果行首行显示总耗时，`ctrl+o` 展开查看完整输出。工具调用行只回显 `code` 正文，不再显示 `timeout` / `description` 等次要入参。
+- **REPL 终端展示**：工具调用行显示代码用途说明，按 `ctrl+o` 展开后代码与执行结果分区展示，保留多行与语法高亮。
+- **`AskUserForStructuredInput` Web UI 卡片样式**：对齐 `AskUserQuestion` 面板视觉规范——pending 状态 brand 主色边框 + 呼吸动画、标题栏图标、独立卡片列表字段区、`enum` 选中填充主色、`boolean` 使用 switch 控件、主次分明的操作栏。
+- **内置插件市场改为 ZIP 分发**：由 Git 仓库克隆改为 ZIP 归档下载安装，提升安装稳定性与更新效率；为市场下载增加连接阶段超时兜底，DNS 解析 / TCP 连接 / 无响应时 10 秒内快速失败，不再阻塞主进程。
+- **工作台可下载当前文件**：编辑器、预览和文件树都能把当前文件存到本地。
+
+### 🐛 问题修复
+
+- **后台任务完成通知丢失**：后台任务结束但退出信号丢失时，不再停留"运行中"，改为定期核对进程真实存活状态，数秒内收口并推送通知；手动停止的任务正确显示「已停止」而非「已完成」；退出码无法采集时明确标注退出码未知并提示以命令输出判断结果；停止失败不再导致任务真正结束后的完成通知被永久丢弃。(#92382)
+- **对话偶发报「请求信息无效」（400）后卡住**：后台任务通知/撞线消息的续圈判定与注入间存在竞态，可能发出以助手回复结尾的请求被网关拒绝。现续圈时用同一归属快照取消息，并在仍取不到时自动补隐藏续跑占位，保证请求永不以助手回复收尾。仅影响上层自管队列（Mode B）场景。
+- **长会话内存泄漏**：修复 abort 监听器逐轮叠链、keep-alive socket `close` 监听器永不自摘导致的泄漏；token 估算改为只读遍历，移除对整条 history 的逐轮深拷；修复 fork/team 长会话首次保存时全量拼接历史导致的内存峰值；工具结果外置扩展到 `output_text` 正文（`providerData.toolResult.content` 渲染字段除外）。
+- **插件初始化恢复**：修复多进程并发或网络异常时插件初始化长期无响应、重复迁移或覆盖可用缓存的问题；增加 24 小时后台清扫、进程退出释放与 Windows PID 复用识别，自动收敛失效的 `.in_use` 标记；Git 身份探测仅对真实 Git 来源解析并限制耗时，避免打包市场因上级目录含 `.git` 触发无关调用。
+- **子智能体恢复与模型持久化**：打开已有子智能体保持当前画面不闪空白，带会话地址时短暂失败会重试；运行中改过的模型重启后沿用，不改主对话默认模型；空白会话套用上次选的模型；频道回执按频道认、坏信封不当用户气泡；1:1 @ 只补全不投递、频道点名走频道页；发言后头像马上进入忙碌态。
+- **历史回放容错**：单条 schema 异常的历史工具调用（如 `command` 为对象而非字符串）不再导致整段会话回放报错、HTTP 500 或历史打开为空——工具标题生成走安全兜底，坏项逐条跳过并记录可定位日志，其余历史正常展示。(#94491)
+- **sandbox 会话断开执行工具挂起**：主动断开连接也会通知上层收尾活跃执行句柄，不再因依赖反向结束通知的工具永久 pending 导致 Agent 任务卡死。
+- **新建页搜索下拉不再挡住输入**：搜索结果跟在搜索条下面占位，不盖住下方输入框。
+- **Web UI 源代码管理**：并发 Git 操作或短暂 index 锁冲突导致切换分支失败的问题，统一串行化仓库操作并阻止重复触发，提供友好错误说明与重试入口。
+
+### 📝 文档更新
+
+- `docs/tools-reference.md` 补充 `AskUserForStructuredInput` 工具条目。
+- `docs/env-vars.md` 补充 `CODEBUDDY_ENABLE_ASK_USER_FOR_STRUCTURED_INPUT` 开关说明。
+
 ## [2.138.0] - 2026-08-24
 
 ### 🎉 新功能