@tencent-ai/agent-sdk 0.3.99 → 0.3.100

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.45.0.md

@@ -0,0 +1,34 @@
+# 🚀 CodeBuddy Code v2.45.0 发布
+
+## ✨ 新功能
+
+### 工具搜索与延迟加载
+
+新增 ToolSearch 工具，支持通过自然语言搜索可用工具。MCP 服务器现在支持 `defer_loading` 配置，将工具延迟到需要时才加载，有效减少上下文消耗并提高工具选择准确性。
+
+### 环境变量模型配置
+
+支持通过环境变量灵活配置模型，方便在 CI/CD 环境和脚本中使用：
+
+- `CODEBUDDY_MODEL`：覆盖默认代理模型
+- `CODEBUDDY_SMALL_FAST_MODEL`：配置 lite 变体模型
+- `CODEBUDDY_BIG_SLOW_MODEL`：配置 reasoning 变体模型
+- `CODEBUDDY_CODE_SUBAGENT_MODEL`：配置子代理模型
+- `MAX_THINKING_TOKENS`：启用扩展思考并设置 token 预算
+
+### SDK Commands 订阅
+
+SDK 新增 `getAvailableCommands()` 和 `subscribeToCommands()` 方法，支持获取和实时订阅 CLI 可用命令列表变更。
+
+## 🔧 改进优化
+
+- **Skill Fork 上下文**：支持 `context: fork` 配置，使 Skill 在独立的子代理上下文中执行
+- **Agent 类型指定**：新增 `agent` 字段，可指定执行 Skill 的子代理类型
+- **图片粘贴优化**：增加剪贴板读取重试机制，扩展 macOS 图片格式检测，支持更多截图工具
+- **错误恢复增强**：当模型返回无效工具名时，系统会提示模型检查并重试
+- **界面简化**：将 "Plan Mode" 简化为 "Plan"，使界面更简洁
+
+## 🐛 问题修复
+
+- **ACP 多轮对话**：修复第二轮 prompt 直接返回结果、缺少 sessionUpdate 事件的问题
+- **插件加载去重**：修复插件 skills、agents、commands 在菜单中重复显示的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.45.1.md

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.45.1 发布
+
+## 🔧 改进优化
+
+- **登录界面优化**：调整登录方式顺序，将 iOA 登录放置到最后并标注仅限腾讯内部员工使用，让新用户更容易找到适合自己的登录方式
+- **文档完善**：在快速入门文档中添加四种登录方式的详细说明，帮助用户了解各登录方式的适用场景
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.40，SDK-Python 至 0.3.38

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.46.0.md

@@ -0,0 +1,12 @@
+# 🚀 CodeBuddy Code v2.46.0 发布
+
+## ✨ 新功能
+
+### 语言设置
+
+在 `/config` 中新增 Language 选项，您可以设置首选的响应语言，CodeBuddy Code 将使用您指定的语言进行回复，让交流更加自然流畅。
+
+## 🔧 改进优化
+
+- **复制快捷键**：新增 Ctrl+Y 快捷键，可快速复制最后一条 AI 回复到剪贴板，方便您快速获取代码片段或重要信息
+- **Shell 命令执行优化**：优化命令执行机制，仅在需要加载额外环境配置时才使用 eval 包装，保持默认情况下的原有行为，提升命令执行的稳定性

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.47.0.md

@@ -0,0 +1,20 @@
+# 🚀 CodeBuddy Code v2.47.0 发布
+
+## ✨ 新功能
+
+### 跨会话记忆功能
+
+新增实验性记忆功能，支持 Agent 在会话间保持持久化记忆。您可以通过 `/config` 设置面板或 `memory.enabled` 配置项启用此功能。同时支持团队记忆模式，将记忆存储在项目目录下便于团队共享。
+
+## 🔧 改进优化
+
+- **command:// URI 处理**：优化 ACP 协议中 command:// 资源链接的处理，正确转换为斜杠命令格式并回显原始内容块
+- **命令推送过滤**：修复内置命令被错误推送到 IDE 的问题，现在只推送用户自定义命令、skills 和特定内置命令
+- **文件路径搜索**：优化重复字符查询的匹配精度，避免误匹配分散的字符
+- **SSH 远程剪贴板**：修复在 Linux + SSH 远程环境下 Ctrl+Y 复制到剪贴板失败的问题，通过实现 OSC 52 协议支持远程终端剪贴板操作
+- **会话恢复历史控制**：优化 SDK 恢复会话时的历史回放逻辑，通过 `hasPrompt` 信号让 CLI 智能判断是否需要回放历史消息，提升 resume 场景的使用体验
+
+## 🐛 问题修复
+
+- **管道输入**：修复使用管道传递输入时内容无法被读取的问题（如 `cat file.txt | codebuddy -p "分析"`）
+- **Stop Hooks 执行时机**：修复当工具需要用户确认时 Stop Hooks 被错误执行的问题，现在只有在没有待审批工具时才会触发

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.48.0.md

