手机端配对客户端NOirBRight/dsh-mobile

dsh-mobile

把你自己的 DeepSeek Harness 装进口袋。扫码配对，端到端加密隧道，官方功能，手机布局。

这不是第二套 DSH，不是把 :3080 暴露到公网的浏览器壳，也不是架在别人域名上的托管产品。Host 仍是你已经在跑的那台机器。Android 应用只连接你当前选中的那一台 Active Host。

安装

需要本机已经在跑 DeepSeek Harness 0.1.2-alpha.4 至 0.1.5-rc.1，手机要连的就是这台。

这是 多份已发布的包，不是 npm i dsh-mobile。Host 上先装 远程（配对插件），它会带上公开的隧道库。interaction-operations 是可独立安装的 Host Client 插件；移动 APK 已经内置它和 ui-layout-mobile，因此手机连接时不需要把布局源码或本地路径装进 Host。Codex Sidebar 可选，建议装。然后再装 APK。

dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-mobile-pairing/releases/latest/download/dsh-mobile-pairing-0.1.17.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-mobile/releases/latest/download/dsh-mobile-interaction-operations.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-codex-sidebar/releases/latest/download/dsh-codex-sidebar.tgz
dsh web

第二行是独立的 interaction-operations Host 插件；它只注册浏览器交互适配器，不拥有业务设置或移动布局。第三行是 Codex Sidebar（Files / Review / Browser / Terminal）。只要聊天可以不装 Sidebar。

固定版本（可复现）安装：

dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-mobile-pairing/releases/download/v0.1.17/dsh-mobile-pairing-0.1.17.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-mobile/releases/download/v1.1.6/dsh-mobile-interaction-operations.tgz

@dsh-mobile/ui-layout-mobile 只随 APK 和移动壳打包，由移动端在窄屏替换官方 root；不要把它加入只提供桌面 WebUI 的 profile。需要维护自有移动壳时，才从本 Release 下载对应的 dsh-mobile-ui-layout-mobile.tgz，并按移动壳的 bundle 说明加载。

配对插件 v0.1.17 依赖 @dsh-mobile/e2e-tunnel v0.1.5，兼容 DeepSeek Harness 0.1.2-alpha.4 至 0.1.5-rc.1。不要把隧道库再加进 DSH 插件列表；更旧 Runtime 的用户应继续使用对应旧版插件。

然后在 Host 上打开 设置 → 插件 → 插件配置 → DSH Mobile（导航里叫 远程）。

1. 自动生成（临时 Quick Tunnel）或 填写地址（你拿到的，或自己部署 的 Relay）。
2. 刷新二维码。约 5 分钟有效，且一次性。

Android APK（已签名 v1.1.14）：

- 最新 APK：https://github.com/NOirBRight/dsh-mobile/releases/latest/download/dsh-mobile.apk
- 固定 APK：https://github.com/NOirBRight/dsh-mobile/releases/download/v1.1.14/dsh-mobile.apk

装上应用，打开后扫描 Host 二维码。

| 部件 | 当前版本 | 角色 |
|---|---|---|
| dsh-mobile-pairing（@dsh-mobile/pairing） | v0.1.17 | 必装。 Host 插件：二维码、设备、回环 Gateway、Tunnel / Direct；兼容 DSH 0.1.2-alpha.4 至 0.1.5-rc.1。 |
| dsh-mobile Host interaction artifact（@dsh-mobile/interaction-operations） | v1.1.6 | 可选 Host Client 插件。只提供输入/弹层交互适配；移动 APK 使用同一份本地 bundle。 |
| dsh-mobile 移动端布局 artifact（@dsh-mobile/ui-layout-mobile） | v1.1.6 | APK 内置的窄屏 root 布局；不安装到桌面 WebUI profile。 |
| dsh-e2e-tunnel（@dsh-mobile/e2e-tunnel） | v0.1.5 | 配套库。pairing 已经依赖它。 |
| dsh-codex-sidebar | v0.5.12 | 可选。 details 席位上的 Files / Review / Browser / Terminal。 |
| dsh-mobile APK | v1.1.14 | 手机应用。下载固定名称 dsh-mobile.apk。 |
| Relay | relay/deploy | 可选自托管密文转发。只用 Quick Tunnel 就跳过。 |

