DeepSeek Harness (DSH) 的核心設計理念是插件化，這讓開發者可以靈活擴展工具鏈。Herdr 是一個專爲 AI 編碼代理設計的終端工作區管理器。要在 DSH 會話中直接控制 Herdr，需要解決如何通過 DSH 的控制平面與 Herdr 的 Unix 域套接字通信的問題。dsh-plugin-herdr 插件提供了這套控制平面能力。
插件定位¶
這是一個 Herdr 控制平面插件，由 sunny0826 維護，遵循 MIT 許可證。它運行在 DSH 之上，通過本地 Herdr 服務器的 Unix 域套接字提供 19 個 herdr_* 工具，支持快照、管理代理、窗格、工作區、佈局和通知等操作。
核心功能¶
控制平面工具¶
插件通過 Unix 域套接字暴露 19 個 herdr_* 工具，覆蓋 Herdr 的核心操作，包括快照、代理管理、窗格操作、工作區控制、佈局調整和通知查看。
會話作用域 UI¶
Herdr 的標籤頁和側邊欄界面是會話隔離的。在非 Herdr 模式下這些 UI 元素隱藏；在 Herdr 模式下，它們僅顯示當前會話的 workspace。
Herdr 模式¶
DSH 支持創建 Herdr 模式會話。這種模式下會獲得一個專用的 workspace，該 workspace 會隨着會話的創建和銷燬而存在和消失。
安裝與啓用¶
安裝前請確保已安裝 DSH 並擁有一個配置文件（例如 web），且 Herdr 服務器正在運行。
- 使用 npm 安裝：
dsh plugin --profile web add dsh-plugin-herdr
- 從本地目錄安裝：
dsh plugin --profile web add /path/to/dsh-plugin-herdr
- 從 tarball 安裝：
pnpm pack
dsh plugin --profile web add ./dsh-plugin-herdr-*.tgz
- 從 Git 安裝：
dsh plugin --profile web add github:sunny0826/dsh-plugin-herdr
安裝完成後，重啓配置文件以加載工具和 UI。驗證安裝狀態：
dsh plugin --profile web list
卸載¶
如需移除插件：
dsh plugin --profile web remove dsh-plugin-herdr
再次重啓配置文件以卸載工具、面板和 Herdr 模式。注意，插件會在 $DSH_HOME/.agent-presets/herdr/ 留下一份預設副本，如有需要請手動刪除。
注意事項¶
該插件以當前 DSH 進程的權限運行。在安裝或使用前，建議檢查源碼和許可證。插件通過本地 Unix 域套接字與 Herdr 通信；如果 Herdr 服務器未啓動，面板可以嘗試從 PATH 啓動它。
