Jensen-Yao/deepseek-harness-android-app

🤖 DeepSeek Harness 安卓应用

把 DeepSeek Harness 装进你的安卓手机 —— 从零到跑起来，全程点按完成，无需命令行
Install DeepSeek Harness on your Android phone — zero to running, tap-only, no command line

License
Android
DeepSeek Harness
Termux

中文 · English · 截图 / Screenshots · 存储位置 / Storage

📸 截图 / Screenshots

| 服务控制 Control | 部署向导 Deploy wizard | 部署进度 Deploy progress |
|---|---|---|
|  |  |  |

| 内置浏览器 Built-in browser | 存储管理 Storage manager | 浏览器选择器 Browser picker |
|---|---|---|
|  |  |  |

🇨🇳 中文 · 点击收起中文说明

✨ 特性（中文）

| 能力 | 说明 |
|---|---|
| 🧭 Termux 引导安装 | 自动识别机型与架构（arm64/armv7/x86），App 内直接下载匹配的 Termux 安装包并调起系统安装器 |
| 🚀 一键部署 | 自动测速选择最快软件源（清华/北外/中科大等 7 源）→ 安装工具链 → 编译原生模块 → 启动服务，全程实时日志 |
| 📟 三通道日志 | 部署日志从第 0 秒起同步显示在 App（脚本心跳上报 / 早期进度服务 / 控制守护进程三通道） |
| 🌐 内置浏览器 | WebView 内直接使用 Harness，顶部工具栏支持返回/前进/刷新/外部打开 |
| 🎛 服务控制 | 启动 / 停止 / 重启 / 状态监控 / 日志查看，全在手机点按完成 |
| 🔛 Termux 开关 | 从 App 内直接启动或关闭 Termux（关闭需确认，连同 dsh 服务一并停止） |
| 📁 存储管理 | 查看/编辑 harness 全部数据（会话、附件、技能、MCP 配置档案）；单项或统一数据根一键迁移到共享存储 |
| 🧭 浏览器选择 | 外部打开 Harness 可选择任意已装浏览器（默认 Via，可选系统默认） |
| 🔋 防冻结引导 | 按机型（ColorOS/鸿蒙/MIUI/OriginOS/One UI）提示电池优化设置路径 |
| 🔧 自服务更新 | 手机端守护进程可经 App 一键更新，不依赖电脑 |
| 🎨 Apple 设计语言 | iOS 系统色板、大标题负字距、弹簧动画（阻尼/响应参数化）、按下变暗+震动、触觉反馈、减少动态效果适配 |

📦 快速开始（中文）

只需一次：把 install/dsh-harness.apk 传到手机并安装（微信/QQ/数据线/网盘均可）。之后的每一步都在 App 内完成。

1. 打开 DeepSeek Harness App →「部署」页
2. 点「下载 Termux 安装包」（自动按机型匹配、自动选最快源）→「安装 Termux」
3. 点「一键部署 DeepSeek Harness」→ 等待 5~15 分钟（日志实时滚动）
4. 出现「✓ 部署完成」→「打开 Harness」→ 填入 DeepSeek API Key，开始使用 🎉

若自动部署被系统拦截（部分 ColorOS/鸿蒙机型），App 会自动弹出「粘贴部署」万能通道：一键复制命令 → 打开 Termux 粘贴回车，效果相同。

🇬🇧 English · click to expand English description

✨ Features (English)

| Capability | Description |
|---|---|
| 🧭 Termux setup wizard | Detects device model & ABI (arm64/armv7/x86), downloads the matching Termux APK in-app and launches the system installer |
| 🚀 一键部署 | 自动测速 7 个镜像源（TUNA/BFSU/USTC……）→ 安装工具链 → 编译原生模块 → 启动服务，并实时显示日志 |
| 📟 三通道日志 | 从第零秒起即可在应用内查看部署日志（脚本心跳推送 / 早期进度服务器 / 控制守护进程） |
| 🌐 内置浏览器 | 直接在 WebView 中使用 Harness，工具栏支持后退/前进/刷新/在外部打开 |
| 🎛 服务控制 | 启动 / 停止 / 重启 / 状态 / 日志——全部可在手机上点按操作 |
| 🔛 Termux 开/关 | 从应用内启动或关闭 Termux（关闭时会请求确认，并同时停止 dsh 服务） |
| 📁 存储管理器 | 浏览/编辑所有 harness 数据（会话、附件、技能、MCP 配置档案补丁）；支持逐项或统一数据根目录一键迁移到共享存储 |
| 🧭 浏览器选择器 | 在任意已安装浏览器中打开 Harness（默认 Via，可选系统默认） |
| 🔋 防冻结指南 | 针对机型提供电池优化说明（ColorOS/HarmonyOS/MIUI/OriginOS/One UI） |
| 🔧 自助更新 | 手机端守护进程可从应用自身更新——无需电脑 |
| 🎨 Apple 设计语言 | iOS 调色板、大标题负字距、参数化弹簧动画、按压变暗 + 触感反馈、支持减弱动态效果 |

