guzhou079-arch/deepseek-harness-android 预览 preview

guzhou079-arch/deepseek-harness-android

把 DeepSeek Harness 打包成能直接装的安卓 APK:不用 Termux、不用 root、不用配环境。它还能在手机上自己编译、打包、签名、发布。

Project Overview项目介绍

deepseek-harness-android is a packaged port-and-enhancement project that ships the DeepSeek Harness (DSH) AI Agent as a directly installable Android APK, targeting Android 8.0+ devices with no Termux, no root, and no manual environment setup required. It integrates DSH by embedding the engine's build artifacts inside an upstream woaiys3/deepseek-harness-android-app WebView-plus-Service skeleton, layering twenty-five Android adaptation patches on top, plus in-house plugins whale-shota (overlay pet) and dsh-android-ui (mobile layout), and distributes checksum-stripped SHA-256-verified APK files via both GitHub and Gitee Releases. Distribution is centered on the project's own signing identity, meaning users would experience overlap conflicts if they sideload alternative builds.

The typical workflow is to download the latest release APK from the Releases page, verify its SHA-256 fingerprint as listed in the release notes, then sideload it onto the device. After launch the floating-ball overlay serves as the primary trigger for voice-or-text agent turns, while a fluid-cloud capsule surfaces streaming replies that can be expanded into a card view and scrolled manually. Users invoke bundled skills for routine document readiness — dsh-mobile handles accessibility read-screen, click, input, notification access, scheduled tasks and virtual screens, doc-tidy handles document organization, and dsh-review handles cross-vendor multi-model review — which makes the app attractive to developers, automation researchers, and AI enthusiasts who want DSH running entirely on a phone without a desktop. Power users can additionally download roughly 193 MB of on-demand build environment (proot + Alpine + OpenJDK 17) via the in-app self-build console to run javac, d8, repackage, sign and release entirely on the phone.

The overall release is published under MIT, but the virtual-screen functionality follows LGPL-3.0 (with GPL-3.0 text shipped alongside), the DSH engine remains copyrighted by DeepSeek, and every third-party component is itemized in THIRD_PARTY_NOTICES.md. First-time installers must use only the project's signed release APK or risk triggering INSTALL_FAILED_UPDATE_INCOMPATIBLE and losing private data; before any upgrade users must export all data through Console → Rescue (or via developers running selfbuild/scripts/backup-dshhome.sh), and should never uninstall the previous build when that error appears because the prompt itself is the data protection feature.

deepseek-harness-android 是一个把 DeepSeek Harness(DSH)AI Agent 打包成可直接安装的安卓 APK 的移植增强项目,目标平台明确单一为安卓可用、无需 Termux、无需 root。其集成方式是在上游 woaiys3/deepseek-harness-android-app 的 WebView + Service 骨架内嵌入 DSH 引擎构建产物,并叠加 25 条安卓适配补丁、自研皮肤 whale-shota 与安卓界面补丁 dsh-android-ui,最终通过 GitHub 与 Gitee 的 Releases 渠道分发带 SHA-256 校验的 APK。

典型使用流程是从 Releases 下载 APK 装入 Android 8.0+ 设备,启动后通过悬浮球触发对话,在流体云胶囊中观察流式回复,或调用随包技能 dsh-mobile(读屏、点击、通知、定时、虚拟屏)、doc-tidy 与 dsh-review 完成多模型会审与文档归档。面向希望在手机端独立运行 DSH、又要兼顾移动自动化的个人开发者与 AI 爱好者;进阶用户还可在控制台按需下载约 193MB 构建环境(proot + Alpine + OpenJDK 17),在手机上完成 javac → d8 → 重打包 → 签名 → 发版全链路。

项目整体 MIT 发布,但虚拟屏功能遵循 LGPL-3.0(GPL-3.0 同步随附),DSH 内核版权归 DeepSeek 所有,THIRD_PARTY_NOTICES.md 中逐项声明。首次安装必须使用本仓库 Releases 中的签名包,否则会触发 INSTALL_FAILED_UPDATE_INCOMPATIBLE 导致私有数据丢失;升级前应在控制台→救援中导出全部数据,并仅核对 Release 说明里附带的 SHA-256 指纹后再覆盖安装。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:guzhou079-arch/deepseek-harness-android

把 guzhou079-arch/deepseek-harness-android 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Harness · 安卓移植增强版

DeepSeek Harness · 安卓移植增强版

中文 | English


Stars Release Platform Last commit

把 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.

能干什么 说明
🐳 悬浮球 / 桌宠 单击球就"说话":台词 / 账户余额 / 今日已用 / 上一轮消耗 / 峰谷与预算提醒
☁️ 流体云回复卡 AI 正在写的时候,屏幕顶部浮出胶囊;点开成卡片看正文,可手动上下翻
📱 手机自动化 读屏、点击、输入、通知读取、定时任务、虚拟屏
🔧 手机自己出包 javac → dex → 打包 → 签名 → 发版,全程不需要电脑(构建环境 App 内按需下载)
🧩 随包技能 手机自动化(dsh-mobile)/ 文档整理(doc-tidy)/ 跨厂商多模型会审(dsh-review)

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

下载安装:见本仓库 Releases(GitHub 与 Gitee 两边内容一致,用哪个都行; 每个 Release 的说明里带该 APK 的 SHA-256,装前可以核对)。

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

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

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

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

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-workspace-studio 下一个 Next dsh-survey →