deepseek-harness-android-app README

The project's README from github.com/woaiys3/deepseek-harness-android-app. As one markdown file: README.md.

DeepSeek Harness 手机版（Android）

把 DeepSeek Harness（DSH）打包成可直接安装的 Android APK —— 装上就能用，还能让 AI 免 Root 真正操作手机。

License Stars Release

✨ 核心亮点

📸 界面预览

截图于 v1.2.0（2026-08-17）与 v1.4.0（2026-08-20），完整文件见 docs/screenshots/。
界面截图 1 界面截图 2 界面截图 3
界面截图 4 界面截图 5 界面截图 6

v1.4.0（Lite 共存版）实测截图：
Lite 截图 1 Lite 截图 2 Lite 截图 3

🛠️ 手机端插件（本项目的核心特色）

插件 能力
dsh-tool-shizuku 特权 shell：任意系统命令（pm/am/settings/dumpsys…），异步执行 + 环境消毒 + dex 只读自愈
dsh-tool-android 结构化系统操作：包管理 / 应用管理 / 系统设置 / 截图 / 模拟输入
dsh-tool-accessibility 无障碍读屏 + 模拟操作（v1.7.0）：读控件树 / 点击 / 输入 / 返回主页 / 滚动 / 无障碍截图理解

通过这三个插件，AI 不再只是"聊聊天"，而是能真正控制你的手机——特权通道（root/Shizuku）负责系统级操作，无障碍通道（无需授权）负责读屏与交互。

👁️ 无障碍屏幕助手（v1.7.0）

让 AI 看着屏幕操作手机：读屏、点击、输入、滚动、截图理解——不需要 root / Shizuku。

开启方式

  1. 系统设置 → 无障碍 →（已下载的服务/服务）→ 开启「DeepSeek Harness 屏幕助手」
  2. 在 App 里让 AI：先用 android_screen 读屏 → 用 android_tap / android_type / android_scroll 操作 → 需要看图时用 android_see 截图理解

AI 可用工具

工具 能力
android_a11y_status 查询无障碍服务状态（未开启时返回引导文案）
android_screen 读当前屏幕控件树（文字 / 坐标 / 可点击性 / 可输入性）
android_tap 按文字 / 描述 / 坐标点击
android_type 输入文本到输入框（WebView / 网页输入框用 paste:true 走剪贴板粘贴）
android_back / android_home 系统返回键 / 回桌面
android_scroll 上 / 下 / 左 / 右滚动
android_see 无障碍截图并发送给视觉模型理解（需 Android 11+ 与支持图片的模型，如 deepseek-v4-flash-vision-exp）

无障碍通道与特权通道互补：无障碍不依赖授权、擅长读屏与点击；Shizuku/root 通道擅长系统级操作（装应用 / 改设置 / 系统输入）。

📦 安装

下载 Releases 里的 APK 安装即可：

要求：

🆘 打不开 / 白屏 / 连接失败？ 先看 启动排查（常见问题都能自助解决）。

📁 目录结构

CHANGES.md              版本改动记录（含 @Suyi222 贡献的 v1.1.1 稳定基线）

android-app/             APK 构建工程
├── build.sh             一键打包脚本
├── env.sh               编译工具链环境（可 export PREFIX 覆盖）
├── AndroidManifest.xml  包名/targetSdk(28)/横竖屏自由旋转/Shizuku 声明
├── libs/                Shizuku 官方 aar（api/provider/aidl 13.1.5）
├── res/                 图标 + 字符串资源
├── sdk/                 放 platform android.jar（见 sdk/README.md）
└── src/.../MainActivity.java   Android 原生壳（权限引导页/加载页/引擎启动）

mobile-patch/            移动端适配（注入 DSH 前端，不覆盖原生代码）
├── inject.sh            注入脚本（mobile.css + mobile.js 到 dist）
├── mobile.css           触摸优化 + 竖屏适配 + 插件管理页 UI 适配
└── mobile.js            软键盘适配（VisualViewport 方案，横竖屏通用）

plugins/                 手机端自定义 DSH 工具插件
├── dsh-tool-shizuku/    特权 shell（Shizuku 通道）
├── dsh-tool-android/    结构化系统操作（包管理/应用/设置/截图/输入）
└── dsh-tool-accessibility/  无障碍读屏/模拟操作（v1.7.0）

