lunaship/dsh-links

dsh-links

把 DeepSeek Harness 带到手机上
让运行在电脑、家中主机或远程服务器上的 DSH，拥有一个经过配对的原生 Android 入口。

Beta · 仅 Android · 可信局域网 · Relay 内测（需接入码） · 非官方

电脑继续运行 DSH、工具和工作区；手机负责查看会话、发送消息、接收实时事件和处理审批。

这是什么

这不是远程桌面，也不是把 DSH Web 页面塞进手机浏览器。DSH Links 将手机作为 DSH 的一个已配对客户端：电脑继续运行 DSH、工具和工作区；Android App 负责在手机上查看会话、发送消息、接收实时事件和处理审批。

| 组成 | 作用 | 发布方式 |
|---|---|---|
| 本仓库 dsh-links | DSH 插件、手机 HTTPS 接入代理、电脑端配对与设备管理面板；Relay 源码在 relay/ | 开源 npm 插件；Relay 源码同仓公开，使用仍需维护者接入码 |
| DSH Links Android App | 扫码/手动配对、设备入口、原生会话工作台、实时流与审批 | 私有源码；仅发布官方签名 APK |

Android App 能做什么

- 扫描电脑端二维码，或手动输入地址和一次性配对码添加 DSH。
- 保存多个已配对设备，显示连接状态，并可随时移除本机记录。
- 在原生工作台中浏览会话与历史、继续对话、查看工具/思考事件，并通过 SSE 接收实时更新。
- 在手机上处理 DSH 的审批请求；短暂断线（默认 30 秒内重连，且不超过原 5 分钟期限）仍可继续处理。超时未处理按「不可用」结束，该次工具调用失败，可重试。丢失设备时，可从电脑端立即吊销该设备。
- 系统通知只覆盖 App 仍能收到当前会话 SSE 时的本地提醒；进程被杀、锁屏推送和全会话后台通知尚未交付（渠道待定）。完整说明见 PRIVACY.md 与 docs/MOBILE_SYNC_CONTRACT.md。
- 使用手机本地加密保存配对 Token 与 TLS 证书指纹；App 禁用云备份和明文 HTTP。完整说明见 PRIVACY.md。

Android App 当前最低支持 Android 8.0（API 26）。源码不在本仓库；请只安装 GitHub Release 随版本号和 SHA-256 发布的官方签名 APK。

三步开始

1. 在运行 DSH 的电脑或服务器安装本插件，并启动 dsh web。
2. 打开「设置 → 手机连接」，使用二维码或当前 6 位配对码添加设备。
3. 在 Android App 选择已添加的 DSH，进入会话工作台；设备管理和吊销始终在电脑端可见。

局域网不需要接入码。远端 Relay 目前不是公开自助能力：只有拿到维护者发放的接入码，才能在「远端连接」里把电脑接入 Relay，并再扫第二张云端码。

最新界面截图

电脑端截图于 2026-08-30 从当时本地运行版本截取；二维码、配对码、主机名、内网地址和设备标识均已脱敏。Android 截图来自 0.5.0-beta.14 构建。当前发布 App 是 0.5.0-beta.16，界面未重拍。

电脑端手机连接与 Android 设备

电脑端手机连接：从当前 DSH Web 设置发起局域网配对。
Android 设备：查看多个已配对设备及其连接状态。

手机上的 DSH 工作台

原生工作台：在手机上继续会话、查看思考事件并发送消息。
工作区导航：切换设备、工作区、会话与设置。

Android App 设置

Beta 支持边界

此版本为 Android Beta。受支持的公开路径仍为可信局域网。
- 支持： Android 手机与 DSH 位于同一可信局域网。当前源码基线与已验证组合维护在
dsh-links/docs/COMPATIBILITY.md。
- 内测： DSH Links Relay。端到端远程配对已经过验证，但仍仅限邀请。接入码仅由维护者发放。本仓库、GitHub Releases 和 npm 包均不包含接入码、Relay 主机凭据或 state.json。
- 实验性，风险自负： 你自行运营的 Tailscale 或 Cloudflare Tunnel 路径。它不属于受支持的 Beta 路径，也不在安全或兼容性承诺的覆盖范围内。
- 不支持： 将端口 18640 直接暴露到公网，或使用 frp。公开自助 Relay 注册不可用。

