企业官网建设流程全解析

Herdr 三种键盘模式入门指南：terminal / prefix / navigate 一次看懂

【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr

Herdr 是一个把 Claude Code、Codex 等编程 Agent 装进常驻终端面板的工作区管理器（runtime）。新手最容易卡住的地方是键盘：同一把键盘，有时打字直接进了 Agent，有时却触发了新建标签页。搞清楚 terminal、prefix、navigate 这三种键盘模式各管什么，是上手 Herdr 的第一课。

"模式"到底在切换什么

先放下键位表，理解这一点之后，所有快捷键都会变得好记：你按下的每个键，去向只有两个——当前聚焦面板里的程序，或者 Herdr 本身。模式决定的就是"话筒递给谁"。terminal 模式下话筒全程在演员（面板程序）手里；prefix 模式下话筒也在演员手里，但你喊一声"暂停"（按前缀键ctrl+b），下一句就归导演（Herdr）处理；navigate 模式下话筒完全交给导演，你只管指挥调度，面板只是被查看的对象。

用三步就能判断自己现在该待在哪种模式：

1. 手上正在给 Agent 打字、跑命令？那就在 terminal，别切。
2. 要执行一次 Herdr 动作，比如开标签页、分屏、断开？进 prefix，按完动作键立刻自动回 terminal。
3. 要连续扫多个面板、多个工作区，看谁卡住了？进 navigate，巡视完按Esc落回 terminal。

三张速查表：每种模式怎么进、按什么、什么时候用

三张表各对应一种模式，列名统一为"进入方式 / 高频按键 / 适合场景"，建议对照着记。

把三种模式串起来感受一遍：假设你刚打开一个挂着三个 Agent 的工作区。新会话默认落在 navigate 模式，你先用j、k扫一圈，发现第二个面板的 Agent 卡在等待确认；按Esc落回 terminal，对着它输入"继续"；想顺便看一眼第三个 Agent，按ctrl+b松开再按l切过去；觉得右半边太挤，ctrl+b再按v分出一个新面板；巡视完毕，ctrl+b再按q断开——终端窗口可以关掉，三个 Agent 都在后台继续跑。

新手最容易踩的三个坑

新开会话和恢复会话的落点不一样

新建会话默认落在 navigate 模式，而从持久化快照恢复的历史会话直接进 terminal 模式，同一个 Herdr 两次启动"手感"不同。规避办法：每次重连后先花一秒钟确认当前模式，不对就按Esc或prefix+w校正，别硬猜。

默认前缀键ctrl+b在别处另有身份

bash 的 emacs 行编辑里ctrl+b是光标后移一位，tmux 用户也习惯用它当前缀；而且在 Herdr 的 copy mode（prefix+[进入）里，ctrl+b的翻页语义会被前缀模式抢走。动作"失灵"或光标莫名移动时，多半是这里冲突了。规避：在配置文件里整体换掉前缀键——

[keys] prefix = "ctrl+a"

关掉鼠标捕获后，纯键盘流要补的活更多

在[ui]下设置mouse_capture = false，点击会穿透给外层终端，适合想让终端原生文本选择生效的人。但代价是点面板、拖分屏边框、右键菜单这些 Herdr 原生鼠标操作全部失效，只能靠 prefix 和 navigate 的键盘绑定补齐。💡 建议先保持默认开启，确认和外层终端确实打架了再关。

按你的习惯挑一套默认姿势

• 如果你一次只盯一个 Agent、以对话为主：terminal 就是主场，只需要多记一个prefix+q用来断开。
• 如果你的日常是开屏、切屏、断屏这类运维式操作：把 prefix 当主力，c、v、w、q四个动作键背熟即可覆盖大部分场景。
• 如果你同时照看多个项目的多个 Agent：把 navigate 当总览台，j/k扫一圈看谁 blocked，再Esc落回 terminal 处理具体那个。
• 如果你是重度键盘流、连ctrl+b都想省掉：可以在配置里给切面板、切标签页追加ctrl+alt直连组合键（默认键表里就有示例），ctrl+alt这一族组合在主流终端里基本无人占用，最安全。

三步最小上手路径

1. 在项目目录运行herdr启动一个新会话：默认落在 navigate 模式，按h/j/k/l逛一圈布局，Esc退出回 terminal。
2. 按ctrl+b松开再按c：多出一个新标签页；再按ctrl+b松开按v：当前面板一分为二。
3. 按ctrl+b松开再按q断开，重开终端再跑herdr：会话原样还在，Agent 没被打断。

所有默认键位都只是起点，完整键表见docs/next/website/src/content/docs/keyboard.mdx，默认绑定的源码定义在src/config/keybinds.rs，想改哪个按哪查。

【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr