企业官网建设流程全解析

Herdr 三种键盘模式 10 分钟上手：编程 Agent 终端工作区管理器完整速查指南

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

Herdr 是一款面向编程 Agent 的终端工作区管理器，它把 Claude Code、Codex、Cursor 等编程 Agent 关进常驻的终端面板里持续运行。新手最容易卡住的，就是 terminal、prefix、navigate 这三种键盘模式——它们其实只是三条"按键归谁管"的规则。花 10 分钟读完这篇指南，你就能自由切换三种模式，并建立自己的按键习惯。

Herdr 到底是什么：让编程 Agent 常驻的"机房"

想象这个场景：Claude Code 在重构一个模块，Codex 在跑测试，Cursor 停在等你确认的界面上。这几个任务要并行跑几个小时，而终端窗口不能关。

Herdr 就是为这个场景做的终端工作区管理器（runtime）：每个 Agent 被放进一块持久化的终端面板，侧边栏还能汇总各个 Agent 的状态。核心卖点一句话——断开连接后，后台服务器和所有 Agent 继续运行。关闭终端窗口只断开前端，不杀掉任务。完整的工作区、标签页、面板、Agent 概念，见官方 Concepts 文档。

首次运行体验：从 herdr 启动到断开重连

还没装的话，按 Install 文档装好，然后在任意项目目录执行一行命令：

herdr

这条命令会启动或接入你的默认后台会话，不需要自己管理 socket。

第一次进入时，留意两个默认行为：全新会话默认落在 navigate 模式，恢复的历史会话则直接回到 terminal 模式。原因很直白——新用户先总览一遍布局，老用户心里有数，直接回到上次干活的位置。

首次体验可以一口气跑完：启动后在 navigate 模式里用h/j/k/l扫过各个面板、标签页和工作区，按Esc退出；再按ctrl+b试一下c（新建标签页）和v（分屏）；最后按prefix+q断开，重新运行herdr接回同一个会话。完整步骤可对照 Quick Start。

💡 断开不等于终止：重连后，你上次看到的一切原样都在。

三种模式一张图看懂：你的按键去哪了

不逐个模式分开讲，只问一个问题：此刻我按的键，归谁处理？

两个点值得说透：

• prefix 机制借鉴了 tmux 的前缀键思路：终端里的程序已经用掉了大部分按键组合，所以 Herdr 只接管一个前缀键，你按下它之后的下一个键才被当作指令，这样不会破坏 shell 和编辑器。
• terminal 模式完全不拦截按键；navigate 则是一个常驻的导航面板，不是按一下就关掉的临时弹窗。

高频按键速查：按任务来查

按键不按模式分，而按"你想干什么"分。下面是日常高频部分：

🧭 navigate 里左右方向键被永久保留为左右移动，方向键会保持模式激活，可以连续挪焦点。另外q在 navigate 中专用于退出，避免弹窗里误触。

键位支持产品内实时查询：随时按prefix+?就能看到所有激活的绑定。完整键位表与语法见官方 Keyboard 文档。

按你的习惯选主力：三类用户各记 2~3 个键

🎯 不必全都会，按习惯选主力组合：

纯鼠标党。Herdr 天生鼠标原生：点面板、拖分屏边框、右键菜单都可用。你可以整个流程都留在 terminal 模式，点着鼠标完成一切，只需记住prefix+q断开这一个键；想瞄一眼键位再补prefix+?。

tmux 老手。前缀机制是老朋友，把 prefix 模式当主力即可，背下 2~3 个高频动作：prefix+c新标签页、prefix+v分屏、prefix+w开导航，其余靠旧手感。

多 Agent 监工流。把 navigate 模式当"总览台"：j/k扫一遍各工作区，看哪个 Agent 卡在blocked，再按Esc回到 terminal 模式处理。只需记住h/j/k/l和Esc。

常见问题 FAQ：前缀键、断开重连、鼠标开关

问：我按了 ctrl+c，怎么没到 Agent？terminal 模式下ctrl+c会直接发给面板里的进程，Herdr 不拦。唯一被"拿走"的是前缀键本身（默认ctrl+b）；如果你刚按完前缀键，下一个键会被 Herdr 当作指令解释。

问：前缀键怎么改？在配置文件的[keys]段写prefix = "ctrl+a"，新的前缀立即生效。

问：关掉终端后，Agent 还在跑吗？在。服务器持有面板和进程状态，断开只切断前端。真要停掉整个会话，执行herdr server stop。

问：navigate 里方向键能用吗？能。左右方向键永久保留为左右移动，up/down切换工作区，方向键还会保持模式激活，连续移动不用反复进入。

问：鼠标能不能关掉？能。配置[ui]段写mouse_capture = false即可停止鼠标捕获，键盘本来就是可选层。

进阶配置入口与延伸阅读

常用调整集中在四处：

所有默认键位定义在 src/config/model.rs，调键位时对照着改。

三种模式归根结底是一条规则：terminal 是"打字给 Agent"，prefix 是"下指令给 Herdr"，navigate 是"看全局"。现在就去试一次：按prefix+q断开、关掉终端，再运行herdr接回去，看看后台还在跑的 Agent 原封不动地等着你。

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