速览
dsh-Go 是 DeepSeek Harness(DSH)的非官方 Android 客户端,让手机成为 DSH 的入口:手机本机跑一套 Ubuntu + Node.js 引擎,或通过 SSH / DSH Remote 接管电脑、服务器上的 DSH。它只做界面和运行环境调度,推理仍走你配置的 API。本文围绕"怎么把渠道配对、怎么排错"展开,版本 v1.1.0(2026-11-15);未在 dsh-Go 内做操作测试,界面说明均标出处,核对日期 2026-11-17。
对开发者来说,这类客户端最耗时间的往往不是安装,而是对着几个相似的输入框猜:接 DeepSeek 为什么要选 OpenAI 协议?Base URL 要不要带 /chat/completions?"测试连接"通过了是不是就能用?这篇就把接入和排错讲透,安装和背景只占必要篇幅。
dsh-Go 仓库是 ccch1mneyyy/dsh-go,AGPL-3.0(sdk/、examples/ 为 MIT),README 明确是社区非官方项目。它的底座 DeepSeek Harness(dsh)是 DeepSeek 开源的智能体框架,MIT 许可、TypeScript、"技术预览",核心是"Agent = Model + Harness"、一切皆插件、与模型无关——正因为前后端能分离、运行环境不重、不扛算力,才能做成手机客户端。
搜 dshgo 会撞上同名仓库,接入前先认准:
| 项目 | 是什么 |
|---|---|
| ccch1mneyyy/dsh-go | 本文讲的 Android 客户端 |
| just-a-FA-for-name/DSHgo | 另一手机端项目,内置 Tailscale + 电脑端 dsh 插件 |
| @xiazhi88/dshgo | DSH 插件,把本机 Web 开放给局域网 |
| JopenChen/dsh-go | 纯 Go 进程内 Agent 实现,面向后端,与手机端无关 |
| 规格项 | 内容(2026-11-17 核对) |
|---|---|
| 版本 | v1.1.0,2026-11-15 |
| 平台 | Android 8.0(API 26)起;iOS 无公开安装包 |
| 安装包 | dsh-go-1.1.0-arm64.apk,221 MB;无 32 位 ARM、无 x86_64 |
| 分发 | APK 侧载 |

配渠道前要先明确引擎在哪台主机,因为渠道绑定主机,不是全局配置。
| 对比 | 本机模式 | 远程模式 |
|---|---|---|
| 引擎位置 | 手机内置 Ubuntu + Node.js | 电脑/服务器上的 DSH |
| 前置 | 约 1 GB,免 Root、免 Termux | 远端装 DSH,开 SSH 或装远程插件 |
| 适合 | 轻量文本、小脚本 | 接管电脑长任务、代码排查 |
npm i -g @deepseek-ai/dsh 并开 SSH,"设置 › 远程主机"填主机、用户名、端口(默认 22),托管启动命令 dsh web,首连核对指纹。github.com/liguobao/ds-harness-remote)。经 DSH Remote 连接时只能发图片、打不开网页版、插件只能开关。记住一点:在本机配好的渠道,切到远程主机后看不到,要在那台主机上重新配。
DSH 不含算力,连上主机第一步就是配模型。先把四样分清:兼容协议、Base URL、API Key、模型 ID。Provider 名字只是标签,请求怎么发由这四项决定。
DeepSeek 开放平台(platform.deepseek.com)建 Key。dsh-Go"设置 › 模型"渠道分官方、订阅、自定义三组,官方组的 DeepSeek 填 Key 即可,不用 Base URL。模型列表跟随官方发布列表(约每十分钟后台刷新),官方文档示例的模型名有 deepseek-flash、deepseek-v4-pro,以账户实际列表为准。
想用一个接口和密钥切换多家模型时走这条。先准备凭据:
deepseek-v4.1-flash、qwen3.8-flash,是该平台命名,与 DeepSeek 官方模型名不同,不能混用。
/v1 为止,官方文档示例就是 https://gateway.example/v1,别再拼 /chat/completions,否则路径重复会 404;本例 https://api.crazyrouter.com/v1。

配置时几个工程细节:

