前言¶

DeepSeek Harness (DSH) 的理念是“一切皆插件”。在使用 Herdr 多路复用器管理多个 Agent 会话时，如果能在侧边栏直接看到 dsh-TUI 的当前状态（working / blocked / done），可以大幅提升任务追踪的直观性。dsh-tui-herdr 插件将 dsh-TUI 的生命周期状态实时同步给 Herdr，使其获得与 Claude Code、Kimi 等官方 Agent 同样的可视化待遇。

核心功能¶

• 状态实时上报：将 dsh-TUI 的生命周期事件实时推送到 Herdr。
• 侧边栏展示：在 Herdr 侧边栏直接显示当前状态（working / blocked / done）。
• 自动激活/休眠：检测 HERDR_PANE_ID，在 herdr pane 内自动激活，否则自动休眠，零开销。
• Fire-and-forget 模式：上报不依赖 Herdr 连接，Herdr 不可用不会拖垮宿主。

安装¶

该插件暂未发布到 npm，需要下载仓库内打包好的 tgz 文件进行本地安装。

1. 下载 tgz 文件（浏览器打开保存，或使用 curl -LO）：
   https://github.com/FUSU123fusu/dsh-tui-herdr/raw/main/dsh-tui-herdr-0.1.0.tgz
2. 执行安装命令（替换为实际下载路径）：

   dsh plugin --profile dsh-tui add file:C:\path\to\dsh-tui-herdr-0.1.0.tgz

安装前请确保 herdr CLI 在系统 PATH 中。

使用¶

装好即用。在 herdr pane 中启动 dsh-tui，侧边栏即可看到对应的状态行。

• /herdr：查看当前 pane id、上报来源与状态映射关系。
• /herdr ping：发送一条测试上报，state 为 idle。

原理与限制¶

Herdr 对新 agent 的原生检测需要二进制更新，本插件利用官方提供的自定义上报 API (herdr pane report-agent) 实现。当检测到环境变量 HERDR_PANE_ID 时，插件监听 dsh 事件并上报：

• turn/start：状态变为 working
• approval/asked：状态变为 blocked
• approval/resolved：状态变为 working
• turn/end：状态变为 done

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

注意事项¶

• 需要她的 CLI 在 PATH 中。
• 暂未发布到 npm，需下载仓库内打包好的 tgz 文件安装。
• 只上报顶层会话事件；子代理（subagent）会话不产生上报，与官方 web 端行为一致。

结语¶

该插件解决了在 Herdr 中追踪 dsh-TUI 会话状态的痛点，实现了可视化的生命周期管理。更多细节请参考 GitHub 仓库。