掌上终端 ccch1mneyyy/dsh-Go

简体中文 · English

DeepSeek Harness 的 Android 客户端。手机上直接跑，也能遥控你电脑上的 DSH。

Deepy 和鲸娘，陪你干活

干活时敲代码，做完来个空翻，等你确认会举手。打开「App 外显示」，它们还会跟你到桌面。

下载 DSH Go 从 GitHub Releases 或官网下载页获取最新版 APK，常见手机选 arm64 包。

感谢大家对 DSH Go 的支持和喜爱，我将尽快适配 iOS 和鸿蒙！大家 Star 点得越多，我适配得越快哦 hhh

第一次用可以先看使用指南，遇到问题欢迎来论坛和 QQ 群。
手机上装过签名不同的早期测试包时不能直接覆盖安装，需要先卸载旧版；卸载会清空对话、Linux 环境和设置。

本机运行，也能遥控电脑

内置 Linux 环境，免 Root、免 Termux。电脑上的 DSH，也能一键切过去接着用。

插话、打断，过程自动收好

回复中途也能插话，排队的消息随时「立即发送」。做完的过程折叠成一行。

原生界面，也有网页版

和官方网页版一键切换，停在同一段对话，下次打开还是你上次用的那个。

分享卡、对话回放和链接

回复一键做成分享卡。整段对话生成链接，对方在浏览器里回放，链接端到端加密。

横屏与平板

横屏手机和平板重新排版：侧栏常驻，内容居中，弹出键盘也不挤。

主题配色与桌面图标

六套主题色，也能跟随壁纸或自选颜色。四款桌面图标，三种功能图标风格。

中文，也说 English

全部界面支持英文，在设置里切换，默认跟随系统。

手机操控

看屏幕、帮你点，三档确认随你选。付款、密码和验证码，永远交还给你。

可以做什么

DSH Go 提供聊天界面、本机运行环境和远程连接，是基于 DeepSeek Harness 的第三方项目。运行在手机上的是 DSH 引擎；模型请求仍由你配置的模型提供方处理。

- 本机运行：在 App 内安装 Ubuntu、Node.js 与 DSH 运行环境，无需 Root 或另装 Termux。
- 远程连接：通过 SSH 或 DSH Remote 使用电脑、服务器上的 DSH。
- 聊天与工具：切换模型，发送图片、使用语音输入，处理工具审批和提问；支持聊天界面与网页模式。
- 插件界面：使用适配 DSH Go 的原生工具卡、表单和面板；仓库提供 SDK、教程和示例。
- 手机操控：在你开启权限后，让本机引擎读取屏幕、点按和输入，并可随时停止。
- 分享与外观：分享、导出和回放对话，调整主题、图标和桌宠。

功能随主机和连接方式不同。DSH Remote 当前只支持图片附件，不能在 App 内打开网页版，插件管理限于开关，且不支持 DS Bot 和对话日志导出。详见本机引擎与远程主机。

安装

安装要求为 Android 8.0（API 26）及以上。Release 页面上的 arm64 安装包适用于常见的 64 位 Android 手机；x86_64 设备和模拟器用的 x64 包在发布说明末尾的「其他版本下载」里。仓库没有 32 位 ARM 构建。

1. 从 GitHub Releases 或官网下载页下载对应架构的 APK，并按系统提示允许该安装来源。
2. 首次启动时，选择在本机安装运行环境，或连接远程主机。
3. 为所选主机配置模型和所需凭据，再开始对话；部分远程渠道需要在主机侧配置。

仅连接远程主机时，不必在手机上安装本机运行环境。手机操控只对正常模式下的本机引擎开放，需要按界面说明开启无障碍等权限；不打扰模式另外要求 Android 14 及以上，以及 Shizuku 或自连 ADB。首次使用可按使用指南逐项配置。

本地引擎默认使用 PRoot 兼容启动。开发者选项中的直接启动默认关闭，开启后的兼容性和回退方式见常见问题。当前 Android 构建以 APK 侧载为目标，不是 Google Play 发布配置。

数据与权限

模型请求会发送给你配置的提供方。开启手机操控后，任务需要的屏幕文字可能发送给模型，支持看图的模型也可能收到截图；请先阅读 App 的权限说明。

“发送匿名使用统计”默认开启，可在首次引导或“设置 → 隐私与分享”关闭。采集范围和关闭后的处理见常见问题。分享内容前，请检查预览；收到链接或文件的人可以保存其中的内容。

常见问题

和 DeepSeek 官方是什么关系？

没有关系。DSH Go 是社区开发的非官方客户端，基于开源的 DeepSeek Harness 构建。手机上运行的是 DSH 本身；模型请求发给你配置的模型提供方，需要联网，按你在提供方的账户计费。

安全吗？

本机网页版只接受 App 自己的访问。分享链接端到端加密，密钥只在链接里，服务器看不到内容。手机操控遇到付款、密码、验证码和系统设置，一律交还给你。

切到后台会被杀吗？

部分系统的省电策略会拦住后台。DSH Go 发现后会提醒你，并直达对应的放行设置，vivo、小米、华为、荣耀、OPPO 都有。

