速览
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、DSH 与同名项目

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 侧载

dsh-Go v1.1.0 Releases 页

二、两种运行模式决定渠道配在哪

配渠道前要先明确引擎在哪台主机,因为渠道绑定主机,不是全局配置。

对比 本机模式 远程模式
引擎位置 手机内置 Ubuntu + Node.js 电脑/服务器上的 DSH
前置 约 1 GB,免 Root、免 Termux 远端装 DSH,开 SSH 或装远程插件
适合 轻量文本、小脚本 接管电脑长任务、代码排查
  • SSH:远端 npm i -g @deepseek-ai/dsh 并开 SSH,"设置 › 远程主机"填主机、用户名、端口(默认 22),托管启动命令 dsh web,首连核对指纹。
  • DSH Remote:免配网络、端到端加密,远端装远程插件登录、手机同账号登录即可,首连核对指纹。它是开源项目 ds-harness-remote(github.com/liguobao/ds-harness-remote)。经 DSH Remote 连接时只能发图片、打不开网页版、插件只能开关。

记住一点:在本机配好的渠道,切到远程主机后看不到,要在那台主机上重新配。

三、核心:配置 OpenAI 兼容 API 渠道

DSH 不含算力,连上主机第一步就是配模型。先把四样分清:兼容协议、Base URL、API Key、模型 ID。Provider 名字只是标签,请求怎么发由这四项决定。

方式一:官方直连 DeepSeek

DeepSeek 开放平台(platform.deepseek.com)建 Key。dsh-Go"设置 › 模型"渠道分官方、订阅、自定义三组,官方组的 DeepSeek 填 Key 即可,不用 Base URL。模型列表跟随官方发布列表(约每十分钟后台刷新),官方文档示例的模型名有 deepseek-flash、deepseek-v4-pro,以账户实际列表为准。

方式二:自定义渠道,以 Crazyrouter 为例

想用一个接口和密钥切换多家模型时走这条。先准备凭据:

  • 打开 Crazyrouter 注册页,已有账号登录;
  • 进入令牌管理建密钥、单独命名;完整密钥只显示一次,复制后别贴进截图或聊天;
  • 核对有效期、额度、模型限制;
  • 模型广场复制模型 ID。示例用 deepseek-v4.1-flash、qwen3.8-flash,是该平台命名,与 DeepSeek 官方模型名不同,不能混用。

Crazyrouter 控制台 API Keys 页,密钥已打码

在 dsh-Go 里填渠道(设置 › 模型 › 添加渠道)

  1. 兼容协议选 OpenAI、Anthropic 或 Responses。接 OpenAI 兼容接口选 OpenAI——它是接口格式,不代表只能用 OpenAI 的模型。
  2. 填 Base URL 和 API Key。Key 必填,名称可留空。Base URL 写到 /v1 为止,官方文档示例就是 https://gateway.example/v1,别再拼 /chat/completions,否则路径重复会 404;本例 https://api.crazyrouter.com/v1。
  3. 点获取模型勾选;没列出就手动添加填模型 ID,原样复制,大小写、连字符、版本号都别改。
  4. 至少加一个模型,保存。

dsh-Go 添加自定义渠道 4 步

DSH 官方配置模型页:自定义模型 API 表单

配置时几个工程细节:

  • 渠道绑定当前主机,切主机不带走。
  • Provider ID 建后不可改(请求、会话、默认模型、凭据引用都用它),改名只能新建删旧;其余字段可编辑。
  • 一个提供商一种协议,网关同时提供两种协议要建两个渠道。
  • 单模型可调参数:上下文默认 256K(32K–1M 可选),最大输出默认 32K,输入类型文本或"文本和图片",思考档位可选。
  • v1.0.16 起支持自定义请求头,也用于模型发现,个别网关要额外头部时用得上。
  • 重置运行环境会删自定义渠道,只有 App 里的 DeepSeek Key 自动补回,重置前先备份。

三层验证,别拿一个按钮当完成

  1. 读模型列表:"获取模型"或"测试连接"。指南写明测试连接是"用已保存的 Key 读取模型列表,不消耗 token",只证明地址和 Key 对得上。

