CodeBuddy 交互模式

一、键盘快捷键

键盘快捷键可能因平台和终端而异。在交互式会话中输入问号 ?可查看你环境中可用的快捷键。

二、通用控制

注意：说明：

三、多行输入

注意：说明：

注意：在终端设置中配置你首选的换行行为。运行 `/terminal-setup` 为 iTerm2 和 VS Code 终端安装 Shift + Enter 绑定。

四、快速命令

五、编辑快捷键

六、Vim 编辑器模式

使用 /vim 命令启用 vim 风格编辑,或通过 /config 永久配置。

七、模式切换

八、导航 （NORMAL 模式）

九、编辑 （NORMAL 模式）

十、命令历史

CodeBuddy Code 为当前会话维护命令历史：

·历史记录按工作目录存储

·使用 /clear 开启全新对话（旧对话可通过 /resume 恢复）

·使用 Up/Down 方向键导航 （参见上面的键盘快捷键）

·注意：历史扩展 （!) 默认禁用

十一、编辑排队中的消息

当 Agent 正在响应时，你输入并回车的消息会进入排队，显示在输入框上方。此时输入框为空，按 Up 方向键即可把排队中的消息拉回输入框继续编辑（多条排队消息会按发送顺序合并，以换行拼接）：

·输入框为空且有可编辑排队消息时，会显示「Press ↑ to edit queued messages」提示

·系统注入的排队项（异步任务通知、频道消息、队友消息等）不会被拉回输入框，会保留在队列中继续自动处理

·已经在用 Up/Down 回溯历史时，方向键仍按历史导航处理，不会打断

十二、使用 Ctrl+R 反向搜索

按 Ctrl+R 交互式搜索你的命令历史：

1. 开始搜索：按 Ctrl+R 激活反向历史搜索

2. 输入查询：输入文本以在之前的命令中搜索 – 搜索词将在匹配结果中高亮显示

3. 导航匹配：再次按 Ctrl+R 循环浏览更早的匹配项

4. 接受匹配:

·按 Tab 或 Esc 接受当前匹配并继续编辑

·按 Enter 接受并立即执行命令

5. 取消搜索:

·按 Ctrl+C 取消并恢复原始输入

·在空搜索时按 Backspace 取消

搜索显示匹配的命令并高亮搜索词，方便查找和重用之前的输入。

十三、后台 Bash 命令

CodeBuddy Code 支持在后台运行 bash 命令，允许你在长时间运行的进程执行时继续工作。

十四、后台运行的工作原理

当 CodeBuddy Code 在后台运行命令时，它会异步运行命令并立即返回后台任务 ID。CodeBuddy Code 可以在命令继续在后台执行时响应新的提示。要在后台运行命令，你可以：

·提示 CodeBuddy Code 在后台运行命令

·按 Ctrl+B 将常规 Bash 工具调用移至后台。(Tmux 用户必须按两次 Ctrl+B,因为 tmux 的前缀键。)

主要功能：

·输出被缓冲，CodeBuddy 可以使用 TaskOutput 工具检索它

·后台任务具有唯一 ID,用于跟踪和输出检索

·CodeBuddy Code 退出时，后台任务会自动清理

常见的后台命令：

·构建工具 （webpack, vite, make)

·包管理器 （npm, yarn, pnpm)

·测试运行器 （jest, pytest)

·开发服务器

·长时间运行的进程 （docker, terraform)

十五、使用 ! 前缀的 Bash 模式

通过在输入前加上 ! 前缀直接运行 bash 命令，无需通过 CodeBuddy:

! npm test! git status! ls -la

Bash 模式：

·将命令及其输出添加到对话上下文中

·显示实时进度和输出

·支持相同的 Ctrl+B 后台运行长时间运行的命令

·不需要 CodeBuddy 解释或批准命令

这对于快速 shell 操作同时保持对话上下文非常有用。

十六、权限模式

CodeBuddy Code 支持多种权限模式来控制工具使用的授权方式：

十七、可用模式

十八、切换权限模式

·使用 Shift+Tab 在模式之间切换（所有平台通用，Windows 同时支持 Alt+M 别名）。可通过 ~/.codebuddy/keybindings.json 自定义快捷键

·使用 –permission-mode 命令行参数指定启动模式：

codebuddy –permission-mode acceptEditscodebuddy –permission-mode bypassPermissionscodebuddy –permission-mode plan

·在 settings.json 中设置默认模式：

{ "permissions": { "defaultMode": "acceptEdits" }}

十九、权限规则

权限模式与权限规则结合使用，以提供细粒度控制。参见 IAM 文档 了解配置权限规则的详细信息。

注意：说明：

注意：在交互式会话中随时输入 ? 可查看可用的快捷键和命令。使用 /help 命令获取更多帮助信息。