📦 快速开始（英文）

一次性设置：将 install/dsh-harness.apk 传输到手机并安装（微信/QQ/USB/云盘均可）。其余一切都在应用内完成。

1. 打开 DeepSeek Harness 应用 → 「部署 / Deploy」标签页
2. 点击 「下载 Termux 安装包」（自动匹配机型，最快镜像源）→ 「安装 Termux」
3. 点击 「一键部署 DeepSeek Harness」→ 等待 5–15 分钟（实时滚动日志）
4. 出现 「✓ 部署完成」后 → 「打开 Harness」→ 输入你的 DeepSeek API Key 🎉

如果自动部署被拦截（部分 ColorOS/HarmonyOS 设备），应用会弹出通用“粘贴部署”通道：一键复制命令 → 粘贴到 Termux 并按回车——结果相同。

🏗 架构 / Architecture

┌─────────────────────────────────────────────┐
│        DeepSeek Harness App（原生 APK）        │
│  控制 Control · 部署 Deploy · 关于 About       │
│  内置 WebView · 存储管理 Storage manager       │
└───────────────┬─────────────────────────────┘
│ HTTP (127.0.0.1:8045 / 8023)
┌───────────────▼─────────────────────────────┐
│            Termux 环境（手机本机 on-device）    │
│  ┌───────────────────────────────────────┐  │
│  │  控制守护进程 daemon server.mjs (8023)  │  │
│  │  status/start/stop/restart/storage…   │  │
│  └───────────────┬───────────────────────┘  │
│                  │ spawn / pkill             │
│  ┌───────────────▼───────────────────────┐  │
│  │  DeepSeek Harness  (127.0.0.1:3080)   │  │
│  │  ~/.dsh: 会话/附件/技能/配置档案        │  │
│  └───────────────────────────────────────┘  │
│  runit 自启 · 部署脚本服务(8045) · sshd      │
└─────────────────────────────────────────────┘

📁 存储位置 / Storage locations
Harness 全部数据位于单一数据根 ~/.dsh（源码 @deepseek-ai/dsh-home-paths，可由 DSH_HOME 覆盖）· All harness data lives under one root ~/.dsh (see @deepseek-ai/dsh-home-paths; overridable via DSH_HOME):

| 数据 Data | 路径 Path |
|---|---|
| 凭证 Credentials | ~/.dsh/.credentials.yaml |
| 设置 Settings | ~/.dsh/settings.yaml |
| 会话 Sessions | ~/.dsh/sessions///session.jsonl[.zstd] |
| 会话缓存/工作区 Session cache/workspace | ~/.dsh/storages/.json |
| 附件 Attachments | ~/.dsh/attachments/v1/objects// |
| 用户技能 User skills | ~/.dsh/skills（另有 ~/.agents/skills、项目级 .dsh/skills） |
| MCP 配置 MCP config | ~/.dsh/profiles/ 配置档案 profile patches（cordis.patch.yml 等） |

App「关于 → 存储位置」可浏览/编辑以上全部，并支持统一数据根一键迁移到 /sdcard/dsh-data/（软链接回原位，harness 无感知）· The app's 「About → Storage」 can browse/edit all of the above and migrate everything under one data root to /sdcard/dsh-data/ (symlinked back, invisible to the harness).

🛠 从源码构建 / Build from source

无 Gradle，仅需 JDK 17 + Android SDK build-tools 36 · No Gradle — just JDK 17 + Android SDK build-tools 36:

