前言¶

在 DeepSeek Harness（DSH）裏做帶終端、帶工作區的智能體會話時，往往需要一套「控制面」：能看 Herdr 是否在跑、能否連上控制 socket、能否從 Web 側拉起會話。上游 NAMEWTA/dsh-plugin-herdr（npm @namewta/dsh-plugin-herdr）已經提供 19 個 herdr_* 工具、Web 儀表盤和 Herdr 會話預設；在原生 Windows 主機上，傳輸方式、進程探測和安裝指引與 Linux/macOS 並不相同。capxh73/dsh-plugin-herdr-win 是在上游 0.0.3 基線上的 Windows 適配 fork，面向在同一臺 Windows x64/arm64 上同時跑 DSH 與 Herdr 的場景。

這是什麼¶

Herdr control-plane plugin for DeepSeek Harness：觀察並驅動 Herdr，包含 herdr_* 工具、會話預設與 Web 面板。維護者 capxh73 在 contributors 中標註爲 native Windows adaptation；倉庫 MIT 許可，保留上游版權。SkillHub 分類爲「客戶端」。

與上游的主要差異（見 README 與 COMPATIBILITY.md）：named-pipe 傳輸、基於 tasklist 的進程探測、Windows 環境變量白名單、PowerShell/CMD 安裝指引，以及平臺中性的工具/技能文案。fork 僅發佈編譯產物（lib/），完整構建流水線在上游倉庫。

環境與版本¶

插件 0.0.3 要求 Node 24+，DSH 爲 0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2 或 0.2.1-rc.3。DSH 插件安裝器還要求 pnpm 在 PATH 中。Herdr 與插件須在同一主機運行；原生 Windows 通過 Herdr 的 named-pipe 控制 socket 支持，WSL 在兩側同發行版內仍可用。基線爲 Herdr 0.9.0 / protocol 22；文檔記載曾在 Herdr 0.9.3 / protocol 22 上於真實 Windows 與 WSL 相鄰環境驗證。

Herdr 0.9.0 / protocol 22 與官方安裝器可能裝到更新版本時，面板會警告而非宣稱完全兼容。

核心功能¶

• 19 個 herdr_* 工具：在 DSH 會話中觀察、驅動 Herdr（具體工具名以插件 manifest 爲準）。
• Web 儀表盤：DSH Web 側欄 Herdr 入口；可爲對話選擇 Herdr mode 專用工作區。
• 安裝與環境面板：Herdr → Installation & settings，或 Settings → Built-in plugins → Herdr environment。可執行文件缺失時自動打開安裝指引；會話服務器橫幅也可進入同一面板。
• 連接與檢查：Check environment / test connection 檢查的是 DSH Host（非瀏覽器所在 OS）：平臺/架構、Herdr 可執行文件與版本、npm/pnpm、配置的 socket 與終端能力。檢查不安裝軟件、不啓動終端、不改配置。
• 只讀連接項：運行中可見 terminalSession.binPath / HERDR_BIN_PATH、socketPath / HERDR_SOCKET_PATH、session / HERDR_SESSION；修改需改插件配置或啓動環境並重啓 DSH。

Windows Host 上面板展示官方 PowerShell 安裝器及 cmd.exe 回退，以及 npm 與 PATH 步驟；Linux/macOS 仍顯示上游安裝方式。面板不會自動安裝、停止、升級或替換已在運行的軟件；可從 PATH 啓動 Herdr 二進制（含 ~/.local/bin 等發現邏輯）。

安裝 DSH 與 pnpm¶

資料中 pinned 的可復現默認下載版本如下（2026-10-11 時 npm latest/next 爲 0.2.0-rc.2，alpha 爲 0.2.1-alpha.2；npx @deepseek-ai/dsh web 不一定等於 GitHub 最新預發佈）：

npm install --global pnpm@10.28.2
npm install --global @deepseek-ai/dsh@0.2.0-rc.2
# 或顯式使用 alpha：
# npm install --global @deepseek-ai/dsh@0.2.1-alpha.2
dsh --version
pnpm --version

安裝預構建插件¶

從 GitHub Releases 下載 namewta-dsh-plugin-herdr-0.0.3.tgz 與 SHA256SUMS（上游 CI 通過後發佈；同名包也可在成功 ci 運行的 herdr-plugin-package artifact 中獲取）。不要直接把未構建的 Git 檢出當作插件安裝（無 lib/）；GitHub 源碼歸檔也不是預構建 tarball。npm 發佈與上述 tarball 流程分離，registry 的 latest 可能仍指向較舊插件版本。

# 在包含 tgz 與校驗文件的目錄執行
sha256sum --check SHA256SUMS
dsh plugin --profile web add /absolute/path/namewta-dsh-plugin-herdr-0.0.3.tgz
dsh plugin --profile web list
dsh web

安裝或替換包後，若 Web profile 已在運行需重啓。也可在 DSH 插件安裝 UI 中選擇同一 tarball。打開側欄 Herdr 查看儀表盤；Herdr 本體須已安裝並在需要時運行。

卸載同一 profile 中的包：

dsh plugin --profile web remove @namewta/dsh-plugin-herdr

重啓 profile 以卸載工具、面板與運行時註冊的預設。

典型用法¶

1. 在 Host 上按面板所示安裝 Herdr（Windows 用 PowerShell/CMD 指引；命令複製到 Host 終端，勿按瀏覽器 OS 選錯腳本）。
2. 在 Installation & settings 中 Check environment / test connection，確認 socket、會話與二進制路徑。
3. 若需啓動服務，在面板中 Start（僅針對預期實例；插件不會停止或替換已有服務器）。
4. 在 DSH Web 中選 Herdr mode 開啓專用工作區，通過 herdr_* 工具與會話驅動任務。

瀏覽器在 Windows、Host 在 Linux 時，安裝命令必須以 Host 系統爲準。

適用場景與注意¶

• 適合：在原生 Windows（或文檔所述 WSL 同 distro 佈局）上跑 DSH Web profile，並希望通過統一面板管理 Herdr 連接與會話預設的開發者。
• 不適合期望：安裝插件即自動裝好 Herdr 或常駐服務——插件只提供控制面與管理 UI；0.0.3 起纔有完整管理屏，通過包名從 npm 解析可能得到更舊的 0.0.2。
• 權限與安全：插件隨當前 DSH 進程權限運行；安裝前應閱讀 capxh73/dsh-plugin-herdr-win 源碼與 LICENSE。故障排查勿清空 profile、憑證或工作區；勿分享 API key、認證 URL 或完整環境 dump。
• 生態：DSH 採用「一切皆插件」思路；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

故障排查要點¶

• 找不到可執行文件：按面板顯示的 Host 系統執行命令；若顯式 HERDR_BIN_PATH 無效，需修正 override，而非再裝一個會被 override 隱藏的二進制。
• 已安裝但未連接：覈對 socket 與 session；Start 僅用於預期服務器。
• 檢查/啓動失敗：根據 Host 返回的本地化錯誤修正路徑或權限後重試。

仍失敗時，記錄完整錯誤、Host OS、DSH/插件/Herdr 版本及失敗操作後再提 issue。

結尾¶

capxh73/dsh-plugin-herdr-win 把上游 Herdr 控制面插件落到原生 Windows：named-pipe、tasklist 探測與 PowerShell/CMD 安裝路徑與 DSH Web 側欄、環境檢查面板一致。目錄與倉庫：

• https://www.skillhub.cn/plugins/capxh73/dsh-plugin-herdr-win
• https://github.com/capxh73/dsh-plugin-herdr-win