DeepSeek Harness Mobile Pairing 插件使用指南

前言¶

DeepSeek Harness（DSH）採用插件化架構。在開發或調試智能體應用時，移動端設備往往需要通過 WebRTC 或加密隧道與本地 Host 建立連接。noirbright/dsh-mobile-pairing 是一個 DSH Host 側插件，用於管理移動設備的配對流程、生成連接入口以及提供 WebRTC Direct 與加密 Tunnel Fallback 能力。

插件概述¶

該插件由 NOirBRight 維護，開源協議爲 MIT。它作爲 DSH Host 的一個組件運行，主要解決以下問題：

提供統一的配對管理界面。
通過 Host Gateway 提供信令與加密 Tunnel 入口。
支持通過二維碼或 Deep Link 將移動端接入 DSH 環境。

核心功能¶

DSH Host 插件：作爲 Host 側組件，提供配對服務。
配對管理：管理已配對的設備狀態。
Host Gateway：提供本地迴環地址供移動端連接。
WebRTC Direct：支持點對點直連。
加密 Tunnel Fallback：在直連不可用時提供加密隧道。
QR 二維碼鑄造：生成配對用的二維碼（主要針對 Android）。
Device Token 持續有效：首配簽發的 Token 在 Host 撤銷前持續有效。

安裝¶

在終端中執行以下命令，安裝最新版本（v0.1.22）：

dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-mobile-pairing/releases/download/v0.1.22/dsh-mobile-pairing-0.1.22.tgz

安裝完成後，需要在 DSH 的配置文件中啓用該插件。

配置與使用¶

GUI 配置路徑¶

打開 DSH 客戶端。
進入設置 → 插件 → 插件配置 → DSH Mobile。
在展開的卡片中，可以查看當前的 Public Endpoint 和 Host Identity。
刷新二維碼：點擊刷新按鈕會立即鑄造一個新的 offer，有效期 5 分鐘。
設備管理：點擊“打開完整設備管理”可查看設備列表、刷新既有設備的二維碼或執行撤銷操作。

配置文件設置¶

在插件的配置文件中，需要指定 Host Gateway 的綁定地址和端口，以及 DSH Host 的連接信息。

默認配置面向日常 :3080 profile：

- id: dsh-mobile-pairing
  config:
    dshHost: 127.0.0.1
    dshPort: 3080
    gatewayBind: 127.0.0.1
    gatewayPort: 0

如果是 Lab profile，建議將 dshPort 設置爲 3082。

移動端接入¶

Android QR：掃描 GUI 中生成的二維碼。
Deep Link：Android 設備可直接通過 dsh-mobile://pair 打開配對頁面。

技術細節與注意事項¶

Host Gateway 限制¶

Host Gateway 僅監聽迴環地址（127.0.0.1），不提供瀏覽器 Shell。這意味着 Gateway 本身不暴露給公網，但可以通過配置的 Public Endpoint（如 Quick Tunnel 或自定義 Endpoint）將此有界的 Gateway 暴露給移動端。

QR 二維碼與 Token 機制¶

二維碼中的 offer 有效期爲 5 分鐘。
刷新二維碼會生成新的 offer，舊的將失效。
首次配對成功後，簽發的 Device Token 會持續有效，直到在 Host 側執行撤銷操作。

進程與依賴¶

嚴禁多進程共享 DSH_HOME：不要啓動第二個共享同一 DSH_HOME 目錄的 DSH 進程來承載本插件，這可能導致衝突。
依賴說明：該插件依賴 @dsh-mobile/e2e-tunnel 庫（版本 >= 0.1.6），安裝時需確保該依賴已滿足。

參考資源¶

插件目錄：https://www.skillhub.cn/plugins/NOirBRight/dsh-mobile-pairing
源碼倉庫：https://github.com/NOirBRight/dsh-mobile-pairing