DeepSeek Harness · 安卓移植增强版

中文 | English

把 DeepSeek Harness（DeepSeek 的 AI Agent）打包成装个 APK 就能用的安卓版。

不用 Termux、不用 root、不用配环境 —— 终端、文件访问、命令执行全部在 App 内运行。

English — DeepSeek Harness packaged as a ready-to-install Android APK. No Termux, no root, no setup: the terminal, file access and command execution all run inside the app. It can even compile, package, sign and release itself — entirely on the phone, without a computer.

⭐ 如果它帮你省了时间，给个 Star 是最好的反馈 —— 也让我知道继续维护值不值得。 用着有问题、或者有想要的功能，欢迎开 Issue。

下载安装（三步）

1. 打开 Releases，下载最新的 DeepSeekHarness-vX.Y-dist.apk（约 95 MB，Android 8.0 及以上）；
2. 安装后按首次引导给权限（无障碍、通知、悬浮窗等，可随时在系统设置里收回）；
3. 在设置页填入自己的模型 API Key 就能开聊 —— 不用装 Termux、不用 root、不用连电脑。

🌐 国内直连 GitHub 打不开？ 每个 Release 说明的第一条就是加速直链 （ghproxy 等镜像前缀 + 官方直链，哪个通用哪个）；也可以自己给官方直链加前缀： https://ghproxy.net/ 、 https://ghfast.top/ 、 https://gh-proxy.com/。

每个 Release 的说明里带该 APK 的 SHA-256，装前可以核对。

文档：安装与系统要求 · 权限与隐私 · 常见问题 · 升级与救援 · 自建环境与出包

⚠️ 更新前必读 —— 只从本仓库 Releases 更新

本 App 用本项目自己的钥匙签名。安装其它来源的同名 App（官方原版 / 上游作者的包 / 别人转发的 APK）会因签名冲突无法覆盖安装；此时若选择「卸载重装」， App 私有数据会全部清空（会话历史、运行环境、配置；没做过备份的话通常找不回来）。

遇到 INSTALL_FAILED_UPDATE_INCOMPATIBLE 报错时：不要卸载 —— 这个报错正是在保护你的数据。 升级前先备份：App 内「控制台 → 救援 → 导出全部数据」（开发者也可用 selfbuild/scripts/backup-dshhome.sh）。

完整说明与救援步骤 → docs/升级与救援.md

本发布包是 DeepSeek Harness 的安卓移植与增强版，由个人制作。 以下如实说明各部分来源。

一、我做了什么（相对上游的改动）

上游 woaiys3/deepseek-harness-android-app 提供的是安卓壳骨架（WebView + Service 结构、 payload 打包、权限引导）。在这个底子之上，本版本包含大量适配与增强：

1. 安卓适配补丁（25 条）

2. 可以在手机上自己出包

整条链路（proot + Alpine + OpenJDK 17 → javac → d8 → 重打包 → 签名）都跑在手机里， 不需要电脑。构建环境不进 APK，在「控制台 → 自建环境」里按需下载（约 193MB）。 怎么用、踩过哪些坑：docs/自建环境与出包.md。

3. 自研插件与补丁

• whale-shota —— 皮肤 / 桌宠扩展
• dsh-android-ui —— 安卓界面适配
• 背景图补丁、账户 UI 补丁

二、来源与许可

1. 安卓壳骨架 — MIT

MIT 许可允许修改、分发与再发布，要求保留版权声明与许可证文本。

2. DSH 引擎内核 — 归 DeepSeek 所有

3. 虚拟屏（vscreen）— LGPL-3.0

虚拟屏功能的实现移植/对齐自 Operit 的 shower 模块。相关源文件已带原始许可声明， 许可证全文见 licenses/lgpl-3.0.txt（LGPL-3.0 以 GPL-3.0 为基础，故同时提供 licenses/gpl-3.0.txt）。

三、免责

• 使用本包产生的任何后果由使用者自行承担
• 如对合规性有疑问、或发现归属遗漏，欢迎提 Issue 讨论
• 本包不修改、不绕过任何付费机制

四、许可全文位置

LICENSE                     MIT（本项目）
licenses/lgpl-3.0.txt       LGPL-3.0（虚拟屏部分）
licenses/gpl-3.0.txt        GPL-3.0（LGPL-3.0 的基础）
THIRD_PARTY_NOTICES.md      第三方组件逐项声明

