Codex 自定义模型代理

问题背景

OpenAI Codex CLI 默认走 Responses API（/v1/responses）并以 SSE 流式返回；不少自建或第三方模型（例如 MiniMax）只提供与 OpenAI 兼容的 Chat Completions（/v1/chat/completions）。两边请求体、流式事件名和字段并不一致，直接改 base_url 往往会出现 Stream disconnected before completion、Model metadata not found 等现象。

技能如何工作

本技能提供一个可配置的本地 Python SSE 代理（默认监听 http://127.0.0.1:5005），在 Codex 与上游之间做协议转换：

• 接收 Codex 的 Responses API 请求
• 转成 Chat Completions 格式并转发到上游
• 将上游流式块再映射回 Codex 期望的 SSE 事件（如 response.created、response.output_text.delta、response.completed 等）
• 处理模型元数据、UTF-8 编码与超时等常见坑

典型用法是编辑 ~/.codex/config.toml 把端点指向本地代理，启动 scripts/sse_proxy.py（或捆绑脚本），再照常运行 Codex。

适用边界与注意点

• 上游需基本兼容 OpenAI Chat Completions 流式语义；非该形态的 API 需要额外适配。
• Model metadata not found 多为目录警告，可在 model_catalog_gpt55.json 中补条目（见 references/model-catalog-schema.md），不影响代理转发本身。
• 空闲断流时优先加大 UPSTREAM_TIMEOUT（建议 180 秒以上），并确认代理输出完整 SSE 序列与 X-Accel-Buffering: no。
• 多模型、自定义 MODEL_META、HTTPS 上游证书等可在代理脚本与环境变量中扩展。