dsh-mobile-plugin:通过出站 Relay 从手机访问本地 DeepSeek Harness Web UI

DeepSeek Harness 允许在本地运行 Web UI 进行智能体开发。默认情况下,本地服务仅限于电脑。要在手机上访问这些界面,需要网络穿透或特定的网络配置。DSH 插件生态系统提供了一种机制,使本地服务可以通过出站 Relay 连接对配对的手机可见。

插件信息

  • 名称:april-jk/dsh-mobile-plugin
  • 维护者:april-jk
  • 许可证:MIT
  • 核心价值:通过出站 Relay 连接从配对手机访问本地 DSH Web UI。

安装

此插件通过 npm 仓库或 GitHub Release 安装。建议使用 GitHub 标签以保证完整性。

  1. 运行以下命令安装插件(以 web 配置为例):
    npx @deepseek-ai/dsh plugin --profile web add "github:april-jk/dsh-mobile-plugin#v0.1.9"
  1. 启动 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"

配对手机

安装后,需要在手机上建立连接。

  1. 在本地 DSH Web UI 中进入 Settings > Remote Access。
  2. 使用 iPhone 相机或手机端的 DSH Mobile 应用扫描屏幕上的二维码。
  3. 注意:二维码的 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 进程的权限运行,安装前请检查源码与许可证。

参考

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