dsh-phone-pair

DSH 手机版 · 配对版

把电脑上的 DeepSeek Harness（DSH） 界面装进手机的安卓 App：打开先要本机密码，解锁后连你自己的电脑。

这个仓库有两样东西：

App 的安卓侧源码、构建脚本与验证工具在 android/；那里还有一份更详细的工程说明 （android/README.md）。

先说清一件事：这里一定还有 bug，而且有些作者修不了。 手机型号、Android 版本、代理软件、路由器、隧道状态……组合太多，一部分问题在这台电脑上 复现不出来，也就无从定位、无从修复。所以它现在是「能用，但请当自测版用」： 遇到问题先按 tester-troubleshooting.md 和插件 README 的「排错」表 自查一遍；仍然不行，就在 Issues 里报，请附上系统版本、DSH 版本、App 版本、 GET /api/pair/status 里的 tunnel.state 与 relay.state、以及完整报错文字（截图也行）。 这些复现信息往往就是修掉它的唯一线索——只写「用不了」，这边大概率还是修不了。

---

一、手机 App

下载

到 Releases 下载 DSH-Phone-Pair-1.0.3.apk（12,373,348 字节 / 约 11.8 MiB）。

• SHA256：60875A94160F3F736F5CAB1E829964D29BA0DF099FA221D3282576B2604D2CEB
• 包名 com.dsh.phone.pair，应用名「DSH 手机版 · 配对版」，versionName 1.0
• minSdk 26（Android 8.0）· targetSdk 34 · 权限只有 INTERNET 与 ACCESS_NETWORK_STATE
• 签名证书 SHA-256：b9204950d591bb3329ec137180673a98e2899e32fff91f23889585cc78ec1a0f
• 约 28 MB 前端界面已打进安装包（85 个内容哈希资源），所以第一次打开不必先下载界面

用它需要什么

1. 一台开着机的电脑，上面跑着 DSH。
2. 电脑上装 DSH 插件 @linxin666/dsh-remote-web-ui（自带 cloudflared，不需要 Cloudflare 账号、 不需要域名、不需要端口映射），打开它的「自动隧道」，relay 默认就是开的。
3. 电脑面板里复制配对链接：https://<id>.dsh-market.com/pair-accept?pair=<pairing-code>。

使用步骤

1. 手机安装 APK（需要允许「安装未知来源应用」）。
2. 打开 App → 设置一个本机密码（PBKDF2-HMAC-SHA256，10 万次迭代，只存在手机本地）。
3. 把配对链接发到手机点开（App 注册了 https /pair-accept 的 intent-filter），或在 App 里粘贴。
4. 显示配对成功即进入你自己的 DSH 界面；之后每次打开只需输密码。

配对成功后手机拿到一枚一年有效的 HttpOnly 设备凭据，电脑重启、换 IP、换网络都不用重新配对。

电脑关机之后还能用吗

不能。 App 只是手机端界面，DSH 与 Agent 都跑在电脑上。关机、睡眠、退出 DSH（隧道由插件在 DSH 进程里拉起）都会导致手机连不上；唤醒电脑后 1~2 分钟自动恢复，不需要重新配对。「前端内置」只意味着 界面文件在包里，聊天内容与 Agent 产出物始终来自电脑。详见 HANDOFF.md 第六节。

安全边界

• 配对成功的设备 = 完全控制凭据（聊天、会话、设置、凭据、Agent 预设、产出物）。只在自己的手机上配对； 配对链接默认 10 分钟过期，别贴到群里。
• 电脑侧始终保持 127.0.0.1 回环绑定，公网可达性完全由 cloudflared 出站隧道提供；不想要了就 在电脑面板里撤销该设备，或在 App 里「复位本机」。
• 本 APK 不含任何凭据：发布前会用 android/tools/audit_pair_build.py 扫描整个包（含 classes.dex），确认里面没有构建期设备 id 与 dsh_pair=<值>。

更多面向使用者的说明（含常见问题表）见 HANDOFF.md。

配套讲解视频

Releases 页上有一支完整的中文讲解视频（配音 + 烧录字幕，8 分 13 秒，另附 .srt）； 也可以在 B 站看：BV1RCpE6NEwu。 开头是使用声明，接着一页「两个动手安装的时间点」（电脑端 01:49、手机端 03:08，可以直接拖进度条跳过去）， 然后是 6 集讲解（每集 1~1.5 分钟，也可以单独下载）。 使用声明：作者近期学业繁忙、暂时抽不出时间继续做更多调试与答疑；使用中遇到问题， 请把问题直接交给 DSH（你电脑上的这个助手）排查，确需作者出面的再在仓库里留 Issue。

生成这些视频的脚本（分镜、旁白、排版、配音流水线）都在 video/，可以按 video/README.md 自己重出片；画面里的手机与电脑界面是示意图（视频内有角标说明）。

---

二、配套插件 dsh-phone-pair-kit

