DSH Go 完整教程：免 Root 在 Android 手机上本机跑 AI 智能体 DSH
项目地址: https://gitcode.com/gh_mirrors/ds/dsh-Go 你有没有这样的时刻：让 AI 智能体在电脑上跑个长任务，转身去吃饭，回来发现电脑休眠了，任务断在半路。DSH Go 把整套运行环境直接装进 Android 手机——它在本机引擎模式下，于手机内部拉起一套 Ubuntu 24.04 + Node.js 环境，让 DSH（DeepSeek Harness 引擎）完全跑在你自己口袋里，不需要一台常开的电脑，也不用 Root 或装 Termux 这类终端模拟器。装好之后，手机既能当独立的 AI 工作站，也能反过来遥控你电脑上的 DSH。
先说清两件事，免得有误会：DSH Go 是社区开发的非官方客户端，与 DeepSeek 官方没有关联；引擎跑在手机上，但模型请求仍然发给你配置的模型提供方，需要联网、按对方账户正常计费——本机运行不等于模型免费离线。
装之前：三项准备一次查清
下载之前花一分钟确认设备情况，可以避免装到一半提示空间不足。
- 系统版本：Android 8.0（API 26）及以上。
- 架构：常见 64 位手机装 arm64 包；x86_64 模拟器用发布说明末尾「其他版本下载」里的 x64 包，仓库没有 32 位 ARM 构建。
- 空间与内存：运行环境解压后约 750 MB，安装器会按「解压体积 + 15%」校验剩余空间，建议预留约 1 GB；引擎运行峰值约 300 MB 内存，5 GB 以下内存的手机，App 会主动建议你改用远程主机方案。
这些数字不是拍脑袋的：安装页的空间和内存提示由 App 读取设备真实容量后算出，源码见 app/lib/runtime/，空间或内存不够时会直接标黄警告并推荐远程方案。
注意：手机上如果装过签名不同的早期测试包，不能直接覆盖安装，需要先卸载旧版——卸载会清空对话、Linux 环境和设置。
安装流程：三次点击，不用敲任何命令
整个过程没有终端、没有命令行，全部是点按钮。
- 装 App：从 Releases 或官网下载页拿到对应架构的 APK，按系统提示允许该安装来源。
- 选运行位置：首次启动的引导页会问「DSH 在哪里运行？」，选本机——卡片上会写明需要的存储空间和内存占用，确认后 App 自动开始解压内置的 Linux 运行时，页面显示进度环和百分比。
- 配模型、发第一条消息：等待解压完成后，用 DeepSeek 账号登录或填入 API Key（入口在设置 › 模型，也支持 OpenAI、Anthropic 兼容的自定义渠道），就能开聊了。
之后想补装本机环境也不用重装 App：在引擎页点安装运行环境即可，装好自动启动。整个运行时的打包与安装逻辑在仓库的 runtime/ 目录，App 与引擎之间的接口约定写在 docs/architecture.md。
第一次对话：插话、排队、过程自动收好
把引擎跑起来之后，真正每天摸到的是聊天界面。DSH Go 的交互为「长任务」做了三件实事：
- 生成中可直接插话：DSH 还在跑脚本时，输入框提示「生成中 · 可直接插话」，你补一句新要求，它会进入排队，可选「立即发送」插队、「改为插话」或「撤回」；
- 过程折叠成一行：一次回复里的工具调用、思考步骤全部展开可见，完成后折叠成「已完成 · 3 次工具调用」，点开还能看逐步细节；
- 交付物直接给文件：让它「把销账做成表和图」，回复里会挂上 xlsx 和 png，点开即用。
同一个对话还支持原生界面和官方网页版一键切换，停在同一段对话上，下次打开还是你上次用的那个界面。本机网页版只在 App 内监听 127.0.0.1，不会暴露到局域网。
日常维护：设置 › 本机引擎
装好后，设置 › 本机引擎是日常维护的主战场，菜单路径都长这样，按图索骥即可：
- 启动 / 停止 / 重启：停止和重启都会中断进行中的对话，停止前有确认；
- 打开 App 时自动启动：默认开启，不需要时关掉，否则哪怕你在用远程主机，打开 App 也会把本机引擎拉起来；
- 自动进入安全模式：默认开启。连续两次启动失败后自动不加载插件启动——先排除「是不是插件坏了」这一最大嫌疑，修好后点恢复正常模式；
- 日志：引擎的实时输出。启动失败时页面会给出失败原因和对应的修复按钮（重试、以安全模式启动、查看日志）；
- 重置运行环境 / 卸载运行环境：前者删除本机数据后重装，用来救活起不来的环境；后者直接释放空间，本机对话、工作区、插件、设置全部删除且不自动重装。两者都不可撤销，操作前先用
/export或「全部功能」里的导出对话日志把需要的对话存出来。
进阶：同一台手机，遥控电脑也遥控手机
本机引擎装好，不代表要放弃电脑。打开对话列表，点底部的主机名，弹出切换主机面板，在本机、电脑（SSH）、DSH Remote 主机之间切换；对话、工作区、插件各归各的主机，互不干扰。
- SSH 主机：那台电脑开着 SSH 并装好 DSH 即可。在远程主机页点添加 SSH 主机，填主机、用户名、端口（默认 22），选密码或私钥登录，点测试连接，首次连接会弹「信任这台主机？」，核对指纹一致后点信任并连接。
- DSH Remote：不用配网络，连接端到端加密，适合两台机器不在同一网络的情况。在那台主机上装好远程插件并登录，手机端用同一账号登录，列表里选中在线主机即可。
再进一步是手机操控（设置 › 手机操控）：开启后 DSH 能看屏幕、帮你点按输入，比如建日程、定闹钟、替你操作 App。它只对本机引擎开放，需要打开无障碍服务和通知；密码、验证码、付款这类敏感步骤默认交还给你，确认方式三档可选（每次都询问 / 本任务免确认 / 始终免确认）。任务进行中屏幕顶部有悬浮条，点停止或按住小球 1 秒随时叫停；熄屏、锁屏或 3 分钟没有新操作，任务也会自动结束。
故障排查：三个最高频的问题
切后台后引擎被杀？ 部分系统省电策略会拦截后台进程。DSH Go 发现后会提醒你，并直达对应的放行设置（vivo、小米、华为、荣耀、OPPO 都有入口）。按 App 提示关闭电池优化、保留「引擎运行中」通知、在最近任务里锁定 App 这三步做完，绝大多数情况能解决。
引擎反复启动失败？ 确认自动进入安全模式开着（默认就开）。仍不行就打开设置 › 诊断导出诊断包——含版本、设备、日志和最近一次崩溃，但不含 Key 和令牌——反馈给社区；也可以点「让 AI 看诊断」，让内置的排查技能直接给一份 issue 草稿。
想省空间？ 两个级别：暂时不用就停止引擎并关掉「打开 App 时自动启动」，环境还在；彻底释放空间才用卸载运行环境，删干净后想再用，在同一页点安装运行环境即可。
下一步
打开 App，把第一条消息发给本机引擎，让它做一件真正需要工具的事——读文件、跑脚本、生成表格，而不仅是回答一句。哪一步卡住了？先看 docs/guide/README.md 的使用指南总目录和 docs/guide/zh/11-faq.md 的常见问题排查清单。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
