dsh-links

这是什么

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

Android App 能做什么

• 扫描电脑端二维码，或手动输入地址和一次性配对码添加 DSH。
• 保存多个已配对设备，显示连接状态，并可随时移除本机记录。
• 在原生工作台中浏览会话与历史、继续对话、查看工具/思考事件，并通过 SSE 接收实时更新。
• 在手机上处理 DSH 的审批请求；手机在线但超过 5 分钟未处理的审批会按「不可用」结束，该次工具调用失败，可重试。丢失设备时，可从电脑端立即吊销该设备。
• 使用手机本地加密保存配对 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，并再扫第二张云端码。

最新界面截图

以下 UI 截图均于 2026-08-26 从当前本地运行版本重新截取；二维码、配对码、主机名、内网地址和设备标识均已脱敏。Android 截图来自当前 0.5.0-beta.14 构建。

电脑端手机连接与 Android 设备

手机上的 DSH 工作台

Android App 设置

Beta support boundary

This release is an Android Beta. The supported public path remains a trusted LAN.

• Supported: Android phone and DSH on the same trusted LAN. The current source baseline and verified combination are maintained in dsh-links/docs/COMPATIBILITY.md.
• Private testing: DSH Links Relay. End-to-end remote pairing has been exercised, but it is still invite-only. Invite codes are issued only by the maintainer. This repository, GitHub Releases, and the npm package do not contain invite codes, Relay host credentials, or state.json.
• Experimental, at your own risk: a Tailscale or Cloudflare Tunnel path you operate yourself. It is not a supported Beta path and is not covered by the security or compatibility promise.
• Not supported: exposing port 18640 directly to the public Internet or using frp. Public self-serve Relay enrollment is not available.

The Android APK is distributed only as an official signed release. Verify the version and SHA-256 published with that release; do not install repackaged APKs. This repository contains the plugin and its documentation only; the Android source and Relay server are not included here.

安装

dsh plugin --profile web add dsh-links@<published-version>
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），与接入码同等敏感：请勿截图、录屏或投屏分享；怀疑泄露时立即在电脑面板点「断开」作废该凭据（重新接入需要新的接入码）。

开发

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

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

License

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