安卓本地运行器 WSK-build/DSHBox

DSHBox — 在 Android 上本机运行 DeepSeek Harness

DSHBox 是一个开源应用，在安卓手机和平板上本机运行完整的 DeepSeek Harness（DSH）。它把 DSH、PRoot、系统 WebView 或内置 GeckoView、Debian 和 Node.js 整合到一起，再配上终端、文件管理、AI 浏览器助手、手机助手和可选开发者工具，组成个人 AI 工作台。日常使用无需 Root，也无需单独安装 Termux。

DSHBox 是一个可在安卓手机和平板上本机运行完整 DeepSeek Harness（DSH） 的开源应用。它将 DSH、PRoot、系统 WebView 或内置 GeckoView、Debian、Node.js 集成协调在一起，配套终端、文件管理、AI 浏览器助手、手机助手与可选开发者工具，组成个人 AI 工作台。日常使用无需 Root，也无需单独安装 Termux。

快速安装

| 项目 | 说明 |
| 系统要求 | Android 10+ · ARM64 |
| 权限 | 日常使用无需 Root · 无需 Termux；开发者模式中的 Root 通道为可选能力 |
| 发布版本 | 系统 WebView 版：APK 较小，复用手机系统 WebView；内置 Gecko 版：随包提供 GeckoView 158，不依赖系统 WebView |
| 内置 | DSH 0.2.1-rc.5 · PRoot；系统 WebView 或 GeckoView；Debian 与 Node.js 在首次运行时通过多镜像源检测在线获取，或离线导入 |
| 首次准备 | 按分步引导安装精简 Debian 与 Node.js，支持多镜像源检测、失败重试或离线导入；系统 WebView 版还会检测 provider 与启动前兼容能力 |
| 如何选择 | 系统 WebView 较新且工作正常时，可优先选择体积较小的系统 WebView 版；系统 WebView 较旧、白屏、受厂商定制影响，或希望固定渲染内核时，选择内置 Gecko 版。两个 APK 同包名、同签名，覆盖安装会保留 Debian、sandbox 与 user-data。 |

下载系统 WebView 版或内置 Gecko 版 → 覆盖安装 → 启动应用 → 按引导获取运行环境（在线多镜像源，或沿用离线导入）→ 打开 DSH。

更新记录

当前版本 v1.5.1（2026-10-31）：系统 WebView / 内置 Gecko 双渲染 · 开发者模式 · 插件市场增强。
1. 新增系统 WebView 版与内置 Gecko 版双 APK，共用同一套 DSH 页面和 App UI；补齐 System WebView 启动期兼容能力，并由 GeckoView 158 为低版本或特殊 WebView 环境提供独立渲染路径；
2. 新增开发者模式，提供独立于 Pilot 审批体系和 Shizuku 的完整 ADB / Root 通道；ADB 可在开关开启时挂载进 Debian 沙箱，既可连接本机服务，也可调试外部设备；
3. 插件市场与工具链升级：内置 pnpm 11.1.2、插件兼容与安装守卫、已安装状态和目录刷新机制；修复 DSH「添加插件」、第三方安装顶出随包插件等问题；
4. DSH 页面兼容与交互修复：修复链接错误刷新 DSH、账号登录不跳转、右栏资源、配置文件打开、401 恢复、Gecko 键盘顶栏及低版本 WebView 白屏等问题；
5. 官网与发布流程升级：官网分别提供两个 APK，Release 统一输出 dshbox-v1.5.1-system-release.apk 与 dshbox-v1.5.1-gecko-release.apk 并执行发布契约检查。

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

核心特性

DeepSeek Harness 全内嵌与双渲染（v1.5.1）

