DSH-Android：399 Stars 的安卓版 DeepSeek Harness，一个 APK 把 26 万星 Agent 引擎塞进手机最新版

一、项目概览

jackwener/DeepseekHarness-Android（简称 DSH-Android）是一个把 DeepSeek 官方的 Agent 引擎 deepseek-harness（dsh）原样搬上安卓手机的开源项目：免 ROOT、免 Termux，装一个 APK，就能用一句话让手机整理文件、操作 App、改系统设置，或跑定时/条件自动化。它和昨天我们评过的 Mika 同处”手机 AI 智能体”赛道，但技术路线完全不同——Mika 用纯 Kotlin 自己造轮子，DSH-Android 则是把 26 万星的 dsh 完整引擎嵌进 App 进程。

截至 2026 年 10 月 30 日的真实数据：

• Stars：399 / Forks：41 / Open Issues：19
• 创建时间：2026-10-27（仅 3 天冲到 399 Stars），最后推送 2026-10-30
• 许可证：Apache-2.0（内置 Node.js、dsh、Shizuku、ripgrep 等各自保留许可证）
• 语言：Kotlin（约 1.2 MB）为主，JavaScript（约 450 KB，即 dsh 引擎与插件）次之，另有 Python / Shell / C++ / AIDL
• 版本：v0.2.5（2026-10-30 发布，APK 约 94.6 MB，仅 arm64）
• 引擎：dsh 0.2.1 · Node 24（编译成安卓原生 libnode.so 嵌在 App 里）
• 上游：deepseek-ai/deepseek-harness 当前 266,490⭐ / 32,304 fork（”Everything is a Plugin”）
• 主页：无；作者声明为社区项目，与 DeepSeek 官方无关联、未获背书

它把自己定位为”社区项目”，并明确声明和 DeepSeek 官方无关——这点很克制。下面会专门讲它最硬核的工程亮点：怎么把整套 Node.js Agent 引擎塞进安卓还不踩坑。

二、它能做什么：dsh 的能力在手机上原样可用

• 文件：查找、整理、移动、重命名、压缩解压；能读 PDF / Word / Excel / PPT 里的文字。
• 屏幕与 App：基于无障碍服务读屏、点击、滑动、输入；打开 App 或直接跳到指定页面。
• 系统设置：亮度、音量、勿扰、闹钟、Wi-Fi、蓝牙、定位；读取和回复通知、控制媒体播放。
• 自动化：定时执行，或在连上 Wi-Fi/蓝牙、开始充电、到达某地、收到通知等条件下触发。
• 其它模型服务：除 DeepSeek 外，可加 OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、智谱 GLM、通义千问、火山方舟、MiniMax、硅基流动、阶跃星辰，或任意 OpenAI 兼容接口；填 key、拉模型列表即可在模型选择器里切换。
• 完整的 dsh：dsh 原样运行（没有 fork），技能（skills）、MCP、子 agent、网页搜索都能用——这是它相对”自己造轮子”类手机 Agent 最大的底气：直接继承 26 万星引擎的整个生态。
• 不需要 root 或 Termux：装一个 APK 就能用；Shizuku 可选，能解锁更多系统开关。

三、技术架构：把 Node.js 引擎嵌进 App 进程，是它最硬的部分

DSH-Android 的核心难点不是 Agent 逻辑（dsh 已经写好），而是“怎么在安卓上跑起一个完整的 Node 24 引擎，又不触发安卓 12 以后的幽灵进程限制、不用 proot、不用 Termux”。它的解法相当漂亮：

• 引擎嵌在 App 进程里：Node 24 被编译成安卓原生共享库（libnode.so），通过 JNI 在 :engine 前台服务中启动。不用 proot、不用 Termux，也就不会碰到安卓 12+ 的”幽灵进程”被杀限制。冷启动约 5 秒，仍在优化。
• dsh 不做 fork：App 只通过 dsh 的 SDK 协议和它对话，安卓相关适配全部放在插件和少量补丁里（device / guard / account 插件，dsh --profile android）。
• 手机能力在 App 侧：所有设备工具（文件、屏幕、系统、通知、媒体…）都由 Kotlin 实现，通过一条私有 socket 通道（能力桥 JSON-RPC，socketpair）暴露给 dsh。界面层与引擎层用 dsh SDK 的 JSON-RPC（stdio）通信。
• 双进程结构：:main 进程（Kotlin · Compose · Hilt · Room）负责对话、轨迹回看、审批、唤起层、设置、CapabilityHub、TriggerHub、无障碍/通知监听/系统助手/输入法；:engine 前台服务跑 libnode + dsh。架构文档（docs/ARCHITECTURE.md）和引擎契约（docs/ENGINE-CONTRACT.md）都公开。

