DSHBox — Run DeepSeek Harness Locally on Android

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 10+ · ARM64 | | 权限 | 无需 Root · 无需 Termux | | 内置 | Debian · Node.js · DSH · WebView |

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

---

更新记录

当前版本 v1.3.1：DSH 0.1.5-rc.2 深度适配——内置 DSH 升级到 0.1.5-rc.2，会话持久化、文件工具、附件发布、右栏预览、配置文件查看等组件在移动端 WebView 内逐个打通；硬链接兼容改为运行期垫片（DSH 源码一个字节都不改）；并针对不同 WebView 内核版本做了兼容适配（旧内核下右栏「文件资源服务不可用」已修复）。

各版本完整变更见 CHANGES.md。

---

核心特性

DeepSeek Harness 全内嵌

• DSH 随 APK 内置，首启按版本仲裁装配到 runtime-current/dsh：已装较新则保留，换层时旧层备份到 previous/dsh（单份），不触碰用户数据
• DSH 标签页内嵌 WebView 打开 http://127.0.0.1:3080：自动解析 launchToken 完成会话认证、移动 UA、键盘自适应、双指缩放、悬浮刷新
• 运行期硬链接兼容垫片：安卓应用数据分区（FBE/FUSE）拒绝硬链接，而 DSH 用 link() 作为「不可覆盖地发布一个文件」的原语，导致会话持久化、文件工具、附件发布失败。本版改为启动时以 node --import 预加载垫片，在运行期替换 node:fs/promises 的 link——被平台拒绝时退化为语义等价的内容拷贝（保留源文件、保留「不覆盖」语义、补齐权限位）。DSH 源码一个字节都不改，因此不受上游重构影响，也不存在补丁锚点漂移
• 跨 WebView 内核版本适配：部分 WebView 版本对非标准 scheme（dsh-resource://）不解析 authority，hostname 取到空串 → DSH 取不到协议名，右栏点文件报「文件资源服务不可用」。插件内做运行期能力探测 + 范围锁定：只在探测到异常时介入，正常内核零改动
• 首页可复制地址 / 一键用系统浏览器打开；前台服务通知带「打开 / 启动 / 重启 / 停止」快捷操作

DSH 移动端组件适配（v1.3.1 重点）

内置 DSH 升级到 0.1.5-rc.2 后，逐条打通各功能组件在移动 WebView 环境下的断点。适配全部在 app 侧完成（原生桥 + cordis 插件），不改动 DSH 源码：

| 组件 | 移动端断点 | 处理方式 | |---|---|---| | 会话持久化 / 文件写入 / 附件发布 | 安卓应用数据分区拒绝硬链接 → EACCES | 运行期垫片替换 fs/promises.link，退化为内容拷贝（语义等价，见上） | | 附件上传 | WebView 缺 onShowFileChooser → 点上传无任何反应 | 原生实现文件选择回调 + 来源菜单（沙箱文件 / 从安卓导入） | | 右栏文件预览 | 非标准 scheme 的 host 解析差异 → 报「文件资源服务不可用」 | 运行期能力探测 + URL 解析兼容层，仅异常内核生效 | | 设置面板「打开配置文件」 | 拦截后上游的建文件步骤不再执行 → 全新设备必然失败 | 原生侧补齐物化逻辑（已存在则原样保留，绝不覆盖用户配置） | | 上传来源判定 | 隐藏 file input 的 accept 哨兵残留会污染 DSH 原生上传 | 结果回填时主动清理 + 插件侧捕获守卫，双保险 | | 插件装配 | APK 升级后 profile 内的插件副本仍是旧版 | 启动时按内容指纹判定并自动刷新（不覆盖用户手改，失败原因可见） | | 内核能力差异 | 旧内核缺失 :has() / color-mix() 等特性时静默失效 | 诊断页提供真实内核指纹与 CSS 能力实机探测，供排障定位 |

PRoot 分层运行环境（无需 Root）

四层独立装配，PRoot 用户态沙箱与 Android 宿主隔离，运行环境与用户数据（user-data/ → guest /root/projects）互不写入：

| 层 | 内容 | guest 挂载点 | |---|---|---| | base | Debian 13 (trixie) rootfs | /（rootfs） | | node | Node.js 24（npm / npx / corepack） | /usr/local | | dsh | DeepSeek Harness（npm 包） | /opt/dshapp/runtime | | android-side | PRoot / loader / shmem（宿主侧） | — |

• 沙箱 keepalive 与 DSH 为两个独立 PRoot 进程；停机按 /proc 枚举整棵进程树、子进程优先 SIGKILL，不留孤儿、不占端口
• 每层带 SHA-256 哨兵，启动时逐层校验完整性，损坏可识别、可重装

文件管理（v1.2.0 重点增强）

• 双视图：工作区 /root/projects + 沙盒根（叠加 node、DSH 层），面包屑导航、列表 / 网格、按名称 / 时间 / 大小排序、新建文件夹、多选批量操作