- DSH 0.2.1-rc.5 随 APK 内置，层内容保持上游纯净；首启按版本仲裁装配到 runtime-current/dsh，换层时旧层单份备份到 previous/dsh，不触碰用户数据。
- 系统 WebView 版 / 内置 Gecko 版：两个发布变体共用唯一 DSH 页面、宿主导航、文件交付、诊断与日志实现，差异集中在 Renderer Adapter；两个 APK 同为 com.dshbox.app、同一签名，可覆盖切换并保留 filesDir。
- 全屏 DSH 工作区：DSH 标签页在本地地址上自动解析 launchToken、使用移动 UA、处理键盘与视觉视口并支持双指缩放；可拖动悬浮球继续提供刷新和首页、文件、终端、Browser 快捷切换，首页保留「浏览器」和「更多」入口。
- 系统 WebView 兼容：在 DSH 主脚本执行前补齐启动期所需 API，并通过单次 document-start 注入进入页面；支持 document-start 的内核继续复用系统 WebView，不支持的内核会明确阻止导航并提示升级。
- 内置 GeckoView 158：完全使用随包渲染内核，不依赖系统 WebView，不静默回退；处理 DSH 账号 popup、外链、401、文件选择、页面状态、右侧栏和键盘视口等差异。
- DSH 访问设置：首页 DSH 卡片可进入全屏访问设置页，查看并复制带 token 的完整地址、设置外部打开方式、复制连接信息并查看运行时间。
- 运行期硬链接兼容垫片：安卓应用数据分区（FBE/FUSE）拒绝硬链接，而 DSH 使用 link() 作为「不覆盖发布文件」的原语，会导致会话持久化、文件工具和附件发布失败。App 启动时通过 node --import 替换 node:fs/promises.link；遇到平台拒绝时退化为保留不覆盖语义的内容拷贝。
- DSH 源码零修改：兼容逻辑位于 App、渲染适配层、内置扩展和运行环境接线；随包 DSH 层保持上游文件与业务逻辑不变。
- 前台服务通知带「启动 / 重启 / 关闭」快捷操作；页面刷新和重新认证统一使用当前 launchToken，DSH 重启或健康循环换 token 后不会继续请求旧地址。

AI 浏览器助手（Browser，v1.5.0 新增）

独立的内置浏览器工作区，通过随包 browser-use 插件与沙箱 CLI 向 DSH 开放 24 项工具。新用户默认装配，可在首页 Cordis 页签的「DSH浏览器自动化」开关中独立控制。

- 网页操作：搜索、导航、多页面管理、读取内容、定位元素、点击、输入、滚动及条件等待；搜索引擎可选必应、谷歌和百度，默认必应。
- 选区反馈与本地预览：选取网页元素或区域，附截图和评论提交给已绑定的 DSH 会话；沙箱中的 HTML 等文件可通过 CLI 启动本地静态服务，也可登记已有服务，在 Browser 中预览并反馈修改意见。
- 截图与调试：支持前台和后台网页截图；普通后台截图失败时，已开启高级调试才会串行尝试 CDP 后备，否则返回明确提示。高级调试提供 DOM、控制台、脚本求值及网络抓取、HAR 导出等能力，请求拦截、修改与重放按独立授权开放。
- 文件与记录：持久历史、收藏、多页面和下载管理；AI 可准备上传文件，经用户批准后交给网页。任务记录可查看、编辑、删除并向 AI 发送续接摘要。
- 控制权与界面：用户接管 AI 操作前确认，AI 控制关闭时可申请授权；支持主题与六语跟随、移动/桌面/宽屏模式、可设置的闲置关闭时间，以及点击 AI 标记快速返回 DSH。

Browser 负责内置网页，Pilot 负责手机原生应用，由 DSH 选择调用。复杂跨页面任务恢复、长时流式响应及部分媒体、站点兼容场景仍待完善，不保证所有任务均可全自动完成。

手机助手（Pilot，v1.4.0 新增）

内建 39 项手机操控能力表，并在内嵌沙箱与安卓应用层之间建立一条信箱通道（文件投递，无网络、无共享内存），让沙箱内的 DSH 安全可控地操控与连接手机。采用「UI 适配 + 内核平台」两层结构嵌入；内核以 Apache-2.0 独立发布于 interlock-relay 仓库，本仓库调用并做 UI 层适配。

| 执行通路（三类） | 说明 |
| 无障碍模式 | AI 在前台直接操控屏幕：点击、滑动、长按等等 |
| Shizuku 特权模式 | 打通系统 shell 级（adb）权限；危险操作（如删除类）被严格限制，部分权限留给用户自行开启、风险自担 |
| 平台直连调用 | 走系统正常渠道的一系列功能调用 |

| 执行模式（两种） | 说明 |
| 前台 | 用户可见地直接操作，配合无障碍 / 平台直连通路 |
| 后台虚拟屏 | 用户在前台正常使用设备、AI 在后台操控；在部分应用的限制下自动降级回前台操作 |