⚠️ 更新前必读 —— 只从本仓库 Releases 更新

本 App 用本项目自己的钥匙签名。安装其它来源的同名 App（官方原版 / 上游作者的包 / 别人转发的 APK）会因签名冲突无法覆盖安装；此时若选择「卸载重装」， App 私有数据会全部清空（会话历史、运行环境、配置，不可恢复）。

遇到 INSTALL_FAILED_UPDATE_INCOMPATIBLE 报错时：不要卸载 —— 这个报错正在保护你的数据。 升级前建议先跑一次 selfbuild/scripts/backup-dshhome.sh。

完整说明与救援步骤 → docs/升级与救援.md

⬇️ 下载（国内加速直链，任选一条通的就用）

本版安装包：DeepSeekHarness-v1.36-dist.apk（约 95 MB，Android 8.0+）

安装：下载 → 允许「安装未知应用」→ 打开后按引导给权限 → 在设置页填自己的 API Key。

What's new (English)

• In-app updates — when a new version is available, you can download and install it right inside the app instead of going through the browser.
  • Multi-source download: the official direct link and mainland-China mirrors are all candidates, and it moves to the next one if a source stalls.
  • HTTP Range resume, so a dropped connection does not restart the ~95 MB download.
  • SHA-256 is verified before the system installer is invoked.
  • Note: upgrading to this release still uses the old path (browser download). From the next release onward, updates can be done in-app.
• Fix: eight tools were missing from the previous build. dsh-tool-shizuku failed to load as a whole because of an invalid parameter declaration, so the privileged shell, notifications, clipboard, scheduled tasks, voice input and text-to-speech never showed up in the tool list. Fixed — all eight are back (whether they can run still depends on the corresponding system permissions and services).
• Notifications — completion alerts show a heads-up banner and vibrate again; the post-restart self-check notice is quieter; a spurious empty-message notification is gone; and notification taps now carry the auth header the session-creation request was missing.
• Console: notification history — browse the full text of the most recent 100 notifications.
• Accounting — recognises more payment phrasings, so Alipay / WeChat transactions are missed less often.
• Stability and hardening — backup-package validation, safer file-access boundaries, a local-HTTP fence for the virtual display, a unified engine-call channel, plus fixes for several wrong-endpoint calls and a connection-resource leak.

更新内容

1. 应用内一键升级：检测到新版本后，可以直接在 App 内下载并安装，不必再跳到浏览器。
   • 多源回退下载：同一版本的官方直链与国内加速镜像都作为候选，哪个先通就用哪个，卡住就换下一个； 某个源下到的包校验不通过时，会自动改试下一个源；
   • 支持 HTTP Range 断点续传，弱网中断不用从头再来；
   • 下载完成后校验 SHA-256，通过才唤起系统安装器；
   • 本版自身的升级入口与以往相同（旧版本从浏览器下载安装）；装上本版之后，后续版本即可在 App 内直接升级。
2. 修复：八个工具在旧版包里没有加载（本次最重要的一项）
   • 因插件参数声明不合规，dsh-tool-shizuku 插件整体未能加载，导致特权执行、通知、剪贴板、 定时任务、语音输入与朗读等 8 个工具没有出现在工具列表里；
   • 本版已修复，8 个工具重新可用（具体执行仍取决于对应的系统权限与服务状态）。
3. 通知体验
   • AI 完成任务的提醒恢复横幅与震动，不再无声地躺在通知栏；
   • 重启后的自检通知降噪（只在问题较多时才提示）；
   • 修复偶发的「空消息」通知；
   • 通知点击：补上创建会话请求缺失的鉴权头（此前该请求会被引擎拒绝）。
4. 控制台新增「通知历史」：可查看最近 100 条通知的完整内容。
5. 记账：补全「支付了」等句式的识别，降低支付宝 / 微信动账的漏记。
6. 稳定性与安全加固：新增备份包校验、文件读写安全边界、虚拟屏本地请求围栏与统一的引擎调用通道； 修复若干接口调用错误与连接资源泄漏。

安装包 SHA-256：33de45bf2cb8edb9513b1431cfee69f25c03e89aa590c0f2831c1fdb0dffbc6b