CodeBuddy 自定义快捷键

一、配置文件

keybindings 配置文件是一个包含 bindings 数组的对象。每个 block 指定一个上下文（context）和按键到动作的映射。

注意：说明：

注意：对 keybindings 文件的更改会自动检测并应用，无需重启 CodeBuddy Code。

以下示例在 Chat 上下文中将 Ctrl+E 绑定到外部编辑器，并解绑 Ctrl+U：

{ "$schema": "https://code.codebuddy.ai/schemas/keybindings.json", "$docs": "https://code.codebuddy.ai/docs/keybindings", "bindings": [ { "context": "Chat", "bindings": { "ctrl+e": "chat:externalEditor", "ctrl+u": null } } ]}

二、上下文（Contexts）

每个绑定块指定一个 context，决定快捷键在何时生效：

三、可用动作（Actions）

动作遵循 namespace:action 格式，如 chat:submit 发送消息、app:toggleTodos 切换待办事项列表。每个上下文有特定的可用动作。

四、应用动作

在 Global 上下文中可用：

五、历史动作

用于导航命令历史：

六、聊天动作

在 Chat 上下文中可用：

所有平台统一使用 Shift+Tab 作为主快捷键。Windows 上同时保留 Alt+M 作为别名，方便终端不支持 Shift+Tab 时使用。

七、自动补全动作

在 Autocomplete 上下文中可用：

八、确认动作

在 Confirmation 上下文中可用：

九、转录动作

在 Transcript 上下文中可用：

十、历史搜索动作

在 HistorySearch 上下文中可用：

十一、任务动作

在 Task 上下文中可用：

十二、帮助动作

在 Help 上下文中可用：

十三、设置动作

在 Settings 上下文中可用：

十四、选择列表动作

在 Select 上下文中可用：

十五、命令面板动作

在 CommandPalette 上下文中可用：

十六、Diff 动作

在 DiffDialog 上下文中可用：

十七、消息选择器动作

在 MessageSelector 上下文中可用：

十八、插件动作

在 Plugin 上下文中可用：

20、修饰键

使用 + 分隔符组合修饰键：

·ctrl 或 control — Control 键

·alt、opt 或 option — Alt/Option 键

·shift — Shift 键

·meta、cmd 或 command — Meta/Command 键

示例：

ctrl+k 单个修饰键 + 按键shift+tab Shift + Tabmeta+p Command/Meta + Pctrl+shift+c 多个修饰键

21、弦序列（Chords）

弦序列是用空格分隔的连续按键组合：

ctrl+x ctrl+k 先按 Ctrl+X，松开，再按 Ctrl+Kctrl+x ctrl+e 先按 Ctrl+X，松开，再按 Ctrl+E

弦序列有 1000ms 超时。如果超时未完成第二步，弦序列将被取消。

22、特殊按键

·escape 或 esc — Escape 键

·enter 或 return — Enter 键

·tab — Tab 键

·space — 空格键

·up、down、left、right — 方向键

·backspace、delete — 删除键

23、解绑默认快捷键

将动作设为 null 以解绑默认快捷键：

{ "bindings": [ { "context": "Chat", "bindings": { "ctrl+s": null } } ]}

解绑弦序列的所有组合后，可以将前缀键用作单键绑定：

{ "bindings": [ { "context": "Chat", "bindings": { "ctrl+x ctrl+k": null, "ctrl+x ctrl+e": null, "ctrl+x": "chat:newline" } } ]}

如果只解绑了部分弦序列，按下前缀键仍会进入弦等待模式。

24、保留快捷键

以下快捷键不可重新绑定：

25、终端冲突

某些快捷键可能与终端复用器冲突：

26、Web UI 可视化配置

除了编辑 JSON 文件，你还可以在 Web UI 中通过可视化界面管理快捷键：

1. 在侧边栏点击 快捷键 导航项，或使用 URL #/keybindings

2. 使用搜索框按名称、按键或上下文筛选快捷键

3. 点击编辑按钮（铅笔图标）录制新的快捷键组合

4. 录制对话框会实时显示冲突检测

5. 用户自定义的绑定以左侧高亮边框标记

6. 点击重置按钮可恢复单个绑定为默认值

27、REST API

Web UI 通过 REST API 管理快捷键：

28、验证

CodeBuddy Code 会验证你的快捷键配置并对以下情况显示警告：

·解析错误（无效的 JSON 或结构）

·无效的上下文名称

·保留快捷键冲突

·终端复用器冲突

·同一上下文中的重复绑定