Herdr 三种模式指南:terminal、prefix、navigate 到底怎么切换
【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr
Herdr 是面向编程 Agent 的终端工作区管理器,让 Claude Code、Codex 这类 Agent 常驻在终端面板里跑。新手刚接触它时最容易懵的,就是 Herdr 三种模式的区别、模式切换的路径和一套 Herdr 快捷键。这篇指南带你把它们一次捋顺。
为什么按键必须分模式:一个键位的分配问题
面板里跑着的程序早就把常用键瓜分干净了:ctrl+c归中断、ctrl+r归历史搜索,编辑器还会把大半组合键据为己有。Herdr 要是自己乱抢键,这些程序马上失灵。于是它的设计思路很朴素——按键按模式分流:
- terminal 模式:所有按键原封不动交给当前面板,Herdr 不伸手;
- prefix 模式:Herdr 只占一个前缀键(默认
ctrl+b),前缀之后的那个按键才归它管; - navigate 模式:导航界面接管按键,用来在面板和工作区之间挪焦点。
分清这三者,后面的一切就顺了。
写代码、给 Agent 下指令:terminal 模式全直通
什么时候进:这是日常主阵地。面板获得焦点后你就是在 terminal 模式,不需要任何切换动作;恢复的历史会话默认也落在这里。
进去干嘛:正常打字、ctrl+c中断、在编辑器里随便按组合键——面板进程收什么 Herdr 就传什么,全程零拦截。
怎么回来:这里有个免 navigate 的提速技巧。配置里可以为切面板绑上直接快捷键,比如alt+h、alt+right,按一下焦点就跳走,不用先进 navigate 模式再折返。想试纯键盘流,还能在[ui]下把mouse_capture设成false关掉鼠标捕获,不过鼠标点面板、拖分屏边框本来就是 Herdr 的拿手好戏,键盘层纯属可选项。
新建标签页、分屏、断开连接:prefix 模式五个必背键位
什么时候进:想动 Herdr 本体(而不是面板里的程序)时。按一下前缀键ctrl+b就进,再按一个动作键就是一条指令,松开前缀后动作键立即生效。
进去干嘛:记住下面五个就够撑日常了,完整键位表随时按prefix+?调出来看,输入/还能过滤搜索:
| 动作 | 按键 |
|---|---|
| 新建标签页 | prefix+c |
| 向右 / 向下分屏 | prefix+v/prefix+- |
| 面板间挪焦点 | prefix+hjkl |
| 打开工作区导航 | prefix+w |
| 断开连接,Agent 继续跑 | prefix+q |
怎么回来:动作执行完自动退回 terminal,按Esc也能取消前缀。前缀键本身可以换,配置文件[keys]里写prefix = "ctrl+a"即可(完整语法见 configuration 文档)。
不碰鼠标扫遍全部工作区:navigate 模式免鼠标漫游
什么时候进:想一眼巡视多个工作区里哪个 Agent 在blocked等你的时候。terminal 模式里按prefix+w直接进。
进去干嘛:这就是 Herdr 的常驻导航面,vim 手感:
| 动作 | 按键 |
|---|---|
| 面板左 / 右 | h/l(方向键是永久别名) |
| 面板上 / 下 | k/j |
| 工作区上 / 下 | up/down |
| 退出,回 terminal | Esc |
方向键挪焦点时模式不会掉,可以连续移动不用反复进。这些键位对应navigate_pane_*、navigate_workspace_*系列配置项,默认值写在 src/config/model.rs。
怎么回来:Esc一键退出,焦点回到刚才的面板。
三种模式如何切换:一张表看清闭环
| 从 | 按键 | 到 |
|---|---|---|
| terminal | ctrl+b(再按动作键) | prefix |
| prefix | w | navigate |
| navigate | Esc | terminal |
| prefix | q | 断开(Agent 继续跑) |
四个出口连成一个圈,来回切换成本很低。
三个容易忽略的细节坑
- 📌新会话和老会话落点不同:全新会话默认落在 navigate 模式,让你先认认门;恢复的历史会话则直接进 terminal 模式。
- navigate 里的
q只管退出:这个键是专用于断开连接的,不当通用取消键用,弹窗场景下不会误触退出。 - 左右方向键在 navigate 里是硬别名:它俩永远等价于左右切面板,配置里改不掉,只能靠
h/l换别的键。
动手清单:三步把三种模式摸熟
- 在项目目录跑
herdr,新会话会直接落在 navigate 模式,按hjkl逛一圈,Esc回 terminal; ctrl+b再按c建一个标签页,ctrl+b再按v分屏;- 最后
prefix+q断开,重新跑herdr连回来——面板里的 Agent 一行没丢,这就是"关掉终端、Agent 还在跑"的常驻特性。
想继续深挖:
- 键盘与键位完整参考
- 配置与快捷键语法
- 工作区、标签页、面板概念
【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考