WSK-build/DSHBox

DSHBox

Run DeepSeek Harness locally on Android. One APK with Debian, Node.js, DSH, and WebView — no root or Termux required. 在 Android 手机上本机运行完整 DSH。

待分类androidandroid-agentandroid-app

English | 简体中文

DSHBox — Run DeepSeek Harness Locally on Android

DSHBox is an open-source app that runs the full DeepSeek Harness (DSH) locally on Android phones and tablets. It brings DSH, PRoot, WebView, Debian and Node.js together with a terminal, file manager, AI browser assistant and phone assistant to form a personal AI workbench. No root access or separate Termux installation is required.

DSHBox 是一个可在安卓手机和平板上本机运行完整 DeepSeek Harness(DSH) 的开源应用。它将 DSH、PRoot、WebView、Debian、Node.js 集成协调在一起,配套终端、文件管理、AI 浏览器助手与手机助手等工具,组成个人 AI 工作台,无需 Root,也无需单独安装 Termux。

快速安装

项目 · 说明 系统要求 · Android 10+ · ARM64 权限 · 无需 Root · 无需 Termux 内置 · DSH 层 · WebView · PRoot(Debian 与 Node.js 改为首次运行时多镜像源检测在线获取或离线导入) 安装包 · 以 Release 页面所附 APK 为准 首次准备 · 按分步引导安装精简 Debian 与 Node.js,支持多镜像源检测、失败重试或离线导入;引导页提供 WebView 版本探测与兼容性提示 特别注意 · 由于 DSH 官方对系统 WebView 内核要求较高,较低版本可能导致白屏、工作区加载异常等问题。遇到此类情况,可通过谷歌商店更新系统 WebView,或咨询 AI,选择适合自己设备的 WebView 版本进行升级或替换。

下载最新 APK → 安装 → 启动应用 → 按引导获取运行环境(在线多镜像源,或沿用离线导入)→ 打开 DSH。

更新记录

当前版本 v1.5.0(2026-10-17):AI 浏览器助手·系统文件共享区·DSH界面交互升级。

  1. 新增 Browser 与 AI 网页助手,通过 browser-use 插件和沙箱 CLI 开放 24 项工具,支持网页操作、截图、元素/区域反馈、本地网页预览与受控高级调试;与操作手机原生应用的 Pilot 独立分工;
  2. 新增系统文件共享区,创建或沿用手机公共存储中的 DSHBox 文件夹,并可挂载其他选定目录;取消挂载不删除源文件,卸载 App 不会自动删除公共共享目录内容;
  3. DSH 界面交互升级:全屏显示、悬浮快捷切换、附件图标与底部来源面板,修复多文件上传、返回键断点及键盘异常弹起;首页重新布局,设置入口迁至右上角;
  4. 新增分步安装引导与 WebView 版本提示、外部文件接收和文件对外分享,完善首次安装插件实际装配、DSH 启动状态及 Pilot 主题跟随,首页入口由 DshPilot 更名为 Pilot。

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

核心特性

DeepSeek Harness 全内嵌

  • DSH 随 APK 内置,首启按版本仲裁装配到 runtime-current/dsh:已装较新则保留,换层时旧层备份到 previous/dsh(单份),不触碰用户数据
  • DSH 标签页内嵌 WebView 打开 http://127.0.0.1:3080:自动解析 launchToken 完成会话认证、移动 UA、键盘自适应、双指缩放;全屏布局配合可拖动悬浮球,可刷新或快速切换到首页、文件、终端和 Browser。同时,首页保留一键用系统浏览器打开 DSH。

