前言¶
DeepSeek Harness(DSH)的 Web 界面默认只监听本机回环地址,手机在局域网或外网上无法直接打开同一套会话。常见做法是远程桌面或自建反向代理,步骤多,且容易把暴露面做大。下面介绍社区插件 dsh-phone-bridge(维护者 tihuzushi):在电脑 DSH 内提供桥接服务,并注入移动端外壳 UI,配合安卓客户端,用手机作屏幕和输入,算力与数据仍留在电脑上。
这是什么¶
DSH Phone Bridge 是 DeepSeek Harness 的客户端类插件,仓库 tihuzushi/dsh-phone-bridge。一句话定位:把跑在你自己电脑上的 DSH 桥接到手机——手机当屏幕和键盘,模型调用、读写文件、终端命令都在电脑侧执行。
需要区分:这是桥接,不是手机版 DSH。电脑关机或断网,手机端不可用;会话、工作区、插件与密钥都在电脑上。项目本身没有自建业务服务器;两端优先点对点直连,必要时经 Tailscale 加密中继转发密文。
安卓端为独立仓库 tihuzushi/dsh-phone-bridge-app(内置 tsnet,不占用系统 VPN)。插件侧当前版本见仓库 package.json(资料抓取时为 0.4.14),许可证 MIT;本仓库仅使用 Node 内置模块,无运行时 npm 依赖。
核心功能¶
宿主侧桥接¶
插件入口 lib/index.js 在 0.0.0.0:8765 监听,提供配对入口,将 HTTP 与 WebSocket 转发到 DSH 自有回环端口,并附上本地签发的会话 cookie。DSH GUI 若只绑 127.0.0.1,外网设备本无法直连;该插件即这条通道。
移动端界面¶
lib/client.js 在手机打开时套用移动端外壳:抽屉侧边栏、顶栏菜单、面板页标题内联按钮、文件下载与预览等。
远程与 Tailscale¶
支持不在同一 WiFi 的场景:手机用蜂窝网、电脑在家,只要两端登录同一 Tailscale 账号且在线即可。电脑需安装并连接 Tailscale;手机 APK 在 App 内登录 Tailscale 即可,不必再装系统 Tailscale App。插件监听包含 Tailscale 虚拟网卡,设置页会显示设备名;日志中可出现形如 Tailscale: http://100.x.x.x:8765 的地址。
设置与更新¶
设置 → DSH Phone Assistant 提供:配对码与配对页、服务监听地址与上游 DSH 端口、端口修改或「被占用时自动换端口」、Tailscale 状态、APK 下载入口、版本与「检查更新」。配对输错会拉长重试间隔(自 0.4.5 起不会因错误码锁死);可「重新生成配对码」或关闭「配对重试节流」。
状态持久化文件:
~/.dsh/phone-bridge.json
示例字段(以 README 为准):
{
"port": 8765,
"autoPort": true,
"throttle": true,
"pairingCode": "123456"
}
安装与启用¶
环境准备¶
| 项目 | 要求 |
|---|---|
| 电脑 | Windows,已安装并能正常使用 DSH |
| 手机 | Android 8.0(API 26)及以上 |
| 账号 | Tailscale 免费账号,注册入口 |
先在电脑上安装 Tailscale:从 Windows 下载页 安装,托盘登录并 Connect,状态为 Connected。手机端虽自带 Tailscale,电脑也必须在同一 tailnet,手机才能发现电脑。
安装插件¶
DSH 内:设置 → 插件 → 添加插件,填写完整 GitHub 地址(输入框不认 github:user/repo 简写):
https://github.com/tihuzushi/dsh-phone-bridge
装完后重启 DSH。
确认服务¶
打开 设置 → DSH Phone Assistant,应看到:状态运行中、6 位配对码、Tailscale 已连接及设备名、服务监听 0.0.0.0:8765。若未运行,可重启 DSH 或检查 8765 是否被占用。首次运行 Windows 防火墙可能询问入站,建议允许专用网络。
手机端¶
从 dsh-phone-bridge-app Releases 下载 DSH-Phone-Bridge-<版本>.apk 安装(README 亦提供作者托管的 APK 短链与直链,以 README 当前说明为准)。App 内 连接设置 登录与电脑相同的 Tailscale 账号,在「连接设备」中选择电脑、填入配对码,保存并连接。
卸载:DSH → 插件 → 已安装 → dsh-phone-bridge → 卸载,再重启 DSH。
典型用法¶
按 README「从零开始配置」顺序即可复现:
- 电脑装 Tailscale 并 Connected。
- 添加上述插件 URL,重启 DSH,在 DSH Phone Assistant 记下配对码与 Tailscale 状态。
- 手机安装 APK,App 内完成 Tailscale 登录。
- 选中 tailnet 中的电脑,输入 6 位配对码,连接成功后即看到由插件注入的手机版 DSH 布局。
常见问题对照:设备列表为空 → 检查手机 Tailscale 与电脑 tailnet;闪屏进不去 → 核对电脑设置页当前配对码;换电脑或重装插件 → 配对码会变,需重新填写。
适用场景与注意¶
适合需要在移动场景查看或操作同一台电脑上的 DSH 会话、又不想在手机上再跑一套 Harness 的开发者。老手机也可作显示端,不占本地算力。
插件随当前 DSH 进程权限运行,可转发本地 GUI 与终端能力;安装前应自行审阅 源码与 LICENSE,并理解 Tailscale 与防火墙暴露面。社区目录 SkillHub 插件页 与 GitHub 为独立社区生态,与 DeepSeek / 幻方无官方从属关系。