@tencent-ai/codebuddy-code 2.109.0 → 2.109.2

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

@@ -19,6 +19,9 @@
 | `codebuddy daemon stop`            | 停止 Daemon                              | `codebuddy daemon stop`                        |
 | `codebuddy daemon status`          | 查看 Daemon 状态                         | `codebuddy daemon status`                      |
 | `codebuddy daemon restart`         | 重启 Daemon                              | `codebuddy daemon restart`                     |
+| `codebuddy auto-mode defaults`     | 打印 `auto` 模式的内置分类规则           | `codebuddy auto-mode defaults`                 |
+| `codebuddy auto-mode config`       | 打印当前生效的 `auto` 模式配置           | `codebuddy auto-mode config`                   |
+| `codebuddy auto-mode critique`     | 用 lite 模型审视你的自定义 `auto` 规则   | `codebuddy auto-mode critique`                 |
 | `codebuddy ps`                     | 列出所有活跃 Worker 进程                 | `codebuddy ps`                                 |
 | `codebuddy logs <pid\|name>`       | 查看 Worker 日志                         | `codebuddy logs feature-x`                     |
 | `codebuddy attach <pid\|name>`     | 附加到后台 Worker                        | `codebuddy attach feature-x`                   |
@@ -51,8 +54,8 @@
 | `--model`                        | 使用别名设置当前会话的模型，如最新模型的别名（`sonnet` 或 `opus`）或模型全名                                                         | `codebuddy --model gpt-5`                                                                          |
 | `--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-mode`              | 以指定的[权限模式](./permission-modes.md)开始。常用值：`default`、`acceptEdits`、`auto`、`dontAsk`、`plan`、`bypassPermissions` | `codebuddy --permission-mode auto`                                                                 |
+| `--subagent-permission-mode`     | 设置 subagent/团队成员的默认权限模式，覆盖从主 session 继承的模式。支持 `acceptEdits`、`default`、`plan`、`auto`、`dontAsk`、`bypassPermissions` | `codebuddy --subagent-permission-mode dontAsk`                                           |
 | `--permission-prompt-tool`       | 指定在非交互模式下处理权限提示的 MCP 工具                                                                                         | `codebuddy -p --permission-prompt-tool mcp_auth_tool "查询"`                                       |
 | `--resume`                       | 通过 ID 恢复特定会话,或在交互模式下选择                                                                                           | `codebuddy --resume abc123 "查询"`                                                                 |
 | `--continue`                     | 加载当前目录中最近的对话                                                                                                          | `codebuddy --continue`                                                                             |
@@ -66,8 +69,10 @@
 | `--bg`                           | 后台运行会话（detached 模式），日志输出到 `~/.codebuddy/logs/`。详见 [Daemon 文档](daemon.md)                                      | `codebuddy --bg "实现登录页面"`                                                                    |
 | `--name <name>`                  | 后台会话名称（与 `--bg` 配合使用，便于通过 `ps`/`logs`/`kill` 查找）                                                               | `codebuddy --bg --name feature-x "实现功能"`                                                       |
 | `--serve`                        | 启动 HTTP 服务（Web UI、REST API、ACP 协议）                                                                                       | `codebuddy --serve --port 8080`                                                                    |
+| `--prewarm`                      | 以预热待命模式启动：先完成启动初始化后挂起，等待外部通过 IPC 唤醒（唤醒时才绑定工作目录）。用于消除会话拉起时的冷启动等待。默认关闭。 | `codebuddy --prewarm --prewarm-id pool1`                                                           |
+| `--prewarm-id <id>`              | 预热 IPC 端点标识（默认取进程 PID），用于构造本地 socket/管道地址。配合 `cbc-prewarm` 管理命令使用。                                | `codebuddy --prewarm --prewarm-id pool1`                                                           |
 
-> **重要提示**：在使用 `-p/--print` 参数进行非交互式执行时,涉及文件读写、命令执行、网络请求等操作通常需要添加 `-y` （或 `--dangerously-skip-permissions`)参数才能执行，否则操作会被阻止。
+> **重要提示**：在使用 `-p/--print` 进行非交互式执行时，涉及文件读写、命令执行、网络请求等操作必须有一个明确的权限策略：最常见的是 `-y` / `--dangerously-skip-permissions`，也可以使用 `--permission-mode auto`、`--permission-mode dontAsk`、预先配置的 `permissions.allow` 规则，或专门的权限提示 MCP 工具。否则需要人工确认的操作会被阻止。
 
 <Tip>
   `--output-format json` 参数特别适用于脚本和自动化，允许您以编程方式解析 CodeBuddy 的响应。

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

@@ -131,7 +131,8 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 | 环境变量 | 说明 |
 |---------|------|
 | `CODEBUDDY_CODE_DISABLE_TERMINAL_TITLE` | 设置为 `1` 禁用自动终端标题更新 |
