把 DeepSeek Harness（DSH）完整装进安卓手机里运行的 App。

装好之后 DSH 就跑在手机本地的一个 Linux 容器里 —— 不需要电脑、不需要服务器、不需要 root。

⚠️ 非官方声明

本项目是第三方非官方封装，与 DeepSeek 没有任何隶属、合作或背书关系。 "DeepSeek"、"DeepSeek Harness" 等名称归其权利人所有，此处仅用于说明兼容对象。 本项目按 MIT 发布，不提供任何担保，请自行判断风险。

一个把「proot + Ubuntu + Node.js + DSH + WebView」打包在一起的安卓 App：

┌─────────────────── 安卓 App (本仓库) ───────────────────┐
│  MainActivity ── WebView ──► http://127.0.0.1:3080      │
│       │                                                  │
│       └─ DshService（前台服务，保活）                    │
│              └─ proot ── Ubuntu rootfs ── Node ── dsh web│
│                                                          │
│  可选：无障碍服务 + 回环控制桥 → 让 agent 操作指定 App   │
└──────────────────────────────────────────────────────────┘

首次启动会自动下载并解压约 150 MB（Ubuntu base + Node.js + npm i -g @deepseek-ai/dsh）， 大约 1~3 分钟。之后就是秒开。

• 完整 DSH Web UI，对话 / 工作区切换 / 会话管理
• 附件：图片、视频、音频、文档都能加进会话（从「最近 / 图片 / 相册 / 文件管理」哪个入口选都一样）
• 读写手机文件（/sdcard 即内部存储）
• 右侧栏「手机文件」插件：像文件管理器一样浏览手机存储，多选后一键把路径加进会话（只读，不删改你的文件）
• 插件市场：在手机上搜索、一键安装社区写的 DSH 插件
• 插件自救：装到与当前 DSH 不兼容的插件、界面进不去时，App 会自动停用第三方插件并重启，界面自己回来（可一键恢复）
• 界面自愈：白屏/断线自动恢复 —— 容器掉了会自动重连、界面渲染进程被系统回收会自动重建
• 可选：让 agent 操作你指定的 App（无障碍 + 白名单，名单外一律拒绝）
• 无障碍守护：厂商把无障碍开关关掉时自动写回（实测约 0.3 秒恢复，无次数上限）
• 两种操作后端可切换：无障碍（快）或 直接命令 / Shizuku（不被厂商策略影响）
• 兼容老 WebView：内置垫片补齐 Iterator / AbortSignal.any 等新 API
• 手机与平板同一个包：平板上会话列表常驻可见，本机设置入口一个不少
• 内核一键升级：在手机上检测并升级容器里的 DSH
• 常驻服务：给 CLIProxyAPI 这类本地代理配自启
• 桌面图标 + 通知图标配色：8 套可选
• 全部离线自持：容器、Node、DSH 都在手机本地

要自动把无障碍开关写回去，需要 WRITE_SECURE_SETTINGS。它的保护级别带 development 标志，因此可以用 pm grant 单独授予一次，且永久有效 （写进 packages.xml，重启手机、更新 App 都不会掉）：

adb shell pm grant com.dshmobile.probe android.permission.WRITE_SECURE_SETTINGS

没有电脑的用户可以走 Shizuku（它以 shell 身份代跑这条命令）， 详见 docs/Shizuku授权教程.md。

⚠️ 任何 APK 都不可能"自带最高权限" —— Shizuku 的权限来自 ADB 或 root， 是从应用外部拿进来的。详见上面那份教程的开头。

没有这个授权也能正常用，只是无障碍被关掉后需要手动去设置里重开。

去 Releases 下载最新的 DeepSeek-Harness-*.apk，传到手机点击安装。

详细的图文步骤（含 vivo「超级守护」怎么过、API Key 填在哪、工作区怎么选）见 👉 docs/安装与使用说明.md

需要 JDK 17 和 Android SDK（compileSdk 36、build-tools 36.0.0）。

git clone https://github.com/Tongyu3/DSH-Mobile-Android-NO-ROOT.git
cd DSH-Mobile-Android-NO-ROOT

# 指向你的 Android SDK
echo "sdk.dir=/path/to/Android/Sdk" > local.properties

# 打一个可分发（release 签名）的包
./gradlew assembleRelease
# 产物：app/build/outputs/apk/release/app-release.apk

