随身远程控制 afeack/dsh-mobile-harness

DSH Mobile Harness

把电脑上的 DeepSeek Harness，装进你的手机。
扫码即连 · 浏览器就能用（App 可选）· 四条网络入口 · 设备逐台准入

面板：一个开关 + 三张卡

电脑端面板：一个总开关——连接 / 网络入口 / 设备准入。

下载：插件（电脑端）→ npm 或 离线包 1.0.2；手机 App（Android，可选）→ v1.0.0 APK。两者分开发布，版本各自独立。

功能

给 DSH 加上远程控制功能。只用浏览器，扫码就能体验随身携带的 DSH。
如果你不满足于网页版的体验，可以下载我们的 APK，安卓客户端会持续更新。
担心别人连上你的电脑？不用怕：首次授权确认 + 设备管理 + 随机密码，三重保护你的连接安全。
- 我们提供四种远程方式，适合不同人群：
- ①cloudflare（免注册、免费、最省事，代价是每次重启 DSH 都要重新扫码登录）
- ②外部隧道（内网穿透，需注册、可能付费、需实名，好处是最稳定，重启 DSH 后保留原来的登录，不用再扫码）
- ③Tailscale（手机和电脑都要装额外软件，数据走境外服务器，延迟高，不推荐，需注册）
- ④LAN（适合局域网范围，稳定但距离有限）

| 部分 | 是什么 | 必需吗 |
| 插件 | 在 DSH 里加一页「远程访问」：网关、密码、二维码、隧道、设备准入 | 必需 |
| App | 4 MB 的 Android 壳：相机扫码、记住密码、下载落盘 | 可选（只有 Android） |

手机不一定需要 App。 用浏览器（最好用 chrome）扫一下面板上的二维码、确认一次，就能接着用电脑上的同一个 DSH。

iPhone / iPad、鸿蒙不装 App 也行：浏览器打开同一个网址即可，还能「添加到主屏幕」当 PWA。

不是另开一个账号，是同一台电脑、同一个会话：上下文、工具、文件都还是电脑上那份。

安全

- 网关只监听 127.0.0.1，不监听 0.0.0.0、不做端口映射。
- 三层准入：密码 → 6 位配对码两端核对 → 设备白名单。
- 扫码不等于放行：扫完落地的是等待页，页面上那串配对码要和你电脑面板上的一致，点了「允许」才真正进站。
- 移除 = 立刻断开 + 撤销信任，下次要重新配对；拉黑 = 永久拒绝。
- 诊断包是白名单字段，不含密码、session、设备 token。细节见 SECURITY.md。

快速开始

0. 你需要

- 一台跑着 DSH 的电脑（Windows / macOS / Linux；本项目在 Windows 11 上开发与实测）
- DSH ≥ 0.2.1-rc.3，Node ≥ 22
- 一个浏览器（手机、平板、另一台电脑都行）；想用相机扫码再准备一台 Android 8.0+

1. 装插件

方式 A：npm（最快）

dsh plugin --profile desktop add dsh-mobile-harness

方式 B：一键脚本（从仓库）

git clone https://github.com/afeack/dsh-mobile-harness.git
cd dsh-mobile-harness
node scripts/install-plugin.mjs --profile desktop # 换成你的 profile 名字
cd ~/.dsh/profiles/desktop && pnpm install

脚本会往 profile 的 package.json 里写一条依赖和一个 bundle 条目，重复跑是幂等的。

方式 C：手动改 profile

profile 在 ~/.dsh/profiles/<名字>（Windows 是 %USERPROFILE%\.dsh\profiles\<名字>），改两处：

{
"dependencies": {
"dsh-mobile-harness": "^1.0.2"
},
"dsh": { "profile": { "bundles": ["...", "dsh-mobile-harness"] } }
}

dsh.profile.bundles 里必须有包名，否则 DSH 不会去加载它。改完在 profile 目录里 pnpm install。

