把 DeepSeek Harness 装进手机：开源客户端 dsh-Go 核心玩法与 API 接入指南

核心摘要（TL;DR）
dsh-Go（GitHub 仓库：ccch1mneyyy/dsh-Go）是基于开源智能体框架 DeepSeek Harness (DSH) 开发的第三方 Android 客户端。截至 2026 年 11 月 12 日，该项目已斩获约 1.97 万 GitHub Star，最新发行版为 v1.0.15。它支持在手机端通过内置 Linux 容器直接运行 DSH 引擎（本机模式），也支持通过 SSH 或 DSHarness Remote 远程操控电脑与服务器上的 DSH（远程模式）。需要注意，dsh-Go 仅负责终端交互与运行环境调度，大模型推理仍依赖云端 API。上手的核心流程为：明确运行模式 ➔ 安装对应架构 APK ➔ 配置官方或托管中转 API 渠道 ➔ 执行微小型工具调用任务验证连通性。

过去使用 DeepSeek Harness 驱动智能体（Agent）干活，标准动作往往是坐在电脑前打开终端、拉起本地 Web 界面，再下达指令与审批权限。dsh-Go 的出现将这套交互入口迁移到了移动端：开发者不仅能在手机上随时续接对话、审批高权限工具调用，还能把手机当成远端服务器智能体的随身控制台。

相比在手机上多装一个普通 AI 聊天软件，“随时随地接管任务流”显然更具生产力价值。但在下载安装前，首先需要厘清项目边界与底层运行逻辑。

一、 逼近 2 万 Star：先认准开源仓库与项目归属

在搜索和下载时，务必区分框架本体与不同语言生态的同名项目：

• 项目性质：dsh-Go 是由开源社区维护的非官方 Android 客户端，底层依托于 DeepSeek Harness 智能体框架。项目 README 已明确声明，该客户端为社区独立开发，与 DeepSeek 官方无直接关联。
• 热度与版本演进：截至 2026 年 11 月 12 日，GitHub 官方接口数据显示 ccch1mneyyy/dsh-Go 已获得 19,742 Star（反映开源社区关注度，非实际活跃装机量）。该项目于 10 月 30 日发布首个公开版本 v1.0.0，并在 11 月 10 日迭代至 v1.0.15。
• 同名项目防混淆：GitHub 上另一个高频出现的 JopenChen/dsh-go 是面向 Go 后端开发的进程内 Agent 实现库。若目标是寻找移动端应用，请认准 ccch1mneyyy/dsh-Go 的发行页面与文档。

二、 本机模式 vs 远程模式：核心差异在“引擎位置”

dsh-Go 提供了两种截然不同的工作模式，本质区别在于 DSH 引擎、代码工作区及插件运行在哪台设备上：

两个极易踩坑的关键细节：

1. 本机运行 ≠ 本地跑大模型：无论是本机模式还是远程模式，都不会将庞大的大模型权重下载到手机本地。所有推理请求依然通过网络发送至你所配置的 API 服务商，并按对应账户规则计费。
2. 配置随主机隔离：模型渠道、工作区路径和已安装插件均绑定在当前连接的 DSH 引擎实例上。在 App 内切换本机与不同远程主机后，务必重新核对当前激活的模型与工作目录，切勿将其视为全局通用配置。

三、 安装部署与主机连接流程

根据 v1.0.15 版本文档核验，dsh-Go 目前仅支持 Android 8.0（API 26）及以上系统，iOS 与鸿蒙（HarmonyOS）版本尚处于规划阶段，暂无可用安装包。

1. 获取安装包：前往项目 GitHub Releases 页面，下载适用于主流 64 位安卓设备的 dsh-go-1.0.15-arm64.apk（仓库未提供 32 位 ARM 构建版本）。
2. 本机模式初始化：首次打开 App 若选择“本机运行”，只需按界面引导自动拉取并解压内置 Linux 运行环境，等待 DSH 引擎初始化就绪即可。只用远程模式的用户可跳过此步以节省手机存储空间。
3. SSH 远程连接：确保电脑或服务器已安装 DSH 且开启 SSH 服务。在 App 内依次进入 “设置 › 远程主机”，填入主机 IP、端口、用户名及密钥/密码认证信息（默认启动命令保持 dsh web）。首次连接需核对主机指纹，保存后选中即可接管。
4. DSHarness Remote 连接：先在电脑端安装远程插件并完成账号登录，随后在手机端选用相同认证方式登录同一账号，即可在列表内看到在线主机。至于扫码配对功能，目前高度依赖服务端版本支持，需以实际界面提示为准。

四、 核心环节：DeepSeek Harness 大模型 API 接入指南

由于 DSH 引擎本身不包含模型算力，连接引擎后的第一步就是配置高可用的大模型 API 渠道。在 App 中连上目标主机后，依次进入 “设置 › 模型 › 添加渠道”。

