DSH Mobile

在 Android 手机上**独立运行完整 DeepSeek Harness（DSH）**的开源实现：一个原生 WebView 壳 + 内嵌 aarch64 Node.js 运行时 + 裁剪后的 DSH 依赖树。手机自己启动 DSH 服务（127.0.0.1:3080），不依赖电脑，可离线于 PC 使用。

状态：功能可用，UI 仍在优化中。 核心链路（自启服务 → 对话 → agent 工具调用 → 会话落盘）已在真机端到端验证通过；v2.4 起 bash / write / glob / grep 工具全部可用（内置 GNU bash 5.3 + ripgrep 15.2，并修复了 Android 上 link() 被 SELinux 禁止导致的写文件失败）；v2.5 起内置收纳箱（设置页 → 收纳箱：按「工作台产物 / 会话记录」分类浏览，可提取到手机 Download 或删除）；v2.6 起原生界面统一为 DeepSeek 灰色单风格（灰底白卡 + DeepSeek 蓝 #4D6BFE，深浅合一只保留一套，夜间模式不再切换）；v2.7 起「连接电脑」模式修复：一键连接检测、针对性错误提示、断连自动重连（3s 起指数退避，上限 30s）+ 随仓库提供 tools\pc_bridge.bat 隧道自动维持工具；v2.8 起内嵌内核升级为 DSH 0.2.0-rc.2（适配 0.2.0 的 web 启动 token 鉴权与新的原生依赖，升级安装后自动重解压 payload）；界面细节继续迭代中，欢迎 issue / PR。

工作原理

┌───────────────────────────── DSH Mobile APK ─────────────────────────────┐
│  MainActivity (WebView 全屏)         DshServerService (前台服务)           │
│       │ 127.0.0.1:3080                    │ spawn                          │
│       ▼                                   ▼                               │
│  ┌─────────┐  首次运行解压   ┌──────────────────────────────────────────┐ │
│  │ WebView │◄───────────────│ payload/termux/usr/bin/node --expose-    │ │
│  └─────────┘                │   internals lib/bin.js web --port 3080   │ │
│                             │   --no-open  (DSH_HOME = files/dsh-home) │ │
│                             └──────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘

• WebView 壳：加载 http://127.0.0.1:3080，注入移动端补丁层（窄屏布局修复、侧边栏抽屉化、悬浮 ⚙ 菜单），不修改 DSH 前端源码。DSH 0.2.0 起 web 服务有启动 token 鉴权：App 从服务日志解析 dsh web: 行拿到带 token 的 URL 完成首次认证（换取持久 cookie），401 时自动重取一次。
• 内置服务：Termux 官方仓库的 aarch64 Node + GNU bash + ripgrep 二进制及依赖 .so（RUNPATH 改写为 $ORIGIN 相对路径），由前台服务 spawn，进程随应用存活。
• DSH 依赖树：从 npm（镜像）拉取的 DSH 依赖树经舞台拼装后裁剪（去掉桌面专用原生模块并打 stub、剥离 sourcemap/文档、注入 Android 文件系统补丁与 ripgrep aarch64 平台包），功能与桌面版一致。
• 双模式：设置页可切换「本机内置服务」/「连接电脑上的 DSH」；后者提供一键连接检测与断连自动重连，推荐 USB + adb reverse 隧道（见下文「连接电脑」）。

目录结构

dsh-mobile/
├── app/src/main/
│   ├── java/com/dsh/mobile/      # MainActivity / DshServerService / SettingsActivity / ArtifactsActivity(收纳箱)
│   ├── assets/payload.zip        # 构建产物（不入库，由 payload 管线生成）
│   └── res/                      # 布局、主题（含夜间模式）
├── payload/
│   ├── prepare_dsh_tree.py       # 步骤2：裁剪 DSH 依赖树（删原生模块/打 stub/剥离）
│   ├── patch_android_fs.py       # Android 补丁（link()→rename()、flock 放宽、require-builtin 回退）
│   ├── payload_tools.py          # .deb 解包 + ELF DT_NEEDED 解析
│   ├── extract_termux.py         # 步骤1：解包 node .deb 与依赖 .so 到 termux 前缀
│   ├── patch_runpath.py          # RUNPATH 改写（Termux 绝对路径 → $ORIGIN）
│   ├── check_runpath.py          # 校验工具
│   └── build_payload.py          # 步骤3：打包 payload.zip
└── tools/
    ├── build_manual.py           # 零网络手工构建链（aapt2→javac→d8→zipalign→apksigner）
    ├── install_apk.ps1           # adb 安装 + vivo 安装确认弹窗自动点击
    ├── pc_bridge.bat / .ps1      # 「连接电脑」USB 隧道自动维持（adb reverse 每 3 秒重建）
    ├── cdp_eval.ps1 / .mjs       # 通过 WebView DevTools 执行页面 JS 的验证工具
    └── pull_workspace.ps1        # 电脑端导出 agent 产物（备用；手机端用收纳箱即可）

构建（零 gradle，全手工链）

需要：Windows、JDK 17、Android SDK（C:\Android，build-tools 34 + android-34）、Python 3、网络（仅首次下载 Termux .deb）。

