dsh-Go README

项目的 README,来自 github.com/ccch1mneyyy/dsh-Go。合并为一个 markdown 文件:README.md。

简体中文 · English

DSH Go:把 DeepSeek Harness 装进口袋

DeepSeek Harness 的手机应用:Android 版已发布;iOS 版仍在开发和真机测试,需在 Mac 上自行签名编译(iOS 工程 · 架构)。

Android 8+ 许可证 AGPL-3.0 论坛 QQ 群 1132118290

DSH Go:Trendshift 全语言日榜第一(2026-10-30)
Trendshift 全语言日榜 #1 · 2026-10-30


Deepy 和鲸娘,陪你干活

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

Deepy 敲代码 Deepy 完成 Deepy 等你确认 Deepy 睡觉

鲸娘 敲代码 鲸娘 完成 鲸娘 等你确认 鲸娘 睡觉


下载 DSH Go

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

从 GitHub Releases 下载 从官网下载页下载

感谢大家对 DSH Go 的支持和喜爱!当前下载页提供 Android APK;iOS 版还在开发和真机测试,没有公开安装包,鸿蒙版也在继续推进。

GitHub Star 数

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


本机运行,也能遥控电脑

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

本机对话、切换主机、电脑上的对话


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

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

生成中排队一条消息;完成后过程折叠


原生界面,也有网页版

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

同一段对话的原生界面与网页版


分享卡、对话回放和链接

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

分享卡、对话回放、我的分享链接


横屏与平板

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

平板与横屏手机


主题配色与桌面图标

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

主题设置与两种主题色


中文,也说 English

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

同一段对话的中文与英文界面


手机操控

看屏幕、帮你点,三档确认随你选。敏感操作默认交还给你;放宽应用规则或解除限制前,请先了解风险。

手机操控与确认方式


可以做什么

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

功能随主机和连接方式不同。DSHarness 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 的权限说明。

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

风险提示与免责声明

DSH Go 是社区开发的非官方项目,与 DeepSeek 无关联,也不代表 DeepSeek。使用前请了解:

常见问题

和 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。再发布和 fork 时的署名要求见授权范围与再发布。

从源码构建

以下流程面向 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 实现与开发中的 iOS Swift/WidgetKit 实现
packages/dsh_client/ DSH Web API 的 Dart 客户端
packages/dsh_remote/ DSH Remote 的 Dart 客户端
runtime/ Android Linux 运行时、iOS 运行时特化、引擎补丁与 App 桥接
sdk/plugin-kit/ 原生插件作者工具包;在仓库中使用,未发布到 npm
examples/plugins/ 插件示例
docs/guide/、docs/plugins/、docs/pets/、docs/live2d/ 用户指南、插件开发、宠物包与 Live2D 伙伴制作
docs/assets/ 本页用到的展示图、桌宠动图和社群二维码
tooling/ 工具链、Android APK/iOS 开发构建与诊断脚本
services/、site/、infra/ 配套分享服务、网站和部署材料

参与贡献

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

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

社区

QQ 群 DSH-Go!!,群号 1132118290  微信群 DSHGo 2群

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

友情链接

授权范围与再发布

代码以 AGPL-3.0 开源,欢迎 fork 学习、自用和二次开发。请尊重原作者和项目来源:

许可说明:AGPL-3.0 允许符合其条款的修改、再发布和商业使用;上述提前联系及署名位置是作者的协作请求,不是对代码许可证追加的限制。品牌与素材须遵守各自的授权条件;本说明不改变 sdk/、examples/ 及第三方内容的许可。

许可证与致谢

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

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

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

远程连接协议与 ds-harness-remote(MIT)兼容;来源与条款见 THIRD_PARTY_NOTICES.md。


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

dsh-Go (ccch1mneyyy/dsh-Go)

正在搜索数据库…

26K ·GitHub
这是什么?DSH Go 是 DeepSeek Harness(DSH)的非官方安卓客户端,DSH 是一款编程智能体。它可以通过内置的 Linux 环境在你的手机上本地运行 DSH 引擎(无需 root 权限),也可以远程控制运行在电脑或服务器上的 DSH。
它是在我的手机上运行智能体,还是只远程控制我的电脑?两者都支持:DSH Go 内置了应用内的 Linux 环境,可在手机上本地运行 DSH;它也可以通过 SSH 或 DSH Remote 连接,控制已有电脑或服务器上的 DSH。
使用它需要有模型 API 账号吗?需要。你需要自行配置模型服务商,请求费用会计入你在该服务商处的账户;使用时必须联网。运行本地引擎还需要约 1GB 的可用空间用于 Linux 运行环境;如果只连接远程主机,则可以不需要这部分空间。
安装或平台方面有哪些限制需要了解吗?需要 Android 8.0+ 系统,且仅提供 arm64/x86_64 版本(不支持 32 位 ARM);它是侧载安装的 APK,而非 Google Play 正式版本。若要覆盖安装签名不同的测试版,必须先卸载,这会清除对话、Linux 运行环境和设置。
除了聊天,DSH Go 实际还能做什么?它支持切换模型、图片和语音输入、工具审批、带原生工具卡片的插件界面、手机控制(在授权后读取屏幕并点击),以及通过端到端加密回放链接分享对话。
Deepy 和鲸鱼少女吉祥物是谁?它们是动画伴侣,最初来自 DSH-TUI 项目,会在智能体工作时做出反应;开启“在应用外显示”后,可以悬浮在主屏幕上。
手机控制在支付等操作上安全吗?安全。支付、密码、验证码和系统设置等操作始终交还给你处理;智能体绝不会自动完成这些步骤。
它和官方 DeepSeek 是什么关系?没有关系。DSH Go 是基于开源的 DeepSeek Harness 开发的非官方社区客户端,与 DeepSeek 不存在任何隶属关系;DeepSeek 拥有其自身的名称和标识。
大小
666.9 MB
星标
26K
时长
24天
提交 · 90 天