-| `CODEBUDDY_PROMPT_SUGGESTION_DISABLED` | 设置为 `true` 禁用提示建议 |
+| `CODEBUDDY_INCLUDE_PROMPT_SUGGESTION` | 显式启用提示建议，覆盖 headless 默认关闭和 `promptSuggestionEnabled=false` 配置 |
+| `CODEBUDDY_PROMPT_SUGGESTION_DISABLED` | 设置为 `1` / `true` 禁用提示建议，优先级高于 `CODEBUDDY_INCLUDE_PROMPT_SUGGESTION` |
 | `IS_DEMO` | 设置为 `true` 启用演示模式：隐藏邮箱和组织 |
 
 ## 安全和认证

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

@@ -201,14 +201,18 @@ CodeBuddy Code 使用分层权限系统来平衡功能和安全性：
 
 #### 权限模式
 
-CodeBuddy Code 支持几种权限模式，可以在[设置文件](settings.md#配置文件)中设置为 `defaultMode`:
+CodeBuddy Code 支持多种权限模式，可在 [settings](settings.md) 的 `permissions.defaultMode` 中配置，也可通过 `--permission-mode` 指定。常用模式如下：
 
 | 模式 | 描述 |
 |:----|:-----|
-| `default` | 标准行为 - 首次使用每个工具时提示权限 |
-| `acceptEdits` | 自动接受会话的文件编辑权限 |
-| `plan` | 计划模式 - CodeBuddy 可以分析但不能修改文件或执行命令 |
-| `bypassPermissions` | 跳过所有权限提示（需要安全环境 - 见下方警告） |
+| `default` | 标准逐次审批模式 |
+| `acceptEdits` | 自动批准文件编辑，Bash 仍需审批 |
+| `auto` | 对原本会弹审批的动作使用分类器自动判定是否放行 |
+| `dontAsk` | 不弹权限框；未预批准动作直接拒绝 |
+| `plan` | 计划模式；读和探查为主，写源码前先产出计划 |
+| `bypassPermissions` | 跳过所有权限提示（需要安全环境） |
+
+更完整的模式语义、切换方式、状态栏提示和子代理继承规则，请直接参考 [权限模式](permission-modes.md)。
 
 <Warning>
   `bypassPermissions` 模式应仅在安全、隔离的环境中使用，例如 Docker 容器或 VM。在生产环境或包含敏感数据的系统上使用此模式可能会带来安全风险。

package/dist/web-ui/docs/cn/cli/interactive-mode.md

@@ -21,13 +21,13 @@
 | `Up/Down 方向键`                           | 导航命令历史                                                                             | 调用之前的输入                                             | ✅ 支持        |
 | `Esc` + `Esc`                              | 回退代码/对话                                                                            | 将代码和/或对话恢复到之前的状态 (需在输入框为空时连续按两次)                            | ✅ 支持      |
 | `Tab`                                      | 切换思考模式      | 在思考开启和思考关闭之间切换                               | ✅ 支持    |
-| `Shift+Tab` (macOS/Linux) 或 `Alt+M` (Windows) | 切换权限模式                                                                             | 在自动接受模式、计划模式和普通模式之间切换                 | ✅ 支持        |
+| `Shift+Tab` (macOS/Linux) 或 `Alt+M` (Windows) | 切换权限模式                                                                             | 在 `default`、`bypassPermissions`、`acceptEdits`、`auto`（可用时）、`plan`、`delegate` 之间循环 | ✅ 支持        |
 | `Option+P` (macOS) 或 `Alt+P` (Windows/Linux) | 切换模型                                                                                 | 快速打开模型选择面板                                       | ✅ 支持        |
 
 > **说明：**
 > - `Esc` + `Esc` 回退功能已支持：当输入框内容为空时，连续按两次 ESC 键可激活 `/rewind` 功能，快速回退代码或对话到之前的状态
 > - `Tab` 键在 CodeBuddy Code 中主要用于自动补全，扩展思考模式的切换功能部分支持
-> - `Shift+Tab` (macOS/Linux) 或 `Alt+M` (Windows) 用于切换权限模式，包括普通模式、自动接受编辑模式、跳过权限模式和计划模式。注意：在 Windows 上必须使用 `Alt+M`，`Shift+Tab` 不起作用
+> - `Shift+Tab` (macOS/Linux) 或 `Alt+M` (Windows) 用于切换权限模式。当前循环顺序为：`default → bypassPermissions → acceptEdits → auto（可用时）→ plan → delegate`。`dontAsk` 不在键盘循环中，需要通过 `--permission-mode dontAsk` 或 settings 进入。注意：在 Windows 上必须使用 `Alt+M`，`Shift+Tab` 不起作用
 
 ### 多行输入