DSH-Android 接入第三方模型教程:OpenAI、Kimi、智谱GLM、通义千问一键切换
DSH-Android 接入第三方模型教程:OpenAI、Kimi、智谱GLM、通义千问一键切换
DSH-Android 是一个免 ROOT、免 Termux 的安卓 App,把 DeepSeek Harness(dsh)引擎直接内嵌进手机进程,让手机读屏操作 App、改系统设置、跑定时/条件自动化。在 DSH-Android 中接入第三方模型只需三步:在「设置 → 模型服务」里选服务商、填 API Key、获取模型列表,即可在模型选择器里一键切换 OpenAI、Kimi、智谱 GLM、通义千问等任意 OpenAI 兼容接口。
一、DSH-Android 模型接入功能速览 🧭
DSH-Android 的「模型服务」模块围绕 OpenAI 兼容的 Chat Completions 接口设计,核心能力包括:
- ✅ 任意 OpenAI 兼容接口:官方预设 + 「自定义(OpenAI 兼容)」,填地址和 Key 即可
- 📦 内置 13 个预设:OpenAI、Anthropic Claude、Google Gemini、xAI Grok、OpenRouter、Kimi、智谱 GLM、通义千问、火山方舟/豆包、MiniMax、硅基流动、阶跃星辰,以及 Ollama、LM Studio 本地方案
- 🔍 自动拉取模型列表:调用服务商的
/models端点,并顺带读取上下文窗口与最大输出 - 🔐 密钥本机加密:API Key 用 Android Keystore(AES-GCM)加密保存在本机,只在调用模型时交给引擎
- 🧪 真实连接测试:「测试并保存」会发一条带工具调用的真实对话请求,确认模型能干活再设为默认
- 😴 引擎按需加载:没有配置服务商时,内置的模型适配层休眠,不注册任何路由
预设地址与模型解析逻辑集中在 Providers.kt,架构细节见 docs/ARCHITECTURE.md。
二、添加第三方服务商四步走:以 Kimi 为例
- 打开 设置 → 模型服务,在「第三方服务商」区域点 添加服务商
- 在预设列表中选择 Kimi (Moonshot),接口地址会自动填好
- 粘贴你的 API Key(可点「获取 API Key」跳转到申请页)
- 点 获取模型列表,勾选想要的模型,最后点 测试并保存
服务商的增删改都在 ProvidersUi.kt 中实现,「添加服务商」按钮就位于该页面的 ProvidersCard。
三、OpenAI、Kimi、智谱GLM、通义千问接入要点 ⚡
常用服务商的关键参数(预设已内置,选择后自动填充,一般无需手改):
| 服务商 | 接口地址(Base URL) | 默认模型示例 |
|---|---|---|
| OpenAI | https://api.openai.com/v1 |
gpt-5 |
| Kimi (Moonshot) | https://api.moonshot.cn/v1 |
kimi-k3 |
| 智谱 GLM | https://open.bigmodel.cn/api/paas/v4 |
glm-5.3 |
| 通义千问 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
qwen3.8-max |
几个容易踩坑的点:
- Kimi 和智谱不提供公开的
/models接口,拉不到列表时请在编辑页底部的「手动输入模型 ID」里填上模型名 - 火山方舟/豆包的模型需要先在控制台「开通」,否则测试会提示“未开通”
- 所有预设只取各家的 OpenAI 兼容端点,第三方模型统一走 HTTPS
四、获取模型列表:自动填充 + 手动筛选 📋
点「获取模型列表」后,App 会请求 {接口地址}/models:
- 返回的每个模型都会尝试解析上下文窗口与最大输出(兼容 OpenRouter、Moonshot、Groq、vLLM、Mistral 等多种字段命名,见 parseModels)
- 如果填的是裸域名、接口返回 404,App 会自动补上
/v1再试一次,成功后直接更新接口地址 - 上一轮勾选、但接口这次没返回的模型会保留在列表顶部并标记「接口未返回」,由你决定是否删除
「高级设置」里可以为整个服务商设定上下文窗口与最大输出,留空则按「手动值 → 接口返回值 → 默认值(131,072 / 16,384)」的优先级自动处理(ThirdParty.resolve);单个模型可点 ✎ 单独覆盖。
五、测试并保存:发一条真实消息确认能干活 🧪
DSH-Android 对「能不能用」的标准比大多数工具更严:光连上不够,还要会调用工具——因为它靠工具调用去操作你的手机。
ModelVerify.kt 的测试逻辑会发一条真实聊天请求(stream + 一个无参工具,要求模型调用它):
- 测试通过:模型正常对话且成功调用工具 → 保存服务商并设为默认模型
- Key 无效(HTTP 401)、网络不通:整个服务商不保存,先去解决账号/网络问题
- 模型级失败(未开通、模型不存在、不支持工具、有回复但没调用工具、限流/余额不足):换一个模型再试即可
保存失败时页面会给出具体原因;已保存但默认模型未通过测试的,列表里会出现「重新测试」入口(prov_main_untested 逻辑)。
六、日常一键切换模型:输入框上的模型芯片 🔄
配置完成后,切换模型不用回设置页:
- 在对话首页的输入框右下角点击模型芯片(显示当前模型名)
- 弹出列表中会分组列出:DeepSeek 模型 + 每个已启用服务商下的模型
- 点击即切换;未测试过的模型会先自动跑一次连接测试,通过后才切换
- 任务运行中切换时,会在任务结束后生效
「默认模型」同样可以在 设置 → 模型服务 中设置,DeepSeek 与所有服务商模型排在同一列表里(DefaultModelCard)。模型芯片的交互实现在 Composer.kt。
七、进阶:接上电脑里的 Ollama / LM Studio 💻
DSH-Android 内置了 Ollama 和 LM Studio 两个本地预设(Key 可选、地址可编辑):
- Ollama:在电脑上设置环境变量
OLLAMA_HOST=0.0.0.0并重启,再把地址里的localhost换成电脑的局域网 IP(如http://192.168.1.5:11434/v1) - LM Studio:在本地服务器设置中打开「在局域网中提供服务」(Serve on Local Network),同样把
localhost换成局域网 IP
前提:手机和电脑连在同一个 Wi-Fi。App 内已内置这两条提示(prov_hint_ollama / prov_hint_lmstudio)。局域网内允许 HTTP 明文,但请勿在公共网络使用 http 地址。
八、常见问题速查 ❓
| 现象 | 可能原因 | 怎么处理 |
|---|---|---|
HTTP 401 / “key 无效” |
Key 填错、过期或无权限 | 重新复制完整 Key,确认账号有效 |
| “模型不存在” | 模型 ID 拼错 | 对照服务商文档核对 ID,手动输入后再测 |
| “未开通” | 火山方舟等需在控制台开通模型 | 去控制台开通后重试 |
| “余额不足 / 限流” | 账户额度问题 | 充值或稍后再试 |
| 模型回复了但没调用工具 | 该模型不支持工具调用 | 换一个支持 function calling 的模型 |
| 连接失败、一直转圈 | 网络或代理问题 | 使用 App 的网络诊断(NetDiagnosis) |
错误分类规则(key / 未开通 / 无权限 / 限流等中英文关键词识别)见 VerifyErrors。
九、已知限制 ⚠️
- 第三方模型只支持 OpenAI 兼容的 Chat Completions 接口(HTTPS)
- 上下文统一按 128K 计(可手动覆盖),不提供推理等级选择
- 联网搜索由 DeepSeek 提供:使用第三方模型时需要另外配置 DeepSeek API Key,网页读取不受影响
- 工具调用的效果取决于所选模型——选型时优先挑支持 function calling 的
十、总结
DSH-Android 把「接入第三方模型」做成了填地址、填 Key、勾模型的三件事:预设覆盖了 OpenAI、Kimi、智谱 GLM、通义千问等主流服务商,自动拉模型列表、真实消息连接测试、本地 Ollama/LM Studio 也都开箱可用。配置一次,之后在输入框的模型芯片里一键切换即可,让你的手机 Agent 用最合适的模型去干活。