DSH-Android 接入第三方模型教程:OpenAI、Kimi、智谱GLM、通义千问一键切换

原创2026-11-03 13:18:281,961 阅读
文章标签:移动开发AI Agent人工智能交互助手GUI 自动化工具调用MCP Clientsdsh-plugin

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 为例

  1. 打开 设置 → 模型服务,在「第三方服务商」区域点 添加服务商
  2. 在预设列表中选择 Kimi (Moonshot),接口地址会自动填好
  3. 粘贴你的 API Key(可点「获取 API Key」跳转到申请页)
  4. 点 获取模型列表,勾选想要的模型,最后点 测试并保存

服务商的增删改都在 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 逻辑)。

六、日常一键切换模型:输入框上的模型芯片 🔄

配置完成后,切换模型不用回设置页:

  1. 在对话首页的输入框右下角点击模型芯片(显示当前模型名)
  2. 弹出列表中会分组列出:DeepSeek 模型 + 每个已启用服务商下的模型
  3. 点击即切换;未测试过的模型会先自动跑一次连接测试,通过后才切换
  4. 任务运行中切换时,会在任务结束后生效

「默认模型」同样可以在 设置 → 模型服务 中设置,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 用最合适的模型去干活。

登录后查看全文
DSH-Android