欢迎光临
我们一直在努力

如何5分钟启动DSHA:从安装APK到第一次AI对话,新手完整教程

【免费下载链接】DSHA

免 ROOT 免 Termux,在手机上跑 DeepSeek Harness。完整 Ubuntu 环境 + proroot 零 ptrace 开销 · AI 输出实时上屏 · ADB 直连 · 数据不丢

项目地址:
https://gitcode.com/gh_mirrors/ds/DSHA

点击查看 免费下载

DSHA 是一款免 ROOT、免 Termux 的安卓应用,让你在手机上完整运行 DeepSeek 官方 AI 助手 DeepSeek Harness(dsh)——内置完整 Ubuntu 环境,装完 APK 填个 API Key 就能对话。本教程带你走通 DSHA 新手安装全流程:选对版本 → 安装 → 首次启动 → 配置模型 → 完成第一次 AI 对话,全程约 5 分钟,不用敲一行命令。

30秒看懂:DSHA 是什么

DeepSeek Harness(@deepseek-ai/dsh)是 DeepSeek 官方的 agent harness,类似 Claude Code——可以写代码、跑命令、操作文件的 AI 助手。但它原本是为 glibc Linux 写的,直接搬到安卓上会撞上原生模块编译、SELinux 拦截、沙箱启动等一系列问题。

DSHA 把这些全部封进一个 APK 里,装完即用:

你得到的说明
🚫 零命令行门槛 不装 Termux、不配 pkg、不敲命令,装 APK 就完事
🐧 完整 Ubuntu 环境 Ubuntu 24.04 + Node.js 24 + pnpm 10,apt、PTY 终端、Python 都能用
⚡ 离线可用 完整环境打进 APK,无网也能部署,内置离线工具链
🩺 坏了能自诊 组件级自检 + 启动故障处理,Web 起不来会直接点名是哪个插件的问题

第1步:选对APK版本(关键,别装错)

DSHA 提供两个版本,共享 com.dsh.client 包名与数据,不能并排安装。当前正式版为 v0.2.0-rc2 · build170,内置 DSH 0.2.0-rc.2 与移动 UI 3.0.5。

版本适用设备网页内核大小
Standard 标准版 Android 11+ / arm64 系统 WebView,支持实验性虚拟屏 273.10 MiB
Low 兼容版 Android 6+ / arm64 内置 GeckoView 143 345.27 MiB