@@ -0,0 +1,32 @@
+# 🚀 CodeBuddy Code v2.48.0 发布
+
+## ✨ 新功能
+
+### 图生图工具（ImageEdit）
+
+新增 `ImageEdit` 工具，支持基于已有图片进行 AI 编辑和修改：
+- 支持风格转换、添加元素、修改颜色等图片编辑操作
+- 使用 `/model:image-to-image` 命令切换图生图模型
+- 通过 `CODEBUDDY_IMAGE_TO_IMAGE_MODEL` 环境变量或 `imageToImageModel` 设置项配置默认模型
+
+### Prompt Hook
+
+新增基于 LLM 的 Hook 类型，支持使用自然语言定义触发条件，实现更灵活的工作流控制。
+
+## 🔧 改进优化
+
+- **图片 API 重构**：提取共享的 `ImageApiClient` 模块，统一文生图和图生图的 API 调用逻辑
+- **模型标签系统**：引入 `text-to-image` 和 `image-to-image` 模型标签，支持同一模型同时具备多种图像生成能力
+- **Hook 配置面板**：支持显示和管理 Prompt Hook，优化阻断信息的展示方式
+- **Token 计算准确性**：`/context` 命令现在只统计实际启用的工具，排除被禁用的内置工具和 MCP 工具
+- **Plan 模式权限继承**：Plan 模式下保留进入前的权限设置，支持 "plan + bypass" 等组合模式，子代理同样继承此权限配置
+- **热更新系统优化**：在低 FD 限制的容器环境中自动检测并优化热更新行为，支持 `CODEBUDDY_DISABLE_HOT_RELOAD` 完全禁用热更新
+- **Windows 路径提示**：在 Windows 平台添加使用正斜杠的提示，避免反斜杠导致路径解析错误
+- **WorkBuddy 配置分离**：WorkBuddy 现在使用独立的 `.workbuddy/` 配置目录，与 CLI 的 `.codebuddy/` 分离
+
+## 🐛 问题修复
+
+- **ACP 取消处理**：优化取消请求的事件传递机制，确保会话能正确响应取消操作
+- **MCP 非交互模式**：修复 ACP 模式下 MCP 工具未正确识别为非交互模式的问题
+- **记忆上下文注入**：修复记忆提示注入时缺少系统标签的问题
+- **目录扫描**：修复软链接目录下文件相对路径计算不正确的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.48.1.md

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.48.1 发布
+
+## 🔧 改进优化
+
+- **环境变量认证冲突检测**：当设置了 `CODEBUDDY_API_KEY` 或 `CODEBUDDY_AUTH_TOKEN` 环境变量时，/login 命令会自动检测并提示冲突解决方案；认证失败时显示更详细的诊断信息，帮助快速定位问题
+- **子代理消息标识**：修复子代理 user 消息在流式输出时缺少父工具标识的问题，客户端现可正确区分主代理和子代理的消息
+- **MCP prompt 命令格式统一**：统一 MCP prompt 与斜杠命令的上下文拼接格式，确保模型能正确理解命令来源和参数
+
+## 📝 文档更新
+
+- **Prompt Hooks 文档**：完善基于提示词的 Hooks 功能文档，新增支持事件说明、配置示例和最佳实践指南

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.0.md

@@ -0,0 +1,26 @@
+# 🚀 CodeBuddy Code v2.49.0 发布
+
+## ✨ 新功能
+
+### 使用洞察报告
+
+新增 `/insights` 命令，生成 AI 驱动的使用洞察分析报告。报告涵盖交互风格、项目领域、摩擦点、亮点、改进建议等多个维度，帮助您更好地了解和优化自己的 AI 协作模式。支持在浏览器中查看 HTML 格式的可视化报告。
+
+## 🔧 改进优化
+
+- **统计数据准确性**：优化 token 用量统计逻辑，正确区分主会话与子代理会话，修复工具调用 token 遗漏问题
+- **进度显示**：支持自定义进度文本，在 loading 状态中实时展示当前处理进度
+- **自定义模型配置**：修复自定义模型错误继承全局关联模型配置的问题，确保行为符合预期
+- **记忆系统**：优化记忆上下文提示词，精简表述并新增隐式记忆源支持，提升跨会话记忆召回能力
+- **多语言支持增强**：所有子 Agent 现在会正确遵循用户的语言设置进行回复
+- **UI 刷新优化**：优化工具执行完成后的终端刷新策略，增加防抖机制减少不必要的渲染
+- **内存优化**：子 Agent 任务完成后自动释放会话历史和引用，减少内存占用
+- **Grep 搜索**：自动修正搜索模式参数，避免不必要的调用失败；兼容 ripgrep 正则语法
+- **文件读取**：读取目录时返回目录列表，帮助快速定位目标文件
+
+## 🐛 问题修复
+
+- **工具错误处理**：改进工具未找到时的错误提示和处理逻辑
+- **Headless 模式**：修复使用非默认 agent 时流式输出阻塞的问题，确保 completion 信号正确发送
+- **工具结果显示**：修复 Edit 等工具执行完成后输出不显示，需要手动调整终端大小才能看到的问题
+- **会话恢复列表**：移除会话恢复面板中不必要的 agent 类型过滤，允许恢复所有有效会话

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.1.md

