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)

mobile-automation
Searching Database…

What is this?It is an installable Android APK that packages DeepSeek Harness (DSH), an AI agent core, so the AI can directly operate your phone — install apps, tap the screen, change settings, read/edit files — without needing root (via Shizuku) or with root if available.
Is this an app I install, or something I build into my own code?It is a standalone installable Android app (package com.deepseek.harness) bundling the full DSH agent core and runtime, not a library you integrate into your own project.
How do I get it running?Download one of the APKs from GitHub Releases (regular, Lite coexist, or Compat variant) and install it directly; the first launch shows a permission guide page to configure all 9 permissions at once.
Do I need Shizuku or root to use it?No, root/Shizuku is optional: file reading, previewing and editing only needs 'All files access' permission. For system-level actions (installing apps, tapping, changing settings) it uses root if available, otherwise falls back to Shizuku automatically; the accessibility screen assistant needs neither.
What Android versions does it support?Android 7.0 (API 24) and above.
What's the difference between the regular, Lite and Compat APK variants?The regular APK (com.deepseek.harness) is the recommended build; the Lite variant (com.deepseek.harness.beta, port 3082) installs side-by-side with its own data folder and API key for testing; the Compat variant (com.deepseek.harness.compat, port 3084) targets devices with older WebView engines.
What can the accessibility screen assistant do that Shizuku/root cannot?Enabled from system Accessibility settings, it lets the AI read the screen's control tree, tap, type, scroll and take accessibility screenshots without any special permission grant — complementing the privileged channel, which handles system-level actions like installing apps or changing settings.
Does uninstalling the app wipe the AI's data and changes?No — the working root folder (dshroot) is stored externally at /sdcard/DeepSeekHarness, so reinstalling or upgrading the app does not clear the AI's accumulated runtime state.
Does the app keep running while my phone is locked or in the background?Yes, it uses a foreground service to stay alive while the AI is working, and pushes a notification to the status bar when a task finishes or needs attention.
Creator
woaiys3
Size
13.3 MB
Stars
493
Age
2mo
Commits · 90 Days