dsh-patches/             DSH 源码补丁归档 + overlay
├── README.md            补丁说明（适配原因/升级 DSH/打包）
├── apply.sh             重新应用源码补丁
└── overlay/             改好后的源码文件

config/cordis.patch.yml  DSH 组合配置（禁原生模块 + 插入 bash-local/shizuku/android 插件）

docs/开发指南.md            项目开发指南（架构/常用命令/注意事项）

🔨 构建说明

详见 docs/开发指南.md 第六节「常用命令」与第七节「注意事项」。

关键点：

⚠️ 这是源码与配置仓库，不含 APK 二进制、签名密钥（release.jks）、node 运行时、payload.zip、凭证文件。 📦 安装包（DeepSeekHarness.apk）、node 运行时与 DSH 内核分块包见 Releases；构建源码前需准备 runtime/ 与 dshroot/（分块包合并方法见 Release 说明）。

💬 交流讨论

遇到问题、想提建议、或想交流用法？欢迎加入 QQ 群 / QQ 频道：

QQ 群 QQ 频道
QQ 群 QQ 频道

也可以直接在 Issues 反馈，我会尽快回复。

📄 许可证

本项目源码采用 MIT 许可证。

deepseek-harness-android-app (woaiys3/deepseek-harness-android-app)

Searching Database…

477 ·GitHub
Deepseek-harness-android-app
这是什么？它是一个可安装的 Android APK，打包了 AI 智能体核心 DeepSeek Harness（DSH），让 AI 能直接操作你的手机——安装应用、点按屏幕、更改设置、读取/编辑文件——无需 root（通过 Shizuku），设备有 root 时也可以用 root。
这是我安装的应用，还是要集成进我自己代码里的东西？它是一个独立可安装的 Android 应用（包名 com.deepseek.harness），内置完整的 DSH 智能体核心和运行时，不是要集成进你自己项目的库。
怎么让它跑起来？从 GitHub Releases 下载其中一个 APK（正式版、Lite 共存版或 Compat 变体）并直接安装；首次启动会显示权限引导页，可以一次性配置全部 9 项权限。
使用它需要 Shizuku 或 root 吗？不需要，root/Shizuku 是可选的：文件的读取、预览和编辑只需要“所有文件访问”权限。系统级操作（安装应用、点按、更改设置）有 root 就用 root，否则自动回退到 Shizuku；无障碍屏幕助手两者都不需要。
它支持哪些 Android 版本？Android 7.0（API 24）及以上。
正式版、Lite 和 Compat 三种 APK 变体有什么区别？正式版 APK（com.deepseek.harness）是推荐版本；Lite 变体（com.deepseek.harness.beta，端口 3082）可与正式版共存安装，有独立的数据文件夹和 API 密钥，便于测试；Compat 变体（com.deepseek.harness.compat，端口 3084）面向 WebView 引擎较旧的设备。
无障碍屏幕助手能做哪些 Shizuku/root 做不到的事？它在系统无障碍设置中开启，让 AI 无需授予任何特殊权限就能读取屏幕控件树、点按、输入、滚动并截取无障碍截图——与特权通道互补，后者负责安装应用、更改设置这类系统级操作。
卸载应用会清掉 AI 的数据和改动吗？不会——工作根目录（dshroot）存放在外部 /sdcard/DeepSeekHarness，因此重新安装或升级应用不会清除 AI 积累的运行状态。
手机锁屏或应用退到后台时它还能继续运行吗？能，AI 工作期间它用前台服务保持存活，并在任务完成或需要关注时向状态栏推送通知。
What are similar projects?DSHA, Auto.js, Operit, dsh-ios, midscene, dsh-tavern, dsh-mobile-apk, jev-chat-jarvis
Which topics is it in?shizuku, automation-tools, mobile-automation, root, gui-automation, apk, android-app, dsh, accessibility, deepseek-harness, mobile-app, deepseek
Creator
woaiys3
Size
12.9 MB
Stars
477
Updated
CommitOct 17Releasev1.19.1Oct 17
Age
2mo
Commits · 90 Days