@@ -0,0 +1,14 @@
+# 🚀 CodeBuddy Code v2.49.1 发布
+
+## 🔒 安全加固
+
+- **沙箱配置文件保护**：沙箱模式下自动禁止写入 CodeBuddy 配置文件（settings.json），防止通过注入 hooks 实现沙箱逃逸攻击；文件系统拒绝规则同步应用到 Write、Edit 等文件操作工具，确保安全策略全面一致
+
+## 🔧 改进优化
+
+- **会话列表过滤**：过滤子代理和压缩分支会话，确保会话列表和最近会话仅展示用户真实会话
+- **SDK 文档修复**：修复认证配置链接中的括号格式问题
+
+## 🐛 问题修复
+
+- **会话历史定位**：修复了切换会话或恢复历史时，`lastMessageId` 可能错误指向无 ID 的自定义消息（如摘要、主题）导致对话链断裂的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.2.md

@@ -0,0 +1,39 @@
+# 🚀 CodeBuddy Code v2.49.2 发布
+
+## 🔧 改进优化
+
+### 跨会话任务列表共享
+
+支持通过环境变量 `CODEBUDDY_TASK_LIST_ID` 在不同会话间共享任务列表，便于多终端协作和持续任务追踪。
+
+示例：
+
+```bash
+# 在多个终端中使用相同的任务列表
+export CODEBUDDY_TASK_LIST_ID=my-project-tasks
+codebuddy
+```
+
+### 日期格式优化
+
+系统信息中的日期显示现在包含星期信息，使用更友好的格式，提升可读性。例如：`Tuesday, Feb 10, 2026`。
+
+## 🐛 问题修复
+
+### 会话切换权限保持
+
+修复切换会话时权限模式未保留的问题，确保切换后延续当前的权限设置。之前切换会话后权限模式会意外重置，现在会正确保持。
+
+### 拦截器重试机制
+
+修复了当模型响应拦截器触发自动重试时，视图层仍然输出原有失败结果的问题。现在拦截器启动重试后，会正确抑制失败结果的输出，仅显示重试后的成功响应。
+
+### ACP 流式模式中断优化
+
+- **中断状态竞态条件**：修复 ACP 流式模式下中断状态因共享 RunState 被后续运行修改导致的竞态问题，改用事件快照缓存中断状态
+- **结果消息查找**：改进最终助手消息查找逻辑，支持从响应输出中反向搜索已完成消息，并在未找到时回退到会话历史
+
+## 🔨 构建优化
+
+- **构建工具升级**：升级 goreleaser、bun、uv 至最新版本
+- **Bun 编译优化**：启用字节码编译和 ESM 格式，提升启动性能

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.3.md

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.49.3 发布
+
+## 🔧 改进优化
+
+- **模型错误提示优化**：当模型不可用时，自动展示当前账号支持的模型列表，方便用户快速切换到可用模型
+- **错误处理**：优化了被封装的模型行为错误（ModelBehaviorError）的处理逻辑，确保工具调用失败时能够正确识别并重试
+- **MCP 服务器就绪检测**：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.5.md

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.49.5 发布
+
+## 🔧 改进优化
+
+- **MCP 服务器就绪检测**：修复 SDK 模式下 MCP 工具在初始化时可能未就绪的问题，确保工具在首次调用时已完全初始化
+- **构建优化**：移除 Bun 编译中不再需要的构建标志，简化二进制打包流程
+
+## 🐛 问题修复
+
+- **会话压缩挂起修复**：修复了 ACP 会话在压缩消息日志后可能永久挂起的问题，增加了超时保护机制防止异常情况下的永久阻塞
+- **会话历史恢复**：修复查找最后消息 ID 时未正确跳过自定义消息项的问题，避免恢复会话时定位到错误的消息位置

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.6.md

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.49.6 发布
+
+## 🔧 改进优化
+
+- **SDK MCP 初始化时序优化**：修复 SDK 模式下 MCP 服务器注册与 prompt 处理的竞态问题，确保 MCP 工具在 prompt 处理前完成就绪，避免工具调用失败
+- **Headless 模式检测改进**：优化 headless 模式识别逻辑，支持 ACP 模式和非 TTY 环境的自动检测
+- **MCP 配置文件路径支持**：SDK 的 mcpServers 参数新增支持文件路径字符串格式，简化配置方式
+- **ACP SDK 升级**：升级 ACP SDK 至 0.14.1 版本，修复终端输出字节限制参数类型兼容性问题
+- **CI 配置优化**：为 bot 配置添加 npcName 参数支持

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.49.7.md

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.49.7 发布
+
+## ✨ 新功能
+
+### GLM-5.0 模型支持
+
+新增 GLM-5.0 大语言模型，支持 200K 上下文窗口和 48K 输出 token，为国内版和 iOA 版用户提供更强大的推理能力选择。

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.5.0.md

