安卓控制端 Jensen-Yao/deepseek-harness-android-app

🤖 DeepSeek Harness Android App

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

中文 · 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…）→ 安装工具链 → 编译原生模块 → 启动服务，日志实时滚动 |
| 📟 三通道日志 | 从第 0 秒起就能在应用内看到部署日志（脚本心跳推送 / 早期进度服务 / 控制守护进程） |
| 🌐 内置浏览器 | 直接在 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/<项目 project>/<会话 session>/session.jsonl[.zstd] |
| 会话缓存/工作区 Session cache/workspace | ~/.dsh/storages/.json |
| 附件 Attachments | ~/.dsh/attachments/v1/objects/<sha256[:2]>/<sha256> |
| 用户技能 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：手机上跑的是 智能体编排，模型推理走云端 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