codex-router
- 3.9k+★ 社区项目
- 25+ Commits 核心贡献
- 独立模块 antigravity-oauth
把外部大模型无缝接入 Codex CLI 的本地路由网关(社区 3.9k+ Stars 开源项目)。我作为核心贡献者(25+ Commits)负责多渠道 OAuth 2.0 PKCE 认证、v1internal 流式协议重塑与跨平台托盘控制中心。
项目概览与状态
我主导完成了 Kimi / DeepSeek / Antigravity 的 OAuth 2.0 PKCE 认证与并发 Session Lock,实现 OpenAI 兼容请求到 Cloud Code Assist v1internal SSE 流式协议的无损转换(并独立抽离开源为 antigravity-oauth-integration),同时交付跨平台系统托盘 Control Center 与配置原子回滚机制。
要解决的问题
Codex CLI 默认仅绑定官方单一模型源,接入 Kimi、DeepSeek、Antigravity Cloud Code Assist 等外部模型时面临 OAuth 认证协议差异、并发刷新锁冲突、SSE 流式格式不兼容及配置损坏难以回滚等工程痛点。
我的职责
我负责 OAuth 2.0 PKCE 认证链路、v1internal 协议转换网关、并发会话锁与托盘控制中心研发(25+ Commits)。
- 01研发并维护 Kimi、DeepSeek 与 Antigravity 渠道的 OAuth 2.0 PKCE 登录、Token 刷新与并发 Session Lock
- 02攻克 OpenAI Chat/Responses 请求到 Cloud Code Assist v1internal SSE 流式协议转换,并抽离出独立模块仓库
- 03实现跨平台托盘 Control Center 状态监控与配置文件原子备份回滚
AI 参与边界
AI 辅助
- —辅助梳理上游协议字段映射表与边缘异常单测
由我负责
- —OAuth PKCE 状态机设计、并发锁实现、SSE 流式分块边界处理、原子回滚策略与 PR 交付审查
系统架构
关键实现
- 01Kimi / DeepSeek / Antigravity Cloud Code Assist 的 OAuth 2.0 PKCE 授权闭环与 Token 自动续期
- 02并发 Session Lock 机制,解决多终端并发请求下的 Token 刷新竞态与失效雪崩
- 03OpenAI 兼容格式到 Google Cloud Code Assist v1internal SSE 流式协议的双向重塑与工具调用对齐
- 04将 Antigravity 认证与协议转换能力解耦抽离为独立可复用仓库 Zzy-min/antigravity-oauth-integration
- 05跨平台系统托盘 Control Center 图形化控制中心与配置文件原子写入/故障一键回滚
一次真实问题与修复
高频并发 Tool Call 下 Token 过期刷新会产生竞态覆盖,且 v1internal SSE 分块流在跨行 JSON 拼接时偶发截断。
通过构造多并发压测流与抓包对比原始 SSE 帧,定位无锁刷新导致的旧 Refresh Token 重放失败及流式缓冲区边界切割缺陷。
引入基于文件与内存双保险的 Session Lock 串行化凭据续期,并重写 SSE 帧增量状态机解析器,同时将该核心模块独立封装为 antigravity-oauth-integration。
长时高并发编码任务下认证续期与流式工具调用保持零中断,相关核心 PR 已合入主干并获得社区广泛使用。