03-界面与快捷键

OpenCode 操作指导书（三）：界面与快捷键

适用版本：OpenCode v1.18.3
本篇目标：认识 OpenCode 的终端界面（TUI）布局，掌握 Leader 键与常用快捷键，并学会自定义主题与键位。

1. 界面布局

OpenCode 的 TUI 由以下区域组成：

顶部状态栏
模型 / Agent / 会话名

消息区
对话历史 / 工具调用 / 差异

侧边栏
文件树 / 会话列表
（可切换隐藏）

底部输入区
多行编辑 / 自动补全

底部状态栏
模式指示 Plan/Build

  • 顶部状态栏：显示当前模型、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 → aAgent 列表
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. 上手练习

  1. 启动opencode，观察界面四区域。
  2. 按Leader → t切换几个主题，感受差异。
  3. 按Leader → m查看可用模型列表。
  4. 在输入区用Ctrl+A/Ctrl+E/Ctrl+K练习行编辑。

熟悉界面后，进入04-基础使用.md开始真正对话与改动。

本篇为 OpenCode 操作指导书系列之一，版本 v1.18.3。