手机远程访问april-jk/dsh-mobile-plugin

DSH Mobile Remote

通过只建立出站连接的 Relay，让已配对手机远程访问电脑本地的 DeepSeek Harness Web UI。

DeepSeek Harness 插件投稿项目： 本插件已向 DeepSeek Harness 官方插件仓库提交，并已发布到官方社区的插件展示区。

完整项目、已签名 Android APK 和 Relay 私有部署包： DSH Mobile Suite

DeepSeek Harness 中的 DSH Mobile Remote 设置页

兼容性

当前版本已针对 @deepseek-ai/dsh@0.1.0-rc.6 完成测试。DeepSeek Harness 仍处于 Developer Preview，可能引入破坏性插件变更。CI 固定该版本，以便明确发现兼容性变化。

环境要求：

- Node.js 18 或更高版本
- DeepSeek Harness 0.1.0-rc.6
- 一台安装 DSH Mobile 应用的手机
- 能够通过 HTTPS 访问所配置的 Relay

安装

推荐通过不可变的 GitHub Tag 公开安装。该方式不要求全局安装 DSH，也不需要本地插件目录：

npx @deepseek-ai/dsh plugin --profile web add "github:april-jk/dsh-mobile-plugin#v0.1.9"
npx @deepseek-ai/dsh web

每个 GitHub Release 也包含预构建 .tgz。DSH 可以直接从 Release URL 安装，不需要手动下载或填写本地路径：

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"
npx @deepseek-ai/dsh web

包元数据已经为 npm 准备好，但 @april-jk/dsh-mobile 目前尚未发布到公共 npm Registry。完成首次 npm 发布后，安装命令将是：

npx @deepseek-ai/dsh plugin --profile web add "@april-jk/dsh-mobile@"
npx @deepseek-ai/dsh web

卸载命令：

npx @deepseek-ai/dsh plugin --profile web remove @april-jk/dsh-mobile

本地开发时，克隆仓库并让 Shell 自动传入当前目录：

git clone https://github.com/april-jk/dsh-mobile-plugin.git
cd dsh-mobile-plugin
npm ci
npm run build
npx @deepseek-ai/dsh plugin --profile web add "$PWD"
npx @deepseek-ai/dsh web

配对手机

在本机 DSH Web UI 中打开 Settings > Remote Access，使用 iPhone 相机或移动应用扫描二维码。新二维码会直接打开 Relay 浏览器客户端；一次性配对码和端到端加密密钥位于 URL fragment 中，不会随页面请求发送给 Relay。仅输入六位配对码不足以完成安全配对。后续启动 DSH 时，会复用保存在 ~/.dsh-remote/config.json 中的设备凭据；该文件仅允许当前用户读取。

同一设置页可以移除配对。移除操作会撤销 Relay 设备凭据、断开正在进行的远程访问，并且只在 Relay 确认后清除本地凭据。Web UI 不可用时，可以执行 dsh-mobile unpair 完成相同操作。

网络和数据行为

- DSH 始终监听 127.0.0.1:3080；插件不会创建公网监听端口。
- 电脑默认向 https://relay.dshmobile.online 建立出站 WSS 连接。启动 DSH 前设置 DSH_RELAY 可以使用其他兼容 Relay。
- HTTP、SSE 和 WebSocket 载荷由移动应用和本 Companion 使用 AES-256-GCM 进行端到端加密。Relay 只转发密封帧，TLS 额外保护传输中的连接元数据。
- 0.1.9 使用二维码预置的共享密钥，不提供前向保密。如果二维码或任一端点可能泄露，请解除配对后重新配对。
- 插件将 Relay 设备 Token 保存在本机 ~/.dsh-remote/config.json，不会把该 Token 发送给移动端。
- Relay 为访问时间线记录受限的手机元数据和访问时间，但不会持久化 DSH 请求体或响应体。
- 安装本 Bundle 后会禁用 DSH 原生目录选择器，改用浏览器目录选择器，使远程浏览器无需打开 Finder 或其他原生对话框即可选择目录。

使用私有 Relay 时，电脑端必须指向移动应用中配置的同一 HTTPS Origin：

DSH_RELAY=https://relay.example.com npx @deepseek-ai/dsh web

独立命令

后备 CLI 安装为 dsh-mobile，支持 start、pair、status、check-update、update 和 unpair。DSH 设置页会定期检查项目 Release；发现新版本时，可以在运行 DSH 的电脑上点击“一键更新”。更新完成后需要重启 DSH 才会加载新插件。更新请求只允许本机发起，并固定使用 DSH Mobile 插件仓库的合法版本 Tag。

开发

npm ci
npm run build
npm test
npm pack --dry-run

仓库有意提交 dist/，确保从 GitHub 安装时无需执行生命周期脚本即可获得完整插件。CI 会在 Node.js 18、20 和 22 上执行构建、测试、产物新鲜度检查及 npm 打包检查，并针对固定版本的 DSH Developer Preview 验证安装兼容性。

发布时需要同步更新 package.json 与 package-lock.json、重新构建 dist/，然后推送与 v 完全一致的 Tag。Tag 工作流会重复所有发布检查，再创建不可变的 GitHub Release，并上传预构建 npm tarball 与 SHA256SUMS。重跑仅在已有资产集合及两个资产的内容完全一致时成功，且绝不会覆盖已有资产。Tag 与包版本不一致时，会在上传任何产物前失败。

npm 发布默认关闭。仓库维护者可以将 Actions 变量 NPM_PUBLISH_ENABLED 设置为 true，并添加拥有 @april-jk/dsh-mobile 发布权限的 NPM_TOKEN Actions Secret 来显式启用。缺少任一设置时，GitHub Release 仍会正常发布，工作流不会尝试 npm 发布。

官方社区投稿

仓库使用 dsh-plugin 和 deepseek-harness GitHub Topic。项目已发布到官方插件 Discussion 分类，标题为：

DSH | DSH Mobile Remote | Access your local DSH Web UI from a paired phone

可直接发布的项目介绍维护在 docs/SHOW-YOUR-PLUGIN.md。

许可证

MIT