键盘快捷键
命令面板及其前缀、Zen 模式、可重绑定的快捷键、逐条快捷键的终端透传,以及默认绑定。
Cordy 以键盘优先。本页列出默认快捷键、说明如何重绑定,并讲清让终端类应用的快捷键变得棘手的那件事:判断一次按键是驱动 Cordy,还是透传给 shell。
全文中,Cmd/Ctrl 指主修饰键——macOS 上为 Cmd(⌘),Windows 与 Linux 上为 Ctrl。
命令面板
按 Cmd/Ctrl+K 可从任何地方打开命令面板——即便终端处于聚焦状态它也会打开。输入框提示 Run command...;默认同时列出命令与文件。以前缀开头可切换模式:
| 前缀 | 模式 |
|---|---|
> | 只显示命令,隐藏文件 |
: | 跳转到活动编辑器中的某一行 |
% | 在整个项目中搜索文本 |
? | 列出这些前缀 |
在带前缀的空输入框中按 Backspace 会回到默认模式;Escape 关闭面板。
命令按以下顺序分组:
| 分组 | 命令 |
|---|---|
| Workspace | New workspace、Rename workspace、Toggle Browser、Export note for Notion…、Import into note…(笔记面板打开时)、Close workspace |
| Tab | New terminal tab、Next tab、Previous tab、Split terminal right、Split terminal down、Pin tab / Unpin tab、Close tab(固定标签不显示)、Close other tabs、Arrange panes: <预设>、Arrange panes: Even out |
| Switch Workspace | 针对当前项目其他工作区的 Switch to workspace: <名称> |
| Editor | Find in file |
| Project Tools | Show Git changes、Show files、Reveal active file in Files、Search in project |
| Agent | Launch <预设>、Split with <预设> |
| Stop Agent | Stop <智能体> |
| External | Open in editor、Open external terminal |
| Project | Add repository… |
| App | Open performance monitor(Zen 模式下隐藏) |
当前不适用的命令会被隐藏,或显示为禁用并附上原因,例如 "This workspace has no note"。设置从侧栏打开,而不是从命令面板。
Zen 模式
按 Cmd/Ctrl+Shift+Z 切换 Zen 模式,它会收起应用界面外壳,并聚光式突出当前工作区的智能体终端。在 Zen 模式下:
- 顶栏、左侧导航栏与右侧 Project Tools 面板全部隐藏;只保留一条窄窗口栏,提供拖动区域与窗口按钮(macOS 上为窗口控制按钮留出位置);
- 键盘焦点被移入智能体的终端,让你的按键立即抵达它;以及
- 会出现一个小小的 Exit Zen 胶囊按钮,显示该快捷键,因此你始终有退出的途径。
Escape 被有意不绑定为退出 Zen 模式——智能体 CLI 自己占用 Escape。由于 Ctrl+Shift+Z 是 Zen 模式,Windows 上笔记中的重做为 Ctrl+Y。
自定义快捷键
每个快捷键都可在设置 → 快捷键 中重绑定。快捷键分为四组——Global、Workspace、Editor 与 Notes——每组以表格展示:操作、当前绑定、一个 In terminal 开关,以及一个编辑控件。
重绑定方法:
- 点击某快捷键的绑定以开始录制("Press shortcut")。
- 按下新的组合键。
Escape取消;Backspace或Delete清除绑定。 - 多数快捷键要求至少一个修饰键——裸键会被拒绝(两个 Vim 风格导航键除外)。若你的组合已被另一个快捷键占用,Cordy 会告诉你是哪一个。
每一行都可重置为默认值,而 Reset all 按钮可一次性恢复所有绑定与终端设置。你的自定义存储在你本地的机器上,不会同步到任何地方。
终端中的快捷键
Cordy 内嵌真实终端,而 shell 与 TUI 会使用它们自己的控制键组合(例如 Ctrl+C、Ctrl+D、Ctrl+K)。因此当终端聚焦时,Cordy 必须逐次按键地判断:是运行它自己的快捷键,还是把原始按键透传给 shell。
默认:Cordy 优先
默认情况下,一个已配置的、带修饰键的 Cordy 快捷键即便在终端聚焦时也会胜出;任何不匹配 Cordy 快捷键的按键则透传给 shell 或 TUI。剪贴板按键(粘贴,以及有选区时的复制)始终会透传,从而保证正常的终端复制 / 粘贴继续可用。
以下按键默认留给 shell:
- 备用工作区切换键
Alt+↑/Alt+↓,因为 Codex 等 CLI 会绑定它们。Cmd/Ctrl+↑/Cmd/Ctrl+↓在终端中仍可切换工作区。 - Editor 分组(
Cmd/Ctrl+S、Cmd/Ctrl+F),因此 shell 保留Ctrl+S与Ctrl+F。 - Notes 分组,它只在笔记内生效。
- Vim 风格导航键(
J/K,无修饰键),始终如此。
逐条关闭透传
每个快捷键在设置 → 快捷键 中都有一个 In terminal 开关。为某个快捷键关闭它,则在终端聚焦时该按键会被交给 shell,而不触发 Cordy。若你不愿用 Ctrl+D 去复制工作区,这正是把它重新交还给 shell EOF 的方式。
终端控制键冲突
在 Windows 与 Linux 上,Cordy 的主修饰键是 Ctrl——与 shell 所用的修饰键相同——因此当终端聚焦时,某些 Cordy 默认值会遮蔽某个 shell 绑定。设置界面会逐条标出:"In a focused terminal <组合键> overrides <shell 操作>. Turn off "In terminal" to keep the shell binding."(在聚焦的终端中,该组合键会覆盖 shell 操作;关闭 "In terminal" 即可保留 shell 绑定。)以下是需要留意的常见 shell/readline 按键:
| 按键 | shell 通常的作用 |
|---|---|
Ctrl+C | 中断(SIGINT)——或在有选区时复制 |
Ctrl+D | 输入结束(EOF) |
Ctrl+K | 删除到行尾 |
Ctrl+A / Ctrl+E | 移动到行首 / 行尾 |
Ctrl+U / Ctrl+W | 删除到行首 / 删除前一个词 |
Ctrl+R | 反向历史搜索 |
Ctrl+L | 清屏 |
Ctrl+S | 暂停输出(XOFF) |
Ctrl+Z | 挂起(SIGTSTP) |
标签快捷键使用 Ctrl+Alt(Ctrl+Alt+T、Ctrl+Alt+W、Ctrl+Alt+←/→),从而让 Ctrl+T 与 Ctrl+W 留给 shell。
在 macOS 上不存在冲突:Cordy 使用 Cmd 而 shell 使用 Ctrl,两者并存。若某个 Cordy 默认值在终端中妨碍了你,关闭它的 In terminal 开关或重绑定它即可。Ctrl+C 具有特殊的复制—中断行为,详见故障排查。
默认快捷键
Global(全局)
| 操作 | 快捷键 |
|---|---|
| Open command palette(打开命令面板) | Cmd/Ctrl+K |
| Add repository…(添加仓库) | Cmd/Ctrl+Shift+O |
工作区导航
| 操作 | 快捷键 |
|---|---|
| 下一个工作区 | Cmd/Ctrl+↓(也可 Alt+↓,终端中默认关闭) |
| 上一个工作区 | Cmd/Ctrl+↑(也可 Alt+↑,终端中默认关闭) |
| 下一个工作区(翻页) | Alt+PageDown |
| 上一个工作区(翻页) | Alt+PageUp |
| 第一个工作区 | Alt+Home |
| 最后一个工作区 | Alt+End |
| 跳转到工作区 1–9 | Cmd/Ctrl+1 … Cmd/Ctrl+9 |
| 跳转到工作区 10 | Cmd/Ctrl+0 |
| 下一个工作区(Vim) | J |
| 上一个工作区(Vim) | K |
工作区操作
| 操作 | 快捷键 |
|---|---|
| New workspace(新建工作区) | Cmd/Ctrl+Shift+↓ |
| Duplicate workspace(复制工作区) | Cmd/Ctrl+D |
| Close workspace(关闭工作区) | Cmd/Ctrl+Shift+W |
| Toggle Zen Mode(切换 Zen 模式) | Cmd/Ctrl+Shift+Z |
| Focus TUI(聚焦终端) | Cmd/Ctrl+← |
| Focus notes(聚焦笔记) | Cmd/Ctrl+→ |
| Increase TUI font(增大终端字号) | Cmd/Ctrl+= |
| Decrease TUI font(减小终端字号) | Cmd/Ctrl+- |
标签
| 操作 | 快捷键 |
|---|---|
| New terminal tab(新建终端标签) | Cmd/Ctrl+Alt+T |
| Close terminal tab(关闭终端标签;固定标签会忽略) | Cmd/Ctrl+Alt+W |
| Next tab(下一个标签:先终端标签,再文件标签) | Cmd/Ctrl+Alt+→ |
| Previous tab(上一个标签) | Cmd/Ctrl+Alt+← |
在部分 Intel 显卡驱动上,Ctrl+Alt+方向键会在 Cordy 收到之前旋转屏幕;如遇此情况,请重新绑定 Next / Previous tab。
Editor(编辑器)
| 操作 | 快捷键 | 在终端中 |
|---|---|---|
| Save file(保存文件) | Cmd/Ctrl+S | 关闭(shell 保留 Ctrl+S) |
| Save note(保存笔记) | Cmd/Ctrl+S | 关闭 |
| Find in file(在文件中查找) | Cmd/Ctrl+F | 关闭 |
Notes(笔记)
Notes 分组包含笔记编辑器的格式、块与 Turn into 快捷键。完整列表见笔记。
J / K 导航键为裸键(无修饰键),仅在终端或文本输入未聚焦时才会生效。
没有系统级全局热键
Cordy 不注册任何操作系统级全局热键。此处的每个快捷键都仅在 Cordy 窗口拥有键盘焦点时生效;当 Cordy 处于后台时不会有任何按键触发。收起到托盘也不会留下一个全局按键监听器——运行时无需它即可让你的工作保持存活。