Release 完整性：APK 的 SHA-256 列在 v1.1.14/SHA256SUMS-1.1.14；Host 插件 tarball 仍以 v1.1.6/SHA256SUMS 为准。配对插件完整性见 v0.1.17/SHA256SUMS。生产部署请使用固定版本 URL。

把隧道嵌进别的 Host 时才单独钉库（装手机不用跑）：

npm i github:NOirBRight/dsh-e2e-tunnel#v0.1.5

能做什么

首次启动：扫码配对

- 扫码配对 — 首次启动只有相机页。也可以打开 dsh-mobile://pair#offer=…。同一 Host Identity 会更新已有档案，不会复制设备。
- 加密隧道优先 — Automatic 立刻走密封 Tunnel。同网 WebRTC Direct 只在短窗口里可以抢赢。Quick Tunnel 和 Relay 只看见密文帧；Host Gateway 不会公布 DSH 网页端口。
- 官方功能、手机构图 — 窄屏变成顶栏、会话单栏、导航抽屉和 details 面。宽屏仍用官方桌面布局。
- 手机操作层 — 独立插件把 Android 返回、抽屉滑动、长按会话菜单和 hover-only 操作转成官方界面动作；输入框普通回车换行，发送仍点发送按钮。
- 冷启动不白屏 — 壳、字体和窄屏布局打进 APK。Host 插件按内容哈希缓存。重连留在当前文档里，不整页刷新。
- 多 Host、可撤销 — 在应用里切换 Host Profile。在 Host 上撤销设备；本地删档案不等于吊销。
- 后台连接保护（实验，默认关） — 减少 WebView 在后台被暂停。不是可靠的系统推送。

导航抽屉

窄屏会话：顶栏标题、Chat / 模式 / 日志、composer、压缩统计行。模型列表从同一块 composer 打开。

| 会话 | 模型选择器 |
| :---: | :---: |
| 窄屏会话 | composer 上的模型选择器 |

设置用官方分区，按手机构图。官方桌面设置页在手机宽度的浏览器里仍会被挤扁。

| 窄屏设置 | 官方设置在手机宽度下 |
| :---: | :---: |
| 窄屏设置 | 官方设置在手机宽度下 |

手机上加号打开官方命令菜单（含「文件」）。斜杠 skill 行使用统一立方体图标。图片与文件走 Host 官方入口。

composer 插入图片

flowchart LR
apk[Android_APK]
ep[QuickTunnel_or_Relay]
gw[Host_Gateway_loopback]
dsh[User_DSH]
apk -->|"NaCl sealed frames"| ep --> gw --> dsh

伴生：Codex Sidebar

请在同一台 Host 上安装 Codex Sidebar（命令见安装）。桌面上它占用官方 details 列；手机上这个席位变成右侧抽屉。Files、Review、Browser、Terminal 仍是同一套插件，不是手机另做一版。
Codex 工具面板：Review、Terminal、Browser、Files

| Files | Terminal |
| :---: | :---: |
| Files 预览 | Terminal |

flowchart TB
topbar[Top_bar]
chat[Conversation]
nav[Nav_drawer]
codex[Codex_details_drawer]
topbar --> chat
nav -.-> chat
codex -.-> chat

操作者细节

- 任何路径仍会做以 QR Host 公钥为锚的 NaCl hello/ack。端点运营方只是不可信管道。
- Automatic 隧道优先。Direct Only 与 Tunnel Only 仍可选。无 TURN。
- 应用里删除档案是本地操作。要作废凭证，请在 Host 上撤销设备。
- 默认兼容模式：配对、设备、Tunnel/Relay 和官方 UI 不修改 Runtime 也能工作。boot 永远走官方 Runtime。

从源码构建（Java 21 JDK 和 Android SDK）：

npm install
npm test
npm run build
npm run android:debug --workspace @dsh-mobile/mobile-web

调试 APK：apps/mobile-web/android/app/build/outputs/apk/debug/app-debug.apk。签名发布包：npm run android:release --workspace @dsh-mobile/mobile-web。

配对配置见已发布的 dsh-mobile-pairing（唯一来源，dsh-mobile 通过 tag/tarball 消费，不维护本地源码镜像）。自托管 Relay 见 relay/deploy/README.md。布局契约见 docs/adr/0004-responsive-layout-and-design-ownership.md。维护者架构见 docs/architecture.md。

许可证

MIT