AB
AiBoss站
project

DSH-Android - 在安卓手机上免 root 运行 DeepSeek Harness 的手机 Agent

DSH-Android 把 DeepSeek Harness(dsh)装进安卓手机:不用 root、不用 Termux,装一个 APK 就能让 Agent 读屏、点按、整理文件、改系统设置、按条件自动执行任务。本文整理维护者与版本状态、项目自述的能力与入口、系统要求与已知限制。

DSH-Android 是一个把 DeepSeek Harness(dsh)搬到安卓手机上的开源项目。按项目自述,它的目标是让 Agent 直接在手机本地运行,替用户操作 App、整理文件、修改系统设置或按条件自动执行任务,而不需要 root,也不需要电脑或 Termux。它适合两类人:一是希望用自然语言驱动手机完成重复操作、又不想折腾刷机与命令行环境的普通用户;二是已经在电脑或服务器上使用 dsh、想把同一套 Agent 能力延伸到手机端的开发者。

维护者与状态

项目由 jackwener 维护,仓库创建于 2026-10-27,最后一次提交在 2026-10-30,节奏相当紧凑。最新正式版本为 v0.3.0,发布于 2026-10-30。截至 2026-10-31,仓库星标数为 522。从时间线看,这是一个刚起步、仍在快速迭代的早期项目,版本号也印证了这一点。

主要能力

以下内容均来自项目 README 的自述,属于维护者的描述而非中立评测。

  • 操作手机上的 App:README 举例包括用微信发消息、总结群聊、抓取小红书内容、在 BOSS 直聘上投递与打招呼、在淘宝下单等。Agent 通过无障碍服务读屏、点按、滑动、输入,也可以直接打开 App 或跳到指定页面;过程中用户可以随时暂停、停止或插话。
  • 不占用屏幕的并行操作:据项目说明,Android 14 及以上支持「不打扰模式」,配合 Shizuku 或自连 ADB 后,Agent 在虚拟屏幕上操作,用户可照常使用手机。
  • 悬浮球随时呼起:可在任意 App 内通过悬浮球对话、派活,或把当前屏幕内容发给它询问。
  • 文件处理:查找、整理、移动、重命名、压缩解压,并能读取 PDF / Word / Excel / PPT 中的文字。
  • 系统设置与通知:调整亮度、音量、勿扰、闹钟、Wi-Fi、蓝牙、定位;读取和回复通知,控制媒体播放。
  • 自动化触发:支持定时执行,也支持在连上特定 Wi-Fi 或蓝牙、开始充电、到达某地、收到通知等条件下触发。
  • 内置 Linux 环境:README 称手机里自带 Linux 环境,Agent 可以运行 Python、处理用户发来的文件、执行自己写的脚本。
  • 远程连接电脑:可通过 SSH 或 DSH Remote 连接电脑或服务器上的 DSH;只用远程模式时,手机无需安装本地运行环境。
  • 多模型服务:除 DeepSeek 外,可添加 OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、智谱 GLM、通义千问、火山方舟、MiniMax、硅基流动、阶跃星辰,或任意 OpenAI 兼容接口,填入 key 并拉取模型列表后即可在模型选择器中切换。
  • 完整的 dsh:项目强调 dsh 原样运行、没有 fork,技能、MCP、子 agent、网页搜索都可使用。

架构上,据 README 说明,Node 24 被编译成安卓原生共享库,通过 JNI 在独立的前台服务进程中启动,因此不需要 proot 或 Termux,也避开了安卓 12 之后的后台进程限制;App 只通过 dsh 的 SDK 协议与其通信,安卓相关适配放在插件和少量补丁里,设备能力则由 Kotlin 实现并通过私有 socket 通道暴露给引擎。

使用入口

项目仓库地址为 jackwener/DSH-Android,APK 与发布说明在该仓库的 Releases 中提供。

按 README 的快速开始,使用流程大致是:下载并安装 APK;登录 DeepSeek 账号或填入 API key,也可在「设置 → 模型服务」中添加其他服务商;直接用自然语言描述任务,例如「列出下载目录里最大的 5 个文件」,用到某项权限时 App 会引导开启;可选步骤是在「设置 → 手机权限」中一键安装 Shizuku,并在 Shizuku 里打开「开机启动(无线调试)」。

从源码构建需要 JDK 21、Android SDK(compileSdk 37.2)与 NDK r29。README 给出的步骤分三步:先运行 native/prebuilt.sh fetch 下载并校验预编译的原生库;再用 js/build-engine.sh 打包引擎(dsh + 插件 + 补丁)生成 engine.zip;最后通过 Gradle 的 :app:assembleDebug 并传入引擎产物路径构建 APK。在 arm64 Linux 主机上构建时,还需额外传入 aapt2 的覆盖参数。

许可与限制

项目采用 Apache-2.0 许可证。README 同时说明,内置的第三方组件(Node.js、dsh、dsh-llm-service-lite、Shizuku、ripgrep 等)遵循各自的许可证,使用与再分发时需分别核对。项目还声明自己是社区项目,与 DeepSeek 官方无关联、未获其背书。

系统要求方面,README 写明需要 Android 10 及以上、arm64-v8a 架构,安装包约 110 MB,建议预留 500 MB 可用空间,并且需要能访问 DeepSeek API。

已知限制(据项目自述):

  • 锁屏限制:存在安全锁屏时,系统不允许操作其他 App 的界面,这类任务会暂停并提示解锁后继续;文件、设置、通知等系统 API 类任务在锁屏时仍可执行。
  • Shizuku 需重启后重新启动:建议开启「开机启动(无线调试)」,该功能需要 Shizuku 13.6 及以上、Android 11 及以上。
  • 部分厂商 ROM 需手动放行:部分机型需要允许「后台弹出界面」和「自启动」,悬浮球与后台自动化才能稳定工作,App 的体检页会给出提示。
  • 第三方模型的能力边界:只支持 OpenAI 兼容的 Chat Completions 接口(HTTPS);上下文统一按 128K 计,不提供推理等级选择;联网搜索由 DeepSeek 提供,使用第三方模型时需另外配置 DeepSeek API key;工具调用效果取决于所选模型。
  • 冷启动耗时:引擎冷启动目前约 5 秒,项目表示仍在优化。
  • 安装拦截:由于不在 Google Play 分发且使用了无障碍、通知读取、短信等能力,Google Play 保护机制可能误判为有害应用,README 建议核对 APK 与发布说明中的 SHA-256 一致后再安装。

需要提醒的是,这类需要无障碍与通知读取权限的工具天然涉及较高的隐私与安全敏感度,是否授予权限、在哪些场景下使用,应由使用者自行评估。