dsh-mobile

September 4, 2026 · View on GitHub

中文 | English

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

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

安装

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

这是 多份已发布的包，不是 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.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.14/dsh-mobile-pairing.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.14 依赖 @dsh-mobile/e2e-tunnel v0.1.5，仅兼容 DeepSeek Harness 0.1.2-alpha.4。不要把隧道库再加进 DSH 插件列表；Alpha.1–Alpha.3 用户应继续使用对应旧 Runtime 的旧版插件。

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

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

Android APK（已签名 v1.1.6）：

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

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

Release 完整性：插件 tarball 和 APK 的固定名称、SHA-256 均列在 v1.1.6/SHA256SUMS。Latest URL 永远不带版本号；生产部署请使用固定版本 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 上的模型选择器

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

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

手机上加号只提供 命令 和 插入图片。图片仍走 Host 官方的 draft-image 通道。

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

FilesTerminal
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