deepseek-harness-android-app
by woaiys3
DeepSeek Harness 手机版：可直接安装的 Android APK，AI 免 Root 操作手机（Shizuku/root 可选），文件编辑只需所有文件访问权限，前台保活 + AI 通知
353stars
25forks
Java
Added 8/19/2026
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Installation
# Add to your Claude Code skills
git clone https://github.com/woaiys3/deepseek-harness-android-appGetting Started
Guides for using ai agents skills like deepseek-harness-android-app.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportVerified
Last scanned: 8/20/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-08-20T04:36:42.705Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}Compare with similar skills
See how deepseek-harness-android-app compares with popular alternatives.
DeepSeek Harness 手机版（Android）
把 DeepSeek Harness（DSH）打包成可直接安装的 Android APK —— 装上就能用，还能让 AI 免 Root 真正操作手机。
✨ 核心亮点
- 📦 APK 一键安装：不用 Termux、不用敲命令，下载安装即用（包名
com.deepseek.harness） - 🔓 免 Root 系统特权：通过 Shizuku 打通系统 shell —— AI 能装应用、点屏幕、改系统设置、截图、模拟输入，这是"手机上的 AI Agent"，不只是聊天窗口
- 🟢 可选特权，不授予也能正常用（v1.4.0）：不装 Shizuku/无 root 也能用——文件读写、预览、编辑只需「所有文件访问」权限；未授权时 AI 不会反复尝试系统操作，需要时会引导你授权
- 🔀 Root 优先，Shizuku 备用（v1.4.0）：有 root 走 su 通道，无 root 走 Shizuku，自动选择
- 👁️ 无障碍屏幕助手（v1.7.0）：系统设置开启「DeepSeek Harness 屏幕助手」后，AI 能读屏、点击、输入、滚动、无障碍截图理解——不需要 root / Shizuku，与特权通道互补
- 🖥️ 虚拟屏 vscreen（v1.10+）：AI 可以创建一块独立于主屏的真·虚拟屏，把 App 启动进去、在里面点击/滑动/输入，你的主屏照常用；右上角悬浮窗实时显示虚拟屏画面（H.264 视频流，可拖动、可双指缩放），AI 在干什么全程可见。实现移植自开源项目 Operit（LGPL-3.0，详见 THIRD_PARTY_NOTICES.md）
- 🎛️ 原生控制台（v1.12+）：冷启动先进 App 自己的控制台（解压 / 权限 / 插件开关 / 日志 四页），不必先等引擎起来；引擎状态判定全面重做——探测不再吃掉一次性 token、不再误报“未启动”、不会重复拉起两个引擎
- 🚑 救援能力（v1.15+）：控制台提供「安全模式启动 / 退出」与「导出全部数据 / 从备份导入还原」。插件把配置写成非法 YAML 会导致引擎拒启（历史上只能清数据），安全模式把用户层整体旁置后用出厂配置启动、不动会话与凭证；备份导出把会话/插件/配置打成 zip 存到
Download，换机或彻底重装可还原 - 🔐 Shizuku 通道改走 App 进程（v1.13.1+）：特权命令执行从“引擎内
rish子进程”改为经 App 进程内的 Shizuku API（新增本地/shell路由 + 随机令牌鉴权），根治手机上偶发的Request timeout. The connection between the current app … and Shizuku app … - ⏰ 前台保活（v1.4.0）：AI 干活时挂后台/锁屏不被杀，任务完成推送通知
- 🔔 AI 发通知（v1.4.0）：只需通知权限，任务完成/需要关注时推送到通知栏
- 🧠 完整 DSH 内核：
@deepseek-ai/dsh0.2.0-rc.2（v1.17.0 升级，上游当前 latest），保留插件生态 + RPC API，前端用 DSH 原生界面 - 🐍 内置 Python 3.14.6 + pip（v1.16.0/1.16.1）：AI 可直接写脚本做数据处理、解析、统计；
pip install可用、venv可用，免安装免配置 - 📦 内置 npm / npx 11.20.0（v1.16.0/1.16.1）：AI 可自己装 node 包，装出来的 CLI 可直接执行（已适配 Android 没有
/usr/bin/env这件事） - 🔌 插件三条输入全通（v1.15.3→v1.15.8）：本地目录 / 包名 / GitHub 地址 —— 内置 pnpm 与 git 2.55.0，并把 curl / git 的证书链修好（启动时用系统 CA 合成 bundle）
- 📱 移动端适配：触摸优化 + 软键盘适配 + 首次启动权限引导页（9 项权限一站式配置）
- 💾 卸载不丢数据：dshroot 外置到
/sdcard/DeepSeekHarness，重装/升级不清空 AI 的运行时改动 - 🐋 鲸鱼品牌图标，横竖屏自由旋转
📸 界面预览
截图于 v1.2.0（2026-08-17）与 v1.4.0（2026-08-20），完整文件见
docs/screenshots/。
 |
 |
 |
 |
 |
 |
v1.4.0（Lite 共存版）实测截图：
 |
 |
 |
