OpenCode 操作指导书（三）：界面与快捷键
适用版本：OpenCode v1.18.3
本篇目标：认识 OpenCode 的终端界面（TUI）布局，掌握 Leader 键与常用快捷键，并学会自定义主题与键位。
1. 界面布局
OpenCode 的 TUI 由以下区域组成：
- 顶部状态栏：显示当前模型、Agent、会话名称、分享状态。
- 消息区：展示你与 Agent 的对话、工具调用过程、代码差异（diff）。可用
h折叠/展开工具细节。 - 侧边栏（Leader→b 切换）：文件树、会话列表等。
- 输入区：底部多行输入框，支持 Readline/Emacs 风格编辑与自动补全（Tab 补全）。
- 底部状态栏：右下角显示当前模式（Plan / Build）与 Agent 名称。
2. Leader 键机制
OpenCode 使用Leader 键避免与终端自带快捷键冲突。
- 默认 Leader 键：
Ctrl+X - 使用方式：先按
Ctrl+X松开，再按第二个键。 - 例如新建会话：
Ctrl+X然后按n。 - 等待时长由
leader_timeout控制，默认2000 毫秒。
并非所有快捷键都需 Leader 键。部分导航键（如子 Agent 会话切换）默认不带 Leader。
3. 快捷键速查表
3.1 基础操作
| 快捷键 | 功能 | 说明 |
|---|---|---|
Enter | 发送消息 | 发送当前输入 |
Shift+Enter | 换行 | 输入框内换行 |
Tab | 切换 Agent | 在 primary agent 间循环 |
Shift+Tab | 反向切换 | 反向循环 primary agent |
Esc | 中断 | 停止当前 AI 回复 |
Ctrl+C | 清空输入 | 清空输入框 |
Ctrl+D | 退出 | 关闭 OpenCode |
Ctrl+P | 命令面板 | 打开命令列表 |
3.2 Leader 键操作（Ctrl+X+ 键）
| 组合 | 功能 |
|---|---|
Leader → n | 新建会话 |
Leader → l | 会话列表 |
Leader → m | 模型列表 |
Leader → a | Agent 列表 |
Leader → t | 主题列表 |
Leader → e | 打开外部编辑器 |
Leader → c | 压缩（compact）上下文 |
Leader → u | 撤销上次改动 |
Leader → r | 重做 |
Leader → x | 导出会话 |
Leader → s | 状态视图 |
Leader → b | 切换侧边栏 |
Leader → g | 会话时间线 |
Leader → y | 复制消息 |
Leader → h | 隐藏/显示细节 |
3.3 会话导航（子 Agent）
| 快捷键 | 功能 |
|---|---|
↓ | 进入首个子会话 |
→ | 下一个子会话 |
← | 上一个子会话 |
↑ | 返回父会话 |
3.4 消息滚动
| 快捷键 | 功能 |
|---|---|
PageUp/PageDown | 上/下一页 |
Ctrl+Alt+U/Ctrl+Alt+D | 上/下半页 |
Ctrl+G/Home | 跳到顶部 |
Ctrl+Alt+G/End | 跳到底部 |
3.5 输入区编辑（Readline/Emacs 风格）
| 快捷键 | 功能 |
|---|---|
Ctrl+A/Ctrl+E | 行首 / 行尾 |
Ctrl+B/Ctrl+F | 后退 / 前进一字 |
Alt+B/Alt+F | 后退 / 前进一词 |
Ctrl+K/Ctrl+U | 删除到行尾 / 行首 |
Ctrl+W/Alt+D | 删除前/后一词 |
Ctrl+D | 删除当前字符 |
↑/↓ | 浏览输入历史 |
3.6 模型与权限
| 快捷键 | 功能 |
|---|---|
F2/Shift+F2 | 循环最近模型 / 反向 |
Ctrl+T | 循环变体（variant） |
权限提示中y | 允许 |
权限提示中n | 拒绝 |
权限提示中a | 本次会话始终允许 |
4. 自定义主题与界面
切换主题：Leader → t打开主题列表，或命令/theme。
示例 TUI 配置（~/.config/opencode/tui.json）：
{"$schema":"https://opencode.ai/tui.json","keybinds":{"leader":"ctrl+x","session_new":"n","session_list":"l","model_list":"m"}}- 禁用某快捷键：设为
"none"，如"session_compact": "none"。 - 多键绑定：逗号分隔，如
"app_exit": "ctrl+c,ctrl+d,q"，或用数组["y", "ctrl+shift+c"]。
5. 上手练习
- 启动
opencode，观察界面四区域。 - 按
Leader → t切换几个主题，感受差异。 - 按
Leader → m查看可用模型列表。 - 在输入区用
Ctrl+A/Ctrl+E/Ctrl+K练习行编辑。
熟悉界面后，进入04-基础使用.md开始真正对话与改动。
本篇为 OpenCode 操作指导书系列之一，版本 v1.18.3。