方式 D：离线 tgz 从 插件 1.0.2 release 下载 dsh-mobile-harness-1.0.2.tgz（内容和 npm 包一致），解压到 <profile>/node_modules/dsh-mobile-harness/，再把 dsh-mobile-harness 写进 dsh.profile.bundles；或者执行 pnpm add file:./dsh-mobile-harness-1.0.2.tgz。内网 / 连不上 npm 时用这条。

2. 重启 DSH

退出托盘图标，重新打开。会话侧栏会出现「远程」入口，点进去是「远程访问」面板。

3. 选择你的方式、打开开关

面板右上角把总开关打开，再选一个网络入口（见下一节），拿到网址。

4. 手机接入

A. 浏览器（先试这个）

1. 手机浏览器打开面板上的网址，或者直接扫面板上的二维码。
2. 浏览器停在等待页，页面上有一串 6 位配对码。
3. 电脑面板「设备准入」里出现同一串数字 —— 核对一致，点「允许」，再点「数字一致，允许」。
4. 手机上自动进站，之后直接刷新就能继续用。

B. 装 App（可选）

1. 装 App 1.0.0 release 里的 dsh-mobile-harness-1.0.0.apk（或仓库里的 app/dist/dsh-mobile-harness-1.0.0.apk）。iOS / 鸿蒙没有 App，用浏览器即可。
2. 打开 App → 相机扫码（或从相册选图）→ 同样核对 6 位配对码。
3. 勾「记住地址和密码」，以后换地址也能自动填。

四个入口怎么选

| 入口 | 推荐度 | 要准备什么 | 说明 |
| SakuraFrp / 任意外部隧道 | ✅ 推荐 | 已有一条 frp 隧道，填外网地址（如 https://frp-cat.com:12345/） | 地址稳定，延迟低；「自动检测」会去读 SakuraFrp 的运行日志 |
| Cloudflare 快速隧道 | ✅ 推荐（零准备） | 什么都不用 | 免账号、一键建隧道；地址每次重启都变，换地址要重新扫码；首次要下约 50 MB 的 cloudflared |
| 仅本机 | ✅ 局域网内 | 手机和电脑同一个 Wi-Fi | 最安全，出了局域网连不上 |
| Tailscale | ⚠️ 不推荐 | 两端都装 Tailscale、登录同一账号 | 能穿透 NAT，但流量常走 DERP 中继，延迟明显偏高；只在内网直连（同一局域网 / 同一 VPC）时才顺 |

为什么 Tailscale 排最后：它解决的是「没有公网入口也能连上」，代价是节点绕行——手机到电脑可能先绕到境外中继再回来，打字、翻页都能感觉到卡。有公网入口就用外部隧道，没有就开 Cloudflare；Tailscale 留给「内网直连 + 不想开公网」的场景。

第一次接入建议先用「仅本机」把扫码和配对码跑通，再切到公网入口。

常见问题

一定要装 App 吗？ 不用。浏览器扫码就能用，App 只是把相机扫码、密码记忆、下载落盘这几件事做得更顺。

手机上一直转圈 / 打不开？ 先确认入口选对了，地址带不带尾斜杠都试试；公网入口要等隧道状态变成「已连接」。自签证书（64702 端口）第一次会提示不受信任，点「高级 → 继续前往」。

扫码后停在「等待同意」？ 这是设计。去电脑面板「设备准入」，核对那串 6 位数字，一致再点「允许」。

忘了网关密码？ 面板上「重置密码」。重置后所有已连接设备都要重新输密码。

面板里找不到「远程」？ 插件没装好或 DSH 没重启。检查 profile 的 package.json 里有没有依赖和 bundle 条目，然后重启。

Cloudflare 下载失败？ 插件会依次试 8 个地址（官方 + 7 个镜像），全都不通才会报错。三条退路，任选一条：

