前言¶
DeepSeek Harness (DSH) 採用插件化架構，開發者通常在本地運行 DSH Web 界面進行調試和交互。在移動設備上直接訪問本地服務存在端口暴露風險或網絡配置問題。DSH Remote 旨在通過一個插件，爲 DSH Web 提供安全、可控的遠程訪問能力。
插件介紹¶
xiaoxiaohai/dsh-remote（NPM 包名 @musitoolbox/dsh-remote）是一個爲 DSH Web 提供手機訪問能力的插件。它不改變 DSH 的核心邏輯，而是通過在 macOS 上啓動受管的 FRPC 進程，配合二維碼配對機制，將本地 DSH Web 接口橋接到遠程網絡。該插件默認處於 Beta 狀態，需要用戶明確授權才能生效。
核心功能¶
該插件提供以下核心能力：
- Explicit Opt-in（明確授權）： 安裝插件不會自動註冊或開啓隧道。只有用戶在本地設置中手動啓用後，代理纔會建立。
- 本地設置卡片： 在 DSH Web 的設置界面中添加“手機訪問”卡片。支持通過二維碼配對、暫停訪問、旋轉密鑰以及針對單臺設備的撤銷授權。
- 複用現有接口： 直接複用 DSH Web 的 HTTP 和 WebSocket 接口，無需開發額外的協議或應用層組件。
- 受管傳輸層： 使用受管 FRPC 0.70.1 傳輸層，並將流量嚴格限制在本地 DSH Web 端口。
- 模型可見 Skill： 插件註冊了一個
remote-accessSkill。智能體在處理“遠程訪問”、“配對”等意圖時，可以利用該 Skill 獲取本地設置的步驟說明，而無需具備感知外部網絡的能力。 - 自託管覆蓋： 支持通過配置覆蓋
serviceUrl，允許部署兼容的自託管服務。
安裝與啓用¶
插件安裝及啓用流程如下：
- 安裝插件：
dsh plugin --profile web add @musitoolbox/dsh-remote@beta
- 檢查配置：
安裝後，使用以下命令確認配置生效：
dsh --profile web --dump-config
確保輸出中包含 `dsh-remote` 配置行，且 `enabled: false`、`autoStart: false`。
- 啓動 Web 服務：
dsh web
- 首次連接：
- 在 Mac 上打開 DSH Web。
- 進入 Settings → Phone access。
- 點擊 Enable phone access。這一步會在本地註冊 Mac 並寫入憑證。
- 使用手機上的 DSH Web 掃描屏幕上的二維碼。
- 在設置頁面確認手機出現在 Authorized phones 列表中。
典型用法¶
- 更新插件：
dsh plugin --profile web update @musitoolbox/dsh-remote@beta
- 移除插件：
在移除前，請先在設置頁面撤銷手機授權或暫停訪問，然後執行：
dsh plugin --profile web remove @musitoolbox/dsh-remote
適用場景與注意¶
- 運行環境： 僅支持 macOS（
darwin-x64和darwin-arm64），不支持 Windows 和 Linux。 - 依賴版本： 需要 Node.js 22+ 及 DSH 0.1.0-rc.8+。
- Beta 限制： 目前處於 Beta 階段，尚未提供通用可用性 (GA) 保證。
- 安全與隱私：
- 託管服務使用 TLS 加密傳輸，但不提供應用層端到端加密。這意味着託管服務的運營商可以查看通過網關轉發的 DSH Web 流量。
- 管理接口 (RPC) 僅限本地迴環訪問。
- 託管服務無 SLA、數據保留策略、賬號恢復或身份刪除功能。
- UI 狀態： 設置卡片目前爲中文界面，英文 UI 尚未完成。
- 源碼驗證： 由於插件以 DSH 進程的權限運行，建議在安裝前檢查源碼與許可證。
總結¶
DSH Remote 解決了在移動端無縫訪問本地 DSH Web 界面的痛點。通過 QR 配對和受管的 FRPC 隧道，它在不破壞 DSH 插件化架構的前提下，爲開發者提供了可控的遠程調試手段。在使用前，請務必確認其對隱私模型（無端到端加密）的接受程度。