dsh-Go 测试连接说明

  1. 一句短回复:确认基础请求通。
  2. 一个带工具的小任务:让它先列要读的文件、再提取待办、最后才写文件——这步才验证流式、工具调用和审批链路。

出问题时,先在 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}'

四、8 个报错速查

现象与处理来自官方"配置模型"页排错与 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 配

DSH 官方配置模型页排错列表

其中第 5、6 条最容易卡住:DSH 的 pi-ai 对不认识的地址会按 OpenAI 的请求形状发包,很多 OpenAI 兼容网关会拒绝其中的 developer 系统角色和 max_completion_tokens 字段,而这两项在表单里没有,只能去主机 profile 的 cordis.patch.yml 改。这是官方文档明说的,不是 dsh-Go 专属 bug。至于 Crazyrouter 是否需要这两项,本文没有实测结论,遇到全量拒绝时按此排查即可。

成本:Agent 是多步循环,工具结果反复进上下文,token 消耗普遍高于普通聊天。给设备单独建密钥设额度上限,先小任务试跑再看控制台用量。

五、安装与校验

  1. Releases 或官网下载页取 arm64 APK,按提示允许安装来源。
  2. 校验哈希:dsh-go-1.1.0-arm64.apk 的 SHA-256 是 ec7d9ffbfb6cf3d5d8b0c19cd34a5933df00b9290cfe9d6dbdc05337308b3037,与 SHA256SUMS 一致,PowerShell 用 Get-FileHash 比对;版本一换哈希就变。
  3. 首次启动选本机装环境或连远程主机。
  4. "打开 App 自动启动""自动进入安全模式"默认开。
  5. 装过不同签名的测试包不能覆盖,要先卸载(会清空对话、环境、设置)。

六、功能与插件

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"标记为准。

七、安全须知

  1. 只从官方渠道下载并校验哈希,侧载无商店把关。
  2. 密钥单设备单建、设额度、不外泄,导出诊断包前自己再查一遍 Key;疑似泄露先吊销再查用量。
  3. 模型请求一定离开手机:本机运行不等于离线,提示词和读到的文件都发给服务方,聚合渠道还经过聚合方。
  4. 手机操控有数据面:屏幕文字、截图可能发给模型;密码、验证码、付款默认交还给你,别在存支付信息的设备上解除限制;Android Shell 每条命令确认。
  5. 最小权限防注入:AI 可能被文件/网页里的恶意指令误导;远程用受限账号不用 root;高风险操作先审批。
  6. 装插件前看风险标记("不代表安全保证"),构建脚本会在主机上跑,看清软件包再允许。
  7. 匿名统计默认开(版本、机型、计数类,1.0.17 起含 token 总数,不含账号/Key/对话/主机地址/所用模型),可在"隐私与分享"关;ML Kit、自动故障分析另有数据说明。
  8. 连接与分享:SSH、DSH Remote 首连核对指纹;凭据只存手机安全存储;分享链接端到端加密但拿到链接即可读;重置/卸载删本机数据不可撤销。

dsh-Go README 风险提示与免责声明

dsh-Go 常见问题 App 会发送哪些数据

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 和页面内容可能随时更新,以当天官方页面为准。

  • dsh-Go 仓库与 README、Releases、SECURITY.md:github.com/ccch1mneyyy/dsh-go
  • dsh-Go 使用指南(同仓库 docs/guide/zh/):模型与渠道、本机引擎与远程主机、手机操控、插件、常见问题
  • DeepSeek Harness 官方仓库 github.com/deepseek-ai/deepseek-harness,官方"配置模型"文档 deepseek-harness.github.io/deepseek-harness/guide/providers
  • DSH Remote:github.com/liguobao/ds-harness-remote
  • awesome-dsh-plugin 插件精选列表:github.com/bruc3van/awesome-dsh-plugin
  • Crazyrouter 官网:crazyrouter.com,注册、令牌与模型广场入口于 2026 年 11 月核对

一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)

共有 0 則留言


一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)
🏆 本月排行榜
🥇
boluoji
📝40   💬3   ❤️7
1,006
🥈
我愛JS
📝3   💬1   ❤️5
117
🥉
站長阿川
📝1   💬3   ❤️2
44
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次