安卓本地运行器 ATRI072121/DSH-forAndroid

DSH for Android

| English

在 Android 手机和平板上本地运行 DeepSeek Harness（dsh）。

DSH for Android 把 Android 宿主、Node.js 运行环境和 dsh Web 界面整合进应用，支持会话、文件与终端工具、插件和悬浮对话窗。应用运行无需连接电脑；调用在线模型仍需要网络，以及相应的模型服务账号或 API 凭据。

这是由 ATRI072121 维护的第三方 Android 适配项目，并非 DeepSeek 官方 Android 客户端。当前交付版本为 0.2.1，使用的 dsh 内核版本为 0.2.1-rc.2。

主要功能

- 本地运行环境：使用适用于 Android 的 bionic 运行时，在设备上启动 Node.js 和 dsh。
- 应用内工作界面：通过 WebView 访问本机 dsh，提供聊天、会话与工具操作入口。
- 插件支持：提供基础版和全插件版，可按需求选择。
- 三种权限模式：基础模式、Shizuku 模式、Root 模式，启动时检查所选权限是否可用。
- 手机控制：全插件版提供截屏、读取 UI 层级、点击、按键、文本输入和启动应用等工具，需 Shizuku 或 Root 权限。
- 悬浮对话窗：可拖动悬浮球、展开输入与回复面板，复用主界面的会话。
- 开发工具环境：发行包包含 npm、Git、Python、C/C++ 等工具；具体可用性取决于设备和依赖的平台支持。

下载与安装

前往 Releases 下载 APK。

| 版本 | 内容 | 适合场景 |
| 基础版 | dsh 核心、官方基础与 Web 功能 | 希望减少附加插件、先体验核心功能 |
| 全插件版 | 基础功能及随交付提供的社区插件、手机控制插件 | 需要更多插件和设备交互工具 |

当前提供的运行时面向 arm64-v8a。清单最低要求为 Android 8.0 / API 26；兼容性仍取决于 ROM、系统 WebView 和设备权限。原交付记录中的验证设备为 OPPO OPD2413、Android 16，其他设备需自行验证。

1. 下载并安装所需版本，按系统提示允许安装来自该来源的应用。
2. 启动应用，选择基础、Shizuku 或 Root 模式。
3. 阅读并确认应用内说明，等待首次运行环境准备完成。
4. 在 dsh 设置中配置模型服务，再创建会话开始使用。
5. 使用悬浮对话窗时，按提示授予悬浮窗权限；需要后台运行时，可在系统设置中允许应用后台活动。

使用 Shizuku 模式前，请先从 Shizuku 官方项目 获取管理器，启动服务并授权本应用。Root 模式需要设备已有可用的 su 权限。

权限模式

| 能力 | 基础模式 | Shizuku 模式 | Root 模式 |
| dsh 会话与应用内工具环境 | 支持 | 支持 | 支持 |
| 手机控制插件的系统交互 | 不支持 | 需授权 | 需授权 |
| 通过对应权限执行系统命令 | 应用自身权限 | shell 权限 | Root 权限 |
| 项目提供的 bwrap 兼容实现 | 不支持 | 不支持 | 取决于内核支持 |

权限模式与 APK 版本是两个独立选项。手机控制还需要相应插件；选择更高权限不会自动安装插件。系统命令可能修改设备上的文件和设置，请先确认操作内容。

项目结构

app/
AndroidManifest.xml 应用与权限声明 assets/ 自检脚本、链接清单与界面图片 res/ Android 资源 src/dev/dsh/android/ Android 宿主 Java / AIDL 源码 _payload-scripts/ 依赖提取、平台补丁与版本记录 _payload-src/ bwrap 兼容实现及启动脚本 _tools/r8-rules.txt 构建配置 build-apk.ps1 Windows PowerShell 构建脚本 LICENSE GPL-3.0 协议全文 THIRD_PARTY_NOTICES.md 第三方组件说明

开发与构建

本仓库发布的是交付源码包中的 Android 宿主源码和构建辅助文件。预编译运行时、完整 npm 依赖树、Android SDK/NDK、Shizuku API JAR 和签名文件未纳入 Git。仅克隆仓库不足以直接重建发行 APK，现有脚本也保留了需要按本机环境检查的路径和参数。

开发前需要准备：

- Windows、PowerShell 和 JDK 21。
- Android build-tools 34、Android 平台 android.jar、构建脚本指定的 JAR 工具及 Shizuku API JAR。
- 与应用匹配的运行时材料：_payload/termux.tar.gz、_payload/nm.tar.gz、_payload/termux-links.txt。
- 适用于 Android arm64 的原生模块；修改这些模块时还需要 NDK 和对应上游源码。
- 自己的签名配置，并检查构建流程中使用该配置的所有位置。
_payload-scripts/ 保存依赖处理脚本，构建前需根据脚本的相对路径准备工作目录。第三方插件与原生依赖需另外准备，不应将这里的脚本视为完整的依赖下载或一键构建流程。上述材料齐备、路径和参数调整完成后，构建入口为：

.\build-apk.ps1
输出：out\dsh-android.apk

本次仓库发布未重新构建 APK；Releases 提供的是随项目交付的现有安装包。源码中的应用版本字段保留原值，请以 Release 标签区分交付版本。

已知限制

- 本地运行 dsh 不代表模型在设备上离线推理；模型能力取决于所配置的服务。
- 部分桌面插件、Windows 专用二进制和依赖 glibc 的原生模块不能直接在 Android 使用；需要外部服务的插件仍需配置服务地址。
- 文件系统与进程隔离能力取决于设备内核及权限，不能假定具备完整的桌面环境隔离能力。
- 图像接口的部分旋转和色彩操作尚不完整。
- 悬浮窗的英文过滤可能同时过滤英文回答，需要保留英文时可关闭对应开关。
- 后台驻留、悬浮窗和系统输入操作受设备厂商的后台及权限策略影响。

反馈与参与

欢迎通过 Issues 报告问题，或提交 Pull Request。反馈时请附上 APK 版本、设备型号、Android 版本、权限模式和复现步骤。分享日志前请移除 API 密钥、账号信息及私人会话内容。

开源协议与致谢

本项目原创 Android 适配代码按 GNU General Public License v3.0（GPL-3.0-only） 发布，协议全文见 LICENSE。软件按协议规定以现状提供，不附带担保。

感谢 DeepSeek Harness、Termux、Node.js、Shizuku 及相关插件与工具的贡献者。第三方组件保留各自的版权和许可证，详见 THIRD_PARTY_NOTICES.md。