@@ -0,0 +1,24 @@
+# 🚀 CodeBuddy Code v2.5.0 发布
+
+## ✨ 新功能
+
+- 会话分支管理：支持在恢复会话时创建新的分支，帮助你更好地组织和管理不同的对话主题
+- 消息回放确认：在非交互模式下自动回显你的输入内容，确保命令执行前能够二次确认
+- 自定义代理配置：允许你通过配置文件定义专属的 AI 助手行为和能力
+- 系统提示词个性化：支持自定义或扩展系统提示词，让 AI 助手更符合你的工作习惯
+- 设置加载控制：灵活指定从哪些来源加载配置（用户级/项目级/临时设置），满足不同场景需求
+- 外部配置导入：支持从文件或 JSON 字符串加载额外设置，便于配置共享和复用
+
+## 🔧 改进优化
+
+- 命令执行更灵活：可通过环境变量自定义 Bash 命令的超时时间和输出长度，适应不同任务需求
+- 详细日志模式：新增详细输出开关，帮助你深入了解 AI 助手的执行过程
+- 流式消息增强：在流式输出模式下支持查看完整的增量消息，提供更透明的执行反馈
+- 成本统计美化：改进使用成本统计的展示格式，信息对齐更清晰易读
+- 配置加载优化：添加产品配置缓存机制，提升启动速度和运行性能
+
+## 🐛 问题修复
+
+- MCP 服务器交互优化：解决非交互模式下 MCP 服务器审批导致的阻塞问题，现可预先配置免审批服务器
+- 终端兼容性改善：修复部分终端环境下的粘贴模式异常和 ESC 键延迟问题，输入体验更流畅
+- 更新服务稳定性：优化自动更新检查机制，避免重复安装，确保更新过程可靠稳定

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.0.md

@@ -0,0 +1,25 @@
+# 🚀 CodeBuddy Code v2.50.0 发布
+
+## ✨ 新功能
+
+### Agent Teams 多智能体协作
+
+全新的 Team 功能让多个 Agent 可以协同工作，通过 TeamCreate、TeamDelete、SendMessage 等工具实现任务分配和消息传递。Agent 工具扩展支持 teammate 生成，TaskList 支持团队任务协调，适用于复杂项目的并行处理场景。可通过环境变量灵活控制 Team 功能的启用与关闭。
+
+## 🔧 改进优化
+
+- **子代理任务展示优化**：后台任务以 `@AgentType` 样式展示实时进度，同步任务进度集成到 loading spinner 中，界面更简洁
+- **任务完成通知增强**：通知消息包含执行时长、工具调用次数和 token 用量等统计信息，方便了解任务执行情况
+- **后台任务资源清理**：子代理结束时自动清理关联的后台 shell 任务，避免资源泄漏
+- **TaskOutput 超时调整**：默认超时从 30s 提升到 120s，默认阻塞等待完成，减少超时中断
+- **延迟加载工具修复**：修复延迟加载工具通过搜索激活后仍报 "Tool not found" 的问题，未激活时自动激活并提示重试
+- **工具搜索结果优化**：搜索结果改为简洁文本格式，未展开时即可看到工具名称和描述
+- **MCP 服务器管理改进**：修复移除 MCP 服务器后配置未实际删除的问题；SDK 注册的 MCP 服务器现在会在初始化时自动连接并立即可用
+- **SDK 参数格式统一**：JS 和 Python SDK 的 CLI 参数格式标准化为 `--flag=value` 风格
+- **Plan Mode 交互优化**：拒绝计划时区分"继续规划"和"退出规划模式"两种操作，避免被困在不可恢复的规划循环中
+- **队列消息显示优化**：支持中文字符宽度感知的智能截断，自适应终端宽度
+- **Memory 功能默认启用**：将 Memory 功能的默认值调整为开启状态
+
+## 🐛 问题修复
+
+- **依赖注入稳定性**：修复单例组件在循环依赖场景下可能被重复实例化的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.1.md

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.50.1 发布
+
+## 🔧 改进优化
+
+- **文档导航优化**：将 Agent Teams 文档移至 Sub-Agents 之后，使导航结构更符合功能关联性，方便用户按逻辑顺序查阅文档
+
+## 🐛 问题修复
+
+- **配置文件注释保留**：修复保存 MCP 配置时 mcpServers 字段下的 JSONC 注释丢失的问题，确保用户在配置文件中添加的注释不会被意外删除

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.2.md

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.50.2 发布
+
+## 🔧 改进优化
+
+- **MCP Remote 传输类型**：新增 `remote` 传输类型支持，允许通过远程 HTTP 连接 MCP 服务器，扩展了 MCP 的连接方式
+- **构建速度提升**：切换到 Rspack 拷贝插件并将 patch 脚本并行化，加快项目构建速度
+- **任务进度显示优化**：已完成的子任务在全部执行完毕后自动清除，避免大量已完成条目累积占据屏幕空间，保持界面整洁
+
+## 🐛 问题修复
+
+- **粘贴 URL 误判修复**：修复粘贴以 `http://` 或 `https://` 开头的 URL 时被错误识别为文件路径的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.3.md

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.50.3 发布
+
+## 🐛 问题修复
+
+- **模块加载兼容性修复**：修复 `createRequire` 在某些打包环境下因 `import.meta.url` 不可用导致模块加载失败的问题，提升运行时兼容性

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.4.md

