DSHBox — Run DeepSeek Harness Locally on Android

<img width="1772" height="884" alt="DSHBox running DeepSeek Harness locally on Android phones and tablets" src="https://github.com/user-attachments/assets/a9622b15-a348-4c81-a708-3684a208e59e" />

DSHBox runs the full DeepSeek Harness locally on Android phones and tablets. It bundles Debian, Node.js, DSH, PRoot, and an embedded WebView into one APK, with no root access or separate Termux installation required.

DSHBox 是一个可在安卓手机和平板上本机运行完整 DeepSeek Harness（DSH） 的开源应用。它将 Debian、Node.js、DSH、PRoot 和 WebView 集成在一个 APK 中，无需 Root，也无需单独安装 Termux。

---

快速安装

• 支持：Android 8.0+ / ARM64
• 无需 Root
• 无需 Termux
• 内置 Debian、Node.js、DSH 和 WebView

下载最新 APK

安装 APK → 启动应用 → 等待运行环境初始化 → 打开 DSH。

---

v1.1.1 更新亮点（相对 v1.1.0）

• 在线更新 DSH 全链路可用（1.1.0 多处阻断，本次逐点打通）：
  • 点「安装」闪退（布局嵌套滚动崩溃）修复；
  • 「取消安装」即时生效（进程树 SIGKILL + 可中断等待，1 秒内收敛）；
  • 换层前确定性停止旧 DSH、健康检查兼容新版 DSH 认证（401），不再端口争用/误判未就绪；
  • 首次安装显示「已用时/预计」提示，全程后台运行，可离开页面继续使用其他功能。
• 兼容 DSH 0.1.2-rc.1（网页会话认证）：自动从 DSH 启动输出解析 launchToken、完成 签名 Cookie 交换并自动续期——WebView 打开即用，无需手动认证。
• 存储与日志治理：npm 下载缓存迁出运行环境红线区（归「应用缓存」一键可清，重装同版本秒级）； 进程日志 2MB 自动轮转（保留最近两代），诊断页升级为 DSH / 沙箱 / 访客命令全条目展示（可滚动、可导出）。
• 装配移动端适配包一键开关：设置页开关即装即卸、可反复切换，仅执行脚本不干预 DSH 生命周期。

---

v1.1.0 更新亮点（相对 v1.0.0）

• 更新 DSH（在线）重构：新界面并行探测各 npm 源（官方 / 阿里 npmmirror / 腾讯云 / 华为云）的版本号与网络延迟 → 选源选版本（降级二次确认）→ 沙箱内用 npm 从所选源拉取 @deepseek-ai/dsh 及完整依赖树 → 自动重启生效；实时日志流、可取消、退出界面不中断安装。
• 离线导入修复：运行环境包官方 zip 导入失败、DSH 层包版本变 unknown 且重启被内置层覆盖、损坏/截断/加密 zip 闪退——均已修复；导入全链路异常转为可读提示。
• 存储占用与清理：占用按系统同口径统计（分配块、含应用缓存、进设置页自动刷新、可手动刷新）；新增「清理缓存与垃圾文件」（应用缓存 / 访客临时文件 / 运行日志 / apt 缓存，逐项勾选；回滚备份可选），与后台安装/导入互斥，绝不触碰 user-data/.dsh 与运行环境本体。
• 导入格式全覆盖：层归档支持 .tar.zst / .tar.gz / .tar / .tgz / .bz2 / .xz（按魔数识别）；支持裸 base.tar 层归档与「外层 tar 装层归档」布局。

核心特性

