@tencent-ai/codebuddy-code 2.93.3 → 2.93.5

package/dist/web-ui/docs/cn/cli/agent-teams.md

@@ -128,7 +128,13 @@ CodeBuddy 会根据任务自动决定生成多少成员，也可以明确指定
 
 ### 委派模式
 
-默认情况下，领导可能会自己动手实现任务，而不是等成员完成。按 `Shift+Tab` 可以切换到委派模式（Delegate Mode），限制领导只能使用协调工具（生成成员、发送消息、管理任务），不直接修改代码。
+默认情况下，领导可能会自己动手实现任务，而不是等成员完成。按 `Shift+Tab` 可以切换到委派模式（Delegate Mode），限制领导只能使用协调工具（Agent、TaskStop、SendMessage、AskUserQuestion、StructuredOutput），不直接修改代码或读取文件。
+
+委派模式下：
+- 领导不能自己探索代码、运行命令或编辑文件，所有工作都通过 subagent/成员完成
+- Subagent 默认使用 `default` 权限模式（完整工具访问），不继承领导的委派限制
+- 可通过 Agent 工具的 `mode` 参数为单个 subagent 指定权限模式（如 `mode: "bypassPermissions"`）
+- 委派模式下不走 fork 路径，强制使用标准 subagent
 
 适合你希望领导专注于任务拆分、分配和汇总的场景。
 
@@ -206,7 +212,15 @@ CodeBuddy 会根据任务自动决定生成多少成员，也可以明确指定
 
 ### 权限
 
-成员继承领导的权限设置。如果领导使用 `--dangerously-skip-permissions` 启动，所有成员也会如此。
+成员的权限模式按以下优先级确定：
+
+1. **Agent `mode` 参数**：为单个成员指定权限模式（如 `Agent({ mode: "bypassPermissions" })`）
+2. **CLI `--subagent-permission-mode`**：本次会话所有 subagent 的默认权限
+3. **环境变量 `CODEBUDDY_SUBAGENT_PERMISSION_MODE`**：进程级覆盖
+4. **Settings `permissions.subagentPermissionMode`**：全局或项目级配置
+5. **继承主 session**：默认继承领导的权限模式（但委派模式不继承，subagent 使用 `default`）
+
+> **委派模式特殊规则**：委派模式的工具限制只约束领导自身。subagent/成员默认使用 `default` 权限（完整工具访问），因为它们需要完整能力执行实际工作。
 
 ## 使用场景示例
 

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