@@ -0,0 +1,17 @@
+# 🚀 CodeBuddy Code v2.50.4 发布
+
+## 🔧 改进优化
+
+### 后台任务体验升级
+
+后台 Agent 现在自动创建轻量级团队，通过 SendMessage 回传结果，无需再使用 TaskOutput 手动轮询。后台任务完成后自动通知主 Agent，整体交互更流畅。UI 进度展示也进行了统一，后台任务纳入 TeammateProgressView 集中展示。
+
+- **启动性能优化**：优化首次启动时的初始化流程，并行化注册流程，启动速度提升约 10%
+- **终端渲染优化**：统一所有动画组件为全局单一时钟驱动，减少独立定时器导致的终端闪动
+- **消息渲染修复**：修复消息完成后不显示、需要 resize 终端才能看到的问题
+- **内存泄漏修复**：修复 `refreshStatic` 导致内部输出缓冲区无限累积的问题
+- **任务清理修复**：修复失败的子任务未被正确清理导致进度显示残留的问题
+
+## 🐛 问题修复
+
+- **Bash 工具输出修复**：修复 Bash 工具执行结果下方偶尔出现多余空白行的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.5.md

@@ -0,0 +1,16 @@
+# 🚀 CodeBuddy Code v2.50.5 发布
+
+## ✨ 新功能
+
+### Bash 专用子代理
+
+新增 Bash 内置子代理，专注于命令行任务执行。当 AI 需要执行 git 操作、运行构建工具、执行测试等终端任务时，会自动调用轻量级 Bash 子代理快速完成，提升命令执行效率。
+
+### 命令安全检测
+
+新增 Bash 命令注入检测机制，自动识别并拦截包含反引号替换、`$()` 命令替换、换行符注入等潜在危险构造的命令，增强终端操作安全性。
+
+## 🔧 改进优化
+
+- **子代理工具配置优化**：调整 Plan 子代理工具集，新增团队协作工具支持；精简 Explore 子代理工具，减少不必要的工具加载
+- **子代理标签显示优化**：子代理名称统一使用前景色文字显示，视觉更简洁一致

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.6.md

@@ -0,0 +1,15 @@
+# 🚀 CodeBuddy Code v2.50.6 发布
+
+## 🔧 改进优化
+
+- **高危命令识别规则优化**：大幅减少误杀率，细化 CRITICAL/HIGH/MEDIUM 三级风险判定规则。常见开发命令如 `git restore --staged`、`rm temp.log`、`docker rm`、`kill -9` 等不再被错误拦截，提升日常开发流畅度
+- **权限规则安全分层**：将 allow 规则按来源区分为可信（用户设置）和不可信（项目设置），防止恶意仓库通过项目配置文件注入权限规则绕过安全检查，增强供应链安全防护
+- **安全白名单扩展**：新增 50+ 常见开发工具命令到安全白名单，涵盖构建工具、测试框架、包管理器、代码质量工具等，减少不必要的授权弹窗
+- **子代理模型配置优化**：为 MiniMax-M2.5 和 Kimi-K2.5 模型补充 relatedModels 配置，确保子代理在使用这些模型时能正确选择对应的轻量级和推理模型变体
+
+## 🐛 问题修复
+
+- **进程僵死修复**：修复关闭终端后进程不退出且 100% CPU 占用的问题
+- **Shell 句柄泄漏修复**：修复多处 Shell 执行句柄未正确释放的问题，防止 PTY 文件描述符泄漏
+- **node-pty fd 泄漏修复**：检测并在 dispose 时关闭 node-pty 内部泄漏的额外 ptmx 文件描述符
+- **诊断增强**：在 /doctor 面板中添加 Active PTYs 计数，便于检测潜在的 PTY 泄漏

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.50.7.md

@@ -0,0 +1,15 @@
+# 🚀 CodeBuddy Code v2.50.7 发布
+
+## 🔧 改进优化
+
+### Team 成员焦点导航
+
+使用 Team 协作时，现在可以通过 Shift+↑/↓ 在各成员之间切换视图，实时查看成员的对话历史、执行进度和 Token 消耗情况，按 Ctrl+O 可快速返回主视图。
+
+- **成员消息直达**：聚焦到某个成员后，输入框自动切换为向该成员发送消息模式，使用 @main 可将消息路由回主代理
+- **消息路由增强**：SendMessage 工具支持 "main" 别名，用户消息注入成员会话时不再添加多余的 XML 包装
+
+## 🐛 问题修复
+
+- **子代理 AbortSignal 监听器泄漏**：修复子代理中 abort 事件监听器在错误的 AbortSignal 上注册和移除的问题，消除级联中断时的异常报错
+- **成员会话恢复**：修复子代理重启时订阅丢失导致 0 token 的问题，修复 agent_end 事件竞态条件

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.51.0.md