⚠️ 插件只是「电脑那一半」——请先按 §一 在手机上装好 APK。 只装插件、没有手机端 App， 是没有任何东西可以配对的。这句话在插件自己的 README 顶部、以及 DSH 插件市场的条目简介里都写了。

本插件已在 2026-10-15 收录进 DSH 插件市场（awesome-dsh-plugin 目录，PR #7205 已合并）： 打开「设置 → 插件」搜 dsh-phone-pair 就能一键安装，也可以直接用市场页给出的命令。 投稿材料与复核流程保留在 market/。

它做的事只有一件：把远程访问插件按

- id: remote-web-ui
  config:
    autoTunnel: true
    relay: true

插入你的 DSH profile，省掉手动打开开关那一步。它不碰别的东西，卸载就是删掉这段。

安装（三选一，细节见 插件自己的 README）：

# 1) 从本仓库目录安装（不需要 git，推荐）
pnpm add <本仓库路径>\plugin\dsh-phone-pair-kit
# 2) 从 GitHub 安装（需要本机装了 git，否则 pnpm 会报 "'git' 不是内部或外部命令"）
pnpm add github:Zoragyx/dsh-phone-pair#path:plugin/dsh-phone-pair-kit
# 3) 手动：把目录拷进 <DSH profile>\node_modules\，把包名加进 package.json 的 dsh.profile.bundles

没装 git 又想从 GitHub 装：在仓库页面点 Code → Download ZIP，解压后走第 1 种方式，把路径指向解压出来的 plugin\dsh-phone-pair-kit。

前置条件、排错（HTTP 530、HTTPS_PROXY 只认环境变量等）与卸载步骤都在那份 README 里。

---

三、从源码构建 App

代码在 android/，无 Gradle：bundle web assets → aapt2 → javac → d8 → zipalign → apksigner。

cd android
$ps = "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe"
& $ps -NoProfile -ExecutionPolicy Bypass -File .\build.ps1            # 产出 artifacts\dsh-phone-pair-1.0.apk
& $ps -NoProfile -ExecutionPolicy Bypass -File .\tools\verify_pair_build.ps1   # 单测 + 真数据命中 + 逐字节比对
python tools\audit_pair_build.py --apk artifacts\dsh-phone-pair-1.0.apk --device-id-file device-id.txt

前置：JDK 21、Android SDK build-tools;35.0.1 + platforms;android-34、Python。构建时脚本会自己生成 签名用的 keystore（不进仓库），并向本机 DSH 要一份只用于下载前端资源的凭据（同样不进包）。

本轮 1.0 的实测结果（android/README.md 有完整表格）：

---

四、灵感来源与致谢

这个 App 的灵感与配对思路来自开源插件 @linxin666/dsh-remote-web-ui （作者 linxin666，源码仓库 zhu1090093659/dsh-web，Apache-2.0）。 它把「用一次链接/一个二维码把手机配到电脑上的 DSH」这件事做了出来，并给出了公开的配对端点与设备会话机制。 在这个思路上，本项目独立完成了手机端 App（WebView 外壳、密码锁屏、离线缓存、前端内置、从配对链接运行期学习主机）、配套插件与整套构建/验证工具链。 谨向原作者 linxin666 表示感谢与敬意 —— 同时声明：本项目与上游作者没有隶属关系，也没有声称获得其背书；若哪里的说明或做法让上游感到不妥，请告知，我们会立即调整。

本项目自己完成的部分：安卓 WebView 外壳、本机密码锁屏（PBKDF2-HMAC-SHA256）、离线优先缓存、前端资源内置与同源闸门、从配对链接运行期学习主机（所以安装包里没有任何凭据或电脑地址）、以及 android/tools/ 下那套构建与三重验证脚本。

声明：

• 本项目是社区第三方作品，与 DeepSeek / DSH 官方、与 @linxin666/dsh-remote-web-ui 的作者都没有隶属关系。我们对上游只有感谢：如果哪里的说明、命名或做法让上游作者感到不妥，请提 issue，我们会立即修改或下架。
• 本仓库不包含上游插件的源码：plugin/dsh-phone-pair-kit 只是声明依赖并插入一段配置；手机端是按公开行为独立重写的客户端。各自许可见 NOTICE.md。
• 「DSH」「DeepSeek」「Cloudflare」等名称与商标归各自所有者，此处仅作说明用途。
• APK 内含上述前端资源。如果 DSH 作者认为不宜随 APK 分发，告诉我（或提 issue），我会立即处理 Release 资产（删除，或改成不含内置前端的构建 —— 构建脚本就在 android/）。
• 配对成功的手机就是你电脑的完全控制凭据（会话、设置、凭据、产出物）。只配对自己的手机；手机丢了就在电脑的「远程访问」面板撤销那台设备。

---

五、许可

本项目自己的代码是 MIT，见 LICENSE；第三方组件的许可与归属见 NOTICE.md。DSH 本身与 @linxin666/dsh-remote-web-ui 各有各的许可，本仓库不包含它们的源码。