DeepSeek Harness 允許在本地運行 Web UI 進行智能體開發。默認情況下,本地服務僅限於電腦。要在手機上訪問這些界面,需要網絡穿透或特定的網絡配置。DSH 插件生態系統提供了一種機制,使本地服務可以通過出站 Relay 連接對配對的手機可見。
插件信息¶
- 名稱:
april-jk/dsh-mobile-plugin - 維護者:april-jk
- 許可證:MIT
- 核心價值:通過出站 Relay 連接從配對手機訪問本地 DSH Web UI。
安裝¶
此插件通過 npm 倉庫或 GitHub Release 安裝。建議使用 GitHub 標籤以保證完整性。
- 運行以下命令安裝插件(以 web 配置爲例):
npx @deepseek-ai/dsh plugin --profile web add "github:april-jk/dsh-mobile-plugin#v0.1.9"
- 啓動 DeepSeek Harness Web:
npx @deepseek-ai/dsh web
也可以直接從 GitHub Release 下載 .tgz 包安裝:
npx @deepseek-ai/dsh plugin --profile web add "https://github.com/april-jk/dsh-mobile-plugin/releases/download/v0.1.9/april-jk-dsh-mobile-0.1.9.tgz"
配對手機¶
安裝後,需要在手機上建立連接。
- 在本地 DSH Web UI 中進入 Settings > Remote Access。
- 使用 iPhone 相機或手機端的 DSH Mobile 應用掃描屏幕上的二維碼。
- 注意:二維碼的 URL 片段中包含一次性代碼和加密密鑰,這比單純的 6 位數字更安全。如果二維碼失效或設備可能被泄露,應重新配對。
移除配對可以通過 Web UI 的設置頁面,或在 Web UI 不可用時使用命令行工具 dsh-mobile unpair。
網絡與數據行爲¶
- 連接模式:DSH 進程綁定在
127.0.0.1:3080,插件不會創建公共監聽器。電腦主動發起出站連接到 Relay 服務器(默認https://relay.dshmobile.online)。 - 加密:HTTP、SSE 和 WebSocket 負載在移動端 Companion 和本地插件之間使用 AES-256-GCM 進行端到端加密。Relay 服務器僅轉發密封幀。
- 令牌存儲:Relay 設備令牌存儲在本地文件
~/.dsh-remote/config.json中,不會發送給手機客戶端。 - 數據記錄:Relay 服務器會記錄綁定的手機元數據和訪問時間,但不持久化 DSH 的請求或響應體。
專用命令行工具¶
安裝後,dsh-mobile 命令會作爲備用 CLI 工具可用。支持以下操作:
dsh-mobile start:啓動連接dsh-mobile pair:配對設備dsh-mobile unpair:取消配對dsh-mobile status:查看狀態dsh-mobile check-update/update:檢查並更新插件(本地操作)
注意事項¶
- 環境要求:需要 Node.js 18 或更新版本,DeepSeek Harness 版本爲
0.1.0-rc.6。 - 安全性:版本 0.1.9 使用 QR 預配置的預共享密鑰,不提供前向保密。如果二維碼或端點可能已被泄露,請立即取消配對並重新配對。
- 私有 Relay:如果需要使用私有 Relay 服務器,需在啓動 DSH 時設置環境變量
DSH_RELAY。 - 權限:插件以當前 DSH 進程的權限運行,安裝前請檢查源碼與許可證。