🐑 AI 编程智能体的现代放牧工作台 · HERDR ARCHITECTURE

Herdr 深度图解：
告别在无数终端窗口里人肉巡逻，
像放牧羊群一样管理并行 AI Coding Agents！

当你同时运行 Claude Code、Codex 或自定义自动化智能体时，传统终端窗口会把你淹没在无尽的滚屏和误关风险中。开源项目 Herdr 带来了全新的解法：让智能体跑在与窗口解耦的独立 herdr-core 常驻进程中，通过极简的 OSC 7501 状态协议 主动亮灯汇报，更允许 AI 智能体自己动手修改工作台自身的代码与界面！

基于 Herdr 官方架构全景拆解：看懂 herdr-core 会话持久化、OSC 7501 终端转义序列汇报机制、多主机 SSH 侧边栏聚合、以及为什么“智能体可塑软件（Malleable App）”才是多 Agent 时代的终极形态。

🪟 传统终端与多窗口管理：人工逐个点检的疲劳巡逻

每个 Agent 占一个终端窗口或 tmux 窗格。必须肉眼去盯光标是在死等确认还是在写代码；手滑不小心把终端窗口关掉，正在改到一半的代码和进程当场随窗口一起暴毙。

窗口绑定进程生命周期状态靠人工肉眼滚屏多主机服务器割裂

🐑 Herdr 放牧工作台：结构化状态、后台长跑、Agent 可塑

智能体全部运行在独立的 herdr-core 守护进程中。关掉窗口电脑合盖它们照样跑；Agent 通过终端协议主动亮灯（工作中/等审批/搞定）；侧边栏统一纳管本地与云端 VPS，Agent 还能直接写 JS 改造 UI！

进程与界面彻底解耦开放状态协议（OSC 7501） AGENTS.md 界面自改造

💡 核心比喻：从“看守几十只乱跑的鸡”到“现代化数字放牧人（Herder）”
• 传统终端多开 就像在院子里养了二十只鸡：你得时刻竖着耳朵看哪只鸡卡在栅栏里了（等待命令行输入确认）；一旦暴风雨吹翻了鸡棚（关闭终端），所有鸡当场阵亡；
• Herdr 则是一整套“数字化牧羊领地”：
1. 无线电子耳标（OSC 7501）：每只羊在吃草（working）、吃完了（done）、还是被石头卡住要你拔一把（blocked/needs you），耳标自动在侧边栏对应标签亮红绿灯，你平时看书喝咖啡，亮红灯才过去处理；
2. 地下安全避风港（herdr-core）：羊圈直接建在地窖里，哪怕你把观察窗关上、甚至把显示器砸了，羊群在地下依然按部就班吃草干活；
3. 羊自己会搭栅栏（自修工作台）：羊群可以通过 AGENTS.md 读懂牧场的配置文件，你随口一句“在每个标签上加个计时器”，Agent 自己敲击代码把工作台 UI 给改了！

三大杀手级机制：Herdr 凭什么专为 AI Coding Agent 而生？

🔌

1. 界面与内核解耦：herdr-core 永不关机

Herdr 分为两个独立程序：前台渲染界面的 herdr-app 与负责真实驱动每一个 pty 终端的后台服务 herdr-core (hc)。即使软件崩溃、关闭窗口或版本更新，所有运行中的 Agent 和长任务都不会中断，重新打开瞬间原样呈现。

支持命令行通过 hc 控制、监控和接入任何终端会话，具备完善的 OpenRPC 接口。

🚦

2. 告别屏幕抓取：OSC 7501 状态协议

很多工具靠正则表达式分析屏幕文字来猜 Agent 状态，不仅脆弱而且极易误判。Herdr 联合生态定义了 OSC 7501 终端转义序列协议：Agent 只需输出一行特定字符即可宣告自身状态（working / blocked / done / idle），你的自定义 Shell 脚本也能一秒接入！

printf '\e]7501;state=blocked:app=my-script\e\'，原生零成本接入。

🛠️

3. 智能体可塑软件（Malleable App）：由 Agent 重塑自身

Herdr 的布局、标签、快捷键和主题全是以纯 JSON 与 JS 形式存放在 ~/.config/herdr-app 下。目录内置的 AGENTS.md 用自然语言向大模型解释了每一份配置的修改方式。你只需对 Agent 说需求，它便能自己写补丁扩展 UI 功能！

这是“软件被它所服务的目标本身修改”的先锋人机协作范式。

🧪 交互工作流探针

点一点：跟随 4 个核心场景，体验放牧多 Agent 的丝滑节奏

点击下方步骤，透视 Herdr 如何在后台管理庞大多智能体集群：

注：本探针严格基于 Herdr 官方架构设计与 AGENTS.md 规范构建。

深度拆解：为什么说 Herdr 代表了新一代研发环境的方向？

🧭

1. 空间（Space）与标签（Tab）的双层收纳

一个代码仓库对应一个独立的 Space，该仓库下的每个具体攻坚任务对应一个 Tab。标签与空间的状态会自动向上冒泡：整个空间显示所有 Agent 中最紧急的状态（Blocked > Done > Working > Idle），一目了然。

🖥️

2. 真正的真实 PTY 终端（No Sandboxing Trap）

不同于很多网页或被阉割的玩具环境，Herdr 提供的是原汁原味的原生虚拟终端（pty），所有 CLI 工具、Git、包管理器、底层编译器都能无障碍直接运行，完全保持开发者原生的开发环境与习惯。

🤝

3. 开放标准与纯粹开源（Apache 2.0）

客户端、herdr-core 与 Herdr TUI 全面开源，不仅杜绝被商业平台绑架，更鼓励生态基于 hc 核心命令行构建独立的移动端监控、编辑器插件甚至 Stream Deck 实体物理状态按钮。

传统多窗口开发 vs tmux 会话 vs Herdr 放牧工作台（Cheat Sheet）

机制维度	传统系统终端窗口多开	经典 tmux 终端复用器	Herdr 放牧型智能体工作台
进程生命周期	窗口关闭则进程全部强制终止	独立 server 守护，关闭终端后会话保活	基于 herdr-core 独立常驻，关窗、升级客户端零影响
智能体状态汇报	完全无感知，靠人工反复点击窗口检查	无原生协议，靠人工观察或第三方复杂正则	标准化 OSC 7501 状态协议，侧边栏与 Tab 自动亮灯
多服务器纳管	需在各个终端手动 SSH 登录并切目录	各自在远端跑独立的 tmux，无法统一聚合	本地侧边栏原生集成 SSH 远端主机，同套逻辑直接下发
界面与功能可塑性	固定界面，不可动态修改	可通过配置文件修改快捷键和主题	开放 AGENTS.md，Agent 可自主写 JS 插件扩展修改自身 UI

一句话带走

“在单兵作战时代，开发者需要的是一把趁手的螺丝刀（终端）；而在几十个 AI 智能体并行写代码的集群时代，开发者需要的是一套带有自动化对讲机与巡逻雷达的现代化牧场——Herdr 正是为这一浪潮而生的放牧总控台。”

让 AI 智能体在后台安静干活，在遇到瓶颈时准确呼唤你，并把修缮工作台本身的锤子交给它们，这正是人机协同最舒展的姿态。