发布签名：仓库不含任何密钥。要出正式包，在项目根放一个 keystore.properties：

storeFile=release.keystore
storePassword=你的口令
keyAlias=dshmobile
keyPassword=你的口令

没有这个文件也能构建，只是 release 包不会被签名（等同于未签名包）。

debug 与 release 共用同一签名配置，所以两者可以互相覆盖安装、不会清空 App 数据 （方便排查界面问题）。详见 app/build.gradle。

Gradle wrapper 默认指向腾讯镜像（mirrors.cloud.tencent.com），开箱可用。 境外用户若觉得慢，改 gradle/wrapper/gradle-wrapper.properties 里的 distributionUrl 为 https://services.gradle.org/distributions/gradle-8.14.5-bin.zip 即可。

tools/patch.js 是单一事实来源：app/src/main/assets/dsh-mobile.js 由 Gradle 的 syncMobilePatch 任务在构建时自动生成，不要直接改 assets 里那份。 补丁全部是注入式的，不修改容器里 DSH 的任何文件，所以 DSH 升级后依然有效。

⚠️ webview-shim.js 必须在 onPageStarted 里真的注入进去。 它曾经因为注入语句漏掉变量而长期没有生效（文件在仓库里、编译无警告、 只在老机器上表现为 Iterator is not defined / AbortSignal.any is not a function）。 改动这段注入逻辑后，请用 SIMULATE_OLD_WEBVIEW 做一次对照实验： 先删掉这些 API 复现故障，再确认垫片能把它们补回来。 正式构建前 SIMULATE_OLD_WEBVIEW 必须复位为空字符串。

只需要改一行 app/src/main/res/values/strings.xml：

<string name="app_name">DSH Mobile</string>

改显示名不影响包名，因此不会导致容器里的 rootfs / Node / DSH 需要重装。

这个 App 要的权限看着吓人，所以说清楚它到底做什么：

• API Key 只存在手机本地的 App 私有目录，由 App 作为环境变量传给容器里的 DSH， 最终由 DSH 直接请求 api.deepseek.com。本项目没有任何自有服务器，代码可自行审计。
• 控制桥只监听 127.0.0.1:3099，需带随机 token；token 通过只读绑定进容器， 不放共享存储（否则其他 App 能读到）。
• 不 root、不改系统设置。

• 本仓库自身代码：MIT，见 LICENSE
• 打包进 APK 的第三方二进制（proot 为 GPLv2 等）：见 THIRD-PARTY.md 与 LICENSES/

Run DeepSeek Harness (DSH) entirely on an Android phone. No PC, no server, no root — DSH runs inside a local Linux container (proot + Ubuntu + Node.js) and its web UI is shown in a WebView.

⚠️ Unofficial

This is a third-party, unofficial packaging. It is not affiliated with, endorsed by, or connected to DeepSeek in any way. "DeepSeek" and "DeepSeek Harness" are trademarks of their respective owners and are used here only to describe what this app runs. Provided as-is, with no warranty.

Requirements: arm64 device, Android 7.0+, ~150 MB free space, your own DeepSeek API key. On first launch the app downloads and unpacks Ubuntu base + Node.js + DSH (~1–3 min).

Highlights: full DSH web UI · attachments (images / video / docs) · a built-in "phone files" tab in the right sidebar · plugin marketplace · self-healing UI (reconnects when the container dies, rebuilds the renderer when Android reclaims it) · auto-recovers from incompatible plugins by disabling them and restarting · optional app automation behind an allow-list · accessibility self-repair on vivo/iQOO · phone and tablet share one APK.

Install: grab the latest APK from Releases. See docs/安装与使用说明.md for a step-by-step guide (screenshots included).

Build:

echo "sdk.dir=/path/to/Android/Sdk" > local.properties
./gradlew assembleRelease

Known limitations:

• targetSdk is pinned to 28 on purpose — Android 10+ W^X forbids apps with targetSdk >= 29 from executing binaries in their own data directory (Termux does the same). Consequence: this app can never ship on Google Play, sideload only.
• On vivo/iQOO, the system force-disables accessibility services when QQ/WeChat come to the foreground (anti-fraud policy), so those two apps can't be automated there. Other apps are fine.
• arm64 only.

License: MIT for this repository's own code; bundled third-party binaries (proot is GPLv2) are covered in THIRD-PARTY.md.