DeepSeek Harness安卓开源版v0.3.7 官方正版

编辑点评：安卓手机本地跑DeepSeekHarness,集成Ubuntu与Shizuku自动化。

DeepSeekHarness安卓版是一个把完整AI智能体工作台搬进手机的开源项目,将DeepSeekHarness、Ubuntu运行环境、会话管理、插件与文件管理整合在同一个应用内。用户配置自己的模型API Key后,AI可以在手机本地执行Shell命令、读写文件,授权Shizuku或无障碍服务后还能操作指定应用。Linux环境通过PRoot在用户空间运行,不需要Root权限,适合想在移动端体验本地AI智能体能力的用户。

使用方法

1、先在本站下载安装APK（按系统提示允许来自可信来源的安装）。

2、打开应用，跟着两步引导走完：配模型 → 装运行环境。

3、配模型：粘贴一份 DeepSeek API Key 点保存。首次配置不遮罩密钥，方便确认粘贴完整；这一页只填 Key。

装运行环境：官方 APK 已内置镜像，点「安装运行时」等进度走完即可，无需联网；自行构建的 APK 通常没有内置镜像，改走「安装失败？去在线下载其它版本」→「版本管理 → 在线可用版本 → 下载到版本库」→「切换至此版本」。

两步走完窗口就结束；凭据与运行环境都齐了，回主界面点「打开对话」开始。

4、之后想改配置，用设置 → 模型与密钥；运行环境与版本在设置 → Ubuntu 运行时 / 版本管理。

工作原理介绍

管理界面（Capacitor + React）。 原生安卓外壳，负责运行时安装、服务控制、模型供应商设置、终端、运行时来源与环境重置。

原生运行时层（Kotlin）。 负责根文件系统的校验与解压、以原生库形式随包提供的 PRoot 运行器与加载器管理、Harness 进程与 PTY 会话监管，以及在用户授权后连接 Shizuku UserService。

Ubuntu 运行时（PRoot）。 通过固定的白名单入口在 Ubuntu 24.04 内启动 dsh web 并仅监听回环地址。Node.js 预加载模块会在任何请求到达 Harness 之前校验当次启动令牌，内置 WebView 也被限制在同一回环源内。

环境要求

Android 8.0 及以上、arm64-v8a（64 位 ARM）处理器的设备。

数 GB 左右的可用存储空间，用于存放解压后的 Ubuntu 环境。

至少一个受支持模型供应商的 API Key、一个 DeepSeek 账号授权，或一个兼容的自定义端点。

官方 APK 内置运行时镜像，可全程离线安装；自行构建的 APK 若未打包镜像，首次安装需要联网下载一份经摘要校验的运行时。

DeepSeekHarness常见问题解答

使用DeepSeekHarness需要Root手机吗?

不需要。Linux环境通过PRoot在用户空间运行,普通原厂设备即可使用。Shizuku提供的是安卓Shell权限而非Root权限,且属于可选功能,不授权也不影响基础的文件读写和对话功能。

首次打开应用需要联网吗?

正式版APK内置了经过校验的rootfs.bundle与清单文件,无网络环境也能完成运行时安装。但如果需要使用远程模型API或下载插件,仍然需要网络连接。

DeepSeekHarness支持哪些模型服务?

内置支持DeepSeek、OpenAI、Anthropic、Google Gemini、OpenRouter、Groq、xAI、Mistral以及自建OpenAI兼容端点。用户填入对应服务的API Key后即可在应用内切换使用,密钥通过Android Keystore加密保存。

DeepSeekHarness下载优势

开源可查,项目源代码在GitHub公开,应用许可证为MIT,用户可以自行审查代码或根据需求调整。

免Root运行,通过PRoot实现用户空间容器化,普通原厂手机即可体验完整的Linux智能体环境,不需要解锁或刷机。

运行时防篡改,每份清单与根文件系统镜像在使用前按精确长度与SHA-256校验,下载仅接受HTTPS目标地址,解压时具备路径穿越防护。

模型选择自由,不绑定单一AI服务商,用户可以用自己已有的API Key接入DeepSeek、OpenAI、Claude、Gemini等多种模型。

DeepSeekHarness使用注意事项

Shizuku权限需谨慎授予,开启后AI可以执行设备Shell命令,虽然便利但也扩大了操作范围,建议仅在确有需要时开启,并在不使用时关闭授权。

模型调用会产生费用,应用本身免费开源,但使用DeepSeek或其他第三方模型的API时按各服务商的计费规则收费,请在配置前了解对应价格。

运行环境占用存储较大,内置运行时和Ubuntu环境需要约0.6GB以上的应用数据空间,安装前建议预留至少1GB可用存储,避免解压中途失败。

部分功能依赖设备兼容性,目标应用副屏操作需要Android 10及以上并配合Shizuku,低版本系统或部分定制ROM可能无法使用全部自动化能力。

DeepSeekHarness核心功能

1、本地Linux智能体环境:Ubuntu 24.04通过PRoot在手机本地运行,不依赖云服务器或远程桌面,智能体运行时与网页控制台均在设备内执行,无需注册账号。

2、模型供应商管理:支持DeepSeek、OpenAI、Anthropic、Gemini、OpenRouter、Groq、xAI、Mistral及自建OpenAI兼容端点,凭据通过Android Keystore加密,不会回传至WebView。

3、Shizuku与无障碍自动化:用户主动授权后,AI可通过Shizuku执行设备Shell任务,或通过无障碍服务读取屏幕、点击、输入,操作指定应用。

4、插件导入与回滚:支持从npm包名、HTTPS压缩包或git+https仓库地址导入插件,管理启停并在更新时保留数据,可切回上一版本。

5、集成终端与文件管理:同一界面中可使用PRoot环境内的Ubuntu终端和Shizuku支持的安卓设备终端,投递区支持文件夹分类管理文件。

DeepSeekHarness环境起不来怎么办

遇到运行时环境无法启动时,可以按以下步骤排查。

1、打开应用内的运行时自检功能,查看Shell、Node.js、沙箱启动器、PTY模块等18项检查结果,定位具体缺失的组件。

2、检查手机可用存储是否充足,运行时解压需要约0.6GB以上空间,低于512MB时应用会提示清理。

3、如果首次解压中途失败,确认下载的APK文件完整,可核对Release页面提供的SHA-256值。

4、尝试在控制台中重新触发运行时安装,或检查是否有系统权限(如存储权限)未授予。

DeepSeekHarness适用人群与使用场景

适合以下用户群体和使用场景。

1、想在手机上体验完整AI智能体工作流的开发者或技术爱好者,无需携带电脑即可测试Agent任务。

2、需要让AI在手机本地执行文件整理、脚本运行、批量处理等任务的用户,数据在设备内处理,不经过第三方服务器。

3、使用Shizuku进行手机自动化操作的用户,可以通过AI指令完成跨应用操作、系统设置调整等任务。

4、对开源项目感兴趣、希望自行审查代码或参与改进的技术用户,项目源码公开且采用MIT许可证。

精品相似程序