Herdr 状态面板 haoliangwu/dsh-herdr

dsh-herdr

一个插件，把你的 dsh 会话显示在 Herdr 的智能体面板里——带实时 idle / working / blocked 状态，让你在 Herdr 里任何位置都能看到 dsh 正在做什么，以及它什么时候卡住等你的批准。它说的是 Herdr 自家集成（opencode、pi、omp）用的同一套 pane-socket 协议，所以 Herdr 这边零配置。

Herdr 智能体面板中的 dsh

- 极小。 打包后约 5 KB（gzip 后 1.7 KB），零依赖——编译产物只用到 Node 的 net 和 fs。
- 零配置。 用的是 Herdr 内置集成已经在用的 JSON-lines pane socket API；不需要 Herdr 配置，不需要额外守护进程。
- 状态对人友好。 只上报 pane 的根智能体，所以子代理的频繁变动不会刷屏面板；待批准的请求会显示为 blocked，并附上原因。
- 绝不阻塞 dsh。 上报是发后即忘，重试 3 次，超时 3 s——Herdr 不在或正在重启，也拖不住你的智能体。
- 重启后依然有效。 上报序号用墙上时钟做种子，所以重启后的 dsh 不会被当成过期数据丢掉。
- 自己收拾干净。 退出时——包括 Ctrl+C——插件会同步释放自己的 pane 权限，不会留下幽灵 dsh 行。

示例

在 Herdr pane 里运行 dsh，面板就会跟着你的会话走：

$ dsh --profile tui # inside a Herdr pane
panel: dsh ● idle
$ you: "deploy the api" # agent starts working
panel: dsh ● working
$ bash tool asks for approval # panel: dsh ● blocked — waiting for approval: bash
$ you approve # panel: dsh ● working

快速上手

前置条件： dsh-TUI >= 0.8.5，带 tui 配置档，以及一个用来跑 dsh 的 Herdr pane。

1. add the plugin to your tui profile
dsh plugin --profile tui add /path/to/dsh-herdr

2. restart dsh inside a Herdr pane
3. open Herdr's agent panel — dsh appears with a live status

依赖： 这个插件是为 @deepseek-harness-tui/dsh-tui >= 0.8.5 构建的，在 Herdr pane 之外（或使用其他配置档时）严格不产生任何操作。

卸载时，把该包从配置档的 dsh.profile.bundles 列表里移除即可。

工作原理

Herdr pane 里的进程会继承 HERDR_ENV、HERDR_PANE_ID、HERDR_BIN_PATH 和 HERDR_SOCKET_PATH。插件用 JSON-lines 请求（pane.report_agent、pane.release_agent）跟本地 Herdr socket 通信——和 Herdr 内置集成用的是同一套协议。

只上报 pane 的根智能体：

| dsh 信号 | Herdr 状态 |
| 插件启动 | idle |
| agent/status → running | working |
| agent/status → idle | idle |
| 会话事件 approval/asked | blocked |
| 会话事件 approval/decided | 先前状态 |

只要会话存在，每份报告都会带上 dsh 会话 id（agent_session_id）；退出时插件释放生命周期权限（pane.release_agent），同步刷写，因此即使强制退出也能送达 Herdr。

Herdr 只接受某个来源的报告，前提是它们的 seq 严格递增，过期的报告会被静默丢弃。上报器在启动时用墙上时钟为每个来源播种序列，因此重启后的 dsh 绝不会低于前一个进程已经用过的序列。

开发

bun install # dev deps (types only)
bun run typecheck # tsc --noEmit
bun run build # bundle to dist/ (reinstall the profile after changes)
bun run smoke # fake-Herdr-socket end-to-end test