@@ -0,0 +1,24 @@
+# 🚀 CodeBuddy Code v2.51.0 发布
+
+## 🎉 新功能
+
+### 记忆目录摘要
+
+系统提示词中新增记忆文件列表摘要，展示文件名、大小、修改日期及首行标题。AI 助手现在可以一眼看到您有哪些记忆文件，并按需加载相关内容，避免将所有记忆文件内容塞入上下文，大幅节省 Token 消耗。
+
+### 记忆文件自动清理
+
+会话历史清理时同步清理过期记忆文件，复用相同的保留期配置。再也不用担心 `.codebuddy/memories/` 目录无限增长了。
+
+## 🔧 改进优化
+
+- **Skills 支持内联 Shell 命令**：Skills 的 SKILL.md 现在支持 `` !`command` `` 语法执行 Shell 命令，与斜杠命令保持一致的处理管道，让 Skills 编写更加灵活
+- **Skill 斜杠命令分发**：支持通过 `/skill-name` 或 `skill-name` 直接调用已注册的 Skill，未匹配到内置命令时自动回退到 Skill 查找，提升命令使用的流畅度
+- **斜杠命令菜单优化**：描述过长时自动截断，避免菜单项跨多行显示，界面更整洁
+- **YAML 解析增强**：支持折叠块标量语法（`>-`、`>+`），正确将多行描述折叠为单行
+- **模型系数更新**：更新各模型的计费系数至最新值，新增部分模型支持，计费更准确
+
+## 🐛 问题修复
+
+- **确认框滚动修复**：修复权限确认框、计划确认框和编辑确认框内容超过终端高度时滚动条自动跳到顶部的问题，长内容确认体验更顺畅
+- **自定义子代理工具继承**：修复自定义子代理在未配置工具列表时会继承创建子代理能力的问题，避免意外的递归调用

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.51.1.md

@@ -0,0 +1,17 @@
+# 🚀 CodeBuddy Code v2.51.1 发布
+
+## 🔧 改进优化
+
+- **Ctrl+N/P 快捷键映射**：支持使用 Ctrl+N/Ctrl+P 替代方向键 ↓/↑，在输入框、选择菜单、确认面板等所有场景中均可使用，为习惯 Emacs 键位的用户提供更顺畅的操作体验
+- **Loading 状态 Token 展示优化**：修复主 agent 等待 subagent 时 token 显示为 0 的问题，现在能正确展示实时流式 token 变化；subagent 和 Team 成员进度行均支持实时流式 token 展示
+- **会话级授权同步**：在子代理执行过程中选择"本次会话不再询问"时，授权现在会同步到主会话和所有子代理，避免重复弹出相同的权限确认
+- **MCP 连接超时保护**：为 MCP 服务器连接等待添加超时机制，防止在 headless 模式下因服务器无响应而无限挂起
+- **Team 通知机制优化**：重构后台任务完成通知，改用邮箱延迟去重机制，避免重复通知干扰对话流；修复队列消息丢失发送者身份的问题
+- **新增模型支持**：添加 GPT-5.3-Codex 模型配置
+- **Agent Teams 设置显示**：设置面板中 Agent Teams 默认状态现在正确显示为开启
+
+## 🐛 问题修复
+
+- **自定义命令覆盖内置命令**：修复自定义斜杠命令和 Skill 无法覆盖同名内置命令的问题，现在按项目级 > 用户级 > 内置的优先级正确覆盖
+- **启动界面渲染**：修复欢迎 Banner 重复渲染以及信任对话框与 Banner 内容重叠的显示问题
+- **后台任务查询**：修复后台 Agent 启动后通过 TaskOutput 查询时报 "not found" 的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.51.2.md

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.51.2 发布
+
+## 🔧 改进优化
+
+- **新增模型支持**：添加 Gemini 3.0 Pro 和 Gemini 3.0 Flash 模型配置，您现在可以在模型选择中使用这两款 Google 最新一代模型，享受更强的推理能力和更快的响应速度

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.0.md

