前言¶
DeepSeek Harness (dsh) 採用“一切皆插件”的設計理念。本地安裝和更新插件通常需要執行命令行操作。dsh-link-plugin 允許本地運行的 dsh 實例通過 WebSocket 網關主動連接到 dsh 社區網站。這使得瀏覽器可以作爲控制端，遠程管理本地插件、查看商店註冊表，並支持在斷網環境下瀏覽可安裝條目。
核心功能¶
- 安全連接本機運行的 DeepSeek Harness (dsh) 到 dsh 社區網站。
- 從瀏覽器遠程安裝插件。
- 查看商店註冊表。
- 支持離線瀏覽可安裝條目。
安裝與啓用¶
在 dsh 的 profile 中執行以下命令安裝插件：
dsh plugin --profile web add "github:qwert702/dsh-link-plugin#main"
安裝後，插件會出現在 dsh Web UI 的插件設置中。
配置¶
在 dsh Web UI 的插件設置裏，需要填寫以下字段：
| 字段 | 說明 |
|---|---|
serverUrl |
WebSocket 服務器地址，默認爲 wss://dsh.cbnac.com/ws/harness |
pairingCode |
一次性配對碼，用於首次連接驗證 |
profile |
要管理的 profile，默認爲 web |
requireConfirm |
收到安裝指令時是否確認（當前無交互確認 UI，默認自動接受） |
autoStart |
啓動 dsh 時是否自動連接 |
首次連接成功後，插件會將 token 與 deviceId 持久化到 ~/.dsh/src-state-link.json，斷線重連時會自動恢復。
配對流程¶
- 在 dsh.cbnac.com/console 登錄並點擊「生成配對碼」。
- 在 dsh-link-plugin 設置裏填入
serverUrl、pairingCode和profile，保存配置。 - 插件會自動嘗試連接並完成握手。此時返回控制台，即可看到設備上線及已安裝插件列表。
- 在插件詳情頁點擊「遠程安裝」，選擇設備，本機會執行安裝指令，控制台顯示進度。
安全模型¶
該插件通過嚴格的校驗機制保障本地環境安全：
- 白名單安裝：安裝源
spec必須是商店註冊表中approved/manual的行，本地會進行二次校驗。 - 拒絕危險輸入：
./、../、file:、link:以及含&&;|空格/引號等字符的指令一律被攔截。 - 令牌安全：設備令牌在服務器只存 SHA256 哈希；指令僅設備所有者可下發；鏈路經 TLS (wss) 加密。
- 瞭解風險：安裝一個插件會運行其構建腳本 (prepare)。安裝前請檢查源碼與許可證。
離線瀏覽¶
插件連接服務器時會緩存一份註冊表。如果 5 秒內重複拉取，服務器會跳過請求並沿用舊緩存。即使斷網，在 dsh Web UI 中也能看到可安裝條目。
結尾¶
dsh-link-plugin 爲 DSH 提供了遠程管理能力，適合需要在 Web 端批量管理插件或通過瀏覽器控制本機 dsh 實例的場景。該插件遵循 MIT 許可證，由社區開發者維護。
