DeepSeek Harness（DSH）採用插件化架構，dsh-remote/plugin 是其宿主插件。它解決的核心問題是：如何在不通過複雜網絡配置的情況下，利用手機對本地運行的 DSH 進程進行遠程指令下發、流式輸出查看、審批工具調用以及直接回答問題。
本插件運行在 DSH 進程內部，負責與中繼建立連接、管理會話與命令、轉發審批請求，並在狀態欄顯示配對入口。
核心功能¶
插件主要提供以下能力：
1. 遠程操作：在手機上遠程操作 DeepSeek Harness。
2. 指令下發與交互：下發指令，查看流式輸出，直接回答問題。
3. 審批轉發：將宿主的工具調用審批請求轉發至手機端。
4. 主機喚醒：在任務跑完前保持主機喚醒，防止休眠。
5. 安全通信：載荷級端到端加密，中繼只傳輸加密數據；支持零知識中繼。
安裝與啓用¶
插件通過 dsh plugin 命令安裝到指定的 profile 中。安裝後必須重啓 Harness 才能生效，因爲 HMR（熱模塊替換）僅更新配置文件，不會重新加載核心代碼。
安裝命令如下：
dsh plugin --profile web add @dsh-remote/plugin
桌面端用戶需將 --profile web 替換爲 --profile desktop。
安裝完成後，必須重啓 Harness 進程。
生態與使用流程¶
本插件是 DSH 遠控生態的主推組件，需要配合其他組件使用：
* 中繼：提供 WebSocket 通信通道。
* 官方小程序：微信小程序“黑鯨遠控”，用於掃碼配對、會話管理和交互。
配對流程：
1. 在主機 DSH 狀態欄會出現一顆 pill（膠囊）圖標。
2. 打開微信小程序“黑鯨遠控”。
3. 掃描狀態欄的二維碼。
4. 配對二維碼裏的地址來自主機側配置的 serverUrl，小程序無需手動填寫地址。
配置與注意事項¶
安裝方式¶
推薦從 npm 安裝：
dsh plugin --profile web add @dsh-remote/plugin
開發者也可從源碼構建安裝：
pnpm install
pnpm build
node scripts/install-to-profile.mjs
注意：從源碼安裝會創建軟鏈，此時使用 dsh plugin add 安裝會報錯，兩種方式不要混用。
安全設計¶
插件遵循嚴格的安全設計：
* 零知識：插件配置中只包含 hostTokenEnv（環境變量名），不存儲 token 明文。中繼只傳輸加密載荷，密鑰在配對階段通過二維碼傳遞。
* 權限控制：憑據落盤權限設置爲 0600，確保只有宿主進程可讀寫。
* 審批流程：審批必須真的過 waterfall，僅參與宿主 approval/request 的請求才會到達手機；approval/asked|decided 僅作爲審計事件。
結語¶
該插件通過零知識中繼和端到端加密，在提供遠程控制便利性的同時保證了安全性。對於需要在移動端管理或干預 DSH 任務的開發者，這是一個直接的解決方案。
源碼與文檔見：GitHub。