@@ -0,0 +1,30 @@
+# 🚀 CodeBuddy Code v2.52.0 发布
+
+## ✨ 新功能
+
+### 团队视图切换
+
+支持通过方向键在不同团队成员视图之间快速切换。按 `↓` 进入切换模式，`←/→` 选择成员，`Enter` 确认切换到成员视图，实时查看对话历史和工作进度。切换时自动同步高亮预览和输入框边框颜色，让你随时掌握每个成员的工作状态
+
+### Headless 模式
+
+新增轻量级 headless 构建（体积减少 45%），支持 `--print`、`--serve`、`--acp` 快速启动，适用于 CI/CD 管道和自动化集成场景
+
+## 🔧 改进优化
+
+- **启动性能大幅提升**：优化启动流程，Application.start() 耗时降低 96%，内存占用减少 31%，启动体验更加流畅
+- **Bun 原生优化**：使用 Bun 原生 API 替代第三方依赖（PTY、glob、semver 等），提升运行时性能
+- **依赖精简**：移除不再需要的依赖项，减小安装体积
+- **认证时序修复**：确保认证在 API 调用前完成，消除冷启动时偶发的 401 错误
+- **模型排序优化**：调整国内版默认模型优先级顺序，常用模型更容易选择
+- **命令执行稳定性**：优化命令执行与环境初始化流程，减少异常情况下的执行中断
+- **认证体验增强**：增强 API Key Helper 获取令牌过程的健壮性，提升认证流程稳定性
+- **错误处理升级**：将错误处理从字符串匹配升级为自定义错误类，提升错误识别的可靠性
+- **流超时自动重试**：当模型流式响应超时时自动重试，无需手动操作。支持通过环境变量 `CODEBUDDY_STREAM_TIMEOUT` 自定义超时时间
+- **命令建议过滤**：不可直接调用的 Skill 不再出现在斜杠命令建议列表中，保持菜单整洁
+
+## 🐛 问题修复
+
+- **团队成员工具权限确认**：修复团队成员执行工具时跳过权限确认的问题，现在团队成员会正确继承主 Agent 的权限模式；权限确认框中显示成员名称和专属颜色，便于区分来源
+- **插件 MCP 配置兼容**：修复插件 `.mcp.json` 不支持扁平格式的问题，现在同时兼容包装格式和扁平格式
+- **团队成员状态显示**：修复团队成员正常完成任务后因清理流程被错误标记为失败的问题，已完成的成员现在正确显示完成状态

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.1.md

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.52.1 发布
+
+## 🔧 改进优化
+
+### 启动与稳定性
+
+- **版本查询秒回**：`cbc -v` / `cbc --version` 不再触发完整初始化流程，响应速度大幅提升
+- **管道环境兼容**：在非 TTY 环境下执行子命令时不再等待 stdin 输入，避免流程卡住
+- **认证超时保护**：网络不通时认证初始化会自动超时，不再导致 CLI 无限等待
+
+### 团队成员切换体验优化
+
+- **即时切换**：使用左右方向键即时切换团队成员视图，无需回车确认，操作更流畅
+- **快捷进入/退出**：按下键进入选择模式并默认选中 @main，按上键或 Esc 退出
+- **输入历史隔离**：历史导航与成员选择模式互不干扰，清空输入框自动退出历史导航
+
+### SDK 改进
+
+- **Python SDK MCP Server 简化**：可直接传入 server 对象，无需手动构造字典
+- **JS SDK 可执行文件配置**：支持通过 `executable` 和 `executableArgs` 自定义 CLI 可执行文件路径和参数
+- **内部请求头过滤**：支持通过 `CODEBUDDY_SKIP_INTERNAL_HEADERS` 环境变量清理内部请求头，避免干扰第三方 API 网关
+
+## 🐛 问题修复
+
+- **Skill 加载**：修复插件中的 Skill 偶发无法加载的问题，确保初始化顺序正确
+- **Skill 调用**：修复 `user-invocable: false` 的 Skill 无法被模型自动调用的问题
+- **Team 成员颜色**：修复并发生成 Team 成员时颜色索引重复的问题
+- **子代理并发稳定性**：修复大量并发子代理时产生的 MaxListenersExceededWarning

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.2.md

@@ -0,0 +1,12 @@
+# 🚀 CodeBuddy Code v2.52.2 发布
+
+## 🔧 改进优化
+
+- **自定义令牌认证**：支持从 ACC_PRODUCT_CONFIG 环境变量中识别 custom-token 认证配置，修复配置已加载但同步未完成时的认证回退问题
+- **会话加载性能优化**：`/resume` 命令加载历史会话时使用并行读取，减少等待时间
+- **插件加载提速**：并行化插件加载流程，多插件场景下启动速度提升数倍
+
+## 🐛 问题修复
+
+- **/doctor 命令**：修复 session 为空时可能导致属性访问错误的问题
+- **SDK Python 构建脚本**：更新 goreleaser 输出目录路径以匹配 headless 构建产物命名，移除未使用的导入

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.3.md

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.52.3 发布
+
+## 🔧 改进优化
+
+- **Gemini 生图模型**：新增 Gemini-3.0-Pro-Image、Gemini-3.1-Flash-Image、Gemini-2.5-Flash-Image 三个生图模型，支持文生图和图生图功能
+- **Ctrl+D 退出优化**：Ctrl+D 仅在输入框为空且没有进行中的对话时才触发双击退出流程，避免误操作
+- **Windows Shell 兼容性**：修复 Windows 环境下 Shell 路径选择逻辑和 shell snapshot 功能，确保优先使用 Git Bash，改进配置文件检测和编码处理，正确识别 fish、tcsh 等非 POSIX shell
+- **MCP 配置增强**：`--mcp-config` 参数同时支持文件路径和直接 JSON 格式；非项目作用域的 MCP 服务器跳过审批检查，减少不必要的确认操作
+- **依赖升级**：升级 OpenAI Agents SDK 至 0.5.2，OpenAI SDK 至 v6
+
+## 🐛 问题修复
+
+- **插件列表显示**：修复缓存清除后插件 skills 无法正确加载的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.4.md