Android APK 仅以官方签名版本分发。请核对该版本随附发布的版本号和 SHA-256；不要安装重新打包的 APK。本仓库包含插件、relay/ 下的 Relay 源码以及文档。Android 源码保留在私有仓库中。

安装

dsh plugin --profile web add dsh-links@
dsh web

开发期本地目录（本仓库根目录含 package.json）：

dsh plugin --profile web add /path/to/dsh-links

然后重启 dsh web，设置 →「手机连接」扫码或手动配对。扫码中的地址或手动填写的地址可以指向家中电脑或远程服务器上运行的 DSH；当前公开 Beta 正式支持同一可信局域网。跨网络可自管 Tailscale / Cloudflare Tunnel，或在持有维护者接入码的情况下使用内测 Relay。

当前源码基线、发布状态和已验证组合统一见
dsh-links/docs/COMPATIBILITY.md，本 README 不重复维护版本事实。

能力摘要

- 扫码 / 配对码 → 设备 token（x-dsh-link-token）；可选本机确认后才放行
- 0.0.0.0:18640 HTTPS 手机接入代理（面板展示监听地址与可达网段）
- /dsh-link/mobile/ 会话、SSE、审批、吊销；面板可一键吊销全部设备
- 局域网码与云端码分开：云端码只在电脑用接入码连上 Relay 之后出现

详情见 SECURITY.md、PRIVACY.md 与 REMOTE_ACCESS.md。

远端连接

公开 Beta 的正式支持范围仍是可信局域网。

- Tailscale / Cloudflare Tunnel / DSH Links Relay 说明
- 不要把 18640 直接做路由器端口转发。
- DSH Links Relay 正在内测。 电脑和手机都主动连接 Relay；Relay 只实时转发已配对设备的请求与响应，不持久化会话内容、文件、工作区或设备内容。没有维护者发放的接入码无法接入；请不要在 issue、截图或 PR 里张贴接入码。控制台「复制」给出可粘贴进插件的完整接入串（含主机）；自建不要只贴裸邀请码。云端二维码本身内含 Relay 路由凭据（routeSecret），与接入码同等敏感：请勿截图、录屏或投屏分享；怀疑泄露时到控制台吊销该 Host。插件「断开」只是暂停接入、保留凭据，可重连，不能当作作废。换到另一台 Relay 前插件会确认，并在新接入成功后尝试对原 Relay 发 REVOKE_SELF 以空出名额；原 Relay 不可达时仍提醒去原控制台吊销，若记得原控制台地址则可从插件打开。插件也可在本机点「释放名额」自己吊销。接入名额已满时插件会提示先吊销不用的电脑，而不是再签发接入码。满额不消耗该码，吊销后同一张码再点接入即可。控制台此时也不把再签发当主操作。吊销腾出名额后若仍有未用码，让新电脑再点接入。控制台满额时也会标明离线电脑仍占名额，把最久未见的标成建议吊销，并可从横幅一键吊销。换到别的 Relay 不必先在控制台吊销。控制台吊销后，插件会停止重连并提示签发新接入码；若接入串带有控制台地址，插件可直接打开（不是 App 登录）；满额时贴入接入串也可打开控制台去吊销；满额失败后插件仍记住该公网地址，刷新面板不必再贴。更换或换 Relay 后，同一网络下的手机下次打开即可跟上，纯远程请重新扫云端配对码（插件已有有效路由即显示云端码，换路由后刷新，不必等心跳在线；App 设备列表留下本机「扫码恢复云端」，不登录 Control）。

开发

node build-client.mjs
node --test test/.mjs

改 src/module2.js 后必须重新生成 src/client.js。

License
MIT。Android 客户端不在本仓库。第三方见 THIRD_PARTY_NOTICES.md。