手机桥接 Adolanium/dsh-phone

DSH Phone Bridge

真正的 DeepSeek Harness 界面。在你的 iPhone 上。走 Tailscale。

DSH Phone Bridge 包含一个小巧的 Host 插件和一个 SwiftUI iPhone 应用，让你在手机上打开真正的 DeepSeek Harness 桌面界面。它不另起一个 Host，不复制你的会话，也不重写客户端。桌面 Host 始终是唯一的写入方；手机只是一扇安全的窗口，望向它。

Tailscale 是网络边界。桥接只在一个 100.64.0.0/10 地址上开一个监听端口，用配对设备 cookie 把关，再把 HTTP 和 WebSocket 流量反向代理进 Host 已有的回环服务器。

真正的 Web 客户端，由 iPhone 应用渲染，连接到桌面 Host。

为什么做这个

现成的 DSH Web 客户端已经会渲染会话、工具、终端输出、审批、计划、任务和子代理。在 iOS 上重做一遍，只会永远追在后面跑。在 tailnet 上再跑一个 Host，又会多出一个写入方和一份不同的配置档。

所以桥接只做最小而有用的那件事：

- 一个 Host，就是你已经在用的那个；
- 一个 tailnet 监听端口，绑定到一个地址；
- 一个真正的界面，在 WKWebView 里渲染；
- 一份设备凭据，存在 iPhone 钥匙串里。

你能得到什么

- 真正的客户端。 不做原生重写，也没有缩水的「移动模式」。
- 从构造上只走 Tailscale。 没有 0.0.0.0，没有局域网回退，没有公网端口。启动时直接拒绝 100.64.0.0/10 之外的任何地址。
- 配对一次。 在设置 → Phone 里扫二维码。手动输入码和粘贴链接两种备用方式也内置了。
- 撤销快、撤得干净。 撤销一台设备，它下一次请求立刻失效，它持有的每个 WebSocket 也一并关闭。
- 手机用起来像控制台。 前台自动重连、离线横幅、重新加载，还有一个带实时诊断的设置面板。
- 手机上不存启动 token。 Host 的启动 token 从不离开桌面进程；Host cookie 只在回环这一侧注入。

工作原理

┌──────────────────────────────┐
│ iPhone │
│ SwiftUI shell + WKWebView │
│ dsh-phone cookie in Keychain │
└──────────────┬───────────────┘
│ Tailscale (WireGuard)
▼
┌──────────────────────────────┐
│ Host plugin │
│ 100.64.x.x:8787 │
│ device-cookie gate │
│ HTTP + WebSocket reverse │
│ proxy, header rewriting │
└──────────────┬───────────────┘
│ loopback only
▼
┌──────────────────────────────┐
│ Running DSH Desktop Host │
│ sessions, tools, approvals │
└──────────────────────────────┘

手机始终看不到 Host 的 loopback 端口、launch token 或 dsh-auth-… cookie。插件在请求进入时把手机 cookie 换成 Host cookie，在响应返回时剥掉所有 Set-Cookie。

安装

1. Host 插件

git clone https://github.com/Adolanium/dsh-phone.git
cd dsh-phone
sh scripts/install-dev.sh

在没有 turn 或 job 运行时重启 DeepSeek Harness。打开 Settings → Phone。页面会显示 tailnet 地址、实时二维码、配对码、设备列表和诊断信息。

Windows PowerShell 的对应脚本在 scripts/install-dev.ps1 和 scripts/uninstall-dev.ps1；这两个脚本已经提供，但尚未在 Windows 上实际验证。

2. iPhone 应用

cd apps/ios
open DSHPhone.xcodeproj

在 Signing & Capabilities 里设置你的 Apple team，选择你的 iPhone，然后 Run。应用面向 iOS 17+，没有第三方依赖。

模拟器：

xcodebuild \
-project DSHPhone.xcodeproj \
-scheme DSHPhone \
-sdk iphonesimulator \
-destination 'platform=iOS Simulator,name=iPhone 18 Pro Max,OS=27.0' \
-derivedDataPath build \
build

签名、模拟器配对和调试启动入口见 apps/ios/README.md。

3. 配对

1. 在 DSH 里打开 Settings → Phone。
2. 在应用里把摄像头对准二维码。
3. 或者手动输入 8 位配对码，或粘贴 dshphone://pair 链接。

二维码只能使用一次，120 秒后过期。生成的设备 cookie 存在 Keychain 和 WebKit 的 cookie store 里。

安全模型

| 属性 | 如何落实 |
| 仅限 Tailscale | 监听器只绑定一个已确认的 100.64.0.0/10 地址；不回退到通配地址或 loopback |
| 不暴露公网 | 不用 Funnel，不做端口转发，不绑定局域网 |
| launch token 不离开 Host | 在进程内生成；只用于 loopback cookie 交换 |
| Host cookie 不落到手机 | 在上游注入；上游每个 Set-Cookie 都剥掉 |
| 设备凭据静态存储 | 32 个随机字节；Host 上只存 SHA-256 哈希 |
| 配对码 | 8 个 Crockford base32 字符；120 秒；一次性；内存中哈希；限流 |
| 管理接口 | 仅限 loopback，x-dsh-phone-admin: 1，已知 Origin，无 CORS |
| 吊销 | 下一个请求返回 401；已升级的 socket 立即销毁 |
| 手机存储 | 设备 cookie 存在 Keychain；UserDefaults 和 URL 里不放 token |
| 配对页 | 代码在 URL 片段中传输，绝不出现在请求行或日志里 |

仓库结构

apps/ios/ SwiftUI app, Xcode project, tests
packages/dsh-plugin-phone-bridge/
lib/ Host plugin, proxy, pairing, QR, Settings UI
test/ 80 node:test cases
scripts/ install/uninstall for macOS/Linux and Windows
docs/banner.png README hero

开发

node --test packages/dsh-plugin-phone-bridge/test
tests 80, pass 80

cd apps/ios
xcodebuild \
-project DSHPhone.xcodeproj \
-scheme DSHPhone \
-sdk iphonesimulator \
-destination 'platform=iOS Simulator,name=iPhone 18 Pro Max,OS=27.0' \
-derivedDataPath build \
test
5 PairingLink tests, 5 pass

插件没有运行时依赖。iOS app 没有第三方依赖。插件测试不需要 tailnet，用 mock 上游即可跑通。

状态

1.0.0。 已在 macOS 27 上验证，使用物理 iPhone 14 Pro Max（iOS 27.0.1）和 iOS 27 模拟器。

已知限制：

- 监听端口在配置档里配置（默认 8787），app 里不暴露。
- 还没有推送通知；app 回到前台时才显示审批。
- Windows 安装脚本已存在，但尚未实际验证。
- 强制 Tailscale 断网和主机休眠/唤醒不在自动化测试范围内。

许可证

MIT © Adolanium