对手机有什么要求？

Android 8 及以上。手机直接下载 Release 页面上的安装包即可，模拟器用的 x86_64 版在发布说明末尾的「其他版本下载」里。在手机上运行 DSH 要先准备内置的运行环境，请预留约 1 GB 空间；只连电脑或服务器上的 DSH 可以不装。

开源吗？

开源，代码就在这个仓库，以 AGPL-3.0 发布，sdk/ 和 examples/ 为 MIT。DSH Go 的名称和标识，以及 Deepy、鲸娘两位吉祥物，不在开源授权范围内，见 ASSETS.md。

从源码构建

以下流程面向 Linux x86_64。当前工具链脚本默认安装 JDK 17、Flutter 3.47.7 和 Android SDK/NDK；App 要求 Dart ^3.13.5。准备 Bash、Git、curl、tar、unzip、xz、Python 3、zstd（Python 未提供 compression.zstd 时用于解包 zstd 压缩的 deb）、file 和常见 GNU 命令；重新解析 Ubuntu 软件包锁时还需要 gpgv。

先取得完整源码和项目资源。app/pubspec.yaml 声明的字体、图片等都是构建输入，运行时包由下面的脚本生成。

git clone https://github.com/ccch1mneyyy/dsh-go.git
cd dsh-go

bash tooling/setup-toolchain.sh
source tooling/env.sh
flutter --version
java -version

bash runtime/build-runtime.sh arm64-v8a
DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh -f arm64 --keep-daemon

工具链脚本会下载 SDK/NDK 与模拟器镜像，并执行 Android SDK 许可接受步骤。默认安装到 ~/dev；可通过 DEV_ROOT 指定独立目录。脚本会复用已有安装，构建前请核对版本。

产物为 app/build/app/outputs/flutter-apk/app-arm64-release.apk。运行时构建使用仓库固定的版本与校验信息，并需要联网下载依赖。示例中的 DSH_BETA_TOKEN_FILE= 不嵌入维护者的内测通道令牌；--keep-daemon 保留 Gradle daemon，适合同时开发其他 Android 项目的环境。

构建 x86_64 包时，先生成对应运行时：

bash runtime/build-runtime.sh x86_64
DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh -f x64 --keep-daemon

未配置 app/android/key.properties 时，本地 release 构建使用 debug 签名。它不能直接覆盖不同签名的官方安装包；请在测试设备上安装，保留已有数据，不要为解决签名冲突直接卸载正在使用的 App。发布签名与密钥文件不要提交到仓库。

只查看 APK 构建命令，可运行：

DSH_BETA_TOKEN_FILE= bash tooling/build-apk.sh --dry-run -f all

目录

| 路径 | 内容 |
| app/ | Flutter 界面与 Android Kotlin 平台实现 |
| packages/dsh_client/ | DSH Web API 的 Dart 客户端 |
| packages/dsh_remote/ | DSH Remote 的 Dart 客户端 |
| runtime/ | Linux 运行时打包、引擎补丁与 App 桥接 |
| sdk/plugin-kit/ | 原生插件作者工具包；在仓库中使用，未发布到 npm |
| examples/plugins/ | 插件示例 |
| docs/guide/、docs/plugins/ | 用户指南与插件开发文档 |
| docs/assets/ | 本页用到的展示图、桌宠动图和社群二维码 |
| tooling/ | 工具链、APK 构建与诊断脚本 |
| services/、site/、infra/ | 配套分享服务、网站和部署材料 |

参与贡献

问题反馈和改进建议可提交到 Issues。代码、文档和翻译贡献请先看 CONTRIBUTING.md。插件作者可以从插件教程和 SDK开始。

安全问题请按 SECURITY.md 报告，避免在公开 Issue 中提交漏洞细节或凭据。

社区

- 论坛：forum.dshtui.com
- QQ 群：1132118290（点此加群）
- 微信群：扫下方二维码，过期请加 QQ 群

QQ 群号 1132118290，电脑上可直接点此加群。微信群二维码每周更新，过期请加 QQ 群。

许可证与致谢

本项目采用 AGPL-3.0；sdk/ 和 examples/ 保持 MIT。第三方代码和素材以各自声明为准。

- DeepSeek Harness：DSH Go 运行和连接的就是它。
- DSH-TUI：吉祥物 Deepy 小鲸鱼和鲸娘来自这里。

Phase 相关代码经作者许可使用。DeepSeek Harness、PiPilot、DS Bot、DSH Remote 及其他第三方组件、素材保留各自的许可证和署名。具体来源和条款见 THIRD_PARTY_NOTICES.md。

DSH Go 的名称、标识、Deepy 小鲸鱼和鲸娘等形象不在 AGPL 授权范围内，使用条款见 ASSETS.md。

远程连接参考了 ds-harness-remote 的项目和服务器，感谢作者李国宝。

DSH Go 是社区开发的非官方客户端，与 DeepSeek 没有关联，也不代表 DeepSeek。DeepSeek 名称与标识归其所有者所有。