v1.4.0 起,页面刷新一律按当前 token 重新加载:DSH 换过 token(重启或健康循环拉起)后,页面不会卡在「手动刷新都刷新不回来」的状态。

  • 运行期硬链接兼容垫片:安卓应用数据分区(FBE/FUSE)拒绝硬链接,而 DSH 用 link() 作为「不可覆盖地发布一个文件」的原语,导致会话持久化、文件工具、附件发布失败。本版改为启动时以 node --import 预加载垫片,在运行期替换 node:fs/promises 的 link——被平台拒绝时退化为语义等价的内容拷贝(保留源文件、保留「不覆盖」语义、补齐权限位)。DSH 源码一个字节都不改,因此不受上游重构影响,也不存在补丁锚点漂移
  • 跨 WebView 内核版本适配:部分 WebView 版本对非标准 scheme(dsh-resource://)不解析 authority,hostname 取到空串 → DSH 取不到协议名,右栏点文件报「文件资源服务不可用」。插件内做运行期能力探测 + 范围锁定:只在探测到异常时介入,正常内核零改动
  • 前台服务通知带「启动 / 重启 / 关闭」快捷操作

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_* 工具,agent 可直接调用我们的内核信箱机制。此插件可在「Cordis」内的「DSH连接手机」处自由开启。

插件管理与插件市场(v1.4.0 新增)

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

能力 · 说明 随包自制插件开关 · 「DSH移动端页面适配」(dsh-mobile-adapt)、「DSH连接手机」(mobile-pilot)与「DSH浏览器自动化」(browser-use);新用户默认装配,升级保留明确关闭的设置,装配与更新按 DSH 就绪状态处理。 DSH 官方插件 · 把上游默认关闭的官方条目做成开关(如右侧边栏内置浏览器) 绝对安全模式 · 不加载任何第三方插件启动,用于第三方插件导致 DSH 崩溃时恢复启动 插件加载记录 · 按启动分段查看插件加载情况,便于排错 崩溃修复辅助 · 内置终端 Agent opencode,一键安装 / 更新 / 卸载;终端输入 opencode 唤起 TUI,用自然语言交互,完成修复 插件市场 · 位于 App 层,提供分类浏览、搜索及第三方插件安装 / 更新 / 删除入口;插件兼容性仍取决于 DSH 版本,相关遗留问题见下方说明

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

版本兼容说明:本版暂不推送插件市场相关修复。上游 Alpha 变更频繁,涉及较多插件调整,插件适配将在 DSH 下一个正式 RC 发布后同步。本版未随包搭载最新 Alpha;现有测试中,可通过设置里的 DSH 在线更新入口升级体验,但回退稳定 RC 后可能出现对话数据相关故障。后续随包版本将跟进最新稳定 RC。

DSH 移动端组件适配(v1.4.0)

内置 DSH 升级到 0.2.0-rc.2 后,逐条打通各功能组件在移动 WebView 环境下的断点,并开启上游此前不可用的能力。适配全部在 app 侧完成(原生桥 + cordis 插件),不改动 DSH 源码:

组件 · 移动端断点 · 处理方式 会话持久化 / 文件写入 / 附件发布 · 安卓应用数据分区拒绝硬链接 → EACCES · 运行期垫片替换 fs/promises.link,退化为内容拷贝(语义等价,见上) 附件上传 · WebView 文件选择回调与多选结果需要原生接线 · 原生附件来源面板提供拍照、录像、相册、手机文件、音频、工作区和共享区;收集并去重系统多选结果 右栏文件预览 · 非标准 scheme 的 host 解析差异 → 报「文件资源服务不可用」 · 运行期能力探测 + URL 解析兼容层,仅异常内核生效 设置面板「打开配置文件」 · 拦截后上游的建文件步骤不再执行 → 全新设备必然失败 · 原生侧补齐物化逻辑(已存在则原样保留,绝不覆盖用户配置) 上传来源判定 · 隐藏 file input 的 accept 哨兵残留会污染 DSH 原生上传 · 结果回填时主动清理 + 插件侧捕获守卫,双保险 插件装配 · APK 升级后 profile 内的插件副本仍是旧版 · 启动时按内容指纹判定并自动刷新(不覆盖用户手改,失败原因可见) 内核能力差异 · 旧内核缺失 :has() / color-mix() 等特性时静默失效 · 诊断页提供真实内核指纹与 CSS 能力实机探测,供排障定位 语音输入 · WebView 录音需要额外的音频设置权限 · 补齐权限声明,DSH 页面语音输入可用 右侧边栏终端 · guest 的 passwd 缺运行期 uid → Node 的 os.userInfo() 报 ENOENT,Shell 提示符退化成 I have no name! · 运行期把当前 uid 补齐进 guest passwd(GuestUserProvisioner) 右侧边栏内嵌浏览器 · 上游默认关闭该官方插件 · 在插件管理面板提供开关,打开即生效(重启 DSH) 拍照 / 录像 · 上游没有相机入口 · 拦截 onShowFileChooser 的 accept 哨兵,改走系统相机 / 录像

v1.5.0 进一步补齐设备返回键与 DSH 内部面板的层级衔接,抑制非用户手势引发的自动聚焦,减少键盘异常弹起和页面位移;附件工具行提供直达入口,原生来源面板不依赖移动适配插件即可使用。

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.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 / 沙箱 / 访客命令日志各 150 行,可滚动、可导出合并;含 WebView 真实内核指纹(提供者 / 版本 / Chromium 主版本 + CSS 能力实机探测) 用户反馈 · 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
  • 随包小工具补齐(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 · 全屏内嵌 WebView 加载 http://127.0.0.1:3080,自动认证、键盘自适应,悬浮球提供刷新与模块快捷切换 终端 · 多窗口终端、辅助按键栏、控制面板、可直接运行 dsh CLI Browser · 内置浏览器与 AI 网页助手、元素 / 区域反馈、本地网页预览、历史 / 收藏 / 下载及调试设置

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

从源码构建

环境 · 版本 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 单测
./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,未修改) plugin-manager · 插件管理:装配控制、插件市场(目录取数 / 兼容判定 / 安装守卫)、官方插件开关、绝对安全模式、插件加载记录、崩溃修复辅助(opencode) pilot(interlock-relay-core + dshbox-adapter) · 手机助手:内核平台层(独立发布仓库,Apache-2.0)+ 本应用的 UI 适配层 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 页面随版本一并提供打包好的运行环境整包(三层: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.0-rc.2.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.srcDirs("../../runtime/android-assets") 引用发布目录,构建时内嵌进 assets/runtime/* 与 assets/dsh/*
  • 判定机制就在这句话里:放进 `assets.srcDirs` 指向的目录才会进包;base / node 移到 runtime/offline-baseline/ 之后即不再内嵌。实测 APK 内条目与此吻合——只有 assets/dsh/* 与 assets/runtime/android-side.tar.zst
  • 构建前置:assembleRelease 前需先获取 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.0-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(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)由项目权利人独占持有,全部权利保留;未经许可不得用于修改版 / 衍生版,或用于可能造成混淆的标识。