【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载本篇技术指南基于 opencodex 仓库中devlog/_fin/260722_gemini_36_rollout/目录的完整滚动记录研究契约、实施计划 与 目录与线路计划复盘当 Google 于 2026-07-21 将gemini-3.6-flash宣布 GA 时opencodex 如何通过官方证据 认证探测 仓库基线 邻接边界 实施门禁五层证据链将新模型安全地接入直接 Google 与google-antigravity两个 provider并完成旧 3.5 选择的无损迁移。读完本文你将掌握 opencodex 的模型发现Antigravity :fetchAvailableModels单一真源原则、低/中/高推理档位的 wire 编码方式、隐藏兼容别名的路由设计以及如何用一套可复现的测试与验证命令锁定一次模型上线的正确性。时效性说明该研究契约归档于 2026-07-22属于 Gemini 3.6 上线当时的历史快照此后仓库世代已推进至 3.7/3.8 Flash但 3.6 的证据表与退役映射至今仍保留在 src/providers/antigravity-models.ts 中其研究方法论在后续每次模型滚动中持续复用本文会一并标注当前仓库中的对应现状。为什么模型上线前需要一份研究契约模型发布与代理proxy接入之间存在一个天然的时间差上游官方公告发布新模型但仓库的目录、路由、价格、认证预设未必立刻具备对应条目。直接照公告加一行模型 ID是最容易出错的路径——官方模型 ID、Antigravity 探测返回的 wire ID、展示名display name、上下文窗口、价格、推理档位语义之间可能出现错位任何一个不一致都会导致选择器暴露了模型却发不出正确请求。opencodex 的解法是把模型接入拆成先锁定证据、再实施改动两个阶段001_research_contract.md负责把一切可验证的事实固化下来官方契约、认证探测结果、仓库基线、邻接 provider 现状、开放问题000_plan.md据此形成实施计划与验收标准010_model_catalog_and_wire_plan.md则承载目录/线路/价格/测试的具体改动清单。该滚动单元的工作类别是 C3——provider 目录、wire 路由、持久化 OAuth 预设、用量价格与测试必须整体同步移动任何一层缺席都会造成选择器、路由与账单之间的不一致。研究契约的价值在开放问题转化为实施门禁一节体现得最清楚凡是证据不足的选项一律不作为实施前提例如直接 Google API 凭证未配置时不把在线推理当作完成要求、Antigravity 的tiered行没有展示名就不发明选择器语义、Vertex 未被证实前保持冻结。官方证据以官方页面浏览器渲染结果为准研究契约第一条原则是官方页面必须浏览器渲染后读取。2026-07-22 当天普通 HTTP 读取器对 Google 官方文档页面返回空内容因此改用浏览器渲染后的页面内容作为证据来源并逐条固化为证据表声明证据内容GA 发布日期与公开 IDGoogle Gemini API 更新日志2026-07-21Gemini 3.6 Flash GA公开 ID 为gemini-3.6-flash模型形态输入支持文本、图像、视频、音频、PDF输出为文本输入上限 1,048,576输出上限 65,536支持思考thinking、函数调用、代码执行、缓存、结构化输出、URL 上下文、搜索/地图 grounding、文件搜索与 Computer Use 预览公开价格标准付费档输入 $1.50/M含思考的输出 $7.50/M缓存读取 $0.15/M存储 $1.00/M tokens/小时家族请求行为Gemini 3.x 使用thinking_level直接 GenerateContent 形式为generationConfig.thinkingConfig.thinkingLevelCodex 侧可用档位为 low、medium、high采样参数2026-07-21 更新日志将temperature、top_p、top_k标记为弃用但没有证据表明现有请求会被拒绝因此抑制这些参数超出本次改动范围这份表格同时锁定了本次接入的两条硬约束其一推理档位走thinkingConfig.thinkingLevel而不是发明新的请求字段其二弃用的采样参数不处理——弃用不等于拒绝全局请求塑形变更需要单独的证据与兼容性论证实施计划 的固定决策第 7 条。认证 Antigravity 证据探测:fetchAvailableModels对google-antigravity而言仓库运营者声明的模型列表单一真源是 Antigravity 的:fetchAvailableModels后端——这与agyCLI 解析标签所用的后端是同一个src/providers/antigravity-models.ts 头部注释明确这一点。研究阶段使用只读的认证探测仅打印模型 ID、展示名与maxTokens绝不打印凭证与项目身份。2026-07-22 的探测结果如下。可见的 3.6 三档行Wire ID展示名maxTokensgemini-3.6-flash-lowGemini 3.6 Flash (Low)1,048,576gemini-3.6-flash-mediumGemini 3.6 Flash (Medium)1,048,576gemini-3.6-flash-highGemini 3.6 Flash (High)1,048,576隐藏的原始行gemini-3.6-flash-tiered同样以 1,048,576 的maxTokens返回但它没有展示名。研究契约将它记录为证据但不作为选择器行暴露——没有展示名的模型不构成用户可见选择语义。既有 3.5 行与语义错配探测发现一个关键的语义错配旧的 3.5 wire ID 对应的上游展示名与字面语义不一致。例如gemini-3.5-flash-low上游展示为 Gemini 3.5 Flash (Medium)。三档迁移映射如下当前 wire ID上游展示名迁移目标gemini-3.5-flash-extra-lowGemini 3.5 Flash (Low)gemini-3.6-flash-lowgemini-3.5-flash-lowGemini 3.5 Flash (Medium)gemini-3.6-flash-mediumgemini-3-flash-agentGemini 3.5 Flash (High)gemini-3.6-flash-high研究契约还指出当时的静态 owner 用别名aliases重建 Mid/High 两档src/providers/antigravity-models.ts 中别名机制注释而新后端显式提供全部三档因此这些用户可见别名不再需要——但为了兼容已保存的选择旧 ID 必须保留为隐藏的入站兼容别名而不是直接删除。仓库基线每一处需要同步改动的代码点研究契约第 3 节给出了一份精确的仓库基线清单标明每个知识产权的归属位置。当时的对应关系如下其中部分文件在当前仓库已随世代演进调整行号但职责不变知识对象当时位置职责Antigravity wire 列表、别名、上下文窗口、解析器src/providers/antigravity-models.ts可见行与隐藏别名的分离直接 Google 种子与 Antigravity 默认值src/providers/registry.ts当前注册表条目已拆入 src/providers/registry/entries-core.ts直接 Google 3.6 种子与google-antigravity默认档Google 适配器src/adapters/google.ts转发 max output、temperature、top-p、stop sequences 以及 reasoning effortOAuth 预设对账src/oauth/index.ts用 registry 托管的模型与元数据覆盖预设中的models并修复从刷新列表中消失的默认值Antigravity 价格覆盖src/usage/expected-prices.ts3.6 公开价格与衍生价格行生成型元数据当时的scripts/generate-jawcode-metadata.ts与src/generated/jawcode-model-metadata.ts当前对应物为 scripts/generate-model-metadata.ts 与 src/generated/model-metadata.ts由生成器产出禁止手改禁止手改生成文件是一条纪律性约束jawcode 源数据在 2026-07-22 检查时尚未包含 3.6 行因此本次不碰生成快照而是用 registry 提示与经本地验证的价格覆盖临时补齐将来 jawcode 有了官方 3.6 行再以机械方式单独刷新生成文件。邻接 provider 边界不做投机性种子研究契约对每个看起来相关但证据不足的 provider 都做了显式检查结论统一是不加投机行Cursor2026-07-22 的ocx models --json输出含cursor/gemini-3.5-flash但无任何 Cursor Gemini 3.6 行在 Cursor 自身公告新模型之前其发现逻辑src/adapters/cursor/discovery.ts与测试保持范围外。OrcaRouterregistry 静态种子含google/gemini-3.5-flash而 3.6 的候选模型页当时返回 HTTP 404不添加投机行。jawcode 元数据源其packages/ai/src/models.json含多个 3.5 行、无 3.6 行生成快照保持不变。这条边界与 实施计划 的OUT范围一一对应Vertex、Cursor、OrcaRouter、OpenRouter 动态目录、生成元数据、基准 fixture 全部排除在本滚动单元之外。其背后的原则是动态发现的目录自己会成长静态目录只负责把自己证实过的模型做扎实。实施要点目录、路由、迁移、价格与验证Antigravity 可见行替换与隐藏别名实施的核心是把可见的 3.5 Flash 行替换为显式 3.6 三档 wire ID同时把五个退役 IDgemini-3.5-flash-extra-low、gemini-3.5-flash-low、gemini-3.5-flash-mid、gemini-3.5-flash-high、gemini-3-flash-agent收进隐藏兼容别名映射指向各自的 3.6 目标档。ANTIGRAVITY_MODEL_ALIASES合并可见与兼容别名供请求解析ANTIGRAVITY_MODELS只包含 wire 模型与可见别名键兼容键绝不重新进入选择器。同时三个 Flash 上下文窗口 owner 换成显式 3.6 ID均 1,048,576并继续从别名映射推导旧 ID 的上下文窗口使旧保存选择在路由层仍然可解。这一可见/隐藏分离的设计在后续世代中延续至今当前 src/providers/antigravity-models.ts 中的RETIRED_FLASH_TIERS仍保留着全部 3.6 条目gemini-3.6-flash→ medium、-low→ low、-medium→ medium、-high→ high并在 3.6 被 3.7 取代后将它们路由到 3.7 的 redirect target——这正是旧选择永不悬挂、但旧世代绝不再出现在选择器原则的延续。直接 Google 的 thinking-level 接线直接 Google provider 需要把 Codex 侧的推理档位映射为 Gemini 的generationConfig.thinkingConfig.thinkingLevel。从 src/adapters/google.ts 当前实现看该接线在 generationConfig 组装时进行maxOutputTokens、temperature、topP、stopSequences组装完毕后对 eligible 的模型调用mapReasoningEffort得到thinkingLevel非空时写入generationConfig.thinkingConfigL912-L933。当时的边界规则被明确写死仅当provider.googleMode既非vertex也非cloud-code-assist且模型为gemini-3.5-flash或gemini-3.6-flash时应用未选择 effort 时省略thinkingConfig默认档由模型自身承担不向 Antigravity 追加 thinking level——它的 Low/Medium/High wire ID 后缀已经编码了档位再发 thinkingConfig 会产生自相矛盾的请求不在此次改动 temperature/top-p 行为。当前源码注释印证了这一设计的延续gemini-3.5/3.6-flash的 direct-mode 路径保持硬编码使未配置档位阶梯的配置维持既有行为src/adapters/google.ts L918-L929。同时适配器对 Antigravity 路径调用resolveAntigravityEffortWireModel得到 wireModelId 与 thinkingLevel后缀/兼容 ID 返回thinkingLevelundefined——后缀即档位不再叠加声明L970-L988。注册表元数据与默认值直接google注册表条目保留gemini-3.5-flash为默认新增模型不改变既有 API-key 用户的默认值静态顺序改为[gemini-3.6-flash, gemini-3.5-flash, gemini-3.1-pro-preview]3.6 的上下文窗口 1,048,576、输入模态[text, image]、推理档位[minimal, low, medium, high]Codex 目录 sanitizer 只暴露 low/medium/highminimal保留给非 Codex CLI/API 消费者。google-antigravity条目只把默认值从gemini-3.5-flash-low改为gemini-3.6-flash-medium——该选择保留了原有默认档位的有效语义旧gemini-3.5-flash-low行的上游展示名正是 Gemini 3.5 Flash (Medium)。OAuth 预设自愈持久化的 OAuth 预设可能带着旧列表与旧默认值。对账逻辑src/oauth/index.ts用 registry 托管的模型列表与元数据覆盖预设中的models并把刷新后消失的默认值自愈到新列表中的对应档位。新增测试 tests/oauth/oauth-provider-reconcile.test.ts 验证旧 3.5 列表/默认值在启动对账后 models 与新的 Antigravity 列表完全一致、旧默认自愈为gemini-3.6-flash-medium、上下文元数据刷新、凭证/项目 ID 与无关用户字段原样保留、重复调用幂等且不产生变更。价格与用量src/usage/expected-prices.ts 定义了 3.6 的成本常量L58const GEMINI_36_FLASH: Cost4 { input: 1.5, output: 7.5, cacheRead: 0.15, cacheWrite: 0 };价格覆盖行L228、L263-L272包含google/gemini-3.6-flash的verified行、三个 Antigravity 3.6 档位 ID 的verified-derived行以及五个旧 3.5/legacy ID 的兼容价格别名行——后者保留精确键的用量计价因为当时成本匹配收到的是请求 ID 而非解析后的 wire ID注释明确这些行不影响选择器可见性。当前仓库在 3.6 退役后仍保留google-antigravity/gemini-3.6-flash的 collapsed-base 价格行理由写得很清楚历史usage.jsonl行仍携带这些 ID删掉会把已发生请求的成本静默归零src/usage/expected-prices.ts L226-L228。测试矩阵与验证命令实施阶段新增/修改了九个测试文件覆盖可见行、隐藏别名、wire 解析、注册表元数据、thinking-level 激活、静态回退、OAuth 投影、quota fixture 与目录阶梯tests/adapters/google/google-antigravity-wire.test.ts可见 3.6 三档存在、退役 3.5/tiered缺席、新 ID 原样直通、旧 ID 全部解析到固定目标tests/adapters/google/google-hardening.test.ts3.6 注册表元数据精确断言reasoning: high时请求体含thinkingConfig.thinkingLevel未选 effort 时无thinkingConfigtests/adapters/google/google-models-listing.test.ts静态回退契约包含gemini-3.6-flash且未配置的gemini-3-pro/gemini-3-flash不回退泄漏tests/providers/provider-registry-parity.test.ts 与 tests/providers/provider-quota.test.tsOAuth 投影暴露 3.6 隐藏 3.5、quota fixture 刷新到gemini-3.6-flash-mediumtests/usage/usage-cost.test.ts3.6 overlay 成员与五个隐藏兼容键的 1.5/7.5/0.15/0 数值与verified-derived状态tests/codex-integration/codex-catalog.test.ts直接 Google 3.6 的 Codex 阶梯精确为low/medium/high/max/ultraminimal归一化为low公共目录层追加 mockmax/ultra适配器 clamp 回真实 wire 上限hightests/oauth/oauth-provider-reconcile.test.ts见上文自愈场景。验证命令仓库根目录bun test --isolate \ tests/google-antigravity-wire.test.ts \ tests/google-hardening.test.ts \ tests/google-models-listing.test.ts \ tests/provider-registry-parity.test.ts \ tests/provider-quota.test.ts \ tests/usage-cost.test.ts \ tests/codex-catalog.test.ts \ tests/oauth-provider-reconcile.test.ts bun run typecheck随后做运行时面验证bun src/cli/index.ts models --provider google-antigravity --json、ocx provider show google-antigravity --json、ocx models --provider google-antigravity --json期望目录状态为默认 3.6 Medium、Flash 可见行恰为 Low/Medium/High、无 3.5 行与gemini-3-flash-agent。最后每个新暴露档位发一条最小提示词google-antigravity/gemini-3.6-flash-low|medium|high记录模型、HTTP/流式完成状态与脱敏输出尾段绝不持久化 OAuth token、项目 ID 或原始fetchAvailableModels载荷。验收标准一次上线要同时满足什么实施计划 的验收清单把做对了定义为一组可机械核查的断言摘要如下google-antigravity对 Flash 家族只列 3.6 Low/Medium/High无 3.5 行与gemini-3-flash-agent可见旧 3.5 Antigravity ID 路由到对应 3.6 wire ID新 3.6 ID 原样直通持久化 OAuth 配置的默认值gemini-3.5-flash-low启动时自愈为gemini-3.6-flash-medium不触碰凭证与无关 provider 设置直接google列出gemini-3.6-flash、gemini-3.5-flash、gemini-3.1-pro-preview默认仍为 3.5直接 3.6 目录元数据报告 1,048,576 上下文、图像输入与 low/medium/high 推理档位reasoning: high的 3.6 请求携带thinkingLevel high未选档位则省略thinkingConfig用量解析返回已核实的 3.6 公开价格三个 Antigravity 可见档位为衍生价格五个隐藏兼容 ID 保持精确键覆盖Cursor 与 OrcaRouter 不变聚焦测试与 typecheck 通过三个 Antigravity 档位完成最小在线提示词。从开放问题到实施门禁证据不足时的处理纪律研究契约最后把三个开放问题显式转化为实施门禁这是整个方法论中最值得复用的部分直接 Google API 凭证未配置直接在线推理不作为完成要求除非后续获得凭证但官方契约证明与请求形态测试无论如何都必须做。Antigravity 的tiered行在它获得展示名或独立用户可见契约之前保持隐藏——模型存在不足以发明选择器语义。Vertex 冻结Gemini Developer API 的 GA 并不自动建立 Vertex publisher 支持需等待 Vertex 专属可用性证明。这三条共同说明了一个工程原则能证明的就锁进契约不能证明的就变成门禁绝不靠猜测补全缺口。这一原则也解释了为什么研究契约在归档时被标记为 verified and shipped with the Gemini 3.6 rollout——它不是一份论文式调研而是一份与代码改动、测试结果、在线探测和合并记录绑定在一起的、可追溯的实现凭证其 完整实施与验收记录 与 目录/线路/价格/测试清单 至今保留在仓库的devlog/_fin/归档区可作为后续模型接入如 3.7/3.8 Flash 滚动的模板与对照物。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐opencodex Gemini 3.6 Flash 上线实战目录替换、隐藏兼容别名与 thinkingLevel 线路接入opencodex Gemini 3.6 Flash 上线实战目录替换、隐藏兼容别名与 thinkingLevel 线路接入 本篇文章以 opencodexOpenCodex Gemini 3.6 Flash 全链路上线实录Antigravity 线级替换、隐藏兼容别名与 thinkingLevel 推理档位打通OpenCodex Gemini 3.6 Flash 全链路上线实录Antigravity 线级替换、隐藏兼容别名与 thinkingLevel 推理档位打通opencodex 的 OpenAI 单一 Codex 登录 Provider 化codexAccountMode 迁移契约与 Pool/Direct 路由隔离实现解析opencodex 的 OpenAI 单一 Codex 登录 Provider 化codexAccountMode 迁移契约与 Pool/Direct 路由隔创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考