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 进程的权限运行,安装前请检查源码与许可证。