DeepseekHarness-Android - 在安卓手机上用一句话驱动 DeepSeek Harness 的社区客户端

DeepseekHarness-Android 是一个把 DeepSeek Harness（dsh）运行在安卓手机上的开源客户端。按项目自述，它的目标是「一句话，让手机替你办事」：用户用自然语言描述任务，agent 便去整理文件、操作 App、修改系统设置，或者按条件自动执行。它适合希望在手机上直接使用 agent 能力、又不想折腾 root 或 Termux 的用户，也适合想研究「agent 引擎 + 原生设备能力」如何衔接的开发者。

维护者与状态

项目由 jackwener 维护，仓库创建于 2026-10-27，最后一次提交在 2026-10-29。最新 release 为 v0.1.8，发布于 2026-10-29。截至 2026-10-30，仓库星标数为 246。从时间线看，这是一个刚起步、迭代节奏较快的项目，版本号仍处于 0.1.x 阶段。

主要能力

以下能力均据项目 README 自述整理，未经本站实际验证。

• 文件处理：查找、整理、移动、重命名、压缩解压，并能读取 PDF、Word、Excel、PPT 中的文字。
• 屏幕与 App 操作：基于无障碍服务实现读屏、点击、滑动、输入，可打开 App 或跳转到指定页面。
• 系统设置：调节亮度、音量、勿扰、闹钟、Wi-Fi、蓝牙、定位，读取和回复通知，控制媒体播放。
• 自动化：支持定时执行，也可在连接指定 Wi-Fi 或蓝牙、开始充电、到达某地、收到通知等条件下触发。
• 多模型服务：除 DeepSeek 外，可添加 OpenAI、Claude、Gemini、Grok、OpenRouter、Kimi、智谱 GLM、通义千问、火山方舟、MiniMax、硅基流动、阶跃星辰，或任意 OpenAI 兼容接口，填入 key 并拉取模型列表后即可在模型选择器中切换。
• 完整的 dsh：README 称 dsh 原样运行、没有 fork，技能、MCP、子 agent、网页搜索均可使用。
• 无需 root 或 Termux：安装一个 APK 即可使用；Shizuku 为可选项，用于解锁更多系统开关。

架构方面，项目说明将 Node 24 编译为安卓原生共享库，通过 JNI 在独立的 :engine 前台服务中启动 dsh，因此不依赖 proot 或 Termux；App 只通过 dsh 的 SDK 协议与其通信，安卓相关适配放在插件和少量补丁里，设备工具则由 Kotlin 实现并通过私有 socket 通道暴露给 dsh。

使用入口

仓库地址：jackwener/DeepseekHarness-Android。

据项目说明，使用流程大致为：从 Releases 下载 APK 并安装（arm64，Android 10 及以上）；登录 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 生成 engine.zip，最后执行 ./gradlew :app:assembleDebug -Pdsh.engineOut= 打包 APK。

许可与限制

项目采用 Apache-2.0 许可证。README 说明内置的第三方组件（Node.js、dsh、dsh-llm-service-lite、Shizuku、ripgrep 等）各自遵循其原有许可证；项目同时声明自己是社区项目，与 DeepSeek 官方无关联，也未获其背书。

项目自述的已知限制包括：

• 锁屏限制：存在安全锁屏时，系统不允许操作其他 App 的界面，这类任务会暂停并提示解锁后继续；文件、设置、通知等系统 API 类任务在锁屏时仍可执行。
• Shizuku 需重启：设备重启后需要重新启动 Shizuku，建议开启其「开机启动（无线调试）」，该功能需要 Shizuku 13.6 及以上、Android 11 及以上。
• 部分定制 ROM：部分机型需手动允许「后台弹出界面」和「自启动」，悬浮球与后台自动化才能稳定工作，App 的体检页会给出提示。
• 第三方模型：仅支持 OpenAI 兼容的 Chat Completions 接口（HTTPS）；上下文统一按 128K 计，不提供推理等级选择；联网搜索由 DeepSeek 提供，使用第三方模型时需另外配置 DeepSeek API key；工具调用效果取决于所选模型。
• 冷启动：引擎冷启动目前约 5 秒，项目称仍在优化。
• 硬件与体积：需要 Android 10 及以上、arm64-v8a，安装包约 110 MB，建议预留 500 MB 可用空间，并需能访问 DeepSeek API。

上述限制与体积、耗时数字均来自项目自述，实际表现可能因机型与系统版本而异。