@@ -0,0 +1,27 @@
+# 🚀 CodeBuddy Code v2.52.4 发布
+
+## 🔧 改进优化
+
+### 首 token 超时检测
+
+新增请求发出后首个响应数据的超时检测机制，超时后自动断开并重试，避免长时间无响应的等待。同时将流数据监控间隔从 10 秒缩短至 1 秒，提升异常连接的检测速度。支持通过 `CODEBUDDY_STREAM_TIMEOUT_MS` 和 `CODEBUDDY_FIRST_TOKEN_TIMEOUT_MS` 环境变量自定义超时时间。
+
+### 请求压缩
+
+支持对 API 请求体进行 gzip 压缩，减少网络带宽消耗，提升慢速网络下的响应速度。
+
+- **CLI 子命令别名**：为 `mcp list`、`sandbox list`、`marketplace list` 添加 `ls` 简写别名，为 `config remove` 和 `config add` 添加 `-g/--global` 选项
+- **macOS 代码签名**：修复 macOS 26+ 上因缺少 TeamIdentifier 导致多实例运行时被系统终止的问题
+- **MCP 工具钩子修复**：解决 MCP 工具的 PreToolUse/PostToolUse 钩子无法正确触发的问题
+- **工具调用截断重试**：优化模型输出超限导致工具调用参数被截断时的重试机制，提升重试成功率
+- **Hook 权限确认提示优化**：PreToolUse Hook 返回 ask 决策时，将决策原因以警告样式展示在权限确认框中
+- **粘贴行为优化**：粘贴文本内容时不再自动检测是否为图片路径并转换，粘贴的文字始终原样插入
+- **Shell 配置统一**：移除对 PowerShell 和 CMD 的支持，统一要求 Windows 用户使用 Git Bash
+- **模型升级**：将 Gemini Pro 模型从 3.0 版本升级至 3.1 版本
+
+## 🐛 问题修复
+
+- **输入历史导航**：修复按上键浏览历史时，滚动到以 `/` 开头的条目后无法继续滚动的问题
+- **工具权限拒绝渲染**：修复 PreToolUse hook 拒绝和权限规则拒绝时工具调用无法在 UI 中正常渲染的问题
+- **命令解析**：修复 Bash 工具在命令包含未定义环境变量时无法正确识别命令根的问题
+- **子命令路由**：修复使用别名调用子命令时路由路径错误的问题

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.5.md

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.52.5 发布
+
+## 🔧 改进优化
+
+### 图片历史优化
+
+对话历史中的图片数据通过 BlobStore 去重存储，仅最近 N 轮保留完整图片，更早轮次自动替换为文本占位符，显著降低上下文 token 消耗。同一轮对话中重复读取相同图片时返回引用提示而非重复发送完整数据。
+
+### 主题系统重构
+
+扩展主题色彩体系，支持语义化颜色（如 success、warning、error、info 等），增强终端颜色兼容性。新增 ChalkFactory 智能检测终端能力，自动适配颜色级别，支持色盲友好主题。
+
+- **Gzip 压缩兼容修复**：修复企业地址登录时请求体被错误压缩的问题，仅在 SaaS 和 iOA 环境下启用 gzip 压缩
+- **自定义模型 URL 处理**：自动为自定义模型的 URL 补全 `/chat/completions` 后缀，用户无需手动拼接完整路径
+- **Bash 超时配置**：支持通过 settings env 动态配置 Bash 工具超时时间
+
+## 🐛 问题修复
+
+- **Hooks 命令执行**：修复 `node -e "..."` 等包含引号的 hook 命令执行失败的问题
+- **登出竞态修复**：修复登出过程中异步操作未及时终止，导致 session 被重新写回的问题
+- **会话压缩标识修正**：修复异步上下文压缩后会话身份被误判的问题，确保压缩消息正确归属主会话

package/cli/dist/web-ui/docs/cn/cli/release-notes/v2.52.6.md

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.52.6 发布
+
+## 🔧 改进优化
+
+- **模型请求日志增强**：新增请求生命周期完整日志，包含请求发送、首 Token 到达、流式传输进度、完成/错误/超时等关键节点，支持通过 requestId 和 agent 名称快速定位问题
+- **消除运行时警告**：修复长对话中出现的 MaxListenersExceededWarning 警告，封装统一的中止控制器管理工具，提升长会话下的稳定性
+- **Hook 消息渲染增强**：Hook 消息现在会根据执行状态（成功/阻断/警告/错误）显示不同的图标和颜色，并支持展开/折叠查看详细内容，提升可读性