前言¶

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 倉庫。