🛠️ 手机端插件（本项目的核心特色）
| 插件 | 能力 |
|---|---|
dsh-tool-shizuku |
特权 shell：任意系统命令（pm/am/settings/dumpsys…），异步执行 + 环境消毒 + dex 只读自愈 |
dsh-tool-android |
结构化系统操作：包管理 / 应用管理 / 系统设置 / 截图 / 模拟输入 |
dsh-tool-accessibility |
无障碍读屏 + 模拟操作（v1.7.0）：读控件树 / 点击 / 输入 / 返回主页 / 滚动 / 无障碍截图理解 |
dsh-tool-vscreen |
虚拟屏（v1.10+）：建屏 / 把 App 启动到虚拟屏 / 看虚拟屏画面 / 在虚拟屏上点击·滑动·按键 / 关屏（8 个工具） |
通过这四个插件，AI 不再只是"聊聊天"，而是能真正控制你的手机——特权通道（root/Shizuku）负责系统级操作，无障碍通道（无需授权）负责读屏与交互，虚拟屏通道让 AI 在不打扰主屏的前提下跑自动化任务。
👁️ 无障碍屏幕助手（v1.7.0）
让 AI 看着屏幕操作手机：读屏、点击、输入、滚动、截图理解——不需要 root / Shizuku。
开启方式
- 系统设置 → 无障碍 →（已下载的服务/服务）→ 开启「DeepSeek Harness 屏幕助手」
- 在 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 通道擅长系统级操作（装应用 / 改设置 / 系统输入）。
🖥️ 虚拟屏 vscreen（v1.10+）
让 AI 在一块独立于主屏的虚拟屏里干活：你的主屏照常用，AI 在自己的屏里启动 App、点击、滑动、输入；右上角悬浮窗实时显示虚拟屏画面，AI 在干什么全程可见。
用法（3 步）
- 安装 APK（正式版或 Lite 共存版）
- 装好并授权 Shizuku（或设备有 root）—— 虚拟屏服务端必须以 shell 身份运行，没这一步虚拟屏用不了
- 打开一次 App —— 虚拟屏桥自动启动（此时它会拉起 shell 身份的服务端）
- 让 AI 建屏（或直接调
android_vscreen_create）→ 右上角自动弹出预览悬浮窗（可单指拖动、双指缩放）
尺寸：一律手机比例
- 竖屏 9:16（默认 1008×1792）、横屏 16:9（1792×1008）
- 即使显式传了非手机比例的宽高（如 1520×720），服务端也会归一化成 16:9（v1.11 修复）
- 切换横竖屏需先关屏再建屏
AI 可用工具
| 工具 | 能力 |
|---|---|
android_vscreen_create |
建虚拟屏（orientation 可选 portrait / landscape） |
android_vscreen_status |
查询当前虚拟屏（displayId / 宽高 / 是否在跑） |
android_vscreen_launch |
把指定 App 启动到虚拟屏 |
android_vscreen_see |
截虚拟屏画面发给视觉模型（返回换算系数，供坐标换算） |
android_vscreen_tap / swipe / key |
在虚拟屏上点击 / 滑动 / 按键 |
android_vscreen_close |
关闭虚拟屏 |
权限
| 权限 | 用途 | 必需？ |
|---|---|---|
| Shizuku 或 root | 整个虚拟屏功能——服务端（现役核心 vscreen/Main.java）必须以 shell 身份运行：建屏、截图、把 App 启动到虚拟屏、注入触摸/按键全在它身上 |
必需。没有 Shizuku/root 就拉不起服务端，虚拟屏完全不可用（不是“能看不能点”） |
| 悬浮窗（显示在其他应用上层） | 虚拟屏预览窗 | 要看预览必须授权 |
| 存储（所有文件） | 虚拟屏截图保存 | 截图必需 |
| — | 不需要。虚拟屏与无障碍服务无关（不读控件树、不走 dispatchGesture），插件/服务端/桥都没有引用无障碍 |
技术要点
预览不是轮询截图，而是 服务端 MediaCodec H.264 编码 → App 内解码 → 渲染到悬浮窗的实时视频流。 该视频流方案与虚拟屏创建机制移植/对齐自开源项目 Operit（LGPL-3.0）。
已知限制
- 需要 Android 11+；
- 需要 Shizuku 或 root（原因见上表：服务端跑在 shell 身份下）；
- 正式版与 Lite 共存版同时启动时 8999 端口互斥 → 虚拟屏实际二选一；
- 虚拟屏为 PUBLIC 类型显示，部分系统弹窗（如输入法）行为与主屏有差异。
📦 安装
下载 Releases 里的 APK 安装即可：
DeepSeekHarness-official-v1.17.1.apk（正式版，推荐）：包名com.deepseek.harness，从旧版本同签名升级DeepSeekHarness-lite-v1.17.1.apk（Lite 共存版）：包名com.deepseek.harness.beta（端口 3082），与正式版完全独立、可同时安装；数据独立在/sdcard/DeepSeekHarnessLite/，API Key 需单独填DeepSeekHarness-compat-v1.17.1.apk（兼容版）：包名com.deepseek.harness.compat（端口 3084），老 WebView 设备可用
⚠️ 从任何旧版本升级，请直接装 v1.17.1：本版内核升级到 DSH 0.2.0-rc.2（上游最新），并修了两个社区报告的缺陷（虚拟屏入口闪退、平板分屏界面白闪）；同时移除了自研定时任务（0.2.0 内核自带，可在控制台插件页启用）。历史上的 v1.15.3 → v1.16.1 还修掉了「插件装不上 / GitHub 装插件不通 / 证书报错 / 插件重启后消失 / 每次开机配置被重置」，并新增内置 Python 与 npm。完整变更见 CHANGES.md。 覆盖安装不会丢配置（模型/供应商、API Key、会话都保留）；同签名可直接覆盖，无需卸载。
要求：
- Android 7.0（API 24）及以上
- 系统操作能力需配合 Shizuku（免 Root 授权）或有 root；都不授予也能正常使用（文件操作只需「所有文件访问」权限）
- API Key 在 App 内页面填写，只存本机，绝不打包进 APK
🆘 打不开 / 白屏 / 连接失败？ 先看 启动排查（常见问题都能自助解决）。
🐞 遇到问题？日志在哪 / 怎么反馈
- v1.12 及以后（有控制台）：打开 App → 控制台 →「日志」页 —— 「查看日志」看
dsh-web.log末尾 200 行（可截图发来），「分享」把日志以文件形式发出（QQ / 微信 / 邮件都能选；启动失败时还会带上startup-diag.txt） - 不用 App 也能取（v1.7.1 起，无需 root / adb）：用文件管理器进手机存储根目录 ——
正式版
/sdcard/DeepSeekHarness/dsh-web.log、Lite 共存版/sdcard/DeepSeekHarnessLite/dsh-web.log、兼容版/sdcard/DeepSeekHarnessCompat/dsh-web.log； 启动失败时同目录另有startup-diag.txt（错误 + 端口 + node 是否存活 + 日志尾部） - v1.7.0 及更早：既没有控制台也没有外部日志镜像 → 只能
adb logcat | grep -i deepseek（引擎日志在 App 私有目录，无 root 一般读不到）；建议先升级到 v1.12+ - 反馈请附：日志 + 机型 / Android 版本 + 用的哪个包（正式版 / Lite / 兼容版）+ 复现步骤
📁 目录结构
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 第六节「常用命令」与第七节「注意事项」。
关键点：
targetSdk必须保持 28（≥29 会导致 node 二进制 EACCES 起不来）- 需准备
runtime/（node v26 + 依赖库）和dshroot/（DSH 内核）才能打完整 APK build.sh会自动注入 mobile.css/mobile.js，并做 API Key 安全检查
⚠️ 这是源码与配置仓库，不含 APK 二进制、签名密钥（release.jks）、node 运行时、payload.zip、凭证文件。 📦 安装包（DeepSeekHarness.apk）、node 运行时与 DSH 内核分块包见 Releases；构建源码前需准备 runtime/ 与 dshroot/（分块包合并方法见 Release 说明）。
💬 交流讨论
遇到问题、想提建议、或想交流用法？欢迎加入 QQ 群 / QQ 频道：
| QQ 群 | QQ 频道 |
|---|---|
 |
 |