在实际工程应用中，开发者通常根据自身网络环境与任务复杂度，在以下两种主流接入方案中选择：

方案 A：官方直连 / 订阅 API（适合单一模型场景）

直接前往模型厂商官方开放平台（如 DeepSeek 官方平台等）注册并获取凭据。

• 特点：链路直接，适合只需要固定调用单一厂商模型的用户。
• 注意事项：配置时需严格区分厂商的“按量计费 Key”与“包月/企业订阅专属 Key”，两者支持调用的模型范围与并发限制往往不同，不可混用；若接入部分海外官方原生接口，还需确保引擎所在主机（手机容器或远程服务器）具备稳定的跨境网络环境。

方案 B：国内托管中转 API（以 4SAPI 为例，适合多模型调度与稳定直连）

在 DeepSeek Harness 这类多步推理与高频工具调用的 Agent 场景中，不少开发者会选择接入 4SAPI 等国内托管中转服务来替代单一官方渠道。其核心工程考量主要集中在三点：

• 国内直连降低超时率：省去在手机内置 Ubuntu 环境或远程开发机上折腾网络代理的步骤，降低因跨境网络抖动导致 Agent 任务中途断连的概率。
• 统一 OpenAI 协议聚合多模型：通过单一的接口地址与 API Key，即可在 DSH 内部无缝切换 DeepSeek、Claude、GPT 等不同特性的前沿模型（例如用高推理模型做任务规划、高性价比模型做文件整理），无需跨平台重复充值与维护多套密钥。
• 按量弹性计费：按实际 Token 消耗结算，避免多平台绑定订阅套餐造成的额度浪费。

渠道字段标准填写步骤

无论采用官方直连还是 4SAPI 等托管中转站，dsh-Go 均推荐使用标准的 OpenAI 兼容模式进行挂载，具体填写规范如下：

1. 兼容协议：下拉选择 OpenAI。
2. Base URL（接口地址）：填写服务商文档给出的 API 根路径（通常以 /v1 结尾，如官方地址或 4SAPI 提供的标准接入点）。**注意：切勿在末尾手动拼接 /chat/completions**，否则引擎发包时会出现路径重复导致 404 报错。
3. API Key：粘贴在官方后台或 4SAPI 控制台生成的有效令牌，确保该令牌已开通目标模型的调用权限且账户余额充足。
4. 获取与添加模型：点击 “获取模型” 自动拉取可用列表并勾选；若中转站支持的模型较多未全部展示，可对照服务商控制台的真实模型 ID（注意区分真实调用 ID 与网页展示名称，如填写精确的版本标识）进行手动添加。
5. 激活与真实任务验证：保存渠道后，返回聊天主界面顶部的模型选择器，切换至刚添加的模型。

避坑提示：设置页面中的“测试连接”按钮仅用于验证 /v1/models 模型列表接口是否连通。测试通过后，务必在对话窗口发起一次包含工具调用（Function Calling）的实际小任务，确认流式响应与工具返回均正常，才算真正完成配置。

五、 首轮任务实测与当前版本边界

完成模型挂载后，建议通过一个边界清晰的小型任务，跑通“下达指令 ➔ 查看执行计划 ➔ 审批工具权限 ➔ 核验结果”的完整闭环：

• 远程模式验证（代码库排查）：连上电脑端已有项目后，先不要下达大面积重构指令。可以让它“定位当前某个失败的单元测试”或“解释特定模块的调用逻辑”，要求 Agent 先列出代码证据与修改计划，经你在手机端审批确认后，再放行文件写入与测试运行。
• 本机模式验证（文档自动化）：在手机端新建一个独立的测试文件夹，放入几篇 Markdown 笔记，随后发送以下测试指令验证文件读写工具：

只读取当前练习目录里的 Markdown 文件，提取每个文件的标题和未完成的待办事项，输出一份汇总摘要。执行前先说明你将读取哪些文件；遇到信息缺失处请标记为“待确认”。

理性看待 v1.0.15 的功能边界

dsh-Go 的可用特性高度取决于当前所选的连接协议，切勿将项目文档提及的所有功能视为全模式通用：

• DSHarness Remote 模式的限制：在当前版本中，该模式仅支持发送图片附件，不支持在 App 内直接打开 Web 端界面，插件管理仅限基础开关，且暂不支持 DS Bot 接入与对话日志导出（本机模式与 SSH 模式则不受此特定限制）。
• 部分新特性尚待真机广泛验证：维护者在 v1.0.15 发行说明中坦诚指出，“保留既有环境的更新流程”以及“扫码配对”目前仅通过了自动化测试与编译检查，尚未完成全面的真机覆盖验证。

总体而言，dsh-Go 的核心价值在于打破了桌面终端的物理束缚，让 DeepSeek Harness 的智能体工作流得以延伸至移动场景。在实际体验时，建议从低风险的小任务切入，配合稳定的 API 渠道与合理的权限审批习惯，逐步将其融入日常开发与文档处理流程中。