DSHBox 把 Debian 13 用户空间、Node.js 24、DSH 0.1.5-rc.2 和内嵌 WebView
打成一个安卓应用。下面按实际顺序走一遍干净安装。首次启动需要装配环境,留出几分钟和稳定网络即可。
开始之前需要准备什么
- 一台 ARM64、Android 10 及以上的设备。构建目标为 Android 16
(targetSdk 36),不支持 x86、32 位 ARM 和 iOS。
- APK 约 237 MB,初始化后的运行环境约 193 MB,
另外还要给自己的项目文件留出空间。
- 首次启动需要联网,应用要在此期间装配运行环境。
- 一个模型服务账号和 API Key。DSH 不自带,DSHBox 也不会替你提供。
不需要 Root,也不涉及 Termux。想先弄懂背景,可以读
《DSH 到底是什么》;否则直接往下看。
安装 APK
从下载区或项目 GitHub Release 页面获取 APK。
这是侧载安装,安卓会提示"来自应用商店之外",任何独立构建都会遇到这条提醒。
提醒本身正常,但也说明来源很重要:只安装从项目官方发布页拿到的 APK;
浏览器提供校验值时,顺手核对一下。
DSHBox 是 GPL-3.0 社区项目,不是 DeepSeek 官方应用,与 DeepSeek 没有隶属或背书关系。
首次启动与环境初始化
第一次启动时,DSHBox 会在应用私有目录里解包并装配各层:PRoot 加载器、Debian 13
根文件系统、Node.js 24,以及位于 /opt/dshapp/runtime 的 DSH npm 包。
初始化后的运行环境大约 193 MB。每一层都有 SHA-256 标记,启动时校验,
层损坏会被发现,不会悄悄混用。
初始化需要网络,先完整结束再改设置。失败就换稳定网络重试,
并在设置的"诊断与日志"里导出日志。
五个标签页
|
| | 标签页 | 用途 |
| 首页 | 沙箱与 DSH 状态、运行时长、启动、停止、重启、复制地址、在浏览器中打开 |
| 文件 | 工作区与沙箱根目录两种视图、查看器与编辑器、导入与导出 |
| DSH | http://127.0.0.1:3080 的内嵌 WebUI,自动 launchToken 认证、移动端 UA、键盘适配、双指缩放和悬浮刷新 |
| 终端 | 客户机内的 shell,用于执行命令、安装软件包和排查问题 |
| 设置 | 外观、存储与清理、DSH 更新、检查应用更新、运行时包导入、移动端适配装配、诊断与日志、反馈、关于 |
五个标签是同一个沙箱的不同视图,所以启停控制统一放在首页。
打开 DSH WebUI
如果沙箱还没运行,先在首页启动,再切到 DSH 标签页。WebUI 通过回环地址加载,
launchToken 自动带上,无需手动复制。内嵌浏览器使用移动端 UA、适配软键盘,
双指缩放和悬浮刷新用于桌面式布局。
内嵌视图不正常时,首页可复制地址或用系统浏览器打开。服务只监听本机,
其他设备访问需要另行配置网络。
配置模型服务并创建第一个会话
DSH 的配置在 DSH 里完成,不在 DSHBox 设置中。在 WebUI 打开模型服务配置区域,
按服务商文档填入端点、模型名称和 API Key。Key 与 DSH 配置存在一起,请当作机密。
接着新建会话,先给一个小而可验证的任务,比如列目录或创建测试文件。
新文件放在 /root/projects,即 user-data/ 在客户机中的视图。
除模型推理外,一切都在手机上运行:DSH 把补全请求发给你配置的服务商,
模型权重不在设备上执行。
提示词、附件和工具调用的细节,见
《第一个 DSH 会话》。
停止、重启与下一步
首页显示状态和运行时长,并提供启动、停止、重启。停止会结束 DSH 服务,
但保留工作区:/root/projects 里的文件和 user-data/.dsh
中的配置都留在应用私有存储里。重启后沙箱恢复,DSH 标签页重新连上同一地址。
- 先确认设备满足硬件要求,再怀疑安装过程。
- 尽早规划备份,参考《数据存在哪,怎么备份》。
- 收到新版本时,先看更新如何保住工作区。
整个路径就是:安装、初始化、打开、配置、新建会话。剩下的都是 DSH 的日常使用。