@@ -52,6 +52,7 @@
 | `--text-to-image-model`          | 设置文生图功能使用的模型 ID                                                                                                           | `codebuddy --text-to-image-model your-image-model`                                                 |
 | `--image-to-image-model`         | 设置图生图功能使用的模型 ID                                                                                                           | `codebuddy --image-to-image-model your-edit-model`                                                 |
 | `--permission-mode`              | 以指定的[权限模式](./iam.md#permission-modes)开始                                                                                 | `codebuddy --permission-mode plan`                                                                 |
+| `--subagent-permission-mode`     | 设置 subagent/团队成员的默认权限模式，覆盖从主 session 继承的模式                                                                  | `codebuddy --subagent-permission-mode bypassPermissions`                                           |
 | `--permission-prompt-tool`       | 指定在非交互模式下处理权限提示的 MCP 工具                                                                                         | `codebuddy -p --permission-prompt-tool mcp_auth_tool "查询"`                                       |
 | `--resume`                       | 通过 ID 恢复特定会话,或在交互模式下选择                                                                                           | `codebuddy --resume abc123 "查询"`                                                                 |
 | `--continue`                     | 加载当前目录中最近的对话                                                                                                          | `codebuddy --continue`                                                                             |

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

@@ -25,10 +25,20 @@ codebuddy daemon start --port 8080
 
 # 指定绑定地址（允许远程访问）
 codebuddy daemon start --host 0.0.0.0
+
+# 指定权限模式（默认为 delegate 委托模式）
+codebuddy daemon start --permission-mode default
+
+# 传递其他标准参数（model、mcp-config 等会自动继承）
+codebuddy daemon start --model claude-sonnet-4-20250514 --mcp-config ./mcp.json
 ```
 
 Daemon 启动后以 detached 进程运行，父进程立即退出。本地地址默认免密访问，非本地地址自动开启密码认证。
 
+> **默认委托模式**：Daemon 默认以委托（delegate）模式运行——主 agent 只负责协调调度，不直接修改代码。所有实现工作通过 subagent 完成。可通过 `--permission-mode` 切换为其他模式。
+
+> **参数继承**：`daemon start` 时指定的标准 CLI 参数（`--model`、`--permission-mode`、`--mcp-config`、`--tools`、`--agent`、`--settings` 等）会自动继承到 daemon 子进程中。
+
 > **幂等启动**：多次执行 `daemon start` 不会创建多个 daemon。如果已有 daemon 在运行，会直接返回现有 daemon 的信息。
 
 ### 查看状态

package/dist/web-ui/docs/cn/cli/env-vars.md

@@ -68,6 +68,7 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 | 环境变量 | 说明 |
 |---------|------|
 | `CODEBUDDY_AUTOCOMPACT_PCT_OVERRIDE` | 设置自动压缩触发的上下文容量百分比（1-100）。默认由产品配置决定（通常 70-92%）。使用更低的值（如 `50`）来更早压缩 |
+| `CODEBUDDY_PRE_MESSAGE_COMPACT_PCT` | 设置用户发消息前预检压缩的上下文容量百分比（1-100）。默认 10%。当上下文超过此阈值时，在处理用户新消息前自动压缩 |
 | `CODEBUDDY_DISABLE_AUTO_MEMORY` | 设置为 `1` 禁用自动内存，设置为 `0` 启用 |
 | `CODEBUDDY_MEMORY_ENABLED` | 设置为 `true` 或 `1` 启用记忆功能 |
 | `CODEBUDDY_TYPED_MEMORY_ENABLED` | 设置为 `true` 或 `1` 启用分类记忆模式 |
@@ -106,10 +107,13 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 |---------|------|
 | `CODEBUDDY_CODE_SHELL` | 覆盖自动 shell 检测。支持的值：`bash`、`zsh`、`sh`、`powershell` |
 | `CODEBUDDY_CODE_SHELL_PREFIX` | 包装所有 shell 命令的命令前缀（如用于日志或审计） |
-| `CODEBUDDY_CODE_GIT_BASH_PATH` | Windows 下显式指定 Git Bash 路径 |
+| `CODEBUDDY_CODE_GIT_BASH_PATH` | Windows 下显式指定 Git Bash 路径；若指定的路径无效则启动失败 |
+| `CODEBUDDY_SKIP_GIT_BASH_CHECK` | 设置为 `1` 跳过启动时的 Windows Git Bash 检测和提示（适用于上游已管理 shell 的场景） |
 | `CODEBUDDY_POWERSHELL_PATH` | 显式指定 PowerShell 可执行文件路径（优先于自动检测） |
 | `CODEBUDDY_USE_POWERSHELL_TOOL` | 控制 PowerShell 工具启用状态。Windows 上默认启用，设为 `0` 可禁用 |
 | `CODEBUDDY_ENV_FILE` | 在执行每个 shell 命令前自动 source 的环境文件路径 |
+| `CODEBUDDY_DISABLE_SHELL_SNAPSHOT` | 设置为 `1` 全平台禁用 shell 环境快照（在 bash profile 加载慢时有效） |
+| `CODEBUDDY_ENABLE_SHELL_SNAPSHOT` | Windows 无 Git Bash 时默认跳过 snapshot；设为 `1` 可强制启用（通常不需要） |
 
 ## UI 和交互
 
@@ -142,12 +146,21 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 |---------|------|
 | `CODEBUDDY_DISABLE_BACKGROUND_TASKS` | 设置为 `1` 禁用所有后台任务功能 |
 
+## Daemon 模式
+
+| 环境变量 | 说明 |
+|---------|------|
+| `CODEBUDDY_DAEMON_ALLOW_SLEEP` | 设置为 `1` 或 `true` 禁用 daemon 的防休眠功能（允许系统正常进入 idle sleep）。唤醒后的自动重连不受影响 |
+| `CODEBUDDY_DAEMON_AUTO_CONNECT_CHANNELS` | 设置为 `0` 或 `false` 禁用 daemon 启动时自动连接微信/企微 channel。也可通过 `settings.json` 的 `daemonAutoConnectChannels: false` 配置。单个实例可在 `instances.json` 中设置 `autoConnect: false` |
+| `CODEBUDDY_DAEMON_RESTORE_CHANNELS` | daemon 自动重启时由系统设置，包含需要恢复的 channel 列表（逗号分隔，如 `wechat:abc,wecom:default`）。用户通常无需手动设置 |
+
 ## Agent 执行控制
 
 | 环境变量 | 说明 |
 |---------|------|
 | `CODEBUDDY_CODE_MAX_TURNS` | 主 Agent 的最大执行轮次。优先级：CLI `--max-turns` > 此环境变量 > 默认值 (500) |
 | `CODEBUDDY_CODE_SUBAGENT_MAX_TURNS` | 子 Agent 的最大执行轮次。优先级：CLI `--max-turns` > 此环境变量 > 模型动态传入的 `max_turns` > 默认值 (500) |
+| `CODEBUDDY_SUBAGENT_PERMISSION_MODE` | 子 Agent/团队成员的默认权限模式（如 `bypassPermissions`、`acceptEdits`、`default`、`plan`）。优先级：Agent 工具 `mode` 参数 > CLI `--subagent-permission-mode` > 此环境变量 > Settings `permissions.subagentPermissionMode` > 映射表默认值 |
 
 ## Gateway 和远程访问
 
@@ -156,6 +169,8 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 | `CODEBUDDY_GATEWAY_AUTH` | Gateway 认证模式（`password` 或 `none`） |
 | `CODEBUDDY_GATEWAY_PASSWORD` | Gateway 访问密码 |
 | `CODEBUDDY_GATEWAY_FORCE_TUNNEL` | 设置为 `1` 强制使用 tunnel 模式 |
+| `CODEBUDDY_DISABLE_REQUEST_VALIDATION` | 设置为 `1` 关闭 Gateway 自定义请求头校验（`X-CodeBuddy-Request`）。详见 [HTTP API 安全](./http-api.md#安全) |
+| `CODEBUDDY_CODE_CORS_ORIGINS` | 额外的 CORS 允许来源（逗号分隔）。支持精确 origin、`*.domain` 子域通配和 `*` 全开。如 `https://*.example.com,https://specific.com` |
 | `SERVER__HOST` | `--serve` 模式监听地址（默认：`127.0.0.1`） |
 | `SERVER__PORT` | `--serve` 模式监听端口 |
 
@@ -182,6 +197,19 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 | `CODEBUDDY_DEBUG_REQUEST` | 设置为 `1` 启用请求调试 |
 | `CODEBUDDY_STARTUP_PROFILE` | 设置为 `1` 启用启动性能分析 |
 
+## E2E 测试 (Record/Replay)
+
+用于 E2E 测试的模型响应录制/回放功能。录制模式下捕获真实模型响应，回放模式下使用录制文件替代真实 API 调用。
+
+| 环境变量 | 说明 |
+|---------|------|
+| `CODEBUDDY_RECORD_DIR` | 录制模式：指定录制文件保存目录。设置后模型响应会保存到该目录的 `recording.jsonl` 文件 |
+| `CODEBUDDY_REPLAY_DIR` | 回放模式：指定录制文件读取目录。设置后从 `recording.jsonl` 回放响应，无需真实 API |
+| `CODEBUDDY_REPLAY_SPEED` | 回放速度倍率。`0` 表示无延迟立即返回，`1` 表示按原始时间间隔回放（默认：`1`）|
+| `CODEBUDDY_REPLAY_STRICT` | 设置为 `1` 启用严格模式：录制耗尽时抛出错误而非透传到真实 API |
+
+> **注意**：`CODEBUDDY_RECORD_DIR` 和 `CODEBUDDY_REPLAY_DIR` 互斥，不能同时设置。
+
 ## 其他
 
 | 环境变量 | 说明 |

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

@@ -284,16 +284,16 @@ LLM 必须使用包含以下内容的 JSON 响应：
 ### 事件类型
 
 | 事件 | 触发时机 | matcher 字段 | 典型场景 |
-| :-- | :-- | :-- | :----- |
+| --- | --- | --- | --- |
 | `PreToolUse` | 工具执行前 | 支持（工具名） | 校验命令、二次审批、日志记录 |
 | `PostToolUse` | 工具成功执行后 | 支持 | 自动格式化、补充上下文 |
 | `Notification` | 权限请求或 60 秒无输入提醒 | 部分支持 | 桌面提示、IM 通知 |
 | `UserPromptSubmit` | 用户提交消息时<br/>**注：不包括内部命令** | 不支持 | 内容审查、上下文注入 |
 | `Stop` | 主代理响应结束时 | 不支持 | 要求继续执行、追加提醒 |
 | `SubagentStop` | 子代理（TaskTool）结束时 | 不支持 | 子任务继续执行或补充说明 |
-| `PreCompact` | 执行上下文压缩前 | 支持<br/>（`manual`<br/>/`auto`） | 保留关键信息、防止压缩 |
-| `SessionStart` | 会话创建或恢复时 | 支持<br/>（`startup`<br/>/`resume`<br/>/`clear`<br/>/`compact`） | 环境初始化、变量注入 |
-| `SessionEnd` | 会话结束时 | 支持<br/>（`clear`<br/>/`logout`<br/>/`prompt_input_exit`<br/>/`other`） | 清理资源、持久化日志 |
+| `PreCompact` | 执行上下文压缩前 | 支持（`manual`/`auto`） | 保留关键信息、防止压缩 |
+| `SessionStart` | 会话创建或恢复时 | 支持（`startup`/`resume`/`clear`/`compact`） | 环境初始化、变量注入 |
+| `SessionEnd` | 会话结束时 | 支持（`clear`/`logout`/`prompt_input_exit`/`other`） | 清理资源、持久化日志 |
 
 ### PreToolUse
 

package/dist/web-ui/docs/cn/cli/http-api.md

@@ -39,7 +39,37 @@ curl http://127.0.0.1:8080/api/v1/health
 | **公开 ACP 协议** | `/api/v1/acp` | 遵循 ACP 规范 | 完整对话能力，参见 [ACP 文档](https://agentclientprotocol.com) |
 | **内部 RPC** | `/internal/*` | 不保证兼容性 | CLI 内部使用，不对外开放 |
 
-## 认证
+## 安全
+
+### 自定义请求头
+
+所有 API 请求（除[豁免路径](#豁免路径)外）必须携带自定义请求头：
+
+```
+X-CodeBuddy-Request: 1
+```
+
+**原理**：自定义请求头会使浏览器的跨域请求变为"非简单请求"，强制触发 CORS preflight。配合 CORS 白名单，非法源的请求会被拦截。即使攻击者使用 `fetch(url, { mode: 'no-cors' })`，浏览器也不允许在 no-cors 模式下发送自定义头，请求会因缺少该头而被服务端拒绝（403）。
+
+#### 豁免路径
+
+以下路径不需要携带 `X-CodeBuddy-Request` 头：
+
+| 路径 | 说明 |
+|------|------|
+| `GET /` | SPA 入口页 |
+| `GET /assets/*` | 静态资源 |
+| `GET /docs/*` | API 文档页 |
+| `GET /manifest.webmanifest` | PWA 清单 |
+| `GET /api/v1/auth/status` | 认证状态检查 |
+| `POST /api/v1/auth/login` | 登录 |
+| `*/api/v1/webhooks/*` | Webhook（有平台签名验证） |
+| `GET /api/openapi.json` | OpenAPI 规范 |
+| `GET /api/docs*` | Swagger UI |
+
+可通过环境变量 `CODEBUDDY_DISABLE_REQUEST_VALIDATION=1` 关闭此校验。
+
+### 认证
 
 支持两种模式（环境变量 `CODEBUDDY_GATEWAY_AUTH` 控制）：
 
@@ -51,11 +81,14 @@ curl http://127.0.0.1:8080/api/v1/health
 密码认证支持以下方式（任一通过即可）：
 
 ```bash
-# Bearer Token
-curl -H "Authorization: Bearer YOUR_PASSWORD" http://host:port/api/v1/sessions
+# Bearer Token（同时携带安全头）
+curl -H "X-CodeBuddy-Request: 1" \
+     -H "Authorization: Bearer YOUR_PASSWORD" \
+     http://host:port/api/v1/sessions
 
 # URL 参数
-curl http://host:port/api/v1/sessions?password=YOUR_PASSWORD
+curl -H "X-CodeBuddy-Request: 1" \
+     http://host:port/api/v1/sessions?password=YOUR_PASSWORD
 ```
 
 ## 响应格式

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

@@ -98,11 +98,11 @@ codebuddy install
 ::: code-group
 
 ```bash [macOS / Linux]
-curl -fsSL https://copilot.tencent.com/cli/install.sh | bash
+curl -fsSL https://www.codebuddy.cn/cli/install.sh | bash
 ```
 
 ```powershell [Windows]
-irm https://copilot.tencent.com/cli/install.ps1 | iex
+irm https://www.codebuddy.cn/cli/install.ps1 | iex
 ```
 
 :::

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

@@ -68,7 +68,7 @@ CodeBuddy Code 支持自定义键盘快捷键。运行 `/keybindings` 命令创
 
 | 动作 | 默认按键 | 说明 |
 | :--- | :--- | :--- |
-| `chat:cancel` | Escape | 取消当前输入 |
+| `chat:cancel` | Escape | 取消当前输入，或中断当前前台请求 |
 | `chat:submit` | Enter | 发送消息 |
 | `chat:killAgents` | Ctrl+X Ctrl+K | 终止所有后台代理 |
 | `chat:cycleMode` | Shift+Tab* | 切换权限模式 |

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

@@ -17,6 +17,19 @@ Release Notes 记录了每个版本的用户可见变更，包括：
 
 <!-- 新版本自动添加到此处 -->
 
+- [v2.93.3](./v2.93.3.md) - 2026-04-22
+- [v2.93.2](./v2.93.2.md) - 2026-04-22
+- [v2.93.1](./v2.93.1.md) - 2026-04-21
+- [v2.93.0](./v2.93.0.md) - 2026-04-20
+- [v2.92.0](./v2.92.0.md) - 2026-04-20
+- [v2.91.0](./v2.91.0.md) - 2026-04-17
+- [v2.90.0](./v2.90.0.md) - 2026-04-16
+- [v2.89.0](./v2.89.0.md) - 2026-04-16
+- [v2.88.0](./v2.88.0.md) - 2026-04-14
+- [v2.87.0](./v2.87.0.md) - 2026-04-14
+- [v2.86.0](./v2.86.0.md) - 2026-04-13
+- [v2.85.0](./v2.85.0.md) - 2026-04-12
+- [v2.84.0](./v2.84.0.md) - 2026-04-12
 - [v2.83.1](./v2.83.1.md) - 2026-04-10
 - [v2.83.0](./v2.83.0.md) - 2026-04-10
 - [v2.82.0](./v2.82.0.md) - 2026-04-10

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

@@ -0,0 +1,35 @@
+# 🚀 CodeBuddy Code v2.84.0 发布
+
+## ✨ 新功能
+
+### 使用统计 & 链路追踪 & 定时任务 API
+
+新增一组 REST API，让您可以通过 HTTP 接口查询使用统计、链路追踪和定时任务：
+
+- `GET /api/v1/stats` — 查看历史使用统计
+- `GET /api/v1/stats/session` — 查看当前会话实时成本
+- `GET /api/v1/traces` / `GET /api/v1/traces/:traceId` — 查看链路追踪数据
+- `GET/POST/DELETE /api/v1/scheduled-tasks` — 管理定时任务
+
+Web UI 同步新增统计、链路追踪、定时任务三个可视化视图，直观展示数据。
+
+## 🔧 改进优化
+
+- **Cron 调度优化**：修复并发竞态条件，新增 enqueue-first + drain 合并模式，支持执行时间持久化
+- **Trace 采集系统**：支持文件持久化存储和 SDK 桥接，链路数据不再随进程退出丢失
+- **Agent 状态国际化**：子代理阶段标签全面国际化，新增等待权限确认、等待用户回答、重试中等状态显示
+- **中断自动滚动**：权限确认或用户问题弹出时，聊天视图自动滚动到底部，确保操作面板可见
+- **ACP 网络重试**：弱网环境下 ACP 请求自动重连重试，提升远程访问稳定性
+- **E2E 测试覆盖**：新增 30 个 E2E 测试用例和 6 个 ACP 协议方法覆盖
+
+## 🐛 问题修复
+
+- **会话中断误报**：修复启动握手请求导致 session 被误判为用户中断的问题
+- **推荐建议消失**：修复对话结束后推荐建议被内部消息意外取消的竞态问题
+- **记忆提取隔离**：后台记忆提取不再干扰推荐建议和对话状态
+- **会话恢复**：修复已中断会话在切换时无法自动恢复的问题
+- **实例切换 IP 适配**：通过 Tailscale 等远程网络访问时，切换 Worker 实例不再跳转到不可达的局域网地址
+- **消息队列卡住**：修复连续发送多条消息时 Web UI 卡住的问题
+- **压缩取消回滚**：取消上下文压缩时正确回滚状态，不再错误标记为已压缩
+- **/clear 防重入**：修复 /clear 后消息重复发送的竞态问题
+- **后台任务退出保护**：print 模式退出前等待后台任务完成，避免任务被意外终止

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

@@ -0,0 +1,19 @@
+# 🚀 CodeBuddy Code v2.85.0 发布
+
+## ✨ 新功能
+
+### Daemon 模式增强
+
+Daemon 守护进程新增四大增强功能，让 CodeBuddy Code 在后台持续运行更加稳定可靠：
+
+- **防休眠保护**：daemon 运行时自动阻止系统进入 idle sleep，确保微信/企微消息不中断。macOS 使用 caffeinate、Linux 使用 systemd-inhibit、Windows 使用 powercfg，可通过 `CODEBUDDY_DAEMON_ALLOW_SLEEP=1` 手动禁用
+- **唤醒自动重连**：系统从休眠恢复后自动检测并重连所有微信/企微长连接，无需手动干预
+- **空闲自动更新**：daemon 检测到新版本安装后，等待空闲时自动重启完成更新，保持端口和 channel 连接不中断
+- **Channel 自动连接**：daemon 启动时自动连接所有已保存凭证的微信/企微实例，无需手动操作
+
+## 🔧 改进优化
+
+- **Daemon 状态提示**：`daemon start` 和 `daemon restart` 输出增强功能状态摘要，一目了然当前启用的能力
+- **TUI Markdown 渲染优化**：修复 `~` 近似数被误解析为删除线的问题，链接升级为可点击的终端超链接，引用块增加竖线前缀，标题支持层级区分
+- **TUI 表格渲染重写**：全新 Unicode 边框表格渲染，支持终端宽度自适应、单元格自动换行，窄终端自动切换为 key-value 竖排格式
+- **TUI Header 布局优化**：窄终端下自动隐藏 Logo 降低 Header 高度，更好利用有限屏幕空间

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

@@ -0,0 +1,29 @@
+# 🚀 CodeBuddy Code v2.86.0 发布
+
+## ✨ 新功能
+
+### Agent Team 多后端架构
+
+团队成员现在支持三种运行后端：in-process（默认）、独立进程（detached-process）、tmux 可视化。通过 `--swarm` 参数或环境变量灵活切换，满足不同场景下的团队协作需求。
+
+- 独立进程 teammate 通过 SSE 实时事件转发和文件历史回放双路径，Web UI 自动展示成员对话
+- 工具审批通过 Permission Bridge 路由回 leader 统一处理
+- 通信层预留分布式支持，本机自动选择文件 Mailbox，远程自动切换 HTTP API
+
+## 🔧 改进优化
+
+- **Gateway 安全加固**：所有 API 请求现在必须携带 `X-CodeBuddy-Request` 自定义头，有效防止跨站请求伪造；CORS 策略全面加固，非法源请求直接拒绝；`/info` 和 `/health` 端点新增认证保护
+- **OpenAPI 文档增强**：ACP 协议文档大幅完善，新增 12 个 JSON-RPC method 的完整参数/响应示例、13 种 SessionUpdate 类型定义，补齐约 30 个已实现但未文档化的 API 端点
+- **WebFetch 工具升级**：HTML 转换库升级为 turndown，Markdown 输出质量更高；User-Agent 改为 Chrome 格式，解决部分反爬站点抓取失败问题；超时时间调整为 30s
+- **对话历史按钮**：StatusBar 历史按钮始终显示，无需等待 API 轮询
+
+## 🐛 问题修复
+
+- **ACP thinking 格式**：thinking 内容修正为 ACP 标准 `agent_thought_chunk` 类型，确保协议兼容性
+- **工具权限安全**：修复复合命令中 allow 规则意外放行高危子命令的问题；修复 BypassPermissions 模式下 CRITICAL 级别命令被自动批准的问题
+- **配置目录一致性**：修复 7 处硬编码路径绕过自定义配置目录的问题
+- **Shell 执行稳定性**：修复前台命令执行后状态永久显示 "running" 的挂起问题；修复 PTY 模式下文件描述符泄漏
+- **Web UI 链接**：TUI Header 中的 Web UI 链接现在自动携带 sessionId 参数
+- **React 渲染错误**：修复团队成员工具组全隐藏时的 React Hook 顺序问题
+- **TUI 渲染稳定性**：代码高亮和表格渲染添加异常防护，避免崩溃
+- **团队管理**：TeamDelete 主动回收残留的 detached 成员进程

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

@@ -0,0 +1,34 @@
+# 🚀 CodeBuddy Code v2.87.0 发布
+
+## ✨ 新功能
+
+### 委托模式全面重构
+
+全新设计的委托模式（Delegate Mode），让 AI 助手能够更高效地协调多个子代理完成复杂任务：
+
+- **系统提示重写**：完整覆盖角色定义、工具规则、通知格式、任务工作流和交互示例，提供更精准的任务分解和协调能力
+- **团队 Leader 模板化**：从硬编码提取为可配置模板，支持动态成员列表和完整协调指南
+- **工具白名单收窄**：委托模式聚焦于 Agent、TaskStop、SendMessage、AskUserQuestion、StructuredOutput 五个核心协调工具，职责更清晰
+
+### Subagent 权限继承配置
+
+新增三层配置机制，灵活控制子代理的默认权限模式：
+
+- CLI 参数：`--subagent-permission-mode`
+- 环境变量：`CODEBUDDY_SUBAGENT_PERMISSION_MODE`
+- Settings 配置：`permissions.subagentPermissionMode`
+
+### Daemon 模式增强
+
+- **默认使用委托模式**：daemon 启动时自动采用委托模式，支持通过 `--permission-mode` 自定义
+- **参数继承**：daemon 子进程自动继承父进程的 CLI 参数（model、mcp-config、tools 等），无需重复配置
+
+## 🔧 改进优化
+
+- **委托模式视觉优化**：颜色从红棕色调整为琥珀/金色，更符合"调度/指挥"的角色定位
+- **权限继承架构优化**：使用可扩展映射表替代硬编码逻辑，便于新增权限模式
+- **E2E 测试基础设施**：新增 Record/Replay 模式，支持录制模型响应并回放，新增 13 个 E2E 测试用例覆盖核心工具和多轮对话场景
+
+## 🐛 问题修复
+
+- **Compact 同步死锁**：修复子代理场景下上下文压缩永不执行的问题，确保长对话的上下文管理正常工作

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

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.88.0 发布
+
+## ✨ 新功能
+
+### 工具结果外部化存储
+
+新增 blob-store 模块，支持对大型工具输出进行外部化存储。OutputSpiller 实现流式输出溢写到磁盘，避免超大输出（如大文件读取、长日志）撑爆内存，提升长会话稳定性。
+
+### 自动压缩阈值自定义
+
+新增 `CODEBUDDY_AUTOCOMPACT_PCT_OVERRIDE` 环境变量，允许自定义上下文自动压缩触发阈值（1-100 百分比），让您根据使用场景灵活控制压缩时机。
+
+## 🔧 改进优化
+
+- **延迟加载工具权限透传**：每个延迟加载工具现在独立进行权限校验，避免放开代理执行器权限后所有延迟加载工具被自动放行
+- **工具搜索精确化**：移除工具搜索的模糊匹配功能，搜索结果更精确，减少不相关的工具被误匹配
+- **Shell 输出限制提升**：默认输出限制从 20K 提升至 30K，上限从 100K 提升至 150K，减少大输出被截断的情况
+
+## 🐛 问题修复
+
+- **命令注入安全加固**：将 shell 命令执行从 `exec` 替换为 `execFile` 数组参数模式，防止潜在的命令注入风险
+- **MCP defer_loading 配置兼容**：修复 MCP 配置中 `tools` 使用不同格式工具名时 `defer_loading` 不生效的问题
+- **MCP OAuth 回调兼容**：修复浏览器从外部 OAuth 服务器重定向回来时因无法携带自定义头而被请求校验拒绝的问题
+
+## 📝 文档更新
+
+- 新增独立的环境变量参考文档
+- 更新子代理和设置文档

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

@@ -0,0 +1,24 @@
+# 🚀 CodeBuddy Code v2.89.0 发布
+
+## ✨ 新功能
+
+### Canvas 画布终端
+
+全新的 `#/canvas` 视图，支持无限画布自由布局多终端 Tile。你可以在画布上拖拽移动终端窗口、8 向 resize 调整大小、网格吸附对齐、缩放平移浏览全局，以及框选批量操作。每个终端 Tile 支持独立的标题显示，打造真正的多终端协作工作空间。
+
+### 消息预检压缩
+
+用户发送消息前自动检查上下文占比，超过阈值时先压缩再处理消息，避免上下文过大影响对话质量。压缩后直接处理用户原始消息，无需额外的恢复步骤。支持通过环境变量 `CODEBUDDY_PRE_MESSAGE_COMPACT_PCT` 自定义触发阈值（默认 10%）。
+
+## 🔧 改进优化
+
+- **MCP 工具列表容错**：MCP Server 的 listTools 调用失败时自动降级为缓存结果，增加 30 秒冷却期避免频繁重试，提升 MCP 连接稳定性
+- **Agent 子代理默认模式**：省略 subagent_type 参数时默认使用 general-purpose 模式，行为更清晰可预期
+- **SDK 用量数据完善**：在消息响应中完整填充 cache 相关 token 统计字段，提升用量数据的准确性
+- **Team 功能开关**：通过 `CODEBUDDY_CODE_EXPERIMENTAL_AGENT_TEAMS` 环境变量灵活控制 Agent Teams 功能
+- **上下文使用量查询优化**：修复 resume 后上下文使用量查询失败的问题，确保压缩和恢复场景下数据完整
+- **安装脚本加速**：下载源切换为全球加速域名，提升海外用户安装速度
+
+## 🐛 问题修复
+
+- **Headless 模式代理连接**：修复 headless 构建中代理环境下 MCP 连接失败的问题，确保企业网络环境下正常使用

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

@@ -0,0 +1,26 @@
+# 🚀 CodeBuddy Code v2.90.0 发布
+
+## ✨ 新功能
+
+### Canvas 画布终端
+
+新增 `#/canvas` 视图，在无限画布上自由布局多个终端窗口。支持拖拽移动、8 向 resize、网格吸附、缩放平移、框选操作，以及每个终端独立显示标题
+
+### 消息预检压缩
+
+用户发送消息前自动检查上下文占比，超过阈值（默认 10%）时先压缩再处理消息，避免上下文过大影响对话质量。压缩后直接处理用户原始消息，无需额外的恢复步骤。支持通过环境变量 `CODEBUDDY_PRE_MESSAGE_COMPACT_PCT` 自定义阈值
+
+### UI 组件状态持久化
+
+新增 `/api/v1/storage` REST API，将主题、语言、终端布局、编辑器状态、画布视口等 UI 组件状态从浏览器本地存储迁移到后端持久化，关闭标签页后不再丢失。支持 global 和 workspace 两级作用域，主题和语言采用双写策略确保首屏无闪烁
+
+## 🔧 改进优化
+
+- **MCP 连接容错**：MCP Server 连接失败时静默降级，不再显示红色错误提示，增加 30 秒冷却期避免频繁重试
+- **子代理默认行为**：省略 subagent_type 时默认使用独立上下文（general-purpose），避免非预期的上下文继承
+- **上下文使用量查询优化**：修复会话恢复后上下文使用量查询失败的问题，确保压缩决策基于准确数据
+- **安装脚本加速**：切换至全球加速域名，提升海外用户安装速度
+
+## 🐛 问题修复
+
+- **Headless 模式代理**：修复代理环境下 MCP 连接失败的问题

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

@@ -0,0 +1,30 @@
+# 🚀 CodeBuddy Code v2.91.0 发布
+
+## ✨ 新功能
+
+### Canvas 画布终端
+
+全新 `#/canvas` 视图，支持在无限画布上自由布局多个终端 Tile。主要特性：
+
+- 拖拽移动和 8 向 resize 调整大小
+- 网格吸附，保持布局整洁
+- 缩放平移，轻松管理大量终端
+- 框选操作和 per-pane 终端标题显示
+
+### 消息预检压缩
+
+发送消息前自动检测上下文占比，超过阈值（默认 10%）时先压缩再处理，避免上下文过大影响对话质量。压缩后直接处理原始消息，无需额外恢复步骤。可通过环境变量 `CODEBUDDY_PRE_MESSAGE_COMPACT_PCT` 自定义阈值。
+
+## 🔧 改进优化
+
+- **权限安全加固**：HIGH 级别危险命令（如 sudo、rm -rf）在 bypass 模式下也需要用户确认，提升命令执行安全性。用户可通过配置 allow 规则自定义覆盖
+- **DeferExecuteTool 权限增强**：支持更灵活的权限规则匹配，如 `DeferExecuteTool(*)` 和 `DeferExecuteTool(TeamCreate)` 等
+- **新增模型支持**：新增 GLM-4.7 等大语言模型
+- **MCP 工具列表容错**：MCP Server 的 listTools 调用失败时自动降级为缓存结果，增加冷却期避免频繁重试
+- **安装脚本优化**：下载源切换为全球加速域名，提升海外用户安装速度
+- **上下文使用量查询优化**：修复 resume 后使用量数据链式遍历断裂问题，确保数据完整
+- **SDK Cache 字段完善**：在消息中正确填充 cache 相关 token 统计，替代之前的空值
+
+## 🐛 问题修复
+
+- **Headless 模式代理连接**：修复代理环境下 MCP 连接失败的问题，在 headless 构建中正确打包 undici

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

@@ -0,0 +1,29 @@
+# 🚀 CodeBuddy Code v2.92.0 发布
+
+## ✨ 新功能
+
+### 画布独立视图与窗口管理
+
+画布终端功能迎来重大升级，支持将单个终端面板或整个画布在独立浏览器窗口中打开，让多显示器工作流更加顺畅。每个 Tile 新增最大化、最小化、复刻终端等窗口操作，最大化时采用固定定位脱离画布变换，获得全屏沉浸体验。
+
+### 画布交互增强
+
+画布交互对齐 Figma/Miro 体验标准：
+- 滚轮平移、Cmd+滚轮缩放
+- 拖动惯性效果
+- 透明 overlay 抢占指针事件，确保嵌入组件与画布操作互不干扰
+
+## 🔧 改进优化
+
+- **终端状态持久化**：画布中终端的 PTY Session ID 和工作目录随画布状态持久化，刷新后自动恢复，无需重新创建
+- **PTY 闲置释放优化**：SSE 订阅纳入客户端检测，避免活跃连接被误释放；消除 zsh 首行反白标记
+- **Gateway 静态文件路由**：PWA 相关文件正确豁免 CSRF 验证，确保 Service Worker 和图标等资源正常加载
+- **持久化防丢失**：页面刷新时同步 flush 防抖队列，防止未保存的状态丢失
+- **工具参数流式渲染**：修复多个正确性问题，并行工具参数正确渲染、首帧不丢数据、参数不串号、结束时一致性校正
+- **启动性能优化**：Shell snapshot 预热推迟到启动后触发，MCP 配置读取并发去重，降低冷启动耗时
+- **Windows Git Bash 检测**：未安装 Git Bash 时不再强制退出，自动降级到 PowerShell 执行
+
+## 🐛 问题修复
+
+- **市场配置存储**：为市场配置文件写操作添加序列化锁，防止并发读写导致数据丢失
+- **市场查重修复**：修复添加市场时查重逻辑误判问题，改用存储键匹配替代运行时名称匹配

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

@@ -0,0 +1,26 @@
+# 🚀 CodeBuddy Code v2.93.0 发布
+
+## ✨ 新功能
+
+### 画布独立视图与窗口管理
+
+画布终端全面增强，支持将单个终端面板或整个画布在独立浏览器窗口中打开，便于多显示器工作流。新增最大化、最小化、复刻终端等窗口操作，最大化时采用固定定位脱离画布变换，确保全屏沉浸体验。
+
+### 画布交互体验升级
+
+对齐 Figma/Miro 标准交互范式：滚轮平移、Cmd+滚轮缩放、拖动惯性动画，以及透明 overlay 抢占指针事件，让鼠标悬浮在终端内容上也能顺畅操作画布。
+
+## 🔧 改进优化
+
+- **终端状态持久化**：画布中终端的 PTY Session ID 和工作目录随画布状态持久化，刷新后自动恢复连接
+- **PTY 连接管理**：SSE 订阅纳入客户端存活检测，避免活跃连接被误释放；消除 zsh 终端首行反白标记
+- **工具参数流式渲染**：修复并行工具参数串号、首帧丢失、空对象闪白等多个正确性问题，Web UI 工具调用渲染更稳定
+- **启动性能优化**：Shell snapshot 预热推迟到启动后 2 秒触发，MCP 配置读取增加并发去重，减少冷启动 IO 争抢
+- **Windows 兼容性**：未安装 Git Bash 时不再强制退出，自动降级到 PowerShell 执行 shell 命令
+- **持久化防丢失**：页面刷新/关闭时同步 flush 防抖队列，防止未落盘的状态丢失
+- **Gateway 安全**：PWA 相关静态文件正确豁免 CSRF 验证
+
+## 🐛 问题修复
+
+- **市场配置存储**：修复并发读写导致市场配置数据丢失的问题
+- **市场查重逻辑**：修复添加市场时查重误判问题

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.93.1 发布
+
+## 🔧 改进优化
+
+- **新增 Kimi-K2.6 模型**：上线 Kimi-K2.6 模型，支持 256K 上下文窗口、图片理解和推理能力，为国内用户提供更强大的模型选择

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.93.2 发布
+
+## 🐛 问题修复
+
+- **文件树加载恢复**：修复持久化数据恢复异常导致文件树永远显示"加载失败"的问题，新增重试按钮支持手动恢复
+- **持久化数据完整性**：修复 Set/Map 类型字段持久化后恢复为空对象的问题，保存前自动转换为可序列化格式
+- **Marketplace 存储稳定性**：为市场配置文件引入跨进程文件锁与原子写入，修复多进程并发写入时的数据损坏问题；读取到损坏文件时自动备份并重建
+- **对话历史回放**：修复斜杠命令（如 `/clear`）在历史回放时被错误截断的问题，确保命令内容完整还原

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

@@ -0,0 +1,7 @@
+# 🚀 CodeBuddy Code v2.93.3 发布
+
+## 🔧 改进优化
+
+- **权限系统优化**：已信任目录的项目级 allow 规则现在可以覆盖高危命令拦截，无需手动将规则移到用户级配置。未信任目录的行为保持不变
+- **CORS 通配符支持**：CORS 白名单新增子域通配（`https://*.example.com`）和全部允许（`*`）两种配置模式，方便多子域环境快速接入
+- **局域网访问简化**：使用 `--host 0.0.0.0` 启动时，自动将本机局域网 IP 加入 CORS 和 Host 白名单，局域网设备可直接通过 IP 访问 Web UI，无需额外配置

package/dist/web-ui/docs/cn/cli/remote-control.md

@@ -130,6 +130,12 @@ Gateway 默认允许以下来源的跨域请求：
 - Tunnel 分配的公网地址
 - 通过 `gateway.corsOrigins` 配置的额外来源
 
+支持三种配置模式：
+
+- **精确匹配**：`https://example.com`
+- **子域通配**：`https://*.example.com`（匹配所有子域，包括多级子域如 `a.b.example.com`）
+- **全部允许**：`*`
+
 ## Web UI
 
 Web UI 提供了完整的 CodeBuddy Code 交互界面，包括：
@@ -153,7 +159,7 @@ Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了
   "gateway": {
     "auth": "password",
     "password": "your-custom-password",
-    "corsOrigins": ["https://your-domain.com"],
+    "corsOrigins": ["https://your-domain.com", "https://*.example.com"],
     "maxConnections": 5,
     "tokenTtlMs": 86400000
   }
@@ -164,7 +170,7 @@ Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了
 |:------|:-----|:------|
 | `auth` | 认证模式，`"password"` 或 `"none"` | `"none"` |
 | `password` | 自定义密码。为空时首次启动自动生成 | 自动生成 |
-| `corsOrigins` | 额外允许的 CORS 来源列表 | `[]` |
+| `corsOrigins` | 额外允许的 CORS 来源列表。支持精确 origin、`*.domain` 子域通配和 `*` 全开 | `[]` |
 | `maxConnections` | ACP 最大并发连接数 | `5` |
 | `tokenTtlMs` | ACP Session Token 有效期（毫秒） | `86400000`（24 小时） |
 
@@ -172,7 +178,7 @@ Web UI 基于 ACP（Agent Client Protocol）与本地 Agent 通信，保证了
 
 | 环境变量 | 说明 |
 |:---------|:-----|
-| `CODEBUDDY_CODE_CORS_ORIGINS` | 额外的 CORS 允许来源（逗号分隔） |
+| `CODEBUDDY_CODE_CORS_ORIGINS` | 额外的 CORS 允许来源（逗号分隔）。支持精确 origin、`*.domain` 子域通配和 `*` 全开。如 `https://*.example.com,https://specific.com` |
 
 ## 实例管理