⚠️ 选择前记住三件事:

  • 仅支持 arm64:32 位与 x86 设备不支持;
  • 系统 ≥ Android 11 选 Standard(更小、功能更全),更老的系统选 Low;
  • 建议下载后校验 SHA-256,方法见 docs/download-verification.md。
  • 安装时允许"安装未知来源应用"即可。同签名 APK 覆盖安装可平滑升级,历史会话与配置保留。

    第2步:首次启动,等离线环境解压完成

    打开 App 后,DSHA 会自动执行六步安装流水线:解压 → 基础工具 → Node.js → pnpm → dsh → 补丁。每一步先探测再执行、装完即校验,只修失败项,不从头重来。

    • 历史完整冷安装耗时 42.412 秒(尚未达到 30 秒目标),时间取决于机型,耐心等进度条走完;
    • 无需网络:Ubuntu 24.04 的 rootfs 已经随 APK 内置;
    • 某一步失败时,到「安装与环境」页查看六个组件的检查结果,按需单独重装,不重复下载。

    第3步:在"模型配置"页填 DeepSeek API Key

    进入「模型配置」页,按提示填写:服务商 · API Key · 地址 · 协议 · 模型目录。

    • API Key 由 Android Keystore(AES/GCM)加密保护,密钥不出 Keystore;
    • 还没有 Key?可以先跳过,启动后再补填——DSHA 支持手写自定义供应商的 API 地址,非 DeepSeek 官方接口也能用;
    • 提示:使用在线模型时,消息及你选择的附件会发送到所配置的模型服务。

    第4步:点"启动 DSHA",等 Web UI 打开

    在「启动」页点 ▶ 启动 DSHA,App 会自动拉起移动端 Web UI。这一阶段有几点新手须知:

    • 通知栏可见运行状态:DSHA 以前台服务运行,Web 掉了看门狗会自动拉起,不用手动重启;
    • 慢启动不会被误杀:等待鉴权不设强杀时限(60 秒仅提示),机型慢一点也正常;
    • 启动失败会自动进入「启动故障处理」页,安全启动用独立 profile 只加载官方基础组件,原配置与插件开关保留。

    第5步:完成第一次AI对话

    Web UI 打开后,选一个模型,直接输入问题发送即可。内置移动 UI 适配(dsh-web-mobile 3.0.5),手机上体验与桌面基本一致:

    功能体验
    💬 流式悬浮条 AI 输出像歌词一样贴在屏幕顶部,工具调用翻译成人话,危险命令可直接在悬浮条上批准
    🖼 画中画 对话窗口支持 PiP 小窗悬浮,边聊边干别的
    💻 真 PTY 终端 vim / htop / tmux 等全屏程序都能用,自带 Ctrl / Esc / 方向键扩展键行
    🌐 局域网访问 电脑 / 平板浏览器连同一 Wi-Fi,也能直接用手机上的 dsh

    进阶选项:让AI操作你的手机(可选)

    DSHA 的另一大卖点是"手机就是 agent 的手"。不想折腾可以直接跳过,按需开启:

    • 读屏 / 点按 / 输入:走无障碍服务,不需要 ADB,授权即可;
    • ADB 无线直连:开启开发者选项 → 无线调试 → 记下 IP:端口和 6 位配对码 → 回 DSHA「设备能力授权」页填入配对(约 1 分钟)。配对后 DSHA 自动保活 + 重连,重启手机自动恢复,且不需要 Shizuku;
    • 虚拟屏(实验性):Standard / Android 11+,步骤见 docs/virtual-screen-guide.md。

    所有设备能力默认关闭、逐项授权、随时撤销;危险命令始终走白名单,格式化 / 分区 / SELinux 等直接拒绝。每项权限的边界详解见 docs/security-model.md。

    数据与备份:别让会话丢了

    在「数据与备份」页可以:

    • 导出:新用户导出为无需密码的 .tar.gz 归档(历史加密备份仍可读取);
    • 自动备份:默认开启,每天 / 每 1–168 小时 / 停止 DSH 后三种模式,保留最近 3 份已验证副本;
    • 换机恢复:导出实际对话、附件、设置及用户插件,先校验摘要再预检恢复。

    ⚠️ 本机数据副本不保证卸载后存续,换机或卸载前请先导出。

    新手常见问题(FAQ)

    Q:装不上 / 启动不了? 先确认设备是 arm64;再打开「安装与环境」页,六项组件逐个检查,只修复失败项。

    Q:首次启动特别慢正常吗? 正常。冷安装历史实测 42 秒左右,期间请勿杀后台。等待阶段 60 秒才有提示,不会被看门狗误杀。

    Q:Web UI 起不来? DSHA 会进入启动恢复流程,并用人话告诉你"是插件 X、它要的服务不存在",而不是甩一屏堆栈。启动诊断保留最近五次脱敏记录,可导出排查。

    Q:权限一定要给满吗? 不用。最小配置(不给 ADB、不给文件权限、不开局域网)下 DSHA 照常跑 dsh;每项能力默认关闭、随时撤销。

    Q:老版本能直接升级吗? 用同签名 APK 覆盖安装即可,相同 Ubuntu 基础版本只更新受管组件,不重建整个环境。升级前建议在"数据与备份"导出重要数据。

    延伸阅读

    • 项目总览与功能全表:README.md
    • 完整更新记录:CHANGELOG.md
    • 本版正式发布说明:docs/releases/v0.2.0-rc2-notes.md
    • Standard / Low 两版设备适配细节:docs/android-standard.md · docs/android-low.md
    • 插件安装与生态:docs/plugins.md
    • 安全模型(每项权限到底暴露了什么):docs/security-model.md

    装好 DSHA,你的手机就成了一台随身的 Ubuntu + AI 工作站——出门排队、通勤路上,都能让 agent 帮你干活。

    赞

    分享

    【免费下载链接】DSHA

    免 ROOT 免 Termux,在手机上跑 DeepSeek Harness。完整 Ubuntu 环境 + proroot 零 ptrace 开销 · AI 输出实时上屏 · ADB 直连 · 数据不丢

    项目地址:
    https://gitcode.com/gh_mirrors/ds/DSHA

    点击查看 免费下载

    创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

    赞(0)
    未经允许不得转载:171主机测评 » 如何5分钟启动DSHA:从安装APK到第一次AI对话,新手完整教程
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址