by Soodok
Run the DeepSeek Harness AI agent natively on Android — no root, no Termux, extension center included | 手机本地运行 DeepSeek Agent,免 Root 免 Termux
# Add to your Claude Code skills
git clone https://github.com/Soodok/Deepseek-Harness-Local-AndroidGuides for using ai agents skills like Deepseek-Harness-Local-Android.
Last scanned: 10/7/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-07T10:53:40.464Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how Deepseek-Harness-Local-Android compares with popular alternatives.
Deepseek-Harness-Local-Android is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Soodok. Run the DeepSeek Harness AI agent natively on Android — no root, no Termux, extension center included | 手机本地运行 DeepSeek Agent,免 Root 免 Termux. It has 574 GitHub stars.
Yes. Deepseek-Harness-Local-Android 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.
Clone the repository with "git clone https://github.com/Soodok/Deepseek-Harness-Local-Android" and add it to your Claude Code skills directory (see the Installation section above).
Deepseek-Harness-Local-Android is primarily written in Kotlin. It is open-source under Soodok on GitHub, so you can review or fork the full source.
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-Local-Android against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery 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.
Automated security scan — not a certification.
See comparison
| 维度 | 我们的做法 |
|---|---|
| 原生启动 | 2.3 秒(低端 3 GB 设备也能跑起来) |
| Linux 容器启动 | 1.33 秒,容器层只占 0.8% |
| 手机端编译 | clang + JDK 17 + gradle + cmake + rustc + go |
| 手机能力接入 Agent | 176 条路由 / 42 条目录项 / 21 个独立开关 |
下面三部分,逐条拆解这三件事背后的实现。编译环境支持最广,所以放在最前面讲。
把「快」和「能编」同时做好,是这件事里最难的一档。多数方案会先解决其中一个:
apk / apt;我们两条路都做到了快,而且容器这一层几乎不带来额外开销。
execve,不套中间层整套 Node.js 运行时被编译成 Android 原生(bionic)二进制,直接打进 APK。它不需要「搭建」——没有 rootfs 要铺、没有伪文件系统要挂、没有软件源要初始化。冷启动只剩三件事:解压(仅首启一次)、用 execve 启动 Node、等待回环端口就绪。
| 场景 | 设备 | 冷启动到引擎就绪 |
|---|---|---|
| 真机实测 | 一加 15T(Android 16) | 2.3 秒 |
| 主流中端 | 各品牌 Android | 5 ~ 6 秒 |
| 极端低端 | 紫光展锐手表(3 GB 内存) | 13 秒 |
| 模拟器 | x86_64 / 2.5 GB | 2.2 ~ 2.7 秒 |
作为参照:基于 proot 的方案在中低端设备上容易受限于内存与启动开销,主流机型上启动通常在十几秒量级;首次手工搭建 Linux 环境则需要数分钟。
一台 3 GB 内存的手表能把整套引擎跑起来——同内存下,
proot+ glibc 连 rootfs 都铺不开。这不是调参调出来的,是架构差异。
从新版本开始,两条路径都注入了 Node.js 编译缓存(NODE_COMPILE_CACHE),把 JS 模块的编译产物落到磁盘,下次启动直接复用,省掉重复解析与编译。
干净 A/B 对照(同一模拟器、x86_64、各 3 轮、每轮清场):
| 状态 | 三轮结果 | 中位数 |
|---|---|---|
| 缓存命中 | 3652.2 / 3416.8 / 3385.7 ms | 3416.8 ms |
| 缓存清空 | 4540.2 / 4088.8 / 4528.4 ms | 4528.4 ms |
启动耗时减少 1111.6 ms,约 24.5%,缓存落盘体积为 15 MB。
有一个必须处理的细节:NODE_COMPILE_CACHE 是懒写盘的。不注入刷盘器时,跑完一整轮后,缓存目录也只有 16 KB——缓存等于不存在。所以我们内置了 node-compile-cache-flusher.cjs,在原生与容器两条路径中都注入它,让缓存真正落盘,达到 15 MB。
这是当前唯一还有正收益的启动优化项,已进入产线。
这是最反直觉的一条数据。
在自研容器 dsh_alpine 里,跑一条命令只要 2.4 ms;「从零 → 进 Linux → 引擎就绪」的端到端耗时中位数为 1.33 秒。
拆开看这 1.33 秒花在哪:
| 环节 | 占端到端耗时 |
|---|---|
| 容器层本身(路径翻译 + SIGSYS 处理 + ELF 加载) | 0.8% |
| 引擎插件加载(Node 侧) | 96% |
结论:容器这层几乎不花时间。 换任何 OS 级方案,瓶颈都在 Node 加载插件所占的那 96%,不在容器——而那 96% 恰恰是唯一无法绕过、也不该绕过的部分。
同一台设备(OPPO PLZ110 / Android 16 / 内核 6.12.38)横向对照:
| 方案 | 进 Linux 跑一条命令 |
|---|---|
我们的 dsh_alpine |
2.4 ms |
| 真 chroot(需 root) | 1.6 ms |
proot(免 root) |
19 ~ 33 ms |
我们只比需要 root 的真 chroot 慢约 1 ms(就是路径翻译与信号处理的成本),但比 proot 快 8 ~ 14 倍。
内存表现同样干净——跑引擎时与真 chroot 几乎等同(容器 180186 MB vs 真 187 MB),容器 loader 自身 RSS 仅 1.8 MB。文件 IO 比 chroot 181proot 快约 30 倍,syscall 快 2.7 倍。
换句话说:我们不是「在慢的基础上做优化」,而是把容器这一层做到了接近零开销。免 root,却有 root 级的性能。
| 决策 | 换来了什么 |
|---|---|
| bionic 原生运行时,不走 glibc、不套容器 | 省掉用户态翻译,省掉 rootfs 解压与挂载 |
| 容器用 seccomp + SIGSYS,不用 ptrace | 省掉 proot 的全量 syscall 拦截与用户态模拟 |
| 编译缓存落盘(两条路径都注入刷盘器) | 复用 JS 编译产物,再省约 1.1 秒 / 24.5% |
| 运行时预置进 APK(130.8 MB → 解压 418.1 MB / 15292 个文件) | 首启不用下载,装完即用,断网也能启动 |
targetSdk = 28(sideload 策略) |
豁免 Android 10+ 的 W^X,可直接 execve 私有目录二进制 |
CI 收集 + SONAME 去重 + SHA 校验,全部 .so 16 KB 页对齐 |
产物可复现;Android 15+ 的 16 KB 页内核直接可用 |
另有一条:前端注入 polyfill,把 WebView 门槛从 Chrome 126 拉回 85——国产 ROM 常见的 96 实测可用。
门槛分两笔账,别混:JS 侧(语法 + API)确实是 85,构建期用 esbuild 把
static {}转译掉、再补 20 项现代 API(共 22 处安装:按 API 名去重 20 项,其中groupBy分挂Object与Map两处、any/timeout/abort/throwIfAborted亦同名分挂),MIN_CHROME = 85就是按它定的;CSS 侧做不到 85 —— 上游样式表用了:has()(105)、color-mix()(111)、anchor()+position-try(125),在 85–124 上是静默降级(不报错、不白屏,但部分样式与弹层定位失效,例如anchor()缺失时弹出面板会落到视口顶部)。抬门槛会砍掉一大批现役设备,所以选择留在 85 并用客户端插件兜底已知的定位缺口,详见「边界」。
这是整件事里我们最想强调的一块,也是同类方案里缺口最大的一块 —— 编译环境支持最广。别的方案要么只能跑脚本,要么得你自己折腾半天搭环境;这里一键装完就能编。
20 套工具链,一键装,装完就能编。
扩展中心里一共 57 个条目,分 8 类(编译构建 / 交叉编译 / 调试分析 / 逆向分析 / 语言运行时 / 系统与多媒体 / 终端工具 / 网络与组网)。其中编译相关的就是下面这 20 套工具链,剩下的是给 Agent 直接调用的能力包 —— 比如逆向分析(radare2、jadx、binwalk 等)、组网(tailscale、wireguard、frp 等)、调试(gdb、strace、valgrind)。
| 分类 | 工具链 | 提供的二进制 |
|---|---|---|
| C / C++ | Clang / LLVM | clang clang++ make |
| JVM | OpenJDK 17 | java javac jar |
| Android 构建 | android-buildtools | aapt aapt2 apksigner gradle d8 |
| 构建系统 | CMake | cmake |
| Rust | Rust | rustc cargo |
| Go | Go | go gofmt |
| Python | Python | python3 pip3 |
| 其他语言 | Ruby / PHP / Lua / Perl | ruby gem php lua perl |
| 版本控制 | Git | git |
| 打包 | Archivers | zip unzip xz |
| 媒体 | FFmpeg / ImageMagick | ffmpeg ffprobe magick convert |
| 数据库 | SQLite | sqlite3 |
| 远程 | OpenSSH / ADB | ssh scp adb fastboot |
| 本地推理 | llama.cpp | llama-server llama-cli llama-embedding |
| 编辑 | Vim | vim |
① 原生 C / C++ —— clang + make + cmake,能编出 .so、能编 NDK 工程。
② Java / Android —— OpenJDK 17 + gradle + aapt2 + apksigner + d8。这是一条真能打出 APK 的完整编译链,我们用它在手机上编过本项目的扩展。
这条路有一个很容易踩的坑:android-buildtools 内嵌的 gradle 启动脚本在 Android 的 toybox 环境里是开箱即坏的——/system/bin/xargs 是 toybox 版本,不剥引号,会把 "-Xmx64m" 原样传给 JVM,报 Could not find or load main class "-Xmx64m";内嵌 JDK 还把 user.home 与 java.io.tmpdir 硬编码为某个外部环境的固定路径。我们在安装期打补丁修掉了这些问题(issue #86),现在开箱可用。
③ 更多语言 —— rustc / cargo、go、python、ruby、php、lua、perl,各自采用独立闭包安装,并进行 SHA-256 校验和原子发布。
第三条重点中,兼容性是最容易被忽略、却最实用的一层:
| 你要跑的 | 走哪条 |
|---|---|
| 常规 Node / Python / Go / Rust / C 工具链 | 原生 bionic(2.3 秒启动,本地工具链直接可用) |
| 只发布 glibc 构建的预编译 CLI | Linux 容器(Ubuntu rootfs,apt 装依赖) |
需要 apk add / apt install 装任意系统软件 |
Linux 容器(Alpine 或 Ubuntu) |
| 需要 jemalloc / libnuma 这类 glibc 专有库 | Linux 容器(glibc 2.39 完整用户态) |
两条路线共用同一套引擎代码、同一个 $DSH_HOME、同一份工作区。 切换路线不需要重装、不需要重新配置、不需要第二个 App。
把两条同时打通、还都保持秒级启动,是这件事最难的地方。我们把两条都做成了开箱可用。
可选加装,默认关闭。 这是一套自研的免 root 用户态容器:
| 特性 | 实现方式 |
|---|---|
不依赖 ptrace |
seccomp BPF 捕获指定 syscall + SIGSYS handler |
| 不依赖 user namespace | 固定基址 0x2000000000、ET_EXEC 非 PIE、自写 ELF loader |
不依赖 chroot |
用户态路径翻译,/proc /sys /dev 宿主透传 |
| 不要求 Root | 全程在 App 沙箱内运行 |
| 双向端口映射 | seccomp 同时改写 guest 与 host 侧端口 |
首次启动时,容器通过 self-reexec 完成 guest 用户态接管,之后运行的就是一个正常的 Linux 进程树。
两套 rootfs 任选:
| 发行版 | libc | 包管理器 | 来源 | 压缩 | 解压 |
|---|---|---|---|---|---|
| Alpine 3.22 | musl | apk |
APK 内置,离线可用 | 3,979,016 B | 8,510,313 B |
| Ubuntu 24.04 base | glibc 2.39 | apt |
首次联网下载 | 29,936,675 B | 100,784,109 B |
实测:容器启动 31 ms;Ubuntu 冷启 2.6 ~ 4.2 秒;Alpine 冷启 0.1 秒级。Ubuntu 比 Alpine 慢一个量级,是由发行版自身开销(glibc + init 脚本链)决定的,不是加载器缺陷。
注意:这不是安全沙箱。它保证兼容性和性能,不隔离不可信代码。
编完直接起本地服务,在手机内的 WebView 中预览:
「在当前工作区建个项目,编译它,起个开发服务器,把 127.0.0.1 预览链接发我。」
Agent 会真的执行:建目录 → 写代码 → make / gradle build → 起服务 → 给你回环链接。
不提供 X11 / Wayland 桌面,图形结果走本地 HTTP + WebView 预览。
有一批同类项目在某些方面做得比我们好——界面更成熟、移植适配更广。我们也承认这一点。
有了能编译的环境,接下来是另一半:这些能力得能被 Agent 真正调用。而「Agent 到底能替你操作多少东西」,是这一层里更难被补上、我们投入最多的部分。
我们的上限是:只要 Android 肯给,Agent 就能用。
1354 项权限声明,真机实收 432 项。提供 176 条 HTTP 路由、42 条自描述目录项,配有 21 个独立能力开关——每项能力都要用户单独点头,不是一把梭全开。
| 层面 | 能力 |
|---|---|
| 看 | 无障碍节点树(含坐标 / 角色 / 可点性)、截图(不弹 MediaProjection 授权框)、OCR 兜底、帧差判断、屏幕变化监控 |
| 动 | 点按 / 长按 / 双击 / 滑动 / 拖拽 / 双指缩放 / 输入 / 按键 / 启动 App / 构造 Intent / 滚动查找 / 滚动收集 / 等待 / 条件分支 |
| 闭环 | 21 个动作原语组成的 PICK → ACT → VERIFY → RETRY 执行器;执行失败时会换锚点、换动作、换路径,并把失败证据(候选列表、截图、原因)交回决策层 |
| 看见它的手 | dev hand 在屏幕上画出 AI 即将点击的点:绿 = 点击 / 橙 = 长按 / 蓝 = 滑动,2.5 秒淡出,不吃触摸事件 |
| *感知 |