键盘快捷键参考

默认键盘快捷键

通用快捷键

快捷键	操作
`Ctrl+X H`	显示帮助对话框
`Ctrl+X N`	开始新会话
`Ctrl+X U`	撤销上一条消息
`Ctrl+X R`	重做已撤销的消息
`Ctrl+X C`	压缩/总结当前会话
`Ctrl+X M`	列出可用模型
`Ctrl+X L`	列出并切换会话
`Ctrl+X S`	创建公共链接分享对话
`Ctrl+X X`	导出对话为 Markdown
`Ctrl+X E`	打开外部编辑器编写消息
`Ctrl+X I`	创建/更新 AGENTS.md
`Ctrl+X D`	切换工具执行详情显示
`Ctrl+X Q`	退出 OpenCode

导航快捷键

快捷键	操作
`上箭头`	循环浏览命令历史
`下箭头`	循环浏览命令历史
`Tab`	自动完成命令和文件路径
`Ctrl+C`	取消当前输入
`Ctrl+L`	清除终端屏幕

编辑器快捷键

快捷键	操作
`Ctrl+A`	光标移到行首
`Ctrl+E`	光标移到行尾
`Ctrl+K`	删除从光标到行尾的内容
`Ctrl+U`	删除整行
`Ctrl+W`	删除光标前的单词
`Alt+F`	向前移动一个单词
`Alt+B`	向后移动一个单词

自定义键盘快捷键

OpenCode 允许您自定义键盘快捷键以匹配您的工作流程和偏好。以下是配置自定义快捷键的方法：

配置文件

快捷键在 OpenCode 配置文件中配置。位置取决于您的操作系统：

macOS/Linux：

~/.config/opencode/config.toml
# 或
$XDG_CONFIG_HOME/opencode/config.toml

Windows：

%APPDATA%\opencode\config.toml

配置格式

要自定义快捷键，请在配置文件中添加 [shortcuts] 部分：

[shortcuts]
# 通用快捷键
help = "Ctrl+X H"
new_session = "Ctrl+X N"
undo = "Ctrl+X U"
redo = "Ctrl+X R"
compact = "Ctrl+X C"
models = "Ctrl+X M"
sessions = "Ctrl+X L"
share = "Ctrl+X S"
export = "Ctrl+X X"
external_editor = "Ctrl+X E"
init = "Ctrl+X I"
toggle_details = "Ctrl+X D"
exit = "Ctrl+X Q"

按键语法

定义快捷键时，使用以下语法：

Ctrl+ 表示 Control 键
Alt+ 表示 Alt/Option 键
Shift+ 表示 Shift 键
单个字母或数字

示例：

Ctrl+X H（Control + X 后跟 H）
Alt+S（Alt + S）
Ctrl+Shift+Q（Control + Shift + Q）

键盘快捷键的效率优势

键盘快捷键显著提高您在 OpenCode 中的工作流程效率。以下是它们如何增强您的生产力：

1. 更快的导航

快速访问命令：无需菜单导航即可执行常见操作
减少鼠标使用：最小化键盘和鼠标之间的上下文切换
简化工作流程：以更少的按键执行任务

2. 减少上下文切换

保持专注：保持工作流程的连续性
减少认知负担：肌肉记忆减少决策过程
连续工作流：执行命令而不中断思路

3. 提高生产力

节省时间：快速操作随着时间的推移累积效果
批处理：快速执行多个命令
一致性：跨会话的标准化快捷键

4. 人体工程学优势

减少 strain：减少鼠标移动和点击
舒适的姿势：保持自然的手部位置
可持续编码：更好的姿势和减少疲劳

高级快捷键技巧

和弦快捷键

OpenCode 对许多命令使用和弦快捷键（两键组合），如 Ctrl+X H。这允许在没有冲突的情况下使用更多唯一快捷键。

如何使用和弦快捷键：

按下并按住第一个组合键（例如，Ctrl+X）
释放两个键
按下第二个键（例如，H）

自定义命令快捷键

您可以创建自定义命令并为其分配快捷键。有关创建自定义命令的详细信息，请参阅斜杠命令参考。

快捷键学习技巧

从最常用的快捷键开始：专注于 Ctrl+X N（新会话）、Ctrl+X H（帮助）和 Ctrl+X Q（退出）
使用帮助对话框：按 Ctrl+X H 查看所有可用的快捷键
定期练习：重复建立肌肉记忆
创建速查表：打印或保存快捷键表以供快速参考
根据工作流自定义：调整快捷键以匹配您最频繁的任务

快捷键故障排除

常见问题

快捷键不工作：检查与系统或终端快捷键的冲突
行为不一致：确保使用正确的和弦序列
自定义快捷键不被识别：验证配置文件中的语法
终端特定问题：某些终端可能以不同方式处理某些键组合

终端兼容性

如果您遇到快捷键问题，请检查终端模拟器设置。某些终端需要特定配置才能正确处理某些键组合。

重置为默认值

要将所有快捷键重置为默认值，请从配置文件中删除 [shortcuts] 部分或注释掉自定义设置。

总结

键盘快捷键是增强 OpenCode 工作流程的强大工具。通过学习和自定义快捷键，您可以：

工作更快，减少按键和鼠标使用
保持专注，最小化上下文切换
减少疲劳，通过符合人体工程学的按键组合
自定义 您的环境以匹配您的偏好

花时间学习最常用的快捷键并逐渐将它们纳入您的工作流程。随着时间的推移，它们会成为第二天性，让您更高效、更有效地使用 OpenCode。