• 移动到指定文件夹：全屏目标选择器（沙盒 / 工作区切换、可新建文件夹、源自身及子孙目录置灰防环、跨挂载点落点提示）；冲突三策略（覆盖 / 跳过 / 自动改名 + 应用到其余全部）；同卷 renameTo 优先、失败复制兜底（保留权限位 / 时间戳）；「重命名」走同一引擎

• 导入：文件多选批量导入、压缩包解压导入，逐件冲突决策、可取消、完成汇总；ZIP 中文名编码修复，加密 zip 明确拒绝

• 导出：多选导出到目录（SAF），或打包为 ZIP

• 全局搜索：跨沙盒 + 工作区，同时搜文件名与内容，结果带匹配片段

• 风险保护：系统目录 / node / DSH 层 / .dsh 分级标注，写操作前强确认

• 通用文件查看器 / 编辑器 —— 魔数 + 内容嗅探 + 扩展名三级分类，任何文件必有界面：

| 类型 | 能力 | |---|---| | 文本 / 代码 | Sora Editor 编辑（行号 / 撤销重做 / 搜索 / 自动换行），json / yaml / shell / python / js / java+kotlin 高亮；编码自动探测 + 手动切换，有损解码强制只读；大文件分级（≤2MB 可编辑 · 2–10MB 确认后编辑 · >10MB 只读尾窗）；原子保存 + 外部变更检测 + 未保存拦截 | | 图片 | 双指缩放 / 双击放大，超长图条带加载，GIF / 动态 WebP 动图，AVIF（Android 12+） | | PDF | 原生分页渲染；加密 PDF Android 15+ 可输密码，低版本引导外部打开 | | 压缩包 | zip / jar / apk / epub 与 tar 系只读浏览（目录折叠、加密条目标记）、包内文本预览、单条目 / 全部导出；ZIP 中文名不乱码；7z / RAR 信息卡 + 外部打开 | | 十六进制 | 偏移 / Hex / ASCII 三栏，64KB 块随机读，熵估计 | | Office | docx / xlsx 抽纯文本只读；doc / xls / ppt 信息卡 + 外部打开 | | Markdown / HTML / SVG | md 源文编辑 + Markwon 预览（含表格）；html / svg 离线 WebView 渲染（禁 JS、禁网络、退出即销毁） | | 未知 / 二进制 | 十六进制查看 + 文件信息卡；外部打开 / 编辑 / 分享 / 导出兜底 |

更新与导入管理（设置页）

| 功能 | 说明 | |---|---| | 更新 DSH（在线） | 并行探测 npm 官方 / 阿里 / 腾讯云 / 华为云镜像的版本与延迟 → 选源选版本（降级二次确认）→ 沙箱内 npm 拉取完整依赖树 → 换层自动重启；后台运行、实时日志、可取消（进程树 SIGKILL） | | 更新 DSH（离线导入） | 单文件层包 .tar.zst / .tar.gz / .tar / .tgz（或 zip 内含层包），暂存解压 → 形态校验 → 原子换层，失败不留半成品 | | 离线导入运行环境包 | 整包替换 base / node / android-side，逐层 SHA-256 校验，previous/ 单份可回滚（详见下文） | | 装配移动端适配包 | cordis 插件 @local/dsh-mobile-adapt，开关即装即卸、可反复切换，不干预 DSH 生命周期；已装配者随 APK 升级自动刷新为内置版本（含「已是最新」判定，不覆盖用户手改，失败可在设置页看到原因） | | 诊断与日志 | DSH / 沙箱 / 访客命令日志各 150 行，可滚动、可导出合并；含 WebView 真实内核指纹（提供者 / 版本 / Chromium 主版本 + CSS 能力实机探测） | | 用户反馈 | GitHub Star 与问题反馈两条入口，均先弹窗说明再跳转 |

存储占用与清理

• 占用按系统同口径统计（分配块、硬链接去重、含应用缓存），进设置页自动刷新、可手动刷新
• 清理项独立勾选：应用缓存 / 访客临时文件（运行中仅清 24h 前条目）/ 运行日志（截断）/ apt 下载缓存；回滚备份可选并明确警告
• 清理与后台安装 / 导入互斥，绝不触碰 user-data/.dsh 与运行环境本体

终端

• 多窗口：沙盒终端（PRoot Debian 完整环境，bash / vim / htop / node / npm / apt / git / python3 / ssh 开箱可用）/ 受限 shell 兜底，浮动控制面板新建 / 切换 / 关闭
• 两行辅助按键栏（ESC / TAB / HOME / END / CTRL 粘滞 / 粘贴 / 方向键 / 翻页 / 退格 / 删除，DECCKM 感知），双指缩放字号 8–40sp
• 基于 Termux terminal-emulator / terminal-view（v0.118.0，未修改）+ 自研 terminal-session 会话层

多语言适配（v1.3.0）

• 界面全面本地化：联合国六种官方语言——English / 简体中文 / العربية / Español / Français / Русский；默认跟随系统，未支持语言回退英文
• 设置 → 外观新增「语言」选择器：六语 + 跟随系统，即选即生效、无需重启；通知、弹窗、终端菜单等均随语言切换
• 数量文案按语言复数规则处理（阿拉伯语 6 形态 / 俄语 4 形态等）；文件大小、时间戳、Hex 偏移等技术性数字保持西文
• 布局方向：全局恒 LTR（阿拉伯语文本按 Unicode bidi 正常渲染），页面导航与布局不整体镜像
• 内置 i18n 一致性门禁（键位 / 占位符 / 复数形态 / 硬编码扫描），随 CI 校验六语资源