cd app
1) 生成内嵌部署资源（把 daemon/server.mjs 等打包进 APK）
Generate embedded deploy assets (packs daemon/server.mjs etc. into the APK)
powershell -File gen-assets.ps1
2) 编译并签名 / compile & sign
powershell -File build2.ps1
产物 Output: build2/dsh-harness.apk

目录结构 / Layout：

app/        安卓端源码（纯 Java，无第三方依赖）+ 无 Gradle 构建脚本
Android sources (pure Java, no third-party deps) + gradle-free build scripts
daemon/     Termux 侧控制守护进程与自启脚本（Node 零依赖）
Termux-side control daemon & autostart scripts (zero-dep Node)
install/    预编译 APK / prebuilt APK
docs/       项目主页（GitHub Pages）/ project site (GitHub Pages)

❓ FAQ

🤔 这不是给电脑用的吗？手机也能跑？/ Isn't this PC-only? Can a phone really run it?

本质：DeepSeek Harness 是 Node.js agent 编排框架 + Web UI，对硬件的真实要求只有「Unix 环境 + Node 运行时」。手机（ARM SoC + Linux 内核）本身就是一台计算机，Termux 补齐环境；官方讨论区早有 Android/Termux 部署案例（Discussion #136），华为 Mate 60 实机已验证。

Essence: DeepSeek Harness is a Node.js agent-orchestration framework + Web UI. Its only real requirements are a Unix environment and a Node runtime. A phone (ARM SoC + Linux kernel) is* a computer; Termux completes the environment. Community deployments on Android/Termux exist (see Discussion #136) and are verified on a Huawei Mate 60.

手机部署的四个独特价值 / Four values unique to phone deployment：

| 价值 Value | 说明 Description |
|---|---|
| 📱 随身 AI 工作站 / Pocket AI workstation | 会话、技能、文件全在本机，出门掏出手机接着用，无需同步或服务器 · Sessions, skills and files stay on-device — pick up anywhere, no sync or servers |
| ⚡ 真实操作手机 / Really operates the phone | agent 在手机上真执行 bash：批量处理照片、整理文件、跑脚本、装工具——把手机变成「可被 AI 编程的设备」· The agent really executes bash on the phone: batch-rename photos, organize files, run scripts, install tools — turning the phone into an AI-programmable device |
| 🔒 数据不出设备 / Data stays on-device | API Key 仅存本机（0600），不上传任何云 · API key stored locally only (0600), nothing uploaded to any cloud |
| 💰 零服务器成本 / Zero server cost | 只花 API token 钱；手机常开在线，任务随时派 · Only token costs; the phone is always online, ready for tasks |

诚实的边界 / Honest boundaries：手机上跑的是 agent 编排，模型推理走云端 API（手机无 GPU，不适合本地跑大模型）；重型编译速度不如 PC；部分国产 ROM 会冻结后台——App 已内置按机型的防冻结引导。· The phone runs the agent orchestration; model inference goes through the cloud API (no GPU on phones — not for running large models locally). Heavy compiles are slower than on a PC; some Chinese ROMs freeze background apps — the app includes model-specific anti-freeze guidance.

- 自动部署被拦截？ Auto-deploy blocked? 使用 App 弹出的「粘贴部署」万能通道（无需任何权限）。Use the "paste deploy" universal channel that the app pops up (no permissions needed).
- 切后台服务被冻结？ Frozen in background? 按 App 内「电池优化（防冻结）」卡片完成机型对应设置。Follow the in-app "Battery optimization (anti-freeze)" card.
- App 不显示日志？ No logs in app? 已三通道冗余（心跳上报/早期服务/守护进程）；终端侧也可 tail -f ~/dsh/storage/deploy.log。Triple-channel redundancy already; in the terminal you can also tail -f ~/dsh/storage/deploy.log.
- 换手机？ New phone? 新手机装 APK → 重走一遍部署向导即可，全部自动化。Install the APK on the new phone and re-run the deploy wizard — fully automated.

🙏 致谢 / Credits

- deepseek-ai/deepseek-harness — DeepSeek 官方 agent harness
- FunnelCakes/deepseek-harness-android — Android/Termux 部署参考与兼容补丁
- termux/termux-app

📄 License

MIT