也可以直接在 Issues 反馈，我会尽快回复。
🙏 致谢与开源许可
- Operit（AAswordman）—— 本项目虚拟屏（vscreen）功能移植/对齐自 Operit 的 shower 模块（虚拟屏创建、H.264 视频流预览、反射/隐藏 API 规避等）。Operit 采用 LGPL-3.0，因此本仓库的虚拟屏相关文件同样按 LGPL-3.0 分发。完整致谢与许可说明见 THIRD_PARTY_NOTICES.md。
- Shizuku（RikkaApps，Apache-2.0）—— 免 Root 特权通道。
- DeepSeek Harness（
@deepseek-ai/dsh） —— 本项目的运行内核。 - Node.js（MIT）—— APK 内置运行时。
📄 许可证
本项目源码主体采用 MIT 许可证。
- ⚠️ 例外：
android-app/src/com/deepseek/harness/vscreen/（虚拟屏）**移植自 [Operit](https
Frequently Asked Questions
What is deepseek-harness-android-app?
deepseek-harness-android-app is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by woaiys3. DeepSeek Harness 手机版：可直接安装的 Android APK，AI 免 Root 操作手机（Shizuku/root 可选），文件编辑只需所有文件访问权限，前台保活 + AI 通知. It has 353 GitHub stars.
Is deepseek-harness-android-app safe to use?
Yes. deepseek-harness-android-app passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
How do I install deepseek-harness-android-app?
Clone the repository with "git clone https://github.com/woaiys3/deepseek-harness-android-app" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is deepseek-harness-android-app written in?
deepseek-harness-android-app is primarily written in Java. It is open-source under woaiys3 on GitHub, so you can review or fork the full source.
Are there alternatives to deepseek-harness-android-app?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh deepseek-harness-android-app against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
271,622
40,575
JavaScript
AI Agentsai-agentsanthropic
Skills for Real Engineers. Straight from my .agents directory.
250,518
21,171
Shell
AI Agents
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
185,940
28,768
JavaScript
AI Agentsai-agentsanthropic