xxccdl/DeepSeek-Harness-Mobile

DeepSeek Harness Mobile

在 Android 手机上运行 DeepSeek Harness（dsh）AI 助手的 React Native 应用。

内置完整 Linux 环境（Termux + proot-distro Debian 容器），无需 root。AI 可以读写文件、执行命令、安装软件包，甚至可以读取屏幕、点击、滑动、输入，真正操控这台手机。

✨ 功能特性

- 内置 dsh 引擎：嵌入式 Node.js 运行时 + dsh-bundle，首次启动自动解压 Termux bootstrap 并启动 dsh Web 服务
- 完整 Linux 环境：proot-distro 跑 Debian 容器，AI 可通过 bash 工具执行 apt / pip / git / python 等命令
- 手机控制：无障碍服务 + 本地 HTTP 桥接，AI 可读取屏幕元素、点击、长按、滑动、输入、滚动、按键、打开应用
- AI 产物一键保存：AI 产出文件后一键保存到 Download/DeepSeekHarness
- 任务通知：任务完成、产物保存时通过系统通知提醒
- 移动端深度适配：DeepSeek 风格深色 UI、触屏优化、拍照/相册/文件上传、悬浮球、检查更新
- 前台服务保活：退后台 / 息屏后 dsh 服务继续运行

🏗️ 架构

React Native (0.87) 壳层 + 原生 Android 模块：

| 模块 | 说明 |
| --- | --- |
| TermuxEngine | 嵌入式 Termux 引擎：解压 bootstrap、初始化环境、启动 dsh Web 服务 |
| PhoneAccessibilityService / PhoneControlHttp | 无障碍服务 + 本地 HTTP（127.0.0.1:3090），供 dsh-tool-phone 调用 |
| DeliverSaver / DeliverReceiver | 产物保存到 Download/DeepSeekHarness + 通知点击保存 |
| FloatingBallService | 悬浮球（悬浮窗权限 + 触控手势） |

启动流程：

1. App 启动 → 解压 Termux bootstrap → 安装 nodejs / ripgrep → 配置 npm 镜像
2. 安装 dsh 引擎（dsh-bundle.dat）→ 解压 Debian rootfs（proot-distro）
3. 启动 dsh Web 服务（127.0.0.1:3080）→ React Native WebView 加载聊天界面

📁 目录结构

├── android/                  # Android 原生工程（Kotlin 模块在 android/app/src/main/java/com/dshmobile/）
├── src/                      # React Native 界面（SplashScreen / InitScreen / ChatScreen）
├── scripts/                  # 资产构建脚本（bundle-dsh / pack-node-runtime 等）
├── proot-distro/             # proot-distro 打包脚本
├── plugins/                  # dsh 插件源码（@deepseek-ai/*）
└── ...

🔌 插件

本仓库 plugins/@deepseek-ai/ 收录移动端用到的 dsh 插件源码，包括：

- 手机控制：dsh-tool-phone / dsh-client-ui-phone-control（无障碍读屏 + 点击/滑动/输入等）
- 悬浮球：dsh-client-ui-floatball
- 产物交付：dsh-tool-deliver / dsh-client-ui-deliver（一键保存到下载目录）
- 检查更新：dsh-client-ui-updatecheck
- 移动端 UI 魔改：dsh-client-ui-mobile（DeepSeek 风格、上传面板、窄屏适配）
- 移动桥接：dsh-mobile-bridge（通知/保存等原生桥接）
- 以及 dsh-tool-vision、dsh-tool-webfetch、dsh-tool-snippets、dsh-command-btw 等

插件通过 scripts/bundle-dsh.mjs 打进 dsh-bundle.dat（在 EXTRA_PKGS 中声明的包）。

📦 快速开始（下载安装）

从 Releases 下载最新 app-release.apk 直接安装即可，无需 root、无需额外配置。

首次启动会自动解压内置环境并初始化，耗时较长（约数分钟），属正常现象。

🛠️ 构建（Android）

环境要求

- Node.js ≥ 22.11
- JDK 17（见 android/gradle.properties 中的 org.gradle.java.installations.paths）
- Android SDK / Android Studio

运行时资产

为保持仓库精简，以下大体积运行时数据不入库，需先构建或从 Release 获取：

| 资产 | 生成方式 |
| --- | --- |
| android/app/src/main/assets/dsh/dsh-bundle.dat | node scripts/bundle-dsh.mjs（dsh 引擎依赖闭包） |
| android/app/src/main/assets/dsh/node-runtime.dat | node scripts/pack-node-runtime.mjs（嵌入式 Node 运行时） |
| android/app/src/main/assets/dsh/debian-rootfs.tar.gz | proot-distro/pack-proot.mjs（Debian rootfs） |
| android/app/src/main/assets/termux/bootstrap-aarch64.zip | Termux bootstrap 包 |
| mmmbuto-node-pty-android-arm64-1.1.2.tgz | node-pty Android 预编译包 |

注意：资产构建脚本是开发期工具，部分路径指向本地桌面版 dsh 仓库
（如 scripts/bundle-dsh.mjs 中的 SRC_NM = d:/code/dsh-gui/node_modules），
开源后需按自己的环境调整这些路径。

构建 APK

npm install
cd android
./gradlew assembleRelease

生成 APK：android/app/build/outputs/apk/release/app-release.apk

⚠️ 签名：仓库默认 release 构建复用 debug keystore（仅用于开发调试）。
正式分发请在 android/keystore.properties 配置自己的 keystore（模板：
storeFile、storePassword、keyAlias、keyPassword，文件不入库）。
存在该文件时自动使用正式签名，缺失时回退 debug 签名保证可直接构建。

📱 使用

1. 首次启动自动初始化环境，并请求无障碍权限（手机控制）
2. 在系统设置 → 无障碍中开启 DeepSeek Harness
3. 打开 App，在设置页的「手机控制」分区可验证屏幕读取
4. 悬浮球/通知/文件上传等权限按需授权

🙏 致谢

- DeepSeek Harness — dsh 引擎
- Termux — Android 终端环境
- proot-distro — Linux 发行版容器

📄 许可证

MIT