界面（底部 5 个标签）

| 标签 | 功能 | |---|---| | 首页 | 沙箱 / DSH 状态卡片、启动 / 停止 / 重启、运行时长、复制地址、系统浏览器打开 DSH | | 文件 | 双视图浏览、移动 / 重命名 / 删除、多选批量、导入 / 导出、查看器 / 编辑器、搜索 / 排序 | | DSH | 内嵌 WebView 加载 http://127.0.0.1:3080（自动认证、键盘自适应、悬浮刷新） | | 终端 | 多窗口终端、辅助按键栏、控制面板 | | 设置 | 外观（主题 / 语言）、存储与清理、DSH 更新（在线 / 离线）、检查更新 App、运行环境包导入、移动端适配装配、诊断与日志、用户反馈、关于 |

从源码构建

| 环境 | 版本 | |---|---| | JDK | 21（官方 CI 使用 Temurin 21） | | Android SDK | compileSdk / targetSdk 36 · build-tools 36.0.0 | | Gradle | wrapper 8.11.1（AGP 8.9.2 · Kotlin 2.0.21） |

运行环境大层不在本仓库（见下节），构建前请先获取 ../runtime/。

./gradlew testDebugUnitTest     # 全量 JVM 单测（v1.3.1 共 414 例）
./gradlew :app:assembleRelease  # 产物：app/build/outputs/apk/release/app-release.apk

| 模块 | 职责 | |---|---| | app | 全部 UI（5 个标签页、查看器、设置 / 诊断 / 更新页）、前台服务、在线更新编排 | | sandbox-manager | 分层运行时装配、PRoot 进程管理、DSH 层仲裁与更新、导入 / 校验 / 清理 | | common | 常量、npm 镜像源、版本比较、日志脱敏 | | bridge | WebView JS Bridge 安全框架（预留 stub） | | terminal-session | 终端会话层（多窗口、PRoot 终端命令构建） | | terminal-view / terminal-emulator | Termux 终端库（v0.118.0，未修改） |

运行环境层构建脚本见 runtime-bundle/（各层 tar.zst 由 build_base.sh / build_node.sh / build_android_side.sh 在 Linux/WSL2 构建）；构建手册见 docs/BUILD_RUNBOOK.md，预检脚本 tools/pipeline_dryrun.sh。

注：/release每次随apk包发布时，已附带打包好的两个运行环境层，可直接使用。

运行环境大文件（不在本仓库）

| 发布包内路径 | 内容 | |---|---| | runtime/android-assets/runtime/{base,node,android-side}.tar.zst | 三层运行环境，各带 .sha256 侧车与 runtime-profile.json | | runtime/android-assets/dsh/0.1.5-rc.2.tar.zst | DSH 层 + .sha256（纯净上游，不打补丁） | | runtime/dshapp-runtime-debian-arm64-0.1.0.zip | 对外交付的运行环境整包（离线导入用） |

• 引用方式：app/build.gradle.kts 通过 assets.srcDirs("../../runtime/android-assets") 引用发布目录，构建时内嵌进 assets/runtime/* 与 assets/dsh/*
• 构建前置：assembleRelease 前需先获取 runtime/，目录缺失则无法内嵌完整运行环境
• 签名密钥（keystore.properties、local.properties）不在仓库内：用 tools/create_keystore.sh 自建开发签名，未配置时 release 构建回退 debug 签名

离线导入运行环境包

• 交付形式：单文件 dshapp-runtime-debian-arm64-0.1.0.zip，设置页「离线导入运行环境包」选择即可
• 布局与格式：外层 zip / tar；层归档 .tar.zst / .tar.gz / .tar / .tgz / .bz2 / .xz（按魔数识别），兼容一层目录前缀与外层 tar 装层归档
• 校验：逐层 SHA-256（侧车与 runtime-profile.json 交叉核对）+ Zip-Slip 防护；损坏 / 截断 / 加密包返回可读错误
• 替换：旧本体移入 previous/（单份可回滚），绝不触碰 DSH 层与 user-data/.dsh
• DSH 离线更新走「更新 DSH（离线导入）」单文件层包（如 0.1.5-rc.2.tar.zst）

许可证

本项目采用 GPL v3（见 LICENSE）。第三方组件按其各自原许可继续适用，详见 THIRD_PARTY_NOTICES.md：

• PRoot（GPL-2+）· talloc（LGPL-3+）· Debian rootfs（按各包 Debian 版权文件）
• DeepSeek Harness / Cordis（MIT）· Node.js（MIT）
• Termux terminal-emulator / terminal-view（Apache-2.0，v0.118.0 未修改）
• sora-editor（LGPL-2.1-or-later，aar 未修改）· Markwon（Apache-2.0）· commons-compress（Apache-2.0）· zstd-jni（BSD-3-Clause）