- 审批与交互约束：上述每条链路都施加约束，可按能力选择「禁止 / 询问审批 / 完全访问」；通过弹窗与用户交互。
- 悬浮窗提问：离开 DSHBox 页面时，AI 可召唤悬浮窗提问来与用户实现沟通，用户可选择相关条目、全部驳回或重新提问。
- 给 DSH 的原生工具：随包 DSH 插件 @local/mobile-pilot 提供一组 phone_ 工具，智能体可直接调用我们的内核信箱机制。此插件可在「Cordis」内的「DSH连接手机」处自由开启。

开发者模式（v1.5.1 新增）

从 Pilot 进入独立的“开发者模式”面板。该面板提供的是面向高级用户的完整能力，不属于 Pilot 手机助手的受控审批体系：

| 通道 | 能力与边界 |
| ADB | 开关开启时把完整 ADB 客户端及依赖挂载到 Debian 沙箱，关闭时移出；支持本机服务、无线调试配对、外部设备调试、端口与自定义密钥。 |
| Root | 使用设备现有的 su 实现，在 guest 内提供 android-root CLI；支持访问码、失败锁定、Unix/TCP 传输与权限预检。 |

- 与手机助手隔离：ADB / Root 不经过 Pilot 的“禁止 / 询问审批 / 完全访问”逐项审批、权限分级或动作拦截。用户开启开关后自行决定用途，并对自己执行的调试、系统或 Root 操作及其后果负责；原手机助手通道继续保留受控权限和审批保护。
- 与 Shizuku 隔离：开发者模式 ADB 不依赖 Shizuku，可作为部分 Shizuku 兼容性或未解决问题的替代路径；两者的开关、密钥、server 配置和生命周期独立。
- 外部设备调试：该 ADB 不仅能连接手机本机服务，也可通过网络连接其他设备。ADB 通道关闭后，相关命令、server 入口和挂载均从沙箱撤除。
- 使用前须知：无线调试要求设备支持该能力且网络可互通；Root 要求设备已有可用 su，并可能受 Magisk、KernelSU、APatch、隐藏策略和厂商 ROM 差异影响。

插件管理与插件市场（v1.4.0 新增，v1.5.1 增强）

从首页 Cordis 页签进入，插件相关能力集中管理：

| 能力 | 说明 |
| 随包自制插件开关 | 「DSH移动端页面适配」（dsh-mobile-adapt）、「DSH连接手机」（mobile-pilot）与「DSH浏览器自动化」（browser-use）；新用户默认装配，升级保留明确关闭的设置，装配与更新按 DSH 就绪状态处理。 |
| DSH 官方插件 | 把上游默认关闭的官方条目做成开关（如右侧边栏内置浏览器） |
| 绝对安全模式 | 不加载任何第三方插件启动，用于第三方插件导致 DSH 崩溃时恢复启动 |
| 插件加载记录 | 按启动分段查看插件加载情况，便于排错 |
| 崩溃修复辅助 | 内置终端 Agent opencode，一键安装 / 更新 / 卸载；终端输入 opencode 唤起 TUI，用自然语言交互，完成修复 |
| 插件市场 | 位于 App 层，提供分类浏览、搜索、兼容判定、安装守卫及第三方插件安装 / 更新 / 删除入口 |
| 已安装插件 | 先显示本地清单，再异步加载远程目录；区分已生效、重启后生效、待停用、宿主拒绝、不兼容和损坏状态，避免弱网下整个页面持续等待 |
| 随包插件保护 | 移动端适配、Pilot 与 browser-use 写入 profile dependencies；安装、更新或删除第三方插件后，不会被 pnpm 重算 node_modules 顶出 |

插件市场内置 awesome-dsh-plugin 与 awesome-dsh-mobile-plugins 两大实时数据源，后者为 DSHBox 专为移动端 DSH 插件生态新建的仓库，用户可以提交 PR，共建生态。

- 内置 pnpm 11.1.2：随包提供 Corepack 缓存，预置 npm 官方与中国大陆镜像探测；pnpm 的 store、registry 和 Corepack 环境在 DSH、官方“添加插件”入口、插件市场与终端中使用同一配置。
- 官方“添加插件”已接通：支持输入包名或链接后拉取插件信息、安装及卸载；修复 pnpm 找不到、registry 参数不被接受和 store 路径不一致等问题。
- 已安装状态按生效时机展示：启用或停用后需要重启 DSH 才能生效的条目会显示“重启后生效”，宿主拒绝、不可兼容、基础库与市场自身等不可操作项不再显示无效开关。
- 兼容边界：市场会提前检查已知宿主版本、载体和依赖问题，但不能保证所有第三方插件在任意 DSH 版本上可用。升级 Alpha 前仍应备份；从 Alpha 回退 RC 可能出现会话数据兼容问题。

