@tencent-ai/codebuddy-code 2.125.4-next.41bad82.202607231203 → 2.126.0

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

@@ -0,0 +1,23 @@
+# 🚀 CodeBuddy Code v2.121.2 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.121.2 |
+| Agent SDK JS | v0.3.215 |
+| Agent SDK Python | v0.3.214 |
+
+## 🔧 改进优化
+
+- **Daemon 自动更新启用**：修复 daemon 模式下自动更新被跳过的问题，daemon 作为长驻进程现在始终启用自动更新，保持版本及时更新。
+- **Daemon 诊断增强**：`daemon status` 输出新增自动更新状态字段，方便查看当前自动更新是否启用及原因。
+
+## 🐛 问题修复
+
+- **Daemon 重启保留 host 绑定**：修复 daemon 重启后 host 绑定丢失的问题，现在重启会复用此前配置的 host 与端口。
+- **剪贴板复制**：修复非 HTTPS 环境下（如 HTTP 隧道访问）剪贴板复制失效的问题，增加兜底方案，复制失败时会通过提示告知用户。
+- **跨域访问**：修复以 `--host 0.0.0.0` 启动时，通过 IP 或自定义域名访问 Web UI 出现跨域的问题，未显式配置来源白名单时自动放行。
+- **MCP 配置健壮性**：当某个作用域的 MCP 配置存在非法条目（如误写成字符串 / null / 数字）时，跳过该条目并告警，不再让整个作用域加载失败或影响其他正常的 MCP 服务。
+- **Web UI 窗口标题**：修复将 Web UI 安装为 PWA 后，对话窗口标题栏重复显示应用名的问题。
+- **安全中心路径匹配**：修复 Windows 上沙箱路径匹配对用户根目录识别过于宽泛的问题，避免其他账户目录被误判为当前用户目录导致规则跨账户误匹配；同时修复受保护目录因尾斜杠差异未命中文件黑名单的问题。

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

@@ -0,0 +1,21 @@
+# 🚀 CodeBuddy Code v2.121.3 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.121.3 |
+| Agent SDK JS | v0.3.216 |
+| Agent SDK Python | v0.3.215 |
+
+## 🔧 改进优化
+
+- **stdio initialize 提速**：SDK `initialize` 握手在带自定义系统提示词 / Agent 覆盖时不再被慢 MCP 服务阻塞。覆盖注入改为后台执行，握手立即返回，首个 prompt 仍会等覆盖生效后再执行，实测握手耗时从数百毫秒降到毫秒级。
+- **输出风格懒渲染**：内置输出风格的模板内容改为按需渲染，加载风格列表时不再无条件渲染全部模板，真正应用某个风格时才渲染并缓存，加快列表加载。
+
+## 🐛 问题修复
+
+- **首个 prompt 缺失部分 MCP 工具**：修复预热模式下新会话第一个 prompt 的可用工具列表偶现缺少晚连的用户级 MCP 工具、需到第二个 prompt 才出现的问题。运行路径新增工具索引校验，晚连 MCP 就绪后会重建 Agent 再执行，前置请求性能不受影响。
+- **子 Agent 委派崩溃**：修复子 Agent 委派失败的回归问题，遥测拦截器在输入为空时缺少判空导致崩溃，现已在源头和拦截器两层加上防御性判空。
+- **TUI 键盘输入崩溃**：修复粘贴文本或输入特定转义序列（如可被夹带在大段粘贴中的 Ctrl+功能键序列）时，键名解析读取空值触发未捕获异常导致 CLI 进程崩溃退出的问题，输入边界统一做了空值归一化。
+- **回滚延迟工具重试参数提示方案**：回滚此前通过注入激活工具参数结构提示引导模型自我纠正的方案，经验证对部分模型无效，改由上游工具直连方式解决，避免无效提示带来额外开销。

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