# 1. 下载并解包 Termux 运行时（node + bash + ripgrep + 依赖 .so + CA 证书）
python payload\extract_termux.py extract
#    .deb 下载地址见 extract_termux.py 顶部注释；也可手动放入 payload\debs\

# 2. 拉取 DSH 依赖树并舞台拼装（在仓库外的空目录，例如 ..\dshm-fetch）
mkdir ..\dshm-fetch; cd ..\dshm-fetch
npm install --omit=dev --registry=https://registry.npmmirror.com @deepseek-ai/[email protected]
#    国内直连 npmjs 极慢，务必用镜像；不要加 --install-strategy=nested（树会翻倍）
robocopy node_modules\@deepseek-ai\dsh %TEMP%\dshm-stage\dsh /E
robocopy node_modules %TEMP%\dshm-stage\dsh\node_modules /E /XD node_modules\@deepseek-ai\dsh
cd ..\dsh-mobile

# 3. 裁剪依赖树（删桌面原生包/打 stub/剥离/打 Android 补丁，约 112MB）
python payload\prepare_dsh_tree.py %TEMP%\dshm-stage\dsh

# 4. 打包 payload.zip 并放入 assets
python payload\build_payload.py
copy payload\payload.zip app\src\main\assets\payload.zip

# 5. 构建 APK（构建目录必须是 ASCII 路径，中文路径会弄坏 aapt2）
python tools\build_manual.py
# 产物: build\apk\dsh-mobile-v2.8-debug.apk

构建脚本首次运行会自动生成 tools\debug.keystore（已 gitignore，请勿提交）。

发布（推送到 GitHub）

ghproxy.net 只是只读镜像：用它 push 会回 Invalid username or token（代理把请求转给 GitHub，但凭证对不上）。推送必须直连 github.com：

# 1) 确保能直连 GitHub（本机需要先起代理，例如 Clash Verge 的 TUN/系统代理）
# 2) 用带 :443 的 URL 推送，绕开全局 .gitconfig 里的 ghproxy insteadOf 改写
git push https://github.com:443/aojiepp/dsh-mobile.git main:main

• https://github.com:443/... 不会命中 url.https://ghproxy.net/https://github.com/.insteadOf（改写只匹配 https://github.com/ 前缀），同时 GCM 仍按 host github.com 找到已存 token。
• 推送前可先用 curl https://api.github.com/repos/aojiepp/dsh-mobile 确认直连可用。
• 推完把代理正常退出（托盘 → 退出），别强杀，否则内核/TUN/系统代理会残留。

安装与使用

adb install -r build\apk\dsh-mobile-v2.8-debug.apk

• 真机（vivo/国产 ROM）安装会弹确认框，tools\install_apk.ps1 会通过 uiautomator 自动点击「已了解风险」+「继续安装」。
• 首次启动解压 payload 约 1-3 分钟，之后秒开。升级安装（如 v2.7 → v2.8）会自动检测版本并重新解压 payload，同样约 1-3 分钟，期间显示解压进度。
• API Key：App 设置页填写（写入 $DSH_HOME/.env，权限 600），或启动后在 DSH 界面「设置 → 模型」里存储（写入 $DSH_HOME/.credentials.yaml）。
• 收纳箱：设置页 → 收纳箱 —— 智能体产物按「工作台产物 / 会话记录」分类列出，可「提取」到手机 Download/dsh-export/（文件管理器可见）或直接「删除」；应用私有目录普通文件管理器看不到，这里是唯一入口。
• 通知权限用于前台服务保活；进程随应用关闭而退出。

连接电脑（模式二）

电脑上的 DSH Web 默认只监听本机 127.0.0.1（安全设计：0.0.0.0 绑定被明确拒绝，避免把控制能力暴露给网络），所以手机连电脑有两条路：

① USB + adb reverse（推荐，最稳）

1. 手机用数据线连电脑（adb 可用）；
2. 电脑执行 adb reverse tcp:3080 tcp:3080，或双击 tools\pc_bridge.bat 常驻维持隧道（设备重插/adb 重启后自动重建）；
3. App 设置页模式选「连接电脑上的 DSH」，服务地址保持 http://127.0.0.1:3080，点「测试连接」应显示 ✅；
4. 隧道断开时 App 显示针对性错误提示并自动重连（3s 起指数退避，上限 30s），无需手动刷新。

② 无线局域网（需要电脑端配合）

电脑端重启 DSH Web 时绑定局域网地址（会绕过「仅本机」安全保护，仅在可信网络使用）：

dsh web --host <电脑局域网IP> --trusted-host <电脑局域网IP>:3080

手机填 http://<电脑局域网IP>:3080。若直连不通，检查电脑防火墙是否放行 3080 端口。

设置页的「测试连接」会把失败原因翻译成人话（拒绝/超时/解析失败/非 DSH 服务），排查时以它为准。

已知限制与设计取舍

许可

本项目采用 MIT License。

第三方组件按各自许可分发：Termux nodejs 二进制来自 Termux 官方仓库；DeepSeek Harness 依赖树来自 npm 官方 registry（经镜像加速），仅供本工具运行时使用，版权归其各自作者。