
GodeX v1.2.0 升级智谱默认模型多方式安装并支持多 API 调用、多平台运行让每个模型都成为 Codex 引擎。OpenAI 兼容的 Responses API 网关能让 Codex、CLI 工具和开发者 Agent 接入任意模型。GodeX 可让使用 OpenAI Responses API 的客户端通过一个本地网关调用 DeepSeek、Xiaomi、MiniMax、智谱等只提供 Chat Completions API 的模型提供商。GodeX v1.2.0 版本更新内容本次版本将智谱Zhipu默认模型从 glm-5.1 升级为 glm-5.2并同步更新 provider 目录、init 向导、示例配置与文档。新特性智谱默认模型升级为 glm-5.2#152ZHIPU_DEFAULT_MODEL 现为 glm-5.2init 向导生成的通配别名变为 zhipu/glm-5.2。在 provider 目录TEXT_MODELS、THINKING_FORCE_MODELS、TOOL_STREAM_MODELS中新增 glm-5.2使类型化的请求 DTO 能表达默认模型并补充目录不变量测试。本地示例配置godex.yaml、godex.zhipu.yaml将智谱别名路由到 glm-5.2glm-5.1 仍注册为可调用模型。MODEL_MAPPINGgpt-5 / o3 / o4-mini - glm-5.1在本版本中刻意保持不变。需注意需要你的智谱端点支持 glm-5.2。向导默认端点为编程套餐端点open.bigmodel.cn/api/coding/paas/v4。依赖升级 logtape/file、logtape/logtape、js-yaml、clack/prompts 及 fetcher-ecosystem 组#147、#148、#149、#150、#151。功能特性OpenAI 兼容的 POST /v1/responses支持同步和流式响应。GET /v1/models 暴露模型别名让客户端使用稳定模型名GodeX 负责路由到 provider/model。内置 DeepSeek、Xiaomi、MiniMax、智谱桥接 provider。基于 provider capability 规划请求参数、工具、tool_choice、结构化输出、推理和流式 usage。支持 previous_response_id 会话链可使用内存或 SQLite。Trace 记录 provider request、provider response、stream event、usage 和 error。基于 Bun 运行时、TypeScript 源码并通过 release 产出多平台原生二进制。内置提供商提供商推理GodeX 输入工具选择响应格式缓存 Token默认模型DeepSeek原生文本auto, none, required, functiontext, json_object✅deepseek-v4-proXiaomi布尔文本autotext, json_object✅mimo-v2.5-proMiniMax布尔文本、图片、视频auto, none, required, functiontext, json_object✅MiniMax-M3智谱布尔文本auto, nonetext, json_object✅glm-5.2架构与组件交互图架构图组件交互图安装方式本地开发git clone https://github.com/Ahoo-Wang/GodeX.gitcd GodeXbun install包安装npm install -g ahoo-wang/godexgodex --helpDocker预构建镜像发布到 Docker Hub 和 GitHub Container Registrydocker pull ahoowang/godex:latest# 或docker pull ghcr.io/ahoo-wang/godex:latest使用配置文件运行docker run -d \ --name godex \ -p 5678:5678 \ -e ZHIPU_API_KEYyour-key \ -e DEEPSEEK_API_KEYyour-key \ -e MINIMAX_API_KEYyour-key \ -e MIMO_API_KEYyour-key \ -v ./godex.yaml:/etc/godex/godex.yaml:ro \ -v godex-data:/data \ ahoowang/godex:latest镜像支持 linux/amd64 和 linux/arm64。配置文件路径/etc/godex/godex.yaml数据目录会话、Trace/data默认端口5678快速开始交互式创建配置并启动服务godex initgodex serve --config ./godex.yaml向导会引导你选择 Provider、填写 Base URL 和 API Key自动生成配置文件。手写 godex.yamlserver:port: 5678host: 0.0.0.0default_provider: deepseekmodels:aliases:# -------------------------------------------------------------------------# Codex-compatible model aliases## 这些 alias 是 GodeX routing policy不代表与 OpenAI 原模型能力等价。# 依据优先级公开 benchmark 官方模型定位 Provider 产品说明。# -------------------------------------------------------------------------# Codex 默认主力复杂编码 / computer use / research workflows# 依据DeepSeek V4-Pro 在 SWE / Terminal / Codeforces / GDPval-AA 上公开成绩强。gpt-5.5: deepseek/deepseek-v4-pro# Codex 旗舰coding reasoning tool use agentic workflows# 依据DeepSeek V4-Pro 有更完整的公开 coding/agentic benchmark 覆盖。gpt-5.4: deepseek/deepseek-v4-pro# Codex minisubagentsgpt-5.4-mini: zhipu/glm-5.1# Codex 编码专用复杂软件工程# 依据DeepSeek V4-Pro 的 SWE Verified / SWE Pro / Terminal Bench 表现。gpt-5.3-codex: deepseek/deepseek-v4-pro# Codex spark近实时编码迭代gpt-5.3-codex-spark: zhipu/glm-5.1# 上一代通用 coding / agentic fallback# 严谨起见仍走 DeepSeek不强行映射到 Zhipu。gpt-5.2: deepseek/deepseek-v4-pro# -------------------------------------------------------------------------# Provider native models# -------------------------------------------------------------------------deepseek-v4-pro: deepseek/deepseek-v4-prodeepseek-v4-flash: deepseek/deepseek-v4-flashmimo-v2.5-pro: xiaomi/mimo-v2.5-promimo-v2.5: xiaomi/mimo-v2.5glm-5.1: zhipu/glm-5.1glm-5-turbo: zhipu/glm-5-turboglm-4.7: zhipu/glm-4.7glm-4.5-air: zhipu/glm-4.5-airMiniMax-M3: minimax/MiniMax-M3# Fallback for unknown bare model names*: deepseek/deepseek-v4-proproviders:deepseek:spec: deepseekcredentials:api_key: ${DEEPSEEK_API_KEY}endpoint:base_url: https://api.deepseek.comzhipu:spec: zhipucredentials:api_key: ${ZHIPU_API_KEY}endpoint:base_url: https://open.bigmodel.cn/api/coding/paas/v4minimax:spec: minimaxcredentials:api_key: ${MINIMAX_API_KEY}endpoint:base_url: https://api.minimaxi.com/v1xiaomi:spec: xiaomicredentials:api_key: ${MIMO_API_KEY}endpoint:base_url: https://api.xiaomimimo.com/v1session:backend: sqlitelogging:level: infotrace:enabled: truepath: ./data/trace.dbcapture_payload: false启动服务godex serve --config ./godex.yaml源码开发模式bun run devbun run dev 使用端口 13145运行时配置默认端口是 5678。API健康检查curl http://localhost:5678/health模型列表curl http://localhost:5678/v1/models/v1/models 返回已配置模型别名不包含通配别名 *。Responsescurl http://localhost:5678/v1/responses \ -H content-type: application/json \ -d {\n model: gpt-5.5,\n input: 写一个 TypeScript add 函数。\n }流式响应使用标准 Responses SSE 事件名curl -N http://localhost:5678/v1/responses \ -H content-type: application/json \ -d {\n model: gpt-5.5,\n stream: true,\n input: 用两句话解释 Bun streams。\n }模型路由客户端可以传入provider-qualified selector例如 deepseek/deepseek-v4-pro配置别名例如 gpt-5.5普通模型名未命中别名时通过 default_provider 解析models.aliases 的值必须是 provider/model且 provider 必须存在于 providers。Codex 集成将 Codex 桌面应用接入 GodeX在 ~/.codex/config.toml 中添加自定义 providermodel gpt-5.5model_provider godex[model_providers.godex]name GodeXbase_url http://127.0.0.1:5678/v1wire_api responsesrequires_openai_auth falsesupports_websockets false模型别名gpt-5.5、gpt-5.4、gpt-5.4-mini 等由 GodeX 根据 godex.yaml 中的 models.aliases 解析Codex 只需知道别名。Provider 桥接行为GodeX 构建 provider request 分三步将客户端模型选择器解析为配置里的 provider 和上游模型。根据 provider ProviderSpec 规划参数、工具声明、tool_choice、响应格式、推理和 stream usage。将 Responses input 和 session history 转换为 Chat Completions messages调用上游再重建 Responses object 或 Responses SSE stream。Provider 特有差异放在各 provider 的 spec.ts、hooks.ts、协议类型和 HTTP client 中。共享 Responses-to-Chat 策略放在 src/bridge。结构化输出当 provider 支持 json_object 但不支持原生 json_schema 时GodeX 可以把 strict json_schema 请求降级到 json_object。对 strict 降级 schema当前请求的 provider prompt 前言会加入 schema 格式指令。provider 收到 response_format: { type: json_object }。GodeX 校验最终输出是否是合法 JSON。同步响应输出非法时失败流式响应输出非法时改写为终止 response.failed 事件。校验器只检查 JSON 语法不执行完整 JSON Schema 校验。会话Responses 可以通过 previous_response_id 保存并回放上下文。session.backend: memory 使用进程内存。session.backend: sqlite 持久化到 SQLite。store: false 跳过当前轮保存。session chain 保存 request snapshot 和 response output item下一轮再重建 provider-neutral history。Trace 数据库Trace 默认开启默认写入 ./data/trace.db。Trace 记录包括provider request 元数据provider request / response body 的摘要 payload原始和转换后的 stream eventusage 详情包括上游返回的 cached tokensroute error 和 provider error设置 trace.capture_payload: true 会保存 payload JSON最多 trace.payload_max_bytes 字节。敏感环境建议保持关闭。开发bun install # 安装依赖bun run dev # 热重载开发服务器端口 13145bun run start # 从源码启动服务bun run build # 为当前平台编译二进制bun run compile:all # 交叉编译所有支持平台质量门禁bun run typecheck # TypeScriptbun run lint # Biome checkbun run lint:fix # Biome 自动修复bun run format # Biome 格式化bun run test # 单元和集成测试不含 src/e2ebun run test:e2e # mock 上游端到端测试bun run test:zhipu # 智谱 live 测试需要 ZHIPU_API_KEYbun run test:deepseek # DeepSeek live 测试需要 DEEPSEEK_API_KEYbun run test:minimax # MiniMax live 测试需要 MINIMAX_API_KEYbun run test:xiaomi # Xiaomi live 测试需要 MIMO_API_KEYbun run check # typecheck lint testbun run ci # typecheck biome ci test e2e源码地图src/cli/ Commander CLI, init wizard, runtime config loadingconfig/ godex.yaml schema, defaults, env interpolationcontext/ ApplicationContext and per-request ResponsesContextbridge/ Provider-agnostic Responses-to-Chat planning and reconstructionproviders/ Built-in provider specs, hooks, clients, and registryresponses/ Sync and stream request pipelinesserver/ Bun routes for /health, /v1/models, /v1/responsessession/ Memory and SQLite response session storestrace/ SQLite trace recorder and usage/error/event mappersprotocol/ OpenAI protocol type definitionserror/ GodeXError hierarchy and domain codesProvider 开发Provider 目录形态src/providers/name/spec.ts ProviderSpec declarationclient.ts ProviderEdge construction with ChatProviderClienthooks.ts Provider-specific patching, accessors, usage, stream deltasprotocol/ Provider DTOs when neededindex.ts Public exports共享兼容性策略放到 src/bridge共享 provider transport 或协议 helper 放到 src/providers/shared。许可证Apache-2.0. See [LICENSE](https://gitee.com/AhooWang/GodeX/blob/main/LICENSE).