DSH 移动端与双渲染适配（v1.5.1）

内置 DSH 已升级到 0.2.1-rc.5。System WebView 与 Gecko 两条渲染路径共用同一套 DSH 页面和宿主逻辑；适配集中在 App、Renderer Adapter、内置页面兼容资源与扩展中，不修改 DSH 源码或业务逻辑：

| 组件 | 移动端差异或断点 | 处理方式 |
| System WebView 启动 | 旧内核缺少 DSH 依赖的标准 API，或没有 document-start 能力 | 在页面脚本执行前补齐能力；无法安全进入启动前阶段的 provider 明确阻断并提示升级 |
| Gecko 页面桥接 | GeckoView 不具备 System WebView 相同的回调和扩展环境 | 使用内置扩展、页面状态桥、导航代次和原生事件实现 DSH 所需能力 |
| 账号登录 | DSH 先打开空白 popup，再异步取得授权地址；不同内核处理不同 | System 与 Gecko 都在受信 DSH 来源下识别 popup，需要浏览器授权时跳转系统默认浏览器 |
| DSH 内链接 | 直接在主框架加载链接会覆盖当前工作区；侧边栏 iframe 需要保留 | “默认浏览器”把顶层非同源 HTTP(S) 交给系统浏览器；“应用内侧边栏”目标保持 iframe，不误拦截 |
| 401 与重新登录 | 并发导航、重定向和迟到回调可能把状态归到错误文档 | 以导航 nonce、请求头状态和文档状态关联当前代次；旧代次结果丢弃 |
| 附件上传 | 文件选择、多选和来源判定需要原生接线 | 提供拍照、录像、相册、手机文件、音频、工作区与共享区；去重多选结果并清理 accept 哨兵 |
| 语音输入 | WebView 录音需要额外的音频设置权限 | 声明所需权限并接入 DSH 语音输入 |
| 右栏文件预览 | 非标准 scheme 的 authority/host 解析存在内核差异 | 在 App 层补齐 dsh-resource:// 解析；System 与 Gecko 使用同一语义 |
| “打开配置文件” | 旧方案依赖页面拦截，插件关闭或执行时机会导致失败 | 运行环境提供原生 xdg-open 链接，由 App 打开配置文件查看器；已存在文件不覆盖 |
| 键盘与顶栏 | Gecko 弹起键盘时可能上移整个布局视口 | 仅对 Gecko 补足视觉视口差额并固定会话顶栏；System WebView 保持原行为 |
| 右侧边栏终端 | guest 的 passwd 缺运行期 uid，os.userInfo() 可能失败 | 运行期把当前 uid 补齐进 guest passwd |
| 右侧边栏浏览器 | 上游默认关闭对应官方插件 | 在插件管理面板提供开关，重启 DSH 后生效 |
| 拍照 / 录像 | DSH 页面需要系统相机 / 录像入口 | 通过 onShowFileChooser 的 accept 哨兵改走系统拍摄界面 |
| 页面诊断 | 加载完成不等于页面已就绪，主线程能力也不等于 Worker 能力 | 诊断分别记录文档、主线程 API、Worker、Gecko 与页面状态，不伪造“已支持” |

设备返回键、自动聚焦、悬浮快捷切换和附件来源面板沿用 v1.5.0 完成的能力。v1.5.1 进一步把与插件开关绑定的 URL 解析、配置文件打开和 Gecko 键盘处理迁入 App 或明确限定为 Gecko 分支，使 System WebView 不会被 Gecko 专属逻辑干扰。

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 0.2.1-rc.5（npm 包，纯净上游） | /opt/dshapp/runtime |
| android-side | PRoot / loader / shmem（宿主侧） | — |

- 沙箱 keepalive 与 DSH 为两个独立 PRoot 进程；停机按 /proc 枚举整棵进程树、子进程优先 SIGKILL，不留孤儿、不占端口
- 每层带 SHA-256 哨兵，启动时逐层校验完整性，损坏可识别、可重装
- v1.4.0 起，base 与 node 两层不再随包内嵌（APK 内只留 dsh 与 android-side）：它们由「在线获取运行环境」（精简 Debian 层 / Node.js 层，多镜像源可选、可重置）或「离线导入整包」安装。在线组装出来的层会裁掉非必要语言包与文档等无关组件（即「精简 Debian」），占用更小

