前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展其功能。在管理多 agent 工作流时，精确跟踪 root agent 与子 agent 的生命周期状态是关键。lbryany/dsh-herdr 插件解决了这个问题，将 DSH 进程内部的 agent 状态聚合为 Herdr pane 的语义状态。
插件介绍¶
插件名：lbryany/dsh-herdr
维护者：Lbryany
功能：DeepSeek Harness Herdr 状态集成。
定位：该插件运行在 DSH TUI 进程内部，把该进程中的 root agent 与子 agent 聚合成当前 Herdr pane 的语义状态。
核心功能¶
状态映射¶
插件将 DSH 进程状态映射为 Herdr 状态：
| DSH 进程状态 | Herdr 状态 |
|---|---|
| 任一 agent 有未处理审批 | blocked |
| 无待审批，任一 agent 正在运行 | working |
| 存在 agent，且全部空闲 | idle |
| 最后一个 agent 已销毁或插件卸载 | release-agent |
状态监听与持久化¶
插件监听以下事件：agent/created、agent/status、agent/disposed 和 session/event。通过持久 NDJSON 连接（HERDR_SOCKET_PATH）与 Herdr 通信，支持会话恢复时折叠历史审批状态，避免重启后丢失待审批信息。
状态报告机制¶
状态报告通过进程内队列串行执行，并使用 epoch 微秒 seq 进行计数。同一 pane 重启 DSH 后不会从 1 重新计数，确保 Herdr 能正确识别新报告。
安装与启用¶
在安装前，请确保环境满足以下要求：
- DeepSeek Harness 0.1.0-rc.6
- Node.js 22.19+ 或 24+
- Herdr 管理的 pane（进程环境包含 HERDR_ENV=1 与 HERDR_PANE_ID）
安装命令如下：
dsh plugin --profile tui add github:Lbryany/dsh-herdr
安装完成后，在 Herdr pane 内启动 DSH TUI。
典型用法¶
- 在 Herdr pane 内启动 DSH TUI。
- 通过另一个 pane 执行
herdr agent list查看状态。 - 观察 DSH 处理消息显示
working，等待工具审批显示blocked，完成后显示idle或 Herdr 根据可见性派生的done。
设计细节¶
- 连接策略：插件优先通过
HERDR_SOCKET_PATH建立 Unix domain socket 或 Windows named pipe 连接。连接、超时或协议失败时，自动回退到HERDR_BIN_PATH指定的 Herdr CLI。 - 进程复用：同一 DSH 进程复用一条 socket 连接，不为每次状态变化启动 Herdr 子进程。
- 权限：插件以当前 dsh 进程权限运行，未运行在 Herdr pane 内时自动禁用。
适用场景与注意¶
适合需要将 DSH agent 状态实时同步到 Herdr 仪表盘的开发者。安装前建议检查源码与许可证（MIT）。
