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.1.6-alpha.2
• 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