• DeepSeek Harness 全内嵌：DSH（Agent Runtime）随 APK 内置，DSH 标签页通过内嵌 WebView 打开 http://127.0.0.1:3080（移动模式 WebView，原生键盘自适应）；首页也可一键用系统浏览器打开。
• 完整分层运行环境：Debian（base）+ Node.js（node）+ PRoot（android-side）+ DSH 层， PRoot 用户态沙箱，与 Android 宿主隔离，无需 root；运行环境与用户数据相互独立。
• 更新/导入管理：设置页可离线导入运行环境包、离线/在线更新 DSH（内置多镜像源）、 装配 DSH 移动端适配插件（cordis @local/dsh-mobile-adapt），并带实时进度与失败回滚。
• 在线更新新界面（v1.1.0）：并行探测各 npm 源（官方 / 阿里 npmmirror / 腾讯云 / 华为云）的版本与延迟，选源选版本（降级二次确认），沙箱内用 npm 拉取完整依赖树并自动重启；实时日志、可取消。
• 存储占用与清理（v1.1.0）：系统同口径统计（分配块、含缓存、自动刷新）；设置页「清理缓存与垃圾文件」按项勾选清理临时文件/日志/apt 缓存（回滚备份可选），与后台安装互斥，不触碰工作区与对话数据。
• 文件管理：沙盒/工作区双视图（/root/projects 工作区 + 沙盒根），导入/导出引导，目录 ZIP， 搜索、排序、网格/列表切换。
• 持久终端：App 内常驻 shell 会话（terminal-session 模块）。
• 前台服务保活 + 常驻通知（Android 13+ 已支持 POST_NOTIFICATIONS 运行时权限）。
• 运行环境独立性：src/main/assets 不含运行环境大层；运行时从分层包/导入包装配到 runtime-current/{base,node,android-side,dsh}，互不写入用户数据。

界面（底部 5 个标签）

标签	功能
首页	沙箱/DSH 状态，启动/停止/重启，复制地址，在系统浏览器中打开 DSH
文件	沙盒 + 工作区双视图浏览、导入/导出、目录 ZIP、搜索/排序
DSH	内嵌 WebView 加载 http://127.0.0.1:3080 的 DSH WebUI
终端	App 内持久 shell 会话
设置	运行环境包导入、DSH 离线/在线更新、移动端适配装配、诊断、版本信息

从源码构建

环境要求：JDK 21、Android SDK（compileSdk/targetSdk 36、build-tools 36.0.0）、Gradle wrapper 8.11.1（离线缓存）。 运行环境大层不在本仓库（见下节），构建前请先获取 ../runtime/。

./gradlew :terminal-session:testDebugUnitTest :app:assembleRelease
# 产物：app/build/outputs/apk/release/app-release.apk

运行环境层的构建脚本与说明见 runtime-bundle/（base/node/android-side 各层 tar.zst 由 build_base.sh / build_node.sh / build_android_side.sh 在 Linux/root 环境构建，再纳入 runtime/android-assets）。

运行环境大文件（不在本仓库，做好引用）

本仓库（source/）不包含运行环境大层：base / node / android-side 的 .tar.zst、DSH 层 0.1.1-rc.2-patched.tar.zst； 也不包含签名密钥（keystore.properties、local.properties）。

• 大层位置与获取：这些大文件随发布包放在发布目录 ../runtime/（整包 dshapp-runtime-debian-arm64-0.1.0.zip + android-assets/{runtime,dsh}/ 分层 + DSH 层），或从对应发布/下载源获取。
• 引用方式：app/build.gradle.kts 通过 assets.srcDirs("../../runtime/android-assets") 引用发布目录的 runtime/， 构建完整版 APK 时把它们内嵌进 assets/runtime/* 与 assets/dsh/*。
• 构建前置条件：assembleRelease 前需先获取 runtime/（若目录缺失则无法内嵌完整运行环境）。
• 签名密钥：keystore.properties、local.properties 未包含；请用 tools/create_keystore.sh 自建开发签名后构建 release APK。

离线导入运行环境包

运行环境主体（base + node + android-side）对外以一个文件 dshapp-runtime-debian-arm64-0.1.0.zip 交付，在设置页「离线导入运行环境包」选择即可；DSH 更新走「更新 DSH（离线）」单文件 0.1.1-rc.2-patched.tar.zst。

许可证

本项目采用 GPL v3 许可（见 LICENSE）。第三方组件许可见 THIRD_PARTY_NOTICES.md： PRoot（GPL-2+）、talloc（LGPL-3+）、Debian rootfs（各包按 Debian 版权文件）、DeepSeek Harness / Cordis（MIT）、 Termux terminal-emulator / terminal-view（Apache-2.0，未修改）等，均按其各自原许可继续适用。