内置提供商
GodeX 内置了四个提供商，覆盖了最流行的非 OpenAI LLM 平台。每个提供商都是一个自包含模块，声明其能力、通过钩子转换请求、并将响应映射回标准的 Chat Completions 访问器。添加新提供商遵循相同的模式——实现 ProviderSpec，编写请求修补和响应标准化的钩子，然后在 Registrar 中注册。
概览
| 特性 | DeepSeek | Zhipu | MiniMax | Xiaomi |
|---|---|---|---|---|
| Spec 名称 | deepseek | zhipu | minimax | xiaomi |
| 默认 Base URL | api.deepseek.com | open.bigmodel.cn（编程计划） | api.minimaxi.com/v1 | api.xiaomimimo.com/v1 |
| 默认模型 | deepseek-v4-pro | glm-5.2 | MiniMax-M3 | mimo-v2.5-pro |
| 推理能力 | native | boolean | boolean | boolean |
| GodeX 输入 | 文本 | 文本 | 文本、图片、视频 | 文本 |
| 最大工具数 | 128 | 128 | 128 | 128 |
| 响应格式 | text, json_object | text, json_object | text, json_object | text, json_object |
| 流式 Usage | 是 | 是 | 是 | 是 |
| 缓存 Token | 是 | 是 | 是 | 是 |
提供商架构
每个提供商遵循相同的结构模式：spec.ts 声明能力并创建 ProviderSpec，hooks.ts 实现请求修补和响应/流访问器，client.ts 创建用于发起 HTTP 调用的 ProviderEdge，protocol/ 目录包含提供商特定的 DTO 类型。
所有提供商在启动时通过 createBuiltinRegistrar 注册（src/providers/builtin.ts:61-67），它创建一个 Registrar 并注册每个 ProviderDefinition。
工具能力对比
每个提供商声明其支持的工具类型以及哪些工具类型必须被降级为更简单的形式。降级意味着 GodeX 在将不支持的工具类型发送给提供商之前，会自动将其转换为最近的兼容类型。
| 工具类型 | DeepSeek | Zhipu | MiniMax | Xiaomi |
|---|---|---|---|---|
function | 支持 | 支持 | 支持 | 支持 |
local_shell | 降级为 function | 降级为 function | 降级为 function | 降级为 function |
shell | 降级为 function | 降级为 function | 降级为 function | 降级为 function |
apply_patch | 降级为 function | 降级为 function | 降级为 function | 降级为 function |
custom | 降级为 function | 降级为 function | 降级为 function | 降级为 function |
namespace | 降级为 function | 降级为 function | 降级为 function | 降级为 function |
web_search | - | 支持 | - | 支持 |
web_search_2025_08_26 | - | 降级为 web_search | - | 降级为 web_search |
web_search_preview | - | 降级为 web_search | - | 降级为 web_search |
file_search | - | 降级为 retrieval | - | - |
推理支持
每个提供商对推理（链式思考）的处理方式不同。桥接内核中的兼容性方案将传入的 reasoning_effort 映射到提供商特定的表示形式。
| 提供商 | Effort 类型 | 行为 |
|---|---|---|
| DeepSeek | native | 将 high 映射为 high，xhigh 映射为 max。在请求中添加 thinking: {type: "enabled"}。 |
| Zhipu | boolean | 检测到推理内容时添加 thinking: {type: "enabled", clear_thinking: false}。 |
| MiniMax | boolean | 将 reasoning.effort: "none" 映射为 thinking: {type: "disabled"}，其他 effort 映射为 MiniMax adaptive thinking。推理输出读取 reasoning_content。 |
| Xiaomi | boolean | Bridge 将 effort 映射为 thinking: {type: "enabled"/"disabled"}。当消息中存在历史 reasoning_content 时强制 thinking: enabled。未请求推理时默认 thinking: disabled。 |
工具选择支持
| 提供商 | 支持的工具选择值 |
|---|---|
| DeepSeek | auto、none、required、function |
| Zhipu | auto、none |
| MiniMax | auto、none、required、function |
| Xiaomi | auto |
提供商定义注册
每个提供商被包装在一个 ProviderDefinition 中，将提供商名称与工厂函数配对。这些定义被收集在 BUILTIN_PROVIDER_DEFINITIONS 中并在启动时注册（src/providers/builtin.ts:27-45）。
ProviderDefinition 接口定义在 src/providers/definition.ts:6-11，要求提供 name 和一个 create 工厂函数，该函数从 ProviderRuntimeConfig 生成 ProviderEdge。
提供商规格
DeepSeek
DeepSeek 规格目标为 https://api.deepseek.com 上的标准 Chat Completions API（src/providers/deepseek/spec.ts:24-54）。
| 属性 | 值 |
|---|---|
| 名称 | deepseek |
| 协议 | chat_completions |
| 默认 Base URL | https://api.deepseek.com |
| 默认模型 | deepseek-v4-pro |
| 认证 | Bearer |
| 推理 | 原生 Effort 级别 |
Zhipu
Zhipu 规格默认使用编程计划端点 https://open.bigmodel.cn/api/coding/paas/v4（src/providers/zhipu/spec.ts:24-57）。
| 属性 | 值 |
|---|---|
| 名称 | zhipu |
| 协议 | chat_completions |
| 默认 Base URL | https://open.bigmodel.cn/api/coding/paas/v4 |
| 默认模型 | glm-5.2 |
| 认证 | Bearer |
| 推理 | 布尔值（thinking 启用/禁用） |
MiniMax
MiniMax 规格目标为 https://api.minimaxi.com/v1（src/providers/minimax/spec.ts:25-56）。
| 属性 | 值 |
|---|---|
| 名称 | minimax |
| 协议 | chat_completions |
| 默认 Base URL | https://api.minimaxi.com/v1 |
| 默认模型 | MiniMax-M3 |
| 认证 | Bearer |
| 推理 | 布尔值（adaptive/disabled thinking，通过 reasoning_content 返回） |
| 输入 | 文本、图片和视频内容块 |
Xiaomi
Xiaomi 规格目标为 MiMo API https://api.xiaomimimo.com/v1（src/providers/xiaomi/spec.ts）。
| 属性 | 值 |
|---|---|
| 名称 | xiaomi |
| 协议 | chat_completions |
| 默认 Base URL | https://api.xiaomimimo.com/v1 |
| 默认模型 | mimo-v2.5-pro |
| 认证 | Bearer |
| 推理 | 布尔值（thinking 启用/禁用） |
| 环境变量 | MIMO_API_KEY |
下一步
| 主题 | 说明 |
|---|---|
| 配置 | 如何在 godex.yaml 中配置提供商 |
| 快速开始 | 安装并发起你的第一次调用 |
| 概览 | 架构和设计概念 |
参考
- src/providers/builtin.ts:1-55 - 提供商定义和注册器
- src/providers/deepseek/spec.ts:1-57 - DeepSeek 规格定义
- src/providers/deepseek/hooks.ts:18-57 - DeepSeek 能力和钩子
- src/providers/zhipu/spec.ts:1-59 - Zhipu 规格定义
- src/providers/zhipu/hooks.ts:25-75 - Zhipu 能力和钩子
- src/providers/minimax/spec.ts:1-58 - MiniMax 规格定义
- src/providers/minimax/hooks.ts:24-62 - MiniMax 能力和钩子
- src/providers/xiaomi/spec.ts - Xiaomi 规格定义
- src/providers/xiaomi/hooks.ts - Xiaomi 能力和钩子
- src/providers/definition.ts:6-29 - ProviderDefinition 接口
- src/bridge/provider-spec/contract.ts:54-74 - ProviderSpec 契约