一句话总结这套设计：把”Agent 大脑”交给成熟的开源引擎 dsh，自己只做”安卓手脚”（设备工具 + 引擎宿主）。这种”借力打力”的思路让它在几天内就拥有了一个完整且持续进化的 Agent 框架，而不是从零写规划/工具循环。

四、系统要求与安装

• 系统要求：Android 10 及以上，arm64-v8a；安装包约 110 MB，建议预留 500 MB 可用空间；需要能访问 DeepSeek API（或你配置的其他模型服务）。
• 1. 下载安装：从 GitHub Releases 下最新 APK（v0.2.5，arm64）。
• 2. 登录 DeepSeek 账号或填 API Key；或在 设置 → 模型服务 添加其它服务商。
• 3. 直接说要做什么，比如”列出下载目录里最大的 5 个文件”，用到权限时 App 再引导开启。
• 4. 可选：在 设置 → 手机权限 一键安装 Shizuku，并在 Shizuku 里开”开机启动（无线调试）”。
• 关于”已屏蔽有害应用”：它不在 Google Play 分发，又用到无障碍、通知读取、短信等能力，Play 保护可能误判。官方建议核对 APK 与发布说明里的 SHA-256 一致后，在手机弹窗点”更多详情 → 仍要安装”（别点”知道了”，那会取消）。用 adb install 时命令会卡住等你处理弹窗。

五、同类对比：DSH-Android vs Mika

同是”手机 AI 智能体”，DSH-Android 与昨天评的 Mika 正好代表两条技术路线：

怎么选：想要”开箱即用的完整 Agent 生态 + 多模型”选 DSH-Android；想要”后台不占屏、隐私零自有后端”的体验选 Mika。两者都开源、都 Apache-2.0、都不需要 root。

六、当前限制与诚实边界

• 锁屏后不能操作其它 App：安全锁屏下系统禁止操作别的 App 界面，这类任务会暂停等你解锁；但系统 API 类（文件、设置、通知）锁屏时照常执行。这是安卓系统限制，不是 bug。
• Shizuku 重启要重开：建议开 Shizuku 的”开机启动（无线调试）”（需 Shizuku 13.6+、Android 11+）。
• 国产 ROM 适配：部分机型需手动允许”后台弹出界面”和”自启动”，悬浮球和后台自动化才稳；App 体检页会提示。
• 第三方模型有取舍：只支持 OpenAI 兼容的 Chat Completions（HTTPS）；上下文统一按 128K 计、不提供推理等级选择；联网搜索由 DeepSeek 提供，用第三方模型时需另配 DeepSeek API Key；工具调用效果取决于所选模型。
• 冷启动约 5 秒，还在优化。
• Play 保护误报：见上面安装说明，认准官方 SHA-256。
• 通用风险：和所有手机自动化 Agent 一样，用自动化操作第三方 App/网站可能违反其 ToS，有被限制/封号风险；项目本身未提供”询问/自主”这类付款保护开关的详述，涉及敏感动作请人工确认。

七、结论：把成熟引擎”装进手机”的示范级做法

DSH-Android 最值得称道的是工程取舍的清醒：它不重复造 Agent 轮子，而是把已经 26 万星的 deepseek-harness 通过”Node 编译成原生库 + JNI 前台服务 + 私有 socket 能力桥”这套组合拳，干净地搬上了安卓，绕开了幽灵进程、proot、Termux 等一堆坑。结果是：你在手机上几乎白捡了一个完整、持续进化的 Agent 框架——技能、MCP、子 agent、网页搜索原样可用，还能接十几种模型。

代价也很明确：它没有 Mika 那种”后台虚拟屏不占屏”的体验，锁屏后不能操作别的 App，且引擎冷启动有约 5 秒开销；多模型下部分高级特性（推理等级、更长上下文）会被拉平。安装时还要过 Play 保护误报这一关（认准 SHA-256 即可）。

对”想在手机上跑一个真·Agent、希望功能全、模型多、又能自己改”的安卓玩家，DSH-Android 是目前开源里完成度最高的”dsh 上手机”方案之一；新手建议先从文件整理、系统设置这类系统 API 任务玩起，再逐步尝试操作 App 和自动化。要研究”Node 引擎内嵌安卓”的实现，它的 docs/ARCHITECTURE.md 和 docs/ENGINE-CONTRACT.md 是很好的参考资料。