Herdr 三种键盘模式入门指南terminal / prefix / navigate 一次看懂【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr 是一个把 Claude Code、Codex 等编程 Agent 装进常驻终端面板的工作区管理器runtime。新手最容易卡住的地方是键盘同一把键盘有时打字直接进了 Agent有时却触发了新建标签页。搞清楚 terminal、prefix、navigate 这三种键盘模式各管什么是上手 Herdr 的第一课。模式到底在切换什么先放下键位表理解这一点之后所有快捷键都会变得好记你按下的每个键去向只有两个——当前聚焦面板里的程序或者 Herdr 本身。模式决定的就是话筒递给谁。terminal 模式下话筒全程在演员面板程序手里prefix 模式下话筒也在演员手里但你喊一声暂停按前缀键ctrlb下一句就归导演Herdr处理navigate 模式下话筒完全交给导演你只管指挥调度面板只是被查看的对象。用三步就能判断自己现在该待在哪种模式手上正在给 Agent 打字、跑命令那就在 terminal别切。要执行一次 Herdr 动作比如开标签页、分屏、断开进 prefix按完动作键立刻自动回 terminal。要连续扫多个面板、多个工作区看谁卡住了进 navigate巡视完按Esc落回 terminal。三张速查表每种模式怎么进、按什么、什么时候用三张表各对应一种模式列名统一为进入方式 / 高频按键 / 适合场景建议对照着记。进入方式高频按键适合场景terminal默认状态从其他模式按Esc回到这里正常打字、ctrlc中断绝大多数时间都待在这prefix按ctrlb默认前缀键c新标签页、v分屏、h/j/k/l切面板、w工作区导航、q断开navigateprefixw进入新建会话启动时默认就在此模式h/j/k/l面板间移动、up/down工作区上下、Esc退出把三种模式串起来感受一遍假设你刚打开一个挂着三个 Agent 的工作区。新会话默认落在 navigate 模式你先用j、k扫一圈发现第二个面板的 Agent 卡在等待确认按Esc落回 terminal对着它输入继续想顺便看一眼第三个 Agent按ctrlb松开再按l切过去觉得右半边太挤ctrlb再按v分出一个新面板巡视完毕ctrlb再按q断开——终端窗口可以关掉三个 Agent 都在后台继续跑。新手最容易踩的三个坑新开会话和恢复会话的落点不一样新建会话默认落在 navigate 模式而从持久化快照恢复的历史会话直接进 terminal 模式同一个 Herdr 两次启动手感不同。规避办法每次重连后先花一秒钟确认当前模式不对就按Esc或prefixw校正别硬猜。默认前缀键ctrlb在别处另有身份bash 的 emacs 行编辑里ctrlb是光标后移一位tmux 用户也习惯用它当前缀而且在 Herdr 的 copy modeprefix[进入里ctrlb的翻页语义会被前缀模式抢走。动作失灵或光标莫名移动时多半是这里冲突了。规避在配置文件里整体换掉前缀键——[keys] prefix ctrla关掉鼠标捕获后纯键盘流要补的活更多在[ui]下设置mouse_capture false点击会穿透给外层终端适合想让终端原生文本选择生效的人。但代价是点面板、拖分屏边框、右键菜单这些 Herdr 原生鼠标操作全部失效只能靠 prefix 和 navigate 的键盘绑定补齐。 建议先保持默认开启确认和外层终端确实打架了再关。按你的习惯挑一套默认姿势如果你一次只盯一个 Agent、以对话为主terminal 就是主场只需要多记一个prefixq用来断开。如果你的日常是开屏、切屏、断屏这类运维式操作把 prefix 当主力c、v、w、q四个动作键背熟即可覆盖大部分场景。如果你同时照看多个项目的多个 Agent把 navigate 当总览台j/k扫一圈看谁 blocked再Esc落回 terminal 处理具体那个。如果你是重度键盘流、连ctrlb都想省掉可以在配置里给切面板、切标签页追加ctrlalt直连组合键默认键表里就有示例ctrlalt这一族组合在主流终端里基本无人占用最安全。三步最小上手路径在项目目录运行herdr启动一个新会话默认落在 navigate 模式按h/j/k/l逛一圈布局Esc退出回 terminal。按ctrlb松开再按c多出一个新标签页再按ctrlb松开按v当前面板一分为二。按ctrlb松开再按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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考