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 键CtrlX使用方式先按CtrlX松开再按第二个键。例如新建会话CtrlX然后按n。等待时长由leader_timeout控制默认2000 毫秒。并非所有快捷键都需 Leader 键。部分导航键如子 Agent 会话切换默认不带 Leader。3. 快捷键速查表3.1 基础操作快捷键功能说明Enter发送消息发送当前输入ShiftEnter换行输入框内换行Tab切换 Agent在 primary agent 间循环ShiftTab反向切换反向循环 primary agentEsc中断停止当前 AI 回复CtrlC清空输入清空输入框CtrlD退出关闭 OpenCodeCtrlP命令面板打开命令列表3.2 Leader 键操作CtrlX 键组合功能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上/下一页CtrlAltU/CtrlAltD上/下半页CtrlG/Home跳到顶部CtrlAltG/End跳到底部3.5 输入区编辑Readline/Emacs 风格快捷键功能CtrlA/CtrlE行首 / 行尾CtrlB/CtrlF后退 / 前进一字AltB/AltF后退 / 前进一词CtrlK/CtrlU删除到行尾 / 行首CtrlW/AltD删除前/后一词CtrlD删除当前字符↑/↓浏览输入历史3.6 模型与权限快捷键功能F2/ShiftF2循环最近模型 / 反向CtrlT循环变体variant权限提示中y允许权限提示中n拒绝权限提示中a本次会话始终允许4. 自定义主题与界面切换主题Leader → t打开主题列表或命令/theme。示例 TUI 配置~/.config/opencode/tui.json{$schema:https://opencode.ai/tui.json,keybinds:{leader:ctrlx,session_new:n,session_list:l,model_list:m}}禁用某快捷键设为none如session_compact: none。多键绑定逗号分隔如app_exit: ctrlc,ctrld,q或用数组[y, ctrlshiftc]。5. 上手练习启动opencode观察界面四区域。按Leader → t切换几个主题感受差异。按Leader → m查看可用模型列表。在输入区用CtrlA/CtrlE/CtrlK练习行编辑。熟悉界面后进入04-基础使用.md开始真正对话与改动。本篇为 OpenCode 操作指导书系列之一版本 v1.18.3。