dsh-on-phone
在手机上使用电脑里的 DeepSeek Harness。
电脑和手机都装好 Tailscale、登录同一个账号，用手机浏览器打开电脑的地址即可。除了 Tailscale，两边不用再装任何东西 —— 没有专用 App、没有二维码、没有登录页。
特性 · 快速开始 · 不适合谁 · 安全 · 排障 · 更新记录 · English
特性
- 同一个 DSH，两个屏幕 — 会话列表、工作区、消息记录、你选的模型，两台设备上是同一份；一边发出的消息，另一边立刻可见。界面就是电脑上那个界面本身，只是按钮、抽屉和输入框被改成了适合手指的尺寸。
- 数据留在你自己的链路里 — 两台设备之间直连点对点，插件不设账号体系、不引入任何中转服务，也不上传任何内容。访问权由你自己的 Tailscale 私有网络决定。
- 电脑不限系统，手机不限机型 — 电脑端支持 macOS、Windows 与 Linux；手机端 iOS 与 Android 一致，只需要一个能打开网页的浏览器。
- 启用即用，手机端零配置 — 在 DSH 面板点一下启用，把地址复制到手机浏览器即可。不需要配对、不需要在手机上登录任何账号，也不需要在手机上安装第二个应用。
快速开始
1 · 让电脑和手机进入同一张 tailnet
这一步装的是 Tailscale 官方的连网工具，和本插件不是一回事。
电脑 —— 装桌面版并登录。
手机 —— 从 App Store 或 Google Play 安装，用同一个账号登录，然后打开开关把连接连上：iOS 首次会弹「Tailscale 想要添加 VPN 配置」，要允许；Android 首次会请求允许建立 VPN 连接。手机上显示已连接，才算准备好。
手机上如果配过自定义 DNS（NextDNS、AdGuard 这类），要把它改回「自动」，否则后面打不开插件的地址。改法见 排障手册。
两台设备都连上后，设备列表里应该能互相看到。用不同账号的话，在 Machines 里把电脑节点 Share 给对方。
2 · 打开 tailnet 上的两个开关
管理后台的 DNS 页面，两个都要开：
| 开关 | 不开会怎样 |
|---|---|
| MagicDNS | 手机解析不了电脑的地址，页面打不开。 |
| HTTPS Certificates | 拿不到 HTTPS 证书，启用远程访问会失败。失败时面板只给一句笼统提示，不会告诉你是这项没开 —— 遇到莫名其妙的启用失败，先回来看它。 |
3 · 在电脑上安装插件
两种装法，选一种：
1. npm 安装（推荐）
dsh plugin --profile web add dsh-on-phone@latest
Desktop 用不上命令，在 添加插件 里填包名 dsh-on-phone 即可。
2. 源码安装（想改代码或锁定某个提交时用；需要 Node ^22.19.0 || >=24.0.0）
git clone https://github.com/JauLukNgai/dsh-on-phone.git && cd dsh-on-phone
npm ci && npm run build && npm pack
最后一条命令会打印出 dsh-on-phone-<版本>.tgz 的完整路径。
不管你选哪种，接着按你用的是哪个 DSH 走：
DSH Desktop —— 侧栏打开 插件 → 添加插件：npm 安装填包名 dsh-on-phone，源码安装填上面那个 tgz 的完整路径。点 安装，装完点 立即启用。Desktop 的插件由它自己管，命令行装不了 —— dsh plugin --profile desktop 会被直接拒绝。
DSH CLI —— npm 安装用第一条命令；源码安装就先 cd dsh-on-phone，然后：
dsh plugin --profile web add "$PWD/$(ls -1 dsh-on-phone-*.tgz | sort -V | tail -1)"
web 是 dsh web 用的 profile；你如果跑的是别的 profile，把名字换掉。
插件不会自动更新，得先卸再装：Desktop 在插件面板里打开 dsh-on-phone、点 卸载，再按上面选的那种装法装一次（npm 装法填包名，源码装法添新版本的 tgz）；CLI 用 dsh plugin --profile web remove dsh-on-phone 再 add。
同一个版本重复安装会被跳过，卸载后再装一次即可。
装完如果面板里没出现，完全退出再打开 DSH —— 插件运行在宿主里，不能热替换。
4 · 在电脑上启用远程访问
在 DSH 左下角打开 移动访问 面板，点 启用远程访问。面板上会出现一个专属网址（一串以 .ts.net 结尾的地址）—— 点 复制地址 把它发到手机上。
5 · 在手机上打开
用手机浏览器打开那个地址，就是你电脑上这个 DSH。
电脑上的 DSH 要一直开着：手机连的是电脑上正在运行的那个它。以后每次用，手机上保持 Tailscale 已连接即可。
面板上的 诊断 会跑一遍自检并给出可复制的报告，重新连接 用于连接出问题时重来一次。这两个按钮只在电脑上能用，手机上碰不到。
什么时候不适合用这个
- 手机装不了 Tailscale —— 手机和电脑必须在同一张 tailnet 里。
- 要的是随时随地公网访问 —— 它走的是私有网络，不是公网隧道；
Funnel和端口转发都被明确禁止 —— 那会让访问控制失效。 - 想让别人用手机访问你的电脑 —— 能打开地址的设备被视为完全可信的操作者，可以读配置、跑工具；所以它只适合你自己的设备。
- 无法常开电脑 —— 手机连的是电脑上正在运行的那个 DSH。
- 用 DSH Web 的会话分享把链接发给别人 —— 那个链接在手机上也打得开，但这条通道只服务你 tailnet 里的设备。
安全
- 只有你 tailnet 里的设备能访问。 请只把可信设备加入 tailnet。
- 不要开 Tailscale Funnel，也不要用端口转发把它暴露到公网 —— 那会让访问控制失效。不用时关掉面板上的开关。
- 已知限制：DSH 自身的页面安全策略允许内联脚本。这个风险不由本插件引入，也无法在这一层消除。
完整威胁模型见 SECURITY.md。
排障
完整的排障手册在 TROUBLESHOOTING.md。最常见的三种：
- 手机打不开地址 — 确认手机 Tailscale 在运行、和电脑同一账号，且打开的是面板上那个地址（不是
localhost）；再回快速开始第 2 步检查那两个开关。Tailscale 明明连着、用 IP 也通，只有域名打不开的话，是手机上的 DNS 设置，见手册 §4。 - 面板显示就绪但地址打不开 — 先点 重新连接；若提示端口被占用，说明电脑上 443 已被别的服务（例如你自己配的另一个
tailscale serve）占着，见手册 §4。 - 页面排版乱了 — 地址后临时加
?frontend=stock可加载 DSH 原生页面，用来判断问题出在哪一层。
支持哪些 DSH 版本
已验证 0.1.0-rc.5 到 0.2.0-rc.2 这一段的预发布版本，完整清单见 package.json 的 peerDependencies。安装成功却「没有任何反应」，通常就是撞上了版本门禁，见排障。
参与贡献
欢迎 Issue 与 PR，见 CONTRIBUTING.md。
卸载
Desktop 用户在插件面板里打开 dsh-on-phone 点 卸载；命令行用户：
dsh plugin --profile web remove dsh-on-phone # 只卸载插件
dsh plugin --profile web exec dsh-on-phone purge --yes # 连同 $DSH_HOME/mobile-access/ 一起清理
purge 会把 $DSH_HOME/mobile-access/ 整个删掉（配置、自定义 CSS/JS、扩展都在里面）。Desktop 上卸载后想一并清干净，手动删掉这个目录即可。
许可与致谢
Apache-2.0，详见 LICENSE。项目最初 fork 自 dsh-mobile，此后宿主与客户端实现已重写；远程通道建立在 Tailscale Serve 之上。
No comments yet. Be the first to write one.