dsh-herdr

已迁移（2026-10-19）：本仓库已归档，只读。后续开发与发布都在 Lbryany/dsh-plugins/packages/dsh-herdr。 Moved (2026-10-19): this repository is archived; development and releases continue at Lbryany/dsh-plugins/packages/dsh-herdr.

dsh-herdr

DeepSeek Harness 的 Herdr 状态集成插件。插件运行在承载 DSH Agent 的进程内部，把该进程中的 root agent 与子 agent 聚合成当前 Herdr pane 的语义状态。

状态映射

插件监听 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