dsh-herdr
DeepSeek Harness 的 Herdr 状态集成插件。插件运行在承载 DSH Agent 的进程内部，把该进程中的 root agent 与子 agent 聚合成当前 Herdr pane 的语义状态。
状态映射
| DSH 进程状态 | Herdr 状态 |
|---|
| 任一 agent 有未处理审批 | blocked |
| 无待审批，任一 agent 正在运行 | working |
| 存在 agent，且全部空闲 | idle |
| 最后一个 agent 已销毁或插件卸载 | release-agent |
插件监听 agent/created、agent/status、agent/disposed 和 session/event。恢复已有会话时会折叠历史中的 approval/asked / approval/decided，避免重启后丢失待审批状态。
前置要求
- DeepSeek Harness
0.2.1-rc.2 及之后的 0.2.x（engines.dsh：>=0.2.1-rc.2 <0.3.0-0；0.2.0 及更早版本请用 0.1.x 的 release）
- Node.js
22.19+ 或 24+
- Herdr 管理的 pane（进程环境包含
HERDR_ENV=1 与 HERDR_PANE_ID）
插件优先通过 HERDR_SOCKET_PATH 建立持久 NDJSON 连接；Unix 使用 domain socket，Windows 使用 named pipe。连接、超时或协议失败时，当前报告自动回退到 HERDR_BIN_PATH 指定的 Herdr CLI，后续状态变化会重新尝试 socket。未运行在 Herdr pane 内时自动禁用，不影响 DSH。
本地构建与安装
npm install
npm run check
npm pack --ignore-scripts
dsh plugin --profile headless add ./lbryany-dsh-herdr-0.1.3.tgz
dsh headless "your task"
DSH 0.1.6-alpha.2 不再内置 tui profile。请将插件安装到实际承载 Agent 的同一 profile；上例使用 headless，使用其他内置或自定义 profile 时请同时替换安装和启动命令中的 profile 名称。
如果使用长期运行的 Web profile，也可以安装后从 Herdr pane 启动：
dsh plugin --profile web add ./lbryany-dsh-herdr-0.1.3.tgz
dsh web --no-open
发布到 GitHub 后可直接安装：
dsh plugin --profile headless add github:Lbryany/dsh-herdr
验证
在 Herdr pane 内启动已安装插件的 DSH profile，然后从另一个 pane 查看：
herdr agent list
DSH 开始处理消息时应显示 working，等待工具审批时显示 blocked，完成后显示 idle 或 Herdr 根据可见性派生的 done。
设计说明
- 状态报告通过进程内队列串行执行，并使用跨进程递增的 epoch 微秒
seq；同一 pane 重启 DSH 后不会从 1 重新计数，也不会被 Herdr 当成旧报告忽略。
- 同一 DSH 进程复用一条 socket 连接，不为每次状态变化启动 Herdr 子进程。
- Socket 请求默认 3 秒超时；失败时回退 CLI，两条路径都失败才记录警告，不阻塞 DSH agent。
- 多个 DSH profile 进程分别继承自己的
HERDR_PANE_ID，无需跨进程协调。
License
MIT
