dsh-tui-herdr

August 28, 2026 · View on GitHub

dsh-TUI 插件：把 dsh-TUI 的生命周期状态实时上报给 Herdr 多路复用器——在 herdr 侧边栏直接看到 dsh-TUI 是 working / blocked / done，和 Claude Code、Kimi 等官方支持的 agent 同等待遇。

原理

Herdr 对新 agent 的原生检测需要二进制更新，但官方提供了自定义上报 API（herdr pane report-agent），并为每个 pane 注入 HERDR_PANE_ID。本插件在 dsh-TUI 运行于 herdr pane 内时自动激活，通过会话事件上报：

dsh 事件	herdr 状态
`turn/start`	`working`
`approval/asked`	`blocked`（等待人工审批）
`approval/resolved`	`working`
`turn/end`	`done`

不在 herdr 内运行（HERDR_PANE_ID 未设置）时插件自动休眠，零开销。上报全部 fire-and-forget，herdr 不可用不会拖垮宿主。

安装

# 暂未发布到 npm。下载仓库内打包好的 tgz（浏览器打开保存，或 curl -LO）：
#   https://github.com/FUSU123fusu/dsh-tui-herdr/raw/main/dsh-tui-herdr-0.1.0.tgz
# 然后本地安装（路径换成实际下载位置）：
dsh plugin --profile dsh-tui add file:C:\path\to\dsh-tui-herdr-0.1.0.tgz

需要 herdr CLI 在 PATH 中。

使用

装好即用。在 herdr pane 里启动 dsh-tui，侧边栏即出现 dsh-tui 的状态行。

/herdr — 查看 pane id、上报来源与状态映射
/herdr ping — 发送一条测试上报（state=idle）

只上报顶层会话事件；子代理（subagent）会话不产生上报，与官方 web 端行为一致。

原理

安装

使用

相关