系统文件共享区（v1.5.0 新增）

- 授权后在手机公共存储创建或沿用 DSHBox 文件夹，文件管理、DSH、沙箱与终端可访问同一份本地文件，也便于通过其他应用或电脑传入、取出。
- 可选定其他系统公共目录，以独立名称挂载到沙箱共享区；文件管理和附件来源面板均提供入口。新挂载按提示重启相关运行会话后生效。
- 取消挂载只解除关系，不删除源目录或文件。公共共享目录内容不会随 App 卸载或重装而自动删除；重装后需重新授权，额外挂载关系需重新配置。用户主动删除文件仍会生效。

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

- 目录与视图：工作区 /root/projects、沙盒根（叠加 node、DSH 层）与共享区入口，面包屑导航、列表 / 网格、按名称 / 时间 / 大小排序、新建文件夹、多选批量操作
- 新建文件（v1.4.0 新增）：可在当前目录直接创建空文件
- 安装到沙箱（v1.4.0 新增）：选中 .deb 可直接解包安装进沙箱
- 移动到指定文件夹：全屏目标选择器（沙盒 / 工作区切换、可新建文件夹、源自身及子孙目录置灰防环、跨挂载点落点提示）；冲突三策略（覆盖 / 跳过 / 自动改名 + 应用到其余全部）；同卷 renameTo 优先、失败复制兜底（保留权限位 / 时间戳）；「重命名」走同一引擎
- 导入：文件多选批量导入、压缩包解压导入，逐件冲突决策、可取消、完成汇总；ZIP 中文名编码修复，加密 zip 明确拒绝
- 导出：多选导出到目录（SAF），或打包为 ZIP
- 外部接收与分享（v1.5.0 新增）：接收其他应用「分享到」或「用其他应用打开」的文件并选择保存目录，支持多文件与纯文字；文件菜单可直接调起系统分享面板，与导出功能分开
- 全局搜索：跨沙盒 + 工作区，同时搜文件名与内容，结果带匹配片段
- 风险保护：系统目录 / 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 内含层包），暂存解压 → 形态校验 → 原子换层，失败不留半成品 |
| 在线获取运行环境 | 按 Node 层 / 精简 Debian 层 分别探测对应镜像源（可达性与延迟）、下载、GPG 验签、裁剪与组装成层；分步进度、可取消，失败按原因分类提示（镜像缺包 / 验签失败 / 空间不足等）；可随时重置任意层 |
| 离线导入运行环境包 | 整包替换 base / node / android-side，逐层 SHA-256 校验，previous/ 单份可回滚（详见下文）；v1.4.0 起不随 APK 分发，但仍会在 Release 页面单独提供，与在线获取等效。 |
| 插件管理 / 插件市场 | 由首页 Cordis 页签进入：市场浏览与安装、已安装管理、官方插件开关、绝对安全模式、插件加载记录、崩溃修复辅助（详见上文「插件管理与插件市场」及兼容说明） |
| 诊断与日志 | DSH / 沙箱 / 访客命令日志可滚动、复制与导出；渲染诊断区分 System provider、Gecko 版本、页面文档状态、主线程 API、Worker 环境和已知视觉能力，不把加载完成或版本号单独当作页面可用结论 |
| 用户反馈 | GitHub Star 与问题反馈两条入口，均先弹窗说明再跳转 |

存储占用与清理

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

终端

- 多窗口：沙盒终端（PRoot Debian 完整环境，bash / vim / htop / node / npm / apt / git / python3 / ssh 开箱可用）/ 受限 shell 兜底，浮动控制面板新建 / 切换 / 关闭
- 直接操作 DSH CLI（v1.4.0 新增）：沙箱内可直接运行官方 dsh 命令（web / headless / tui / plugin），与网页端同一份 DSH、同一个 profile
- 开发者模式命令：开启对应开关后，sandbox 内可使用完整 adb；Root 通道开启且设备已授权时，可使用 android-root。关闭开关会撤除对应命令入口
- 随包小工具补齐（v1.4.0 新增）：jq、sqlite3、patch、nano、strings（binutils）等 AI 执行任务时常用的系统工具；工具包自愈 —— 换层或升级后检测到缺失会自动补装，不必清数据重来
- 两行辅助按键栏（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 个标签）

