给 Codex 接一个多上游账号池
陈淮锐 · 2026 年 9 月 24 日 · 开发记录,真实接入待验证
GitHub · 0hello-bit/codex-control-center我想解决的事情很具体:手里可能有不同上游的 API,希望都能接进 Codex,之后在一个页面里管理,不必每换一家就重新改配置。
还有一个更让我在意的问题:改完配置后,原来的会话有时看不见了。本地记录提示,会话所属的 provider 会影响历史列表的显示。列表里找不到会话,因此不一定是记录被删除了;不过,每次消失的原因和能否恢复,还需要逐次核对。
先把上游切换留在本地路由里
这次是在现有 Codex Control Center 的 React、FastAPI 和 Python 路由基础上继续改造。我的目标是让 Codex 固定连接本机入口,把新增账号、模型选择和故障处理放到工具内部。
网页现在可以填写上游地址和 API Key,获取模型列表,也可以手填模型名称。选好模型后逐个验证,再导入账号池。相同地址和密钥重复导入会合并模型,不会覆盖手动停用状态。
自动停用不能只看一个报错
无效密钥、余额耗尽、模型不存在和临时限流,需要分别处理。明确的账号级错误隔离整个账号,模型不存在只影响那个模型;临时故障进入冷却,恢复时先放行一个请求。
“已启用”也不等于“现在一定可用”,它只表示允许参与调度。路由还会检查模型和健康状态。流式输出已经开始后,不会换一家上游重新播放请求,避免把两段结果拼在一起。
目前这一版只面向 Responses 兼容接口。只有 Chat Completions、Claude 或 Gemini 原生协议的上游,不能靠换个地址就直接接入。
界面做了几轮减法
最初的深色、渐变和发光按钮看起来太像通用 AI 后台。改成浅色以后,我又觉得字体混用、小字和大数字统计仍然抢眼,于是继续收敛:Windows 上用 Segoe UI 和微软雅黑 UI,去掉重复标题与大块统计,把账号表格和导入操作放在前面。
最后用 xhyapi 的 gpt-image-2 生成了一枚三路汇入的标识,用在侧栏、导入窗口和空状态。它只是视觉素材,不参与接口调用逻辑。页面使用的压缩图片约 22 KB,也为深色模式做了适配。
隔离环境通过,真实客户端还要接着测
这一轮通过了 45 项后端测试、前端生产构建,以及桌面和手机上的导入、搜索、启停与页面检查。验证用的是临时 Codex 目录和本机模拟上游;真实 Codex 配置与认证文件的校验值保持不变。
新接入流程已经实现保留 provider、配置备份与恢复,但还没有对真实 Codex 客户端完成最终接入测试。最小请求成功,也不等于完整工具调用和跨上游会话连续性已经通过。
正式配置暂时保持“隔离检查 · 配置锁定”。等真实上游的工具调用、流式事件和会话连续性逐项验证后,再决定是否切换。