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…

493 ·GitHub
Deepseek-harness-android-app
Что это?Это устанавливаемый Android-APK, упаковывающий DeepSeek Harness (DSH) — ядро ИИ-агента, — чтобы ИИ мог напрямую управлять вашим телефоном: устанавливать приложения, тапать по экрану, менять настройки, читать/редактировать файлы — без root (через Shizuku) или с root, если он есть.
Это приложение для установки или то, что встраивается в мой код?Это отдельное устанавливаемое Android-приложение (пакет com.deepseek.harness) с полным ядром агента DSH и рантаймом, а не библиотека для встраивания в собственный проект.
Как его запустить?Скачайте один из APK со страницы GitHub Releases (обычный, вариант Lite coexist или Compat) и установите напрямую; при первом запуске откроется страница-инструкция по разрешениям, чтобы настроить все 9 разрешений сразу.
Нужны ли Shizuku или root для использования?Нет, root/Shizuku необязательны: чтению, предпросмотру и редактированию файлов достаточно разрешения 'Доступ ко всем файлам'. Для системных действий (установка приложений, тапы, смена настроек) используется root, если он есть, иначе автоматически подключается Shizuku; экранный ассистент через accessibility не нуждается ни в том, ни в другом.
Какие версии 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.
Что умеет экранный ассистент через accessibility, чего не может Shizuku/root?Включается в системных настройках специальных возможностей; он позволяет ИИ читать дерево контролов экрана, тапать, печатать, прокручивать и снимать accessibility-скриншоты без каких-либо особых разрешений — дополняя привилегированный канал, который отвечает за системные действия вроде установки приложений и смены настроек.
Удаление приложения стирает данные и изменения ИИ?Нет — рабочая корневая папка (dshroot) хранится вовне, в /sdcard/DeepSeekHarness, поэтому переустановка или обновление приложения не очищает накопленное рантайм-состояние ИИ.
Приложение продолжает работать, когда телефон заблокирован или оно в фоне?Да, оно использует foreground-сервис, чтобы оставаться живым, пока работает ИИ, и высылает уведомление в строку состояния, когда задача завершена или требует внимания.
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
13.3 MB
Stars
493
Updated
CommitOct 18Releasev1.20.1Oct 18
Age
2mo
Commits · 90 Days