1. 自己的镜像：设环境变量 DSH_CLOUDFLARED_URL 指向你能连的地址，下次点下载会先试它。
2. 手动放置：下载 cloudflared-windows-amd64.exe，改名 cloudflared.exe，放到 ~/.dsh/remote-access/bin/（Windows 是 C:\Users\<你>\.dsh\remote-access\bin\），面板会显示「程序已就绪」。
3. 本来就有：只要 PATH 里能找到 cloudflared，插件直接用它，不再下载。

下载卡住时面板上有「停止下载」；下坏了（文件损坏、下到一半）用「删除」（点两次确认），删掉重下即可。

电脑重启后手机连不上了？ Cloudflare 快速隧道每次重启都会换地址，重新扫码即可；外部隧道和 Tailscale 的地址是稳定的。

能同时连几台？ 「在线上限」控制，默认 3，0 表示不限。同一台手机用不同浏览器或app开多个页面算多台。

密码、二维码会不会被写进日志？ 诊断包是白名单导出，不含密码与 token；面板上的二维码只含一次性票据，不含密码。

目录结构

plugins/dsh-mobile-harness/ 插件：网关、准入、二维码、隧道、面板 UI lib/proxy.js 网关（Cookie、会话、扫码票据、等待页） lib/registry.js 设备与信任、待同意队列、配对码 lib/service.js 开关、快照、诊断包 lib/cloudflared.js Cloudflare quick tunnel lib/tailscale.js Tailscale 探测 lib/phone-tool.js 手机协助（读屏 / 点按） lib/client.js 面板 UI（React） app/ Android 客户端（Capacitor 6，可选） www/index.html 登录页、扫码、手机协助 android/app/src/main/java/com/dsh/remote/ 原生桥、轮询、无障碍服务 scripts/install-plugin.mjs 安装脚本 assets/ README 截图

状态与路线图

- 1.0.0（2026-10-31）：四条入口、扫码 + 配对码、设备准入、下载钩子；浏览器与 App 两条路都能用。
- 手机协助（P2）：读屏、点按、输入、滚动、开 App 都已实现，但界面在 1.0 里默认隐藏，等验收后再放出来。需要系统无障碍服务；支付 / 银行 / 系统设置类界面一律拒绝。
- P3：通知、音量、勿扰、手电、亮度、深链打开 App。

致谢

- DeepSeek Harness：宿主。
- jsQR、Capacitor、cloudflared。

License

MIT。第三方组件许可见 THIRD-PARTY-NOTICES.md。

DSH Mobile Harness 把桌面端 DeepSeek Harness 会话带到手机上。DSH 插件加一个网关，带密码、一次性扫码票据、四条网络入口，以及按设备准入控制。

不用装 App。 任何浏览器都能扫码、输密码，接着用同一个桌面会话。4 MB 的 Android App 是可选的：相机扫码、记住密码、下载到手机。原生 App 目前只支持 Android —— iOS / iPadOS 和 HarmonyOS 上直接用内置浏览器（同一个网关、同一套准入控制，添加到主屏幕当 PWA 用）。

- 四条网络入口：外网隧道（SakuraFrp）和 Cloudflare 快速隧道推荐；局域网只适合本地用；Tailscale 能用，但通常走中继，延迟更高。
- 配对：密码 → 两端都显示 6 位码 → 设备白名单。光扫码本身不给访问权限。
- 准入控制：在线上限、等待队列、移除 / 拉黑设备、全部踢下线。

安装（插件）：

dsh plugin --profile desktop add dsh-mobile-harness
or from source:
git clone https://github.com/afeack/dsh-mobile-harness.git
cd dsh-mobile-harness
node scripts/install-plugin.mjs --profile desktop
cd ~/.dsh/profiles/desktop && pnpm install

下载按组件分开：插件 tarball 在 plugin-v1.0.2，APK 在 v1.0.0。License：MIT。把网关暴露到公网之前，先看 SECURITY.md。