键盘快捷键

命令面板及其前缀、Zen 模式、可重绑定的快捷键、逐条快捷键的终端透传,以及默认绑定。

Cordy 以键盘优先。本页列出默认快捷键、说明如何重绑定,并讲清让终端类应用的快捷键变得棘手的那件事:判断一次按键是驱动 Cordy,还是透传给 shell。

全文中,Cmd/Ctrl 指主修饰键——macOS 上为 Cmd(⌘),Windows 与 Linux 上为 Ctrl。

命令面板

按 Cmd/Ctrl+K 可从任何地方打开命令面板——即便终端处于聚焦状态它也会打开。输入框提示 Run command...;默认同时列出命令与文件。以前缀开头可切换模式:

前缀模式
>只显示命令,隐藏文件
:跳转到活动编辑器中的某一行
%在整个项目中搜索文本
?列出这些前缀

在带前缀的空输入框中按 Backspace 会回到默认模式;Escape 关闭面板。

命令按以下顺序分组:

分组命令
WorkspaceNew workspace、Rename workspace、Toggle Browser、Export note for Notion…、Import into note…(笔记面板打开时)、Close workspace
TabNew 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: <名称>
EditorFind in file
Project ToolsShow Git changes、Show files、Reveal active file in Files、Search in project
AgentLaunch <预设>、Split with <预设>
Stop AgentStop <智能体>
ExternalOpen in editor、Open external terminal
ProjectAdd repository…
AppOpen 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 开关,以及一个编辑控件。

重绑定方法:

  1. 点击某快捷键的绑定以开始录制("Press shortcut")。
  2. 按下新的组合键。Escape 取消;Backspace 或 Delete 清除绑定。
  3. 多数快捷键要求至少一个修饰键——裸键会被拒绝(两个 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–9Cmd/Ctrl+1 … Cmd/Ctrl+9
跳转到工作区 10Cmd/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 处于后台时不会有任何按键触发。收起到托盘也不会留下一个全局按键监听器——运行时无需它即可让你的工作保持存活。

相关页面

  • 工作区——这些快捷键所导航的面板。
  • 笔记——笔记编辑器快捷键。
  • 智能体——从命令面板启动智能体。
  • 故障排查——终端中 Ctrl+C 的复制与中断。