键盘快捷键

命令面板、Zen 模式、可重绑定的快捷键，以及逐条快捷键的终端透传。

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

全文中，Cmd/Ctrl 指主修饰键——macOS 上为 Cmd（⌘），Windows 与 Linux 上为 Ctrl。

命令面板

按 Cmd/Ctrl+K 可从任何地方打开命令面板——即便终端处于聚焦状态它也会打开。面板按分组组织，可以：

  • Workspace（工作区）——重命名、创建或关闭工作区；
  • Project Tools（项目工具）——显示 Git 改动，或显示文件；
  • Agent（智能体）——启动任意可用预设（"Launch <智能体>"）；以及
  • External（外部）——在你的编辑器中打开当前代码目标，或在外部终端中打开。

Zen 模式

按 Cmd/Ctrl+Shift+Z 切换 Zen 模式，它会收起应用界面外壳，并聚光式突出当前工作区的智能体终端。在 Zen 模式下：

  • 顶栏、左侧导航栏与右侧 Project Tools 面板全部隐藏；
  • 键盘焦点被移入智能体的终端，让你的按键立即抵达它；以及
  • 右下角会出现一个小小的 Exit Zen（退出 Zen） 胶囊按钮，显示该快捷键，因此你始终有退出的途径。

Escape 被有意不绑定为退出 Zen 模式——智能体 CLI 自己占用 Escape。请改用该快捷键（或顶栏中的聚焦按钮）来切换 Zen。

自定义快捷键

每个快捷键都可在 Settings → Shortcuts（设置 → 快捷键）（设置对话框的默认页面）中重绑定。快捷键分为三组——Global、Workspace 与 Editor——每组以表格展示：操作、当前绑定、一个 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。这让你在使用智能体时仍能用键盘驱动 Cordy。剪贴板按键（粘贴，以及有选区时的复制）始终会透传，从而保证正常的终端复制/粘贴继续可用。

有两类按键永不从 shell 手中夺走：

  • 保存快捷键（Cmd/Ctrl+S）在终端中默认关闭，因此 shell 保留 Ctrl+S。
  • Vim 风格导航键（J / K，无修饰键）在终端聚焦时始终留给 shell。

逐条关闭透传

每个快捷键在 Settings → Shortcuts 中都有一个 In terminal 开关。为某个快捷键关闭它，则在终端聚焦时该按键会被交给 shell，而不触发 Cordy。若你不愿用 Ctrl+D 去复制工作区，这正是把它重新交还给 shell EOF 的方式。

终端控制键冲突

在 Windows 与 Linux 上，Cordy 的主修饰键是 Ctrl——与 shell 所用的修饰键相同——因此当终端聚焦时，某些 Cordy 默认值会遮蔽某个 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+Z挂起（SIGTSTP）

在 macOS 上不存在冲突：Cordy 使用 Cmd 而 shell 使用 Ctrl，两者并存。若某个 Cordy 默认值在终端中妨碍了你，关闭它的 In terminal 开关或重绑定它即可。Ctrl+C 具有特殊的复制—中断行为，详见 故障排查。

默认快捷键

Cmd/Ctrl 为主修饰键（macOS 上为 Cmd，Windows/Linux 上为 Ctrl）。

Global（全局）

操作快捷键
打开命令面板Cmd/Ctrl+K

工作区导航

操作快捷键
下一个工作区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

工作区操作

操作快捷键
新建工作区Cmd/Ctrl+Shift+↓
复制工作区Cmd/Ctrl+D
关闭工作区Cmd/Ctrl+Shift+W
启动智能体选择器Cmd/Ctrl+Shift+A
切换 Zen 模式Cmd/Ctrl+Shift+Z
聚焦终端 / 智能体Cmd/Ctrl+←
聚焦笔记Cmd/Ctrl+→
增大终端字号Cmd/Ctrl+=
减小终端字号Cmd/Ctrl+-

Editor（编辑器）

操作快捷键在终端中
保存文件Cmd/Ctrl+S关闭（shell 保留 Ctrl+S）
保存笔记Cmd/Ctrl+S关闭

J / K 导航键为裸键（无修饰键），仅在终端或文本输入未聚焦时才会生效。

没有系统级全局热键

Cordy 不注册任何操作系统级全局热键。此处的每个快捷键都仅在 Cordy 窗口拥有键盘焦点时生效；当 Cordy 处于后台时不会有任何按键触发。收起到托盘也不会留下一个全局按键监听器——运行时无需它即可让你的工作保持存活。

相关页面

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