daetz-coder/DSH-Mobile

DSH-Mobile —— 把 DeepSeek Harness 装进口袋

扫码配对一次，之后随时随地用手机查看/控制电脑上的 DeepSeek Harness。
Pair once by QR code — then watch and control your desktop DeepSeek Harness from your phone, anywhere.

DSH-Mobile 是官方 DeepSeek Harness (DSH)
Web 界面的安卓原生配套 App。用二维码与电脑端 dsh web 配对一次，之后官方 DSH
界面就一直在你口袋里——看会话、发消息、控制 agent；即使关掉 App，通知栏也会
逐秒同步桌面上的原生进度文本。

✨ 它能做什么

| 能力 | 说明 |
|------|------|
| 📷 扫码配对 | 扫 dsh web → 设置 → 插件 → 手机访问 的二维码，或手动输入地址 |
| 🔐 PIN 自动登录 | 首次输入的 8 位访问密码自动加密保存；配对历史重开即达，免重复扫码 |
| 🖥️ 官方界面整页呈现 | DSH 界面以 top-level 页面加载（非 iframe），与桌面浏览器完全一致 |
| 🔔 常驻状态通知 | 通知栏逐秒同步桌面状态文本（Deep diving...1分45秒），任务结束自动转「已完成 · 本次用时」——不自计时，与桌面显示永远一致 |
| 🌐 局域网 + 公网 | 同一 WiFi 直连；外出走 cloudflared 快速隧道（URL 每次重启轮换） |
| 🌙 深色模式 + 双语 | 跟随 DSH 的主题；App 内 zh/en 随时切换 |
| 📶 配对状态徽标 | 配对列表实时显示在线 / 离线 / 受密码保护 |
| 🔔 通知权限 | Android 13+ 首次使用拉起系统授权 |

桌面 DSH 是驾驶舱，DSH-Mobile 是口袋里的副驾。

📸 运行效果

| 📱 外部访问界面 | 💬 对话显示界面 |
|---|---|
| 外部访问界面 | 对话显示界面 |

🚀 快速开始

1. 电脑端 —— 安装两个服务端插件，然后启动 dsh web：

方式 A：从 dshmarket 插件市场安装（推荐）
dsh plugin --profile web add dshmarket
然后在 DSH 内安装：设置 → 插件 → 市场 →
dsh-pocket  (shaobeichen/dsh-pocket)
dsh-web-mobile  (mexiaosqwq/dsh-web-mobile)

方式 B：直接安装
dsh plugin --profile web add dsh-pocket -w
dsh plugin --profile web add github:mexiaosqwq/dsh-web-mobile

npx @deepseek-ai/dsh web

插件市场：dshmarket.com（dsh-pocket ·
dsh-web-mobile）。
已测试推荐版本（DSH-Mobile v1.0.3 下）：dsh-pocket v1.13.4 ·
dsh-web-mobile v2.1.1 —— 无需安装其他扩展即可使用。

2. 手机端 —— 安装 DSH-Mobile（Releases
下载 APK，或直接侧载）。

3. 配对 —— 打开 App，扫 dsh web → 设置 → 插件 → 手机访问 的二维码，
输入一次 8 位 PIN —— 完成 🎉。

局域网访问密码默认开启（安全默认）。首次加密输入后，之后免输。

使用

1. 电脑端保持 dsh web + 两个插件运行。
2. 打开 App 点击配对（或重新扫码）——官方 DSH 界面整页打开。
3. 正常看会话、发消息、控制 agent。
4. 随时关掉 App——常驻状态通知继续盯进度，配对列表显示在线 / 离线 / 受保护状态。

🔐 安全

- DSH 能在你电脑上执行代码——配对 URL / PIN / 会话 cookie 就是钥匙：
不要分享、不要提交进仓库、不要贴到任何公开地方。
- PIN 存在电脑端（~/.dsh/dsh-pocket/）；手机只持有加密配对记录，
拆开 APK 也拿不到敏感信息。
- 公网 URL 每次重启轮换；局域网 PIN 建议保持开启。

📦 分发

| 渠道 | 方式 |
|------|------|
| 落地页 | daetz-coder.github.io/DSH-Mobile——「下载 APK」一键直达 |
| GitHub Release | Releases——每个 tag 附带 DSH-Mobile.apk（CI 自动构建）· 更新记录 |
| Obtainium | 一键添加：obtainium://app/github.com/daetz-coder/DSH-Mobile——也可手动把 https://github.com/daetz-coder/DSH-Mobile 添加为应用源，自动跟随 Release 更新 |
| 侧载 | adb install -r DSH-Mobile.apk，或手机直接打开 APK |
| 源码构建 | 见下方「给开发者」 |

给开发者

- 构建 APK：cd app && npm install && npx cap sync android，
再 cd android && .\gradlew.bat :app:assembleDebug（需 JDK 21）
- 二开插件：dsh-pocket v1.13.4（GPL-2.0）、dsh-web-mobile v2.1.1（MIT）

License

按组件双许可：

- App 壳（app/ 的 Capacitor 工程 + 自研原生插件）：MIT
- plugins/dsh-pocket（shaobeichen/dsh-pocket
二开上游）：GPL-2.0——修改/分发必须保持 GPL-2.0 并保留版权声明
- plugins/dsh-web-mobile（mexiaosqwq/dsh-web-mobile
二开上游）：MIT

基于 Capacitor（MIT）与官方
DeepSeek Harness 构建。

通过 dshmarket.com 安装插件的用户请注意：
两个插件遵循各自协议——dsh-pocket 为 GPL-2.0（修改后分发必须保持
GPL-2.0），dsh-web-mobile 为 MIT。本 App（DSH-Mobile）为 MIT 独立许可，
不对插件施加额外协议要求。