键盘快捷键

发现命令并打开帮助

1. Windows/Linux 使用 Ctrl+Shift+P，macOS 使用 Cmd+Shift+P 打开命令面板，或使用可见按钮/菜单项。
2. 输入操作名。面板包括应用操作和当前 Location 自定义命令；可用性取决于活动视图。
3. 运行打开帮助，在外部浏览器上下文以当前界面语言打开本指南。原生 帮助 → CodeNomad 帮助 打开同一指南。

帮助不改变应用视图和草稿。打开失败时，直接访问 CodeNomad 帮助。命令可发现不代表可自定义快捷键：快捷键管理器覆盖固定目录中的 74 项渲染器操作，而非所有命令面板或原生菜单操作。其中包括压缩会话、撤销上一条消息或打开帮助等初始为未设置快捷键的命令面板命令；项目文件夹、终端和编辑器操作只在本地桌面窗口中运行。

录制、禁用和重置

1. 打开设置 → 键盘快捷键，使用筛选快捷键查找操作或组合键。
2. 选择编辑，然后在请按下组合键中按目标组合。录制会保存绑定。
3. 使用清除快捷键（×）移除该操作的渲染器绑定，重置恢复默认值，或全部重置恢复所有渲染器绑定。
4. 解决每一行冲突警告；冲突会被报告，不会静默禁用。

绑定保存在 CodeNomad 界面配置中，影响共享配置的客户端。不会编辑 OpenCode CLI/TUI 绑定或原生菜单快捷键。录制抑制应用渲染器快捷键，但无法抑制操作系统或原生菜单。取消、失焦、关闭部分或离开窗口都会结束录制。单独修饰键和输入法组合输入会忽略；普通 Tab/Shift+Tab 移动焦点。

保存失败时，请保留旧快捷键可用，检查显示的绑定后重试。误分配时，重置是安全恢复方式。

渲染器默认值

Mod 在 Windows/Linux 表示 Ctrl，在 macOS 表示 Cmd。这些是默认值，不保证操作系统/原生宿主会传递按键。作用域很重要：同一键在主页、输入框或搜索中可能执行不同操作。

禁用 Enter 提交的配置中，发送输入默认为 Mod+Enter，插入换行默认为 Enter 或 Shift+Enter。显式快捷键覆盖会替换该默认值。使用管理器查看实际绑定。在 macOS 上，Option+Return 仍是换行，因此只有 Cmd+Shift+Return 会以另一种行为发送；会话工作时，输入框的更多操作菜单也提供同样的选择（将消息加入队列或立即插入）。清空输入会运行输入框自身的清除操作，包括在新对话的首个草稿中。上一个/下一个会话循环切换会话列表；不同于侧栏浏览器式的后退/前进历史，后者没有快捷键。

原生按键与平台拦截

原生按键固定，在更改或禁用对应渲染器绑定后仍有效。尤其是原生 New Window 使用 Mod+Shift+N，也是渲染器新建会话的默认值。原生菜单拦截时，请使用可见的新建会话控件，或重新绑定渲染器操作。同样，原生 Mod+W 可能关闭窗口，而非仅应用标签页。

普通浏览器窗口也保留浏览器快捷键。绑定始终无法传到 CodeNomad 时，请选择其他组合，而非禁用安全功能或更改操作系统全局按键。

键盘布局与文本输入

数字行和方括号快捷键在录制、执行和冲突检查中使用物理键位，包括 AZERTY/QWERTZ 布局。其他键使用逻辑值。请在打算使用的键盘上录制，再检查显示结果。

输入法组合输入期间，文字输入优先。提示词历史和 Escape 操作也取决于焦点、选择器/Shell 状态及当前操作；不要假定所有 ArrowUp 或 Escape 都是无条件全局操作。在桌面端，发送后焦点会移到对话上，因此可用方向键、翻页键和空格键滚动对话；输入一个字符会带着该字符返回输入框，使用提示词历史前可用聚焦输入框返回那里。命令面板、搜索、新建会话、信息和输入框选择器等控件的工具提示会写明其当前快捷键；它们与快捷键管理器一起显示各项分配，无需常驻键盘帮助条。