键盘
Herdr 是鼠标原生的。你可以点击窗格、标签页、工作区和智能体,拖动分割边框,使用右键菜单,一个按键绑定都不用学。键盘操作是可选的一层,不是必需项。
前缀键是什么
Section titled “前缀键是什么”终端复用器位于终端和其中运行的程序之间。这些程序已经占用了大多数按键组合: ctrl+c 中断,ctrl+r 搜索历史,编辑器几乎占用了剩下的一切。如果 Herdr 直接抢占常用按键,就会破坏其中运行的程序。
前缀键解决了这个问题。按下前缀键 (默认 ctrl+b),下一次按键会发给 Herdr 而不是终端。prefix+c 的意思是: 按下 ctrl+b,松开,再按 c。只保留一个键,而不是几十个。
随时按 prefix+? 可以查看所有生效的绑定。在快捷键帮助中按 / 即可筛选操作和快捷键；使用 Backspace 编辑筛选内容，或按 ctrl+u 清除。
| 动作 | 按键 |
|---|---|
| 新建标签页 | prefix+c |
| 向右 / 向下分割 | prefix+v / prefix+minus |
| 在窗格间移动 | prefix+h/j/k/l |
| 工作区导航 | prefix+w |
| 分离并让一切继续运行 | prefix+q |
这些覆盖了日常的大部分移动操作。其余的都可以继续用鼠标。
其余的,按任务分
Section titled “其余的,按任务分”窗格:
| 动作 | 按键 |
|---|---|
| 缩放聚焦的窗格 | prefix+z |
| 关闭窗格 | prefix+x |
| 交换窗格 | prefix+shift+h/j/k/l |
| 调整大小模式 | prefix+r |
| 复制模式 | prefix+[ |
标签页:
| 动作 | 按键 |
|---|---|
| 下一个 / 上一个标签页 | prefix+n / prefix+p |
| 跳转到标签页 1–9 | prefix+1..9 |
| 重命名标签页 | prefix+shift+t |
| 关闭标签页 | prefix+shift+x |
工作区与会话:
| 动作 | 按键 |
|---|---|
| 新建工作区 | prefix+shift+n |
| 重命名工作区 | prefix+shift+w |
| 关闭工作区 | prefix+shift+d |
| Goto 选择器 | prefix+g |
| 切换侧边栏 | prefix+b |
完整键位和绑定语法见按键绑定参考。
Goto 选择器 (prefix+g) 按工作区分组，每个代理或终端各占一行，分割标签页中的窗格也会直接显示。点击一行或按回车即可跳转到对应窗格。按 / 搜索名称、代理类型、标签页、工作区、分支或路径；未输入搜索时，用上下方向键或 j/k 在各行之间移动，左右方向键跳到上一个或下一个工作区中的第一个代理或终端，到达两端后不会循环。编辑搜索内容时，左右方向键只移动文本光标。用 b/w/i/d 筛选 blocked、working、idle 或 done 状态的代理，按 a 重新显示所有终端。所选目标的位置和路径显示在列表下方。列表超出可视区域时，可以使用鼠标滚轮、点击滚动条轨道或拖动滑块来滚动，而不会打开目标。
编辑文本输入框
Section titled “编辑文本输入框”Herdr 的命名对话框、worktree 分支名、筛选框和复制模式搜索框支持在光标处编辑。以下快捷键适用于 Herdr 自己的输入框，不改变窗格内 shell 或智能体的按键行为。
| 操作 | 按键 |
|---|---|
| 移动一个字符 | Left / Right、Ctrl+B / Ctrl+F |
| 移到开头 / 末尾 | Home / End、Ctrl+A / Ctrl+E |
| 移动一个词 | Alt+B / Alt+F |
| 删除前一个字符 | Backspace、Ctrl+H |
| 删除后一个字符 | Delete、Ctrl+D |
| 剪切到开头 / 末尾 | Ctrl+U / Ctrl+K |
| 剪切前一个词 | Ctrl+W、Alt+Backspace、Ctrl+Backspace |
| 剪切后一个词 | Alt+D |
| 插入上次剪切的文本 | Ctrl+Y |
输入和粘贴会插入光标所在位置。移动和删除遵循 Unicode 字素边界，长内容会水平滚动。剪切的文本只保留在当前输入框中，不使用系统剪贴板。Alt 快捷键需要终端报告 Alt/Meta。Enter 和 Esc 仍用于对话框的确认和取消。
按 prefix+[ 让聚焦的窗格进入复制模式。用 h/j/k/l、tmux 风格的 w/b/e 和 {/} 移动。按 / 或 ? 向前或向后进行文本搜索,再用 n 或 N 按相同或相反方向重复搜索。查询包含大写字母时区分大小写,否则不区分。用 v 或空格开始选择,用 y 或回车复制,用 q 或 Esc 不复制直接退出。Esc 会先清除当前选择或搜索,然后才退出。复制模式不会暂停窗格进程:停留在底部时继续跟随输出,进入历史记录后保持当前位置。鼠标拖选可以直接复制,完全不用进入复制模式。
鼠标拖选以及通过 v、空格或 V 开始的选择会在输出和重绘期间保持有效，即使部分选中范围位于可视区域之外。复制读取的是该范围内当前的文本，而不是冻结的快照。调整窗格大小或在普通屏幕与备用屏幕之间切换仍会清除选择。搜索结果和双击单词选择仍保留内容变化检查。
一切都可以改
Section titled “一切都可以改”每个绑定都可以配置,包括前缀键本身:
[keys]prefix = "ctrl+a"你可以把 Herdr 动作绑定到完全不需要前缀的直接组合键。难点在于知道哪些组合键是安全的,因为终端、shell 和桌面环境已经占用了键盘的大部分。
任何组合键都可以做绑定: ctrl+j、alt+k,顺手就行。但一个组合键要经过三层才能到达 Herdr: 操作系统、外层终端 (Ghostty、iTerm2 等都带有自己的默认键位),以及窗格内运行的程序。ctrl+j 能顺利到达 Herdr,但 shell 和编辑器把它当作回车。alt+k 在 Linux 上是空闲的,但在 macOS 的大多数终端里会被组合成特殊字符。如果你从这些键系里选组合键,请对照自己的终端和系统快捷键再确认一遍。
我们梳理了 Ghostty、iTerm2、Terminal.app、kitty、WezTerm、Alacritty、Warp、Windows Terminal、GNOME Terminal 和 Konsole 的默认按键绑定,以及 GNOME 和 KDE 的全局快捷键。有一个修饰键系几乎在所有地方都没被占用: ctrl+alt。终端把它留空,它不受 macOS option 键组合行为 (会挡掉纯 alt 组合键) 的影响,而且即使在没有现代键盘协议的终端里也能正常传输。它是安全的默认推荐;选择权在你。
下面的配置保留前缀绑定,并在其上叠加直接组合键:
[keys]focus_pane_left = ["prefix+h", "ctrl+alt+h"]focus_pane_down = ["prefix+j", "ctrl+alt+j"]focus_pane_up = ["prefix+k", "ctrl+alt+k"]focus_pane_right = ["prefix+l", "ctrl+alt+l"]previous_tab = ["prefix+p", "ctrl+alt+["]next_tab = ["prefix+n", "ctrl+alt+]"]new_tab = ["prefix+c", "ctrl+alt+c"]split_vertical = ["prefix+v", "ctrl+alt+d"]split_horizontal = ["prefix+minus", "ctrl+alt+shift+d"]zoom = ["prefix+z", "ctrl+alt+z"]少数 ctrl+alt 组合键已被其他地方占用。请避开这些:
| 组合键 | 占用者 |
|---|---|
ctrl+alt+arrows | GNOME 工作区切换,Ghostty 和 Konsole 默认键位 |
ctrl+alt+t | Ubuntu 和 Fedora 的“启动终端” |
ctrl+alt+l / ctrl+alt+a | KDE 锁屏 / 注意力窗口 |
ctrl+alt+s / ctrl+alt+u | Konsole |
ctrl+alt+f1..f12 | Linux 虚拟控制台切换 |
如果某个直接组合键没有任何反应,说明终端或桌面环境在 Herdr 看到它之前就把它消费掉了。两边任选其一重新配置: 在终端设置里释放这个组合键,或者在 Herdr 里换一个。