快捷键

自定义你的快捷键。

OpenCode 有一系列快捷键，你可以通过 OpenCode 配置进行自定义。

# 默认配置示例#

json
1{
2  "$schema": "https://opencode.ai/config.json",
3  "keybinds": {
4    "leader": "ctrl+x",
5    "app_exit": "ctrl+c,ctrl+d,<leader>q",
6    "editor_open": "<leader>e",
7    "theme_list": "<leader>t",
8    "sidebar_toggle": "<leader>b",
9    "status_view": "<leader>s",
10    "session_export": "<leader>x",
11    "session_new": "<leader>n",
12    "session_list": "<leader>l",
13    "session_timeline": "<leader>g",
14    "session_interrupt": "escape",
15    "session_compact": "<leader>c",
16    "session_child_cycle": "<leader>right",
17    "session_child_cycle_reverse": "<leader>left",
18    "session_parent": "<leader>up",
19    "messages_page_up": "pageup,ctrl+alt+b",
20    "messages_page_down": "pagedown,ctrl+alt+f",
21    "messages_copy": "<leader>y",
22    "messages_undo": "<leader>u",
23    "messages_redo": "<leader>r",
24    "messages_toggle_conceal": "<leader>h",
25    "model_list": "<leader>m",
26    "model_cycle_recent": "f2",
27    "model_cycle_recent_reverse": "shift+f2",
28    "variant_cycle": "ctrl+t",
29    "command_list": "ctrl+p",
30    "agent_list": "<leader>a",
31    "agent_cycle": "tab",
32    "agent_cycle_reverse": "shift+tab",
33    "input_clear": "ctrl+c",
34    "input_paste": "ctrl+v",
35    "input_submit": "return",
36    "input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
37    "input_line_home": "ctrl+a",
38    "input_line_end": "ctrl+e",
39    "history_previous": "up",
40    "history_next": "down",
41    "terminal_suspend": "ctrl+z",
42    "tips_toggle": "<leader>h"
43  }
44}

# Leader 键#

OpenCode 使用 leader 键来触发大多数快捷键。这避免了终端中的冲突。

默认情况下，ctrl+x 是 leader 键，大多数操作需要你先按 leader 键然后再按快捷键。例如，要开始新会话，你首先按 ctrl+x，然后按 n。

你不需要为快捷键使用 leader 键，但我们建议这样做。

# 禁用快捷键#

你可以通过在配置中添加值为 "none" 的键来禁用快捷键。

json
1{
2  "$schema": "https://opencode.ai/config.json",
3  "keybinds": {
4    "session_compact": "none"
5  }
6}

# 桌面提示快捷键#

OpenCode 桌面应用的提示输入支持常见的 Readline/Emacs 风格的文本编辑快捷键。这些是内置的，目前无法通过 opencode.json 配置。

快捷键	操作
`ctrl+a`	移动到当前行开头
`ctrl+e`	移动到当前行结尾
`ctrl+b`	光标向后移动一个字符
`ctrl+f`	光标向前移动一个字符
`alt+b`	光标向后移动一个单词
`alt+f`	光标向前移动一个单词
`ctrl+d`	删除光标下的字符
`ctrl+k`	删除到行尾
`ctrl+u`	删除到行首
`ctrl+w`	删除前一个单词
`alt+d`	删除下一个单词
`ctrl+t`	交换字符
`ctrl+g`	取消弹出窗口 / 中止正在运行的响应

# Shift+Enter#

某些终端默认不发送带修饰符的 Enter 键。你可能需要配置终端以将 Shift+Enter 作为转义序列发送。

## Windows Terminal#

打开你的 settings.json：

%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

将以下内容添加到根级 actions 数组：

json
1"actions": [
2  {
3    "command": {
4      "action": "sendInput",
5      "input": "\u001b[13;2u"
6    },
7    "id": "User.sendInput.ShiftEnterCustom"
8  }
9]

将以下内容添加到根级 keybindings 数组：

json
1"keybindings": [
2  {
3    "keys": "shift+enter",
4    "id": "User.sendInput.ShiftEnterCustom"
5  }
6]

保存文件并重启 Windows Terminal 或打开新标签页。

快捷键