@@ -0,0 +1,52 @@
+# 🚀 CodeBuddy Code v2.122.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.122.0 |
+| Agent SDK JS | v0.3.217 |
+| Agent SDK Python | v0.3.216 |
+
+## ✨ 新功能
+
+### Web UI 账户登录
+
+Gateway 认证通过后，新增 CBC 账户登录流程（OAuth），支持国内站、国际站、企业域名、iOA 四种登录方式。Gateway Cookie 有效期延长至 30 天并支持滑动窗口自动续期；登录 token 迁移到 localStorage，关闭标签页后仍保持登录。
+
+### 远程控制机器人入口
+
+支持通过产品配置分别控制微信机器人和企微机器人的添加入口显隐，同时保留已有渠道的管理能力。
+
+### 添加市场默认开启自动更新
+
+添加插件市场时新增可选的自动更新开关，开启后一次操作即可完成「添加市场并默认开启套件自动更新」；对已存在的市场同样支持幂等补开自动更新。
+
+### Web UI 自定义模型管理
+
+设置页「模型」分区新增自定义模型管理入口，可在弹窗内查看、新增、编辑与删除自定义模型（OpenAI 兼容端点），配置持久化到用户级配置文件。登录场景下不再因自定义模型收窄白名单而遮蔽账号下发的官方模型列表。
+
+### Web Chat `/skills` 内联展示
+
+在对话中直接输入 `/skills` 时不再跳转页面或发送给模型，而是按来源（用户 / 项目 / 插件）分组内联展示可用技能列表，与 CLI Skills 面板信息架构对齐。
+
+### Web UI 插件页筛选与分页
+
+已安装与浏览列表新增按类型（技能 / MCP / Hook / 工具）和启用状态筛选，并支持前端分页，切换筛选时自动回到首页。
+
+### Web UI 设置页目录导航
+
+设置页新增分区目录（TOC）导航，随页面滚动高亮当前分区，点击可平滑跳转到对应设置区块。
+
+## 🔧 改进优化
+
+- **端口解析修复**：修复 URL 使用默认端口（HTTP=80、HTTPS=443）时端口解析异常的问题
+- **Daemon 启动行为**：启动前先清理残留进程，避免端口占用或状态不干净
+
+## 🐛 问题修复
+
+- **/btw 侧问题**：修复主任务执行工具调用过程中使用 `/btw` 提问时报参数错误、导致侧问题无法使用的问题
+- **WebUI 终端连接**：修复独立二进制下 WebUI 终端连接约 120 秒后被断开、反复重连最终报错的问题
+- **插件缓存**：无显式版本的 Git 市场插件改用 commit SHA 作为缓存版本，并自动迁移历史缓存，仍被会话使用的旧目录会保留到安全清理
+- **Plan 模式**：为计划文件名增加短后缀，降低并发会话下计划文件路径冲突的风险
+- **文件工具沙箱审批**：沙箱启用时 Edit、Write、MultiEdit、NotebookEdit 统一交由沙箱文件规则审批，修复主 Agent 与子 Agent 表现不一致的问题

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

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.123.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.123.0 |
+| Agent SDK JS | v0.3.218 |
+| Agent SDK Python | v0.3.217 |
+
+## ✨ 新功能
+
+### 文件版本回退
+
+新增按会话请求预览和执行整轮文件回退的能力，可在回退前预览将要恢复的文件版本，预览结果包含实际采用的版本标识，让整轮文件的回退操作更直观、可控。
+
+## 🔧 改进优化
+
+- **情绪指标开关**：情绪摩擦分析改为按需启用，仅在显式打开对应产品特性时才进行相关查询与上报，默认不产生额外开销。
+
+## 🐛 问题修复
+
+- **Daemon 自动更新状态**：修复 `cbc daemon status` 显示 "AutoUpdateService not available" 的问题，改为从运行中的 daemon 进程获取真实状态；同时新增外部升级检测，手动全局升级后 daemon 能自动感知并优雅重启。
+- **/rewind 回滚（Windows）**：修复 Windows 下盘符大小写不一致（如 `c:\` 与 `C:\`）导致回滚代码静默失效的问题，现在会统一盘符大小写后再匹配文件，保证保存与回退两侧对齐。
+- **仅回退代码选项**：修复用户先改动再改回原样后，"仅回退代码"选项被错误隐藏、无法回退到该节点的问题，选项展示改为依据该轮是否发生过文件编辑。
+- **Agent 子任务**：修复子任务成功创建后在执行阶段失败仍被误报为"创建失败"的问题，并补齐失败路径的收尾处理，保证失败态与后续清理逻辑一致。
+- **自定义专家**：修复创建自定义专家时可能因未继承配置目录而写入错误目录的问题。
+- **情绪分析上报**：修复情绪分析查询因请求包装标签和网关响应包装差异导致的召回或解析异常，保证分析结果正常上报。

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

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.123.1 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.123.1 |
+| Agent SDK JS | v0.3.219 |
+| Agent SDK Python | v0.3.218 |
+
+## 🐛 问题修复
+
+- **文本处理**：修复在特定运行环境下清理终端控制字符时，可能因模块导出形态差异导致的调用异常，并清理无用依赖，减小安装体积。

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

@@ -0,0 +1,30 @@
+# 🚀 CodeBuddy Code v2.124.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.124.0 |
+| Agent SDK JS | v0.3.220 |
+| Agent SDK Python | v0.3.219 |
+
+## ✨ 新功能
+
+### ShareLink 一键分享工具
+
+新增内置 `ShareLink` 工具，可将本地单个 HTML 文件一键部署为可在线渲染、可分享的公网链接，方便把生成的报告、可视化页面直接发给他人查看。
+
+- 按登录环境自动分流基建，覆盖国内 / 国际 / iOA 场景
+- 默认开启，支持环境变量 `CODEBUDDY_SHARE_LINK_ENABLED=false` 与云端 `productFeatures.ShareLink` 两级开关
+- 按需延迟加载，复用当前登录会话鉴权，无需额外配置
+
+## 🔧 改进优化
+
+- **CLI 命令别名**：新增 `codebuddy-code` 作为 CLI 命令别名，除已有的 `codebuddy` / `cbc` 外多一种调用方式。
+
+## 🐛 问题修复
+
+- **大文件编辑卡死**：修复桌面端编辑大文件（如大型硬件网表）时，差异计算长时间阻塞导致内核卡死数十分钟的问题。现为差异计算增加超时预算，超时文件降级为仅保留在变更列表（仍可查看、可撤回），不再阻塞后续操作。
+- **Stop / SubagentStop Hook 载荷**：修复钩子中 `last_assistant_message` 可能返回过期历史消息的问题，现在优先从当前运行结果提取最终输出。
+- **Stop Hook 续跑**：修复 `-p` / ACP 场景下 Stop Hook 触发续跑时响应可能提前结束、后续输出丢失的问题。
+- **Linux 托管运行时**：修复银河麒麟等 Linux 环境下沙箱内无法调用随包分发的 Node / Python 运行时的问题。

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

@@ -0,0 +1,22 @@
+# 🚀 CodeBuddy Code v2.124.1 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.124.1 |
+| Agent SDK JS | v0.3.221 |
+| Agent SDK Python | v0.3.220 |
+
+## 🔧 改进优化
+
+- **Agent 指标聚合**：窗口 flush 间隔固定为 30 秒，去除对外部配置的依赖，聚合器启动更稳定简洁
+
+## 🐛 问题修复
+
+- **计划模式非交互退出卡死**：修复 `-p` 非交互模式下进入并退出计划模式后进程永久挂起的问题，退出计划模式后任务能正常继续
+- **预热进程本地插件加载**：修复预热进程首次激活时本地插件（含 skills / agents / hooks / mcp）在首个会话加载不出来的问题，激活后会重新初始化并加载插件
+- **Reasoning Effort 面板**：`/config` 设置面板的 Reasoning Effort 选项补齐 `max` 档位，与 `/effort` 命令保持一致
+- **源代码管理 - 全部撤回**：修复"全部撤回"无法同时处理已跟踪变更和新建文件的问题，一次操作即可完全清理
+- **源代码管理 - 面板刷新**：修复文件变更后面板不及时更新的问题，增加定时轮询兜底机制
+- **终端会话保活**：修复手动重连时创建新终端会话导致历史状态丢失的问题，优先复用后端保活的已有会话

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

@@ -0,0 +1,44 @@
+# 🚀 CodeBuddy Code v2.125.0 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.125.0 |
+| Agent SDK JS | v0.3.222 |
+| Agent SDK Python | v0.3.221 |
+
+## ✨ 新功能
+
+### 插件列表无限滚动
+
+已安装与浏览市场列表改为触底加载更多，并支持一键回到顶部，浏览大量插件更流畅。
+
+### Subagent-scoped MCP 支持
+
+subagent 现在可以在 definition 中声明专属的 `mcpServers` 配置：
+
+- inline MCP 仅在当前 subagent 启动时创建、只对该 subagent 可见，结束后自动清理，不污染主 agent 或其他 subagent
+- string reference 可复用已有全局 MCP
+- ToolSearch / DeferExecuteTool 可在当前 subagent 内发现并调用 scoped MCP 提供的工具
+- 开启 `--strict-mcp-config` 严格模式时，按白名单放行受信任的产品内置 subagent 的 scoped MCP
+
+## 🔧 改进优化
+
+- **OOM 取证兜底**：长跑 session（如 `/goal`）濒临堆上限时可自动写 heap snapshot 供事后定位，默认关闭，需要时通过环境变量开启
+- **Skill 可见性隔离**：`disable: true` 的 skill 不再从菜单硬删除，改为不进入模型默认上下文但仍可在 `/` 菜单中被用户主动触发
+
+## 🐛 问题修复
+
+- **自定义模型工具图片结果**：修复部分第三方网关对工具返回图片校验过严导致请求失败的问题
+- **Daemon restart host 丢失**：修复 `daemon restart` 不带参数时 host 配置悄悄退回默认值的问题
+- **会话文件恢复**：修复加载/回退旧会话时因内部产物索引文件导致的内存异常
+- **stream-json resume 回放时间戳**：修复恢复会话回放历史消息时时间戳显示为回放时刻而非原始创建时间的问题
+- **文件监听 ENOSPC**：修复 Linux 上大型项目目录挂载文件监听时打满系统 inotify 限制崩溃的问题
+- **WebSearch 时间关键词**：修复"今天""今年""最新"等时间相关搜索未使用当前时间构造查询的问题
+- **插件 session 隔离**：修复插件管理操作可能在新会话中错误复用上一个 session 插件组合的问题
+- **AskUserQuestion 交互**：修复 ACP 客户端跳过问题时可能导致审批等待卡住的问题
+
+## 📝 文档更新
+
+- 完善内置子代理与场景模型的配置方式、解析优先级和使用入口说明

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

@@ -0,0 +1,22 @@
+# 🚀 CodeBuddy Code v2.125.1 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.125.1 |
+| Agent SDK JS | v0.3.223 |
+| Agent SDK Python | v0.3.222 |
+
+## 🔧 改进优化
+
+- **无持久化会话模式**：新增 `--no-session-persistence` 参数，会话上下文仅保留在内存中，不再创建或追加本地会话记录，同时保留对已有历史记录的只读加载能力，适合临时或隐私敏感场景。
+
+## 🐛 问题修复
+
+- **托管会话启动更稳定**：改由系统自动分配可用端口，并在服务真正就绪后再建立连接，避免端口竞争导致的会话启动失败。
+- **子 Agent 注册**：修复插件指定的主会话 Agent 被重复暴露为可调用子 Agent 的问题，同时保留同插件内成员 Agent 的正常调用能力。
+- **智能体团队工具可见性**：关闭智能体团队功能时，同步隐藏相关的团队创建、删除工具及团队协作提示，避免误触发。
+- **中文/编码乱码修复**：恢复对文件读取与 Shell 输出的编码检测能力，解决部分非 UTF-8（GBK/CP936 等）场景下中文内容显示为乱码的问题。
+- **本地 hook 阻断提示更清晰**：工作区配置的 hook 缺失或主动阻断时，不再显示笼统的「服务异常」，改为在对话中明确展示是本地 hook 拦截及其原因，行为对齐主流实现。
+- **WebUI 跨域访问**：修复 `--host 0.0.0.0` 启动 WebUI 时自动放开跨域的逻辑未生效的问题，`--serve` / daemon 等启动方式现可在 anydev 等云虚拟机环境直接访问，无需手动配置跨域来源。

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

@@ -0,0 +1,13 @@
+# 🚀 CodeBuddy Code v2.125.2 发布
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.125.2 |
+| Agent SDK JS | v0.3.224 |
+| Agent SDK Python | v0.3.223 |
+
+## 🐛 问题修复
+
+- **自定义模型对话上报**：修复 WorkBuddy Desktop 使用自定义模型对话时未被计入活跃统计（活跃地图、连登等）的问题，现自定义模型对话可正常上报。

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

@@ -0,0 +1,30 @@
+# 🚀 CodeBuddy Code v2.125.3 发布
+
+> 本次为补发版本：v2.125.1 与 v2.125.2 因发布流程异常未能上架，线上仍停留在 v2.125.0。v2.125.3 重新构建并发布，完整包含上述两个版本的全部变更。
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.125.3 |
+| Agent SDK JS | v0.3.225 |
+| Agent SDK Python | v0.3.224 |
+
+## ✨ 新功能
+
+### 无持久化会话
+
+新增 `--no-session-persistence` 选项，会话上下文仅保留在内存中，不创建或追加本地 transcript，同时保留对已有历史的只读加载能力，适合临时会话与敏感场景。
+
+## 🔧 改进优化
+
+- **WorkBuddy 托管会话启动**：改由系统分配可用端口，并在服务真正就绪后建立连接，避免端口竞争导致会话启动失败。
+
+## 🐛 问题修复
+
+- **自定义模型对话上报**：修复 WorkBuddy Desktop 使用自定义模型对话时未被计入活跃统计（活跃地图、连登等）的问题，现自定义模型对话可正常上报。
+- **子 Agent 注册**：修复插件通过 `settings.agent` 指定的主会话 Agent 被重复暴露为可调用子 Agent 的问题，同时保留同插件内成员 Agent 的调用能力。
+- **智能体团队工具**：禁用智能体团队时，同步隐藏延迟加载的 TeamCreate、TeamDelete 及 Agent 工具中的团队协作提示。
+- **中文/编码乱码**：恢复对文件读取与 Shell 输出的编码检测能力，解决部分非 UTF-8（GBK/CP936 等）场景下中文内容显示为乱码的问题。
+- **本地 hook 阻断可感知**：工作区 hook 脚本缺失或以退出码阻断时，阻断原因会以消息形式写入历史并干净收尾，客户端可精确识别为本地 hook 拦截，不再只显示笼统的服务异常提示。
+- **WebUI CORS**：修复 `--host 0.0.0.0` 启动 WebUI 时自动放开 CORS 的逻辑未生效的问题，`--serve` / daemon 等启动方式无需手动设置环境变量即可在云虚拟机环境正常访问。

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

@@ -0,0 +1,33 @@
+# 🚀 CodeBuddy Code v2.125.4 发布
+
+> 本次为补发版本：v2.125.1、v2.125.2、v2.125.3 均因发布流程异常未能成功上架，线上仍停留在 v2.125.0。v2.125.4 重新构建并发布，完整包含上述三个版本的全部变更，并新增一项交互体验修复。
+
+## 📦 版本信息
+
+| 组件 | 版本 |
+|------|------|
+| CodeBuddy Code CLI | v2.125.4 |
+| Agent SDK JS | v0.3.226 |
+| Agent SDK Python | v0.3.225 |
+
+## ✨ 新功能
+
+### 无持久化会话
+
+新增 `--no-session-persistence` 选项，会话上下文仅保留在内存中，不创建或追加本地 transcript，同时保留对已有历史的只读加载能力，适合临时会话与敏感场景。
+
+## 🔧 改进优化
+
+- **WorkBuddy 托管会话启动**：改由系统分配可用端口，并在服务真正就绪后建立连接，避免端口竞争导致会话启动失败。
+
+## 🐛 问题修复
+
+- **主页面切换卡顿**：修复主页面切换 tab 时出现卡顿的问题，提升页面交互流畅度。
+- **MCP OAuth token exchange**：修复 HTTP/SSE 类型 MCP server 走网关代理场景下，OAuth 授权成功后 token exchange 报 404 的问题，回调阶段复用初始授权流程已缓存的发现结果，保证 token 请求发往正确的授权服务器。
+- **MCP 配置路径隔离**：修复 `CODEBUDDY_CONFIG_DIR` 环境变量无法隔离用户/本地级 MCP 配置文件路径的问题，使 MCP 配置与其他配置一致遵循该环境变量覆盖，避免多实例、自动化测试等隔离场景误写宿主机真实配置。
+- **自定义模型对话上报**：修复 WorkBuddy Desktop 使用自定义模型对话时未被计入活跃统计（活跃地图、连登等）的问题，现自定义模型对话可正常上报。
+- **子 Agent 注册**：修复插件通过 `settings.agent` 指定的主会话 Agent 被重复暴露为可调用子 Agent 的问题，同时保留同插件内成员 Agent 的调用能力。
+- **智能体团队工具**：禁用智能体团队时，同步隐藏延迟加载的 TeamCreate、TeamDelete 及 Agent 工具中的团队协作提示。
+- **中文/编码乱码**：恢复对文件读取与 Shell 输出的编码检测能力，解决部分非 UTF-8（GBK/CP936 等）场景下中文内容显示为乱码的问题。
+- **本地 hook 阻断可感知**：工作区 hook 脚本缺失或以退出码阻断时，阻断原因会以消息形式写入历史并干净收尾，客户端可精确识别为本地 hook 拦截，不再只显示笼统的服务异常提示。
+- **WebUI CORS**：修复 `--host 0.0.0.0` 启动 WebUI 时自动放开 CORS 的逻辑未生效的问题，`--serve` / daemon 等启动方式无需手动设置环境变量即可在云虚拟机环境正常访问。

package/dist/web-ui/docs/cn/cli/sdk-hooks.md

@@ -502,6 +502,36 @@ return {
 
 :::
 
+### PostToolUse 特殊输出
+
+可以向 Agent 追加上下文（`additionalContext`），或用 `updatedToolOutput` **替换**将要发送给 Agent 的工具结果（对所有工具生效，常用于压缩冗长输出以节省 token）：
+
+::: code-group
+
+```typescript [TypeScript]
+return {
+  continue: true,
+  hookSpecificOutput: {
+    hookEventName: 'PostToolUse',
+    // 替换工具结果（结果可变短）；也可用 additionalContext 追加（结果只会变长）
+    updatedToolOutput: compress(input.tool_response)
+  }
+};
+```
+
+```python [Python]
+return {
+    "continue_": True,
+    "hookSpecificOutput": {
+        "hookEventName": "PostToolUse",
+        # 替换工具结果（结果可变短）；也可用 additionalContext 追加（结果只会变长）
+        "updatedToolOutput": compress(input_data.get("tool_response"))
+    }
+}
+```
+
+:::
+
 ## 示例
 
 ### 完整示例：Bash 命令审计

package/dist/web-ui/docs/cn/cli/settings.md

@@ -37,6 +37,16 @@ CodeBuddy Code 使用分层配置系统，让您能够在不同级别进行个
     "DEBUG": "codebuddy:*"
   },
   "model": "gpt-5",
+  "subagents": {
+    "agents": {
+      "Explore": { "model": "lite" },
+      "Plan": { "model": "reasoning" }
+    }
+  },
+  "variantModels": {
+    "lite": "<fast-model-id>",
+    "reasoning": "<reasoning-model-id>"
+  },
   "cleanupPeriodDays": 30,
   "includeCoAuthoredBy": false,
   "statusLine": {
@@ -65,8 +75,8 @@ CodeBuddy Code 使用分层配置系统，让您能够在不同级别进行个
 | `disableAllHooks` | 禁用所有 [hooks](hooks.md) | `true` |
 | `allowUntrustedFrontmatterHooks` | 是否允许执行来自**非 product 内置**来源的 agent/skill 的 frontmatter `hooks` 字段（包括用户本地 `.codebuddy/agents\|skills/*.md` 和插件市场）。默认 `false`，防止不可信的 md 文件静默启动 shell 命令；只有 product 内置 agent/skill 不受影响。 | `true` |
 | `model` | 覆盖 CodeBuddy Code 使用的默认模型 | `"gpt-5"` |
-| `subagents` | 按内置子代理粒度指定模型。结构为 `{"agents": {"<子代理名>": {"model": "..."}}}`（`agents` 的 key = 子代理名，如 `Explore`；`model` = 模型 ID / 别名 / 变体 `lite`\|`reasoning` / `inherit`）。各子代理互不影响，支持全局 + 项目双 scope。可在 `/agents` 面板可视化编辑。优先级：env `CODEBUDDY_CODE_SUBAGENT_MODEL`（一刀切）> 项目 > 全局 > 内置默认 > 继承主模型。详见 [子代理文档](sub-agents.md) | `{"agents": {"Explore": {"model": "gpt-5.1-codex"}, "general-purpose": {"model": "claude-opus-4"}}}` |
-| `variantModels` | 通用场景变体 → 模型 的映射（key = `lite`\|`reasoning`；value = 模型 ID / 别名）。影响所有走该变体的逻辑（如 `Explore` 等声明 `lite` 的子代理）。可在 `/model` 面板的「场景变体区」编辑。优先级：env（`CODEBUDDY_SMALL_FAST_MODEL` / `CODEBUDDY_BIG_SLOW_MODEL`，按变体）> 项目 > 全局 > 模型级 `relatedModels` > 主模型兜底 | `{"lite": "gpt-5.1-codex-lite", "reasoning": "gpt-5.5"}` |
+| `subagents` | 按内置子代理名称指定模型。格式为 `{"agents": {"<子代理名>": {"model": "..."}}}`；`model` 支持模型 ID、别名、`lite` / `reasoning` 或 `inherit` / `default`。各子代理互不影响，支持用户全局和项目两种范围，可在 `/agents` 中编辑。优先级：`CODEBUDDY_CODE_SUBAGENT_MODEL` > 本次 Agent 工具调用的 `model` 入参 > 项目设置 > 用户全局设置 > 内置声明 > 主模型。详见 [子代理文档](sub-agents.md) | `{"agents": {"Explore": {"model": "lite"}, "Plan": {"model": "reasoning"}}}` |
+| `variantModels` | 将通用场景变体映射到模型，键为 `lite` 或 `reasoning`，值为模型 ID 或别名。该映射影响所有使用相应变体的逻辑，可在 `/model` 的 **Scenario Models** 区域编辑。优先级：对应的变体环境变量 > 项目设置 > 用户全局设置 > 主模型的 `relatedModels` > 适用的产品内置默认 > 主模型 | `{"lite": "<fast-model-id>", "reasoning": "<reasoning-model-id>"}` |
 | `agent` | 覆盖主线程使用的 agent 名称（内置或自定义 agent），应用该 agent 的 system prompt、工具限制和模型配置。优先级：`product.json default` → `plugin agent` → `settings.json agent` → `CLI --agent` | `"my-reviewer"` |
 | `statusLine` | 配置自定义状态行以显示上下文。见 [statusLine 文档](#状态行配置） | `{"type": "command", "command": "~/.codebuddy/statusline.sh"}` |
 | `enableAllProjectMcpServers` | 自动批准项目 `.mcp.json` 文件中定义的所有 MCP 服务器 | `false` |
@@ -448,12 +458,36 @@ curl -X POST http://127.0.0.1:7890/api/v1/runs \
 
 ## 子代理配置
 
-CodeBuddy Code 支持可在用户和项目级别配置的自定义 AI 子代理。这些子代理存储为带有 YAML frontmatter 的 Markdown 文件：
+CodeBuddy Code 支持为内置子代理独立选择模型，也支持通过 Markdown 文件创建自定义子代理。
+
+内置子代理与场景模型可以在用户级或项目级 `settings.json` 中组合配置：
+
+```json
+{
+  "subagents": {
+    "agents": {
+      "Explore": { "model": "lite" },
+      "Plan": { "model": "reasoning" }
+    }
+  },
+  "variantModels": {
+    "lite": "<fast-model-id>",
+    "reasoning": "<reasoning-model-id>"
+  }
+}
+```
+
+* 使用 `/agents` 编辑内置子代理映射；使用 `/model` 的 **Scenario Models** 区域编辑 `lite` 和 `reasoning` 映射。
+* **Global** 写入用户设置，**Project** 写入共享项目设置。
+* `subagents` 按子代理名合并，`variantModels` 按变体名合并。项目级覆盖 `Explore` 不会删除用户级的其他子代理配置；项目级覆盖 `reasoning` 也不会删除用户级的 `lite`。
+* 在 `/agents` 中选择 **Inherit / Default**，或在 `/model` 中选择 **Default**，会删除所选范围的对应项并恢复低优先级解析链。
+
+自定义子代理存储为带有 YAML frontmatter 的 Markdown 文件：
 
 * **用户子代理**：`~/.codebuddy/agents/` - 在所有项目中可用
 * **项目子代理**：`.codebuddy/agents/` - 特定于项目，可与团队共享
 
-子代理文件定义具有自定义提示和工具权限的专用 AI 助手。详见 [子代理文档](sub-agents.md)。
+自定义子代理文件定义专用提示、模型和工具权限。完整配置方式和优先级详见 [子代理文档](sub-agents.md)。
 
 ## 插件配置
 

package/dist/web-ui/docs/cn/cli/slash-commands.md

@@ -15,7 +15,7 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/doctor` | | ✅ 支持 | 检查 CodeBuddy Code 的状态和环境。 |
 | `/status` | | ✅ 支持 | 显示当前仓库和会话的状态。 |
 | `/add-dir` | `<path>` | ✅ 支持 | 添加工作目录。指定要添加的目录路径。 |
-| `/agents` | | ✅ 支持 | 管理实验性 AI 智能体 |
+| `/agents` | | ✅ 支持 | 管理内置和自定义 AI 智能体；查看内置子代理的生效路由值及其来源，并将模型设置保存到 Global 或 Project 范围。具体场景模型可在 `/model` 中查看。 |
 | `/branch` | `[name]` | ✅ 支持 | 在当前对话位置创建一个分支，复制活跃对话历史到新 session 并自动切换。可选指定分支名称。 |
 | `/btw` | `<question>` | ✅ 支持 | 快速提问，不中断当前 Agent 工作流。适用于在 Agent 执行任务时临时提出简短问题，答案基于已有上下文生成。 |
 | `/compact`| | ✅ 支持 | 压缩上下文。 |
@@ -25,7 +25,7 @@ CodeBuddy Code 支持斜杠命令，允许您在聊天中执行特殊操作、
 | `/init` | | ✅ 支持 | 初始化一个新的 CodeBuddy 存储库。 |
 | `/mcp` | | ✅ 支持 | 管理 MCP 连接。 |
 | `/memory`| | ✅ 支持 | 管理长期记忆 |
-| `/model` | `[list \| model-name]` | ✅ 支持 | 切换或查看当前使用的 AI 模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型名称参数时直接切换到指定模型（如 `/model gpt-4o`）。 |
+| `/model` | `[list \| model-name]` | ✅ 支持 | 切换或查看主模型。不带参数时打开交互式界面；还可在 **Scenario Models** 区域查看或编辑 `lite` / `reasoning` 的生效模型、来源，以及 Global / Project 设置。`list` 列出可用模型，带模型名称参数时直接切换主模型。 |
 | `/model:text-to-image` | `[list \| model-id]` | ✅ 支持 | 切换或查看当前使用的文生图模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型 ID 参数时直接切换到指定模型。 |
 | `/model:image-to-image` | `[list \| model-id]` | ✅ 支持 | 切换或查看当前使用的图生图模型。不带参数时打开交互式选择界面，`list` 列出可用模型，带模型 ID 参数时直接切换到指定模型。 |
 | `/permissions` | | ✅ 支持 | 管理工具权限和工作区目录访问权限。 |