| 标签 | 功能 |
| 首页 | 控制 / Pilot / Cordis 三页签：沙箱与 DSH 状态、启动 / 重启 / 关闭、系统状态、手机助手、开发者模式入口与插件管理；设置入口位于右上角 |
| 文件 | 工作区 / 沙盒 / 共享区浏览、移动 / 重命名 / 删除、多选批量、导入 / 导出 / 分享、外部文件接收、查看器 / 编辑器、搜索 / 排序、新建文件 / 文件夹、.deb 安装到沙箱 |
| DSH | 使用 System WebView 或内置 GeckoView 加载 http://127.0.0.1:3080，自动认证、键盘与页面兼容、悬浮球刷新和模块快捷切换 |
| 终端 | 多窗口终端、辅助按键栏、控制面板、可直接运行 dsh CLI |
| Browser | 内置浏览器与 AI 网页助手、元素 / 区域反馈、本地网页预览、历史 / 收藏 / 下载及调试设置 |

设置已迁至首页右上角，保留外观（主题 / 语言）、存储与清理、App 更新、DSH 与运行环境更新 / 导入、诊断日志、反馈与关于。

已知限制

- System WebView 兼容范围取决于 provider 能力：已实测部分 WebView 101 / 124 环境可完成主要 DSH 页面流程；缺少 document-start 或所需标准 API 的旧内核会被阻止进入并提示升级。系统 WebView 版本号不能单独保证所有页面均正常。
- Worker / PDF 不等同于主页面兼容：System WebView 的 Worker 使用独立环境，当前提供诊断而不注入 Worker 兼容补丁；PDF、Excel 或依赖高版本 Worker API 的流程可能需要更新 WebView，或使用内置 Gecko 版。
- 两个 APK 不能同时安装：系统 WebView 版与 Gecko 版同包名、同签名，只能互相覆盖；安装另一个版本不会清空 Debian、sandbox、user-data 或已创建的工作区。
- 开发者模式属于高级能力：ADB / Root 不经过 Pilot 审批体系。你应理解无线调试、外部设备访问和 Root 命令的风险，并自行承担操作后果。不同 ROM 的 su、无线调试、隐藏与授权行为可能不同。
- 插件兼容由宿主与插件共同决定：市场会检查已知宿主能力、载体和依赖差异，但不能保证任意第三方插件在所有 DSH 版本上均可安装或运行。
- Gecko 静态 content script 在个别新系统上存在平台差异：当前需要桥接的登录、外链、配置文件与导航关键路径已使用原生事件、扩展状态桥或运行环境链路；未来新增页面主世界注入功能时仍需重新验证。
- 升级 Alpha 前应备份：从稳定 RC 升级到 DSH Alpha 后，回退 RC 可能出现会话数据兼容问题。

从源码构建

| 环境 | 版本 |
| JDK | 21（官方 CI 使用 Temurin 21） |
| Android SDK | compileSdk 37.2 · targetSdk 36 · minSdk 29 |
| Gradle | wrapper 9.5.0（AGP 9.3.1 · Kotlin/Compose 编译插件 2.4.20） |
| Kotlin | 编译器版本 2.4.20；源码语言/API 固定 2.2，JVM target 17 |

运行环境大层不在本仓库；由于体积较大，改为在 GitHub Release 中作为独立附件发布（见下节）。构建前请先获取 ../runtime/。

./gradlew :app:testDebugUnitTest
./gradlew :app:assembleSystemWebViewRelease :app:assembleGeckoRelease
pwsh tools/assemble_release_apks.ps1

Release 归档后输出：

- apk/dshbox-v<version>-system-release.apk
- apk/dshbox-v<version>-gecko-release.apk

归档脚本会继续执行发布契约门禁，检查两个 APK 的 DSH 兼容资产、Gecko 扩展权限、脚本哈希、包名和签名。

