DSH 安卓版：手机本地 AI 工作台

项目简介

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

无需 Root，Linux 环境通过 PRoot 在用户空间运行，控制台由内置网页视图展示，模型推理使用你自己配置的服务。

主要功能

• 手机上的完整 Linux 智能体环境：Ubuntu 24.04 完全在设备本地通过 PRoot 运行，不依赖云服务器或远程桌面；不要求注册应用账号，也可按需在 Harness 内登录 DeepSeek 账号使用账号模型。
• 适配手机的 Harness 控制台：以首页、插件、设置三个底部入口组织功能，为窄屏、横屏和安全区域做适配，会话管理整合到首页。第三方网页插件的兼容性需按插件和版本验证。
• 插件导入、更新与回滚：支持从 npm 包名、HTTPS 压缩包链接或 git+https 仓库地址导入，可管理包与子插件的启停；更新时按目录规则保留数据，并可切回上一版。
• 文件与外观管理：投递区支持文件夹分类；可选图片或视频背景，调整卡片颜色、通透度、模糊程度、按钮与输入框不透明度及强调色；「DSH 主题」页可让 DSH 跟随当前主题或恢复默认。
• 文件浏览、打开与分享：文件管理页可浏览投递区与外部工作区，普通文件可分享或交给其它应用打开；分享范围严格限制在内置工作区 root/1 下的普通文件，路径由原生重新解析并逐层 NoFollow 校验。
• 外部浏览器打开：诊断页的「外置浏览器」可把 Harness 交给已安装浏览器完整使用，「打开方式」可选每次询问（系统选择器）或固定某个浏览器。
• 免 Root 与可选 Shizuku：普通原厂设备即可通过 PRoot 实现用户空间容器化；Shizuku 集成在用户主动授权后额外提供 Shell 级别的设备终端（/system/bin/sh），这是安卓 Shell 权限而非 Root 权限。
• 开箱即用、支持离线安装：正式版 APK 内置经过校验的 rootfs.bundle 与清单文件，无网络环境也能完成运行时安装。
• 防篡改的运行时分发：清单与根文件系统镜像在使用前按精确长度与 SHA-256 校验，下载仅接受 HTTPS 目标地址，支持范围请求断点续传，解压时具备路径穿越与设备节点防护。
• 内置与自定义模型供应商：DeepSeek、OpenAI、Anthropic、Google Gemini、OpenRouter、Groq、xAI、Mistral 以及自建 OpenAI 兼容端点均可配置 API Key；DeepSeek 还支持官方账号授权。
• 本机控制台访问：Harness 只绑定 127.0.0.1，每次启动生成全新的 256 位传输令牌，同时保护 HTTP 与 WebSocket 请求。
• 集成终端：可在同一界面使用 PRoot 环境内的 Ubuntu 终端，以及可选的 Shizuku 安卓设备终端。
• 运行时自检（18 项）：按固定顺序探测 Shell、Node.js、沙箱启动器、PTY、编译能力、设备事实等，可选能力缺失只标 warn，并报告可用空间。
• 两步首次配置：首次启动走「配模型 → 装运行环境」，窗口只做配 API Key 与装运行环境两件事；本机没有模型凭据时不会直接打开 Harness。

安装与使用

1. 从 Releases 页面下载最新版 APK，并阅读该版本的发布说明。
2. 安装 APK（按系统提示允许来自可信来源的安装）。
3. 打开应用，跟着两步引导走完：配模型 → 装运行环境。
   • 配模型：粘贴一份 DeepSeek API Key 点保存。首次配置不遮罩密钥，方便确认粘贴完整。
   • 装运行环境：官方 APK 已内置镜像，点「安装运行时」等进度走完即可，无需联网；自行构建且未打包镜像的 APK 改走在线下载流程。
4. 之后修改配置用「设置 → 模型与密钥」，运行时与版本在「设置 → Ubuntu 运行时 / 版本管理」。

环境要求：Android 8.0 及以上、arm64-v8a 处理器；数 GB 左右可用存储空间；至少一个受支持模型供应商的 API Key、DeepSeek 账号授权或兼容的自定义端点。

从源码构建需要 Node.js ^22.19.0 或 >=24.0.0、pnpm 11、Android SDK 35、NDK、CMake 3.22.1、JDK 21、Gradle 8.11.1：

pnpm install --frozen-lockfile
pnpm run build
pnpm run android:sync

注意事项

• 模型数据去向：本机控制台不等于离线模型，对话、AI 工具返回的文件内容及截图可能进入当前会话并发送至所配置的模型服务。开启 Shizuku Shell 后，请不要让模型读取或回显密钥、短信、通讯录、令牌等隐私数据。
• Shizuku 版本兼容：0.3.5 及更早版本与 Shizuku 13.6.0 同时使用时，用户服务会在启动阶段退出，表现为「Shizuku 连接未就绪」或连接超时；0.3.6 起已修复，升级应用即可。更新 Shizuku 应用后若连接超时，请在 Shizuku 里停止服务再重新启动。
• 无障碍自动化：需要你在系统设置中手动开启服务，再在应用内选择目标包名并保存白名单；服务不能绕过锁屏，也不保证厂商后台策略下的持续运行。
• 后台保持：前台服务可提高运行时进程的存活优先级，但不能阻止系统在内存、电量或厂商策略下结束进程。
• 目标应用副屏（实验功能）：需要 Android 10 及以上、已连接 Shizuku 并开启 AI Shell；画面仍是逐帧取 PNG，不是视频编码通道。完整 Shizuku 授权与绑定链路、真实第三方应用、小窗互切、长期后台与锁屏恢复尚未验证。
• 许可证：应用代码基于 MIT 发布，APK 还以各自许可证再分发了 PRoot、Operit2 运行时工具链、Ubuntu 软件包、Node.js 等第三方组件，详情见仓库的 THIRD_PARTY_NOTICES.md。

本作品整理自 GitHub 开源项目 dphmoblie/deepseek-harness-android，原作者 @dphmoblie，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。