deepseek-harness-android

DeepSeek Harness 安卓版

English · 繁體中文 · 한국어 · 日本語

面向 Android 的本地 AI 工作台。 将 DeepSeek Harness、Ubuntu 运行环境、会话、插件与文件管理整合到手机中；开启相应授权后，AI 还可通过 Shizuku 执行设备 Shell（命令行）任务，或通过无障碍服务操作指定应用。

无需 Root（超级用户权限）。Linux 环境通过 PRoot 在用户空间运行，控制台由内置网页视图展示；模型推理使用你配置的服务。 目录 功能特性 工作原理 安装 模型供应商 可选的 Shizuku 集成 目标应用副屏（实验功能） 从源码构建 安全与隐私 参与贡献 项目数据 许可证 相关文档 功能特性 手机上的完整 Linux 智能体环境。 Ubuntu 24.04 完全在设备本地通过 PRoot 运行，不依赖云服务器或远程桌面；应用不要求注册自己的账号，也可按需在 Harness 内登录 DeepSeek 账号使用账号模型。 适配手机的 Harness 控制台。 壳内以首页、插件、设置三个底部入口组织功能，并为窄屏、横屏和安全区域提供适配；会话管理整合到首页。第三方网页插件的界面与依赖各不相同，兼容性需按插件和版本验证。 插件导入、更新与回滚。 支持从 npm 包名、HTTPS 压缩包链接或 git+https 仓库地址导入，管理包与子插件的启停；更新时按支持的目录规则保留数据，并可切回上一版。需要安装脚本、原生编译或不同核心 SDK 的包存在限制，详见插件管理。 文件与外观管理。 投递区支持文件夹分类；壳内可选图片或视频背景，调整卡片颜色、通透度、模糊程度、按钮与输入框不透明度及强调色；「DSH 主题」三级页可让 DSH 跟随当前主题、连背景一起同步，或恢复默认。 文件浏览、打开与分享。 「文件管理」页可浏览投递区与外部工作区，对普通文件可以分享或交给其它应用打开；官方文档预览顶栏也有「分享」按钮，点击直接调起系统分享面板。分享范围严格限制在内置工作区 root/1 下的普通文件，路径由原生重新解析并逐层 NoFollow 校验，工作区外的绝对路径、目录跳转和编码斜杠一律拒绝；找不到时提示「工作区里找不到这个文件」，与真正的读盘失败区分。 外部浏览器打开。 诊断页的「外置浏览器」可把 Harness 交给已安装浏览器完整使用（不是只读预览），「打开方式」可选「每次询问（系统选择器）」或固定某个浏览器；固定项被卸载后自动回到每次询问。 设置自动保存与预启动。 设置页没有统一的底部保存条：离开页面或切到后台自动保存一次并提示「设置已保存」；「模型与密钥」页另有「保存密钥」按钮，没有改动时置灰。可选的「打开应用时预启动服务」会在运行环境就绪且已保存模型凭据时先把本机服务拉起来，不替你跳转页面，默认关闭。 免 Root 运行。 在普通原厂设备上即可通过 PRoot 实现用户空间容器化。可选的 Shizuku 集成可在用户主动授权后额外提供 Shell 级别的设备终端（/system/bin/sh）。Shizuku 提供的是安卓 Shell 权限，而非 Root 权限。 开箱即用、支持离线安装。 正式版 APK 内置经过校验的

应用分为三层：

1. 管理界面（Capacitor + React）。 原生安卓外壳，负责运行时安装、服务控制、模型供应商设置、终端、运行时来源与环境重置。 2. 原生运行时层（Kotlin）。 负责根文件系统的校验与解压、以原生库形式随包提供的 PRoot 运行器与加载器管理、Harness 进程与 PTY 会话监管，以及在用户授权后连接 Shizuku UserService。 3. Ubuntu 运行时（PRoot）。 通过固定的白名单入口在 Ubuntu 24.04 内启动 dsh web 并仅监听回环地址。Node.js 预加载模块会在任何请求到达 Harness 之前校验当次启动令牌，内置 WebView 也被限制在同一回环源内。

完整架构与安全边界见 docs/ARCHITECTURE.md。 安装

1. 从 Releases 页面下载最新版 APK，并阅读该版本的发布说明。 2. 安装 APK（按系统提示允许来自可信来源的安装）。 3. 打开应用，跟着三步引导走完：免费声明 → 配模型 → 装运行环境。 免费声明：软件完全免费且开源，官方下载渠道只有本项目的 GitHub Releases；没有付费版或付费代装，遇到收费请退款并举报。 配模型：粘贴一份 DeepSeek API Key 点保存。首次配置不遮罩密钥，方便确认粘贴完整；这一页只填 Key。 装运行环境：官方 APK 已内置镜像，点「安装运行时」等进度走完即可，无需联网；自行构建的 APK 通常没有内置镜像，改走「安装失败？去在线下载其它版本」→「版本管理 → 在线可用版本 → 下载到版本库」→「切换至此版本」。 三步走完窗口就结束；凭据与运行环境都齐了，回主界面点「打开对话」开始。 4. 之后想改配置，用设置 → 模型与密钥；运行环境与版本在设置 → Ubuntu 运行时 / 版本管理。

逐步的操作与排错见 首次配置。 环境要求 Android 8.0 及以上、arm64-v8a（64 位 ARM）处理器的设备。 数 GB 左右的可用存储空间，用于存放解压后的 Ubuntu 环境。 至少一个受支持模型供应商的 API Key、一个 DeepSeek 账号授权，或一个兼容的自定义端点。 官方 APK 内置运行时镜像，可全程离线安装；自行构建的 APK 若未打包镜像，首次安装需要联网下载一份经摘要校验的运行时。 模型供应商

内置供应商：DeepSeek、OpenAI、Anthropic、Google Gemini、Ope