出问题时,先在 App 外用命令行直调一次,能把"渠道问题"和"客户端问题"分开。下面按 OpenAI 兼容接口通用写法给出,本文未在 dsh-Go 内实测此流程,首次用小额度验证;密钥放环境变量,别写进命令行(PowerShell 用 $env:CRAZYROUTER_API_KEY):
# 1) 读模型列表,对应 App 的“获取模型 / 测试连接”
curl -s https://api.crazyrouter.com/v1/models \
-H "Authorization: Bearer $CRAZYROUTER_API_KEY"
# 2) 最小对话,确认模型 ID 可调用
curl -s https://api.crazyrouter.com/v1/chat/completions \
-H "Authorization: Bearer $CRAZYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"只回复:连通"}],"max_tokens":16}'
现象与处理来自官方"配置模型"页排错与 dsh-Go 使用指南,OpenAI 兼容接口通用状态码为补充:
| # | 现象 | 先查什么 |
|---|---|---|
| 1 | 获取模型 401 | 密钥是否完整、是否属于当前 Base URL 对应的服务;模型发现会请求 GET /models |
| 2 | 提示格式不对或列表为空 | 列表格式不在探测范围内,手动填模型 ID,效果完全一样 |
| 3 | UNKNOWN_MODEL |
选已配置模型,或给自定义提供商补上缺失模型 |
| 4 | MISSING_CREDENTIAL |
经模型页存密钥,或提供被引用的环境变量 |
| 5 | 密钥地址都对却全被拒 | 网关请求形状与 OpenAI 不同:在主机 cordis.patch.yml 设 compat.supportsDeveloperRole: false 与 compat.maxTokensField: max_tokens |
| 6 | 只有推理模型失败 | 同上,系统提示以 developer 角色发出被网关拒,先设 supportsDeveloperRole: false |
| 7 | 余额/额度提示 | 回控制台看余额、令牌额度、模型权限,改显示名无用 |
| 8 | App 能聊但 headless 报 MISSING_CREDENTIAL |
dsh --profile headless 不用 App 保存的 Key,要单独在进程环境或 .env 配 |

其中第 5、6 条最容易卡住:DSH 的 pi-ai 对不认识的地址会按 OpenAI 的请求形状发包,很多 OpenAI 兼容网关会拒绝其中的 developer 系统角色和 max_completion_tokens 字段,而这两项在表单里没有,只能去主机 profile 的 cordis.patch.yml 改。这是官方文档明说的,不是 dsh-Go 专属 bug。至于 Crazyrouter 是否需要这两项,本文没有实测结论,遇到全量拒绝时按此排查即可。
成本:Agent 是多步循环,工具结果反复进上下文,token 消耗普遍高于普通聊天。给设备单独建密钥设额度上限,先小任务试跑再看控制台用量。
dsh-go-1.1.0-arm64.apk 的 SHA-256 是 ec7d9ffbfb6cf3d5d8b0c19cd34a5933df00b9290cfe9d6dbdc05337308b3037,与 SHA256SUMS 一致,PowerShell 用 Get-FileHash 比对;版本一换哈希就变。v1.1.0:聊天与工具审批(切模型、发图、语音、插话排队)、网页模式、分享回放、手机操控、语音(新增)、桌宠/酒馆/定时任务/终端/工作区。
插件市场分"官方""适配 DSH Go""全部"。社区精选列表(如 awesome-dsh-plugin,github.com/bruc3van/awesome-dsh-plugin)里常见的有:dsh-web-ui / DSH-better-sidebar(界面)、dsh-at-file(@文件)、modlens(视觉)、dsh-websearch(搜索)、dsh-layered-memory(记忆)、dsh-api-dashboard(用量)、dsh-plugin-gate(装插件前扫描脚本、权限、密钥、网络回调)。注意插件原生界面需主机带 dsh-go 桥接,本机引擎自带、远程主机一般没有,能否用以市场"适配 DSH Go"标记为准。



适合:已在用 DSH、想离开电脑也能审批接管的开发者;有常开电脑/服务器走 SSH 或 DSH Remote 的用户;愿从只读小任务起步逐步放权的新手。
不适合:存支付/银行信息的设备(别解除手机操控限制);无人值守的不可逆任务;指望本地离线跑大模型;需要 iOS 安装包的用户。
非官方且依赖预览版 DSH,版本间可能有行为差异;部分新功能只过自动测试和编译检查;DSH Remote 功能受限;后台存活不保证;代码 AGPL-3.0,名称/标识/吉祥物不在开源授权内,fork 发布要标注主仓库与原作者;本文未在 dsh-Go 内实测,界面与流程以官方文档和项目指南为准,第三方插件描述来自社区列表未逐一验证。
dsh-Go 把 DeepSeek Harness 的入口和审批搬上手机,用 DSH 的前后端分离和插件架构换移动端灵活,代价是承担预览版的版本变动和权限风险。接入的关键就四件事:协议选对、Base URL 到 /v1、模型 ID 原样复制、三层验证跑通;遇到全量拒绝先查 developer 角色和 max_tokens 字段。建议顺序:校验 APK → 远程或只读小任务起步 → 单设备建密钥设额度 → 三层验证 → 再上插件和更高权限。
资料核对日期 2026-11-17,版本、哈希、模型 ID 和页面内容可能随时更新,以当天官方页面为准。
github.com/ccch1mneyyy/dsh-godocs/guide/zh/):模型与渠道、本机引擎与远程主机、手机操控、插件、常见问题github.com/deepseek-ai/deepseek-harness,官方"配置模型"文档 deepseek-harness.github.io/deepseek-harness/guide/providersgithub.com/liguobao/ds-harness-remotegithub.com/bruc3van/awesome-dsh-plugincrazyrouter.com,注册、令牌与模型广场入口于 2026 年 11 月核对