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