| 模块 | 职责 |
| app | 全部 UI（5 个标签页、DSH 访问设置、查看器、设置 / 诊断 / 更新页）、双渲染变体、前台服务、在线更新编排与运行环境获取 |
| dsh-renderer | api 共享渲染契约、导航鉴权与文件交付；system 系统 WebView 兼容与能力探针；gecko GeckoView 158 渲染、扩展、弹窗与文件选择 |
| sandbox-manager | 分层运行时装配、PRoot 进程管理、DSH 层仲裁与更新、导入 / 校验 / 清理 |
| common | 常量、npm 镜像源、版本比较、日志脱敏 |
| bridge | WebView JS Bridge 安全框架（预留 stub） |
| terminal-session | 终端会话层（多窗口、PRoot 终端命令构建） |
| terminal-view / terminal-emulator | Termux 终端库（v0.118.0，未修改） |
| plugin-manager | 插件管理：装配控制、插件市场（目录取数 / 兼容判定 / 安装守卫）、官方插件开关、绝对安全模式、插件加载记录、崩溃修复辅助（opencode） |
| pilot（interlock-relay-core + dshbox-adapter + developer-access） | 手机助手内核与 UI 适配；开发者模式的 ADB、Root、无线配对、设备、密钥和通道面板 |
| browser（browser-api / browser-runtime / browser-bridge / browser-devtools） | 浏览器契约、WebView 会话运行时、沙箱工具桥接与受控高级调试；界面由 app 接入 |

运行环境层构建脚本见 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 发布的运行环境压缩包中解压并提取 android-side 层，放到构建所需的 runtime/android-assets/runtime/android-side.tar.zst；否则编译出的 APK 缺少该运行层，无法正常安装运行环境。

注：Release 页面随版本一并提供打包好的运行环境整包（三层：base / node / android-side，独立于 APK），可直接下载使用。v1.4.0 起 APK 内只内嵌 dsh 与 android-side 两层；base 与 node 两层不再进包，由「在线获取运行环境」现场组装，或由该整包离线导入。

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

| 发布包内路径 | 内容 |
| runtime/android-assets/runtime/android-side.tar.zst | 宿主侧 PRoot / loader / shmem，带 .sha256 侧车（内嵌进 APK） |
| runtime/android-assets/dsh/0.2.1-rc.5.tar.zst | DSH 层 + .sha256（纯净上游，不打补丁；内嵌进 APK） |
| runtime/offline-baseline/{base,node}.tar.zst | Debian 层与 Node 层，各带 .sha256 侧车与 runtime-profile.json；不进 APK，作为离线整包的一部分交付 |
| runtime/dshapp-runtime-debian-arm64-0.1.0.zip | 对外交付的运行环境整包（离线导入用） |

- 引用方式：app/build.gradle.kts 通过 assets.directories.add("../../runtime/android-assets") 引用发布目录，构建时内嵌进 assets/runtime/ 与 assets/dsh/
- 判定机制就在这句话里：放进 assets.directories.add 指向的目录才会进包；base / node 移到 runtime/offline-baseline/ 之后即不再内嵌。实测 APK 内条目与此吻合——只有 assets/dsh/ 与 assets/runtime/android-side.tar.zst
- 构建前置：assembleSystemWebViewRelease / assembleGeckoRelease 前需先获取 runtime/，目录缺失则无法内嵌完整运行环境；v1.4.0 起该前置只对 dsh 与 android-side 两层成立
- 签名密钥（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.2.1-rc.5.tar.zst），与在线更新并存。

用户交流与反馈：

- QQ交流群：2163082322
- Bilibili账号:搜索“文大师啵啵”
- 问题反馈：GitHub Issues

许可证

本项目采用 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 未修改）
- GeckoView 158（MPL-2.0 及内含组件各自许可；仅内置 Gecko 版包含，未修改上游 AAR）
- ZXing Core 3.5.3（Apache-2.0，开发者模式访问码二维码）
- sora-editor（LGPL-2.1-or-later，aar 未修改）· Markwon（Apache-2.0）· commons-compress（Apache-2.0）· zstd-jni（JNI 包装层 BSD-2-Clause，Zstandard 内核 BSD-3-Clause）
- interlock-relay-core（Apache-2.0，手机助手平台层，独立发布，源码随本仓库分发）· Shizuku（MIT，手机助手的 shell 身份执行通路）

三个自有插件 dsh-mobile-adapt、mobile-pilot 与 browser-use 各附完整 LICENSE、NOTICE，并声明为 GPL-3.0-only；第三方依赖保留各自原许可。可在「设置 → 关于 → 开源许可」离线查看随包许可，来源与源码重建说明见 licenses/README.md。

品牌标识不在上述授权范围内。 App 名称、应用图标与应用内自有品牌图形（清单见 TRADEMARK.md）由项目权利人独占持有，全部权利保留；未经许可不得用于修改版 / 衍生版，或用于可能造成混淆的标识。