OmX 0.14.4 发布就绪评估默认 Frontier 模型车道从 gpt-5.4 升级至 gpt-5.5 的契约迁移实践【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codexoh-my-codexOmX在0.14.4补丁版本中完成了一次典型的模型契约升级将默认 frontier 车道从gpt-5.4提升到gpt-5.5同时严格保留gpt-5.4-ministandard/mini 车道与gpt-5.3-codex-sparkspark 车道的精确匹配语义。本文基于仓库内的发布就绪评估文档 docs/qa/release-readiness-0.14.4.md 及其配套的 docs/release-notes-0.14.4.md结合源码与测试完整还原这次模型车道升级的变更范围、验证门禁、兼容性边界与发布判定帮助读者理解 OmX 多车道模型契约的设计与 QA 流程。读完本文你将掌握OmX 的三车道模型契约结构、frontier 默认模型升级时涉及的执行路径与回归套件、以及 release readiness 文档如何驱动 PR/CI 验证与打标签决策。版本定位与 Scope一次最小契约变更的补丁发布0.14.4是紧随0.14.3的补丁发布发布日期为 2026-04-24基线与比较基准为v0.14.3候选分支为hotrelease/0.14.4-gpt55。根据 CHANGELOG.md 中0.14.4条目其核心变更可归纳为Frontier 默认车道升级运行时默认值、Codex agent 默认值、omx explore降级fallback行为统一从gpt-5.4切换到gpt-5.5Mini 与 Spark 车道保持精确匹配gpt-5.4-mini与gpt-5.3-codex-spark的语义不变prompt 指引与测试仍强制 exact-matchSetup/配置文案对齐config seeding 文档与回归覆盖改为描述gpt-5.5并保留原有的上下文窗口推荐值推理级别调整setup 生成的配置与 executor worker 的默认推理级别从high降为medium发布元数据对齐Node/Cargo 元数据、lockfiles、CHANGELOG、release body、release notes 与 release-readiness 文档全部对齐到0.14.4。promote 默认车道 保留精确车道是本次发布的核心手法只有默认值发生迁移任何用户显式配置的gpt-5.4-mini或gpt-5.3-codex-spark覆盖都不受影响因此官方明确标注无需用户迁移。三车道模型契约Frontier / Mini / Spark 的职责边界OmX 的模型路由基于车道lane概念每种车道对应一类角色语义与默认模型。0.14.4 时点的契约如下依据 docs/release-notes-0.14.4.md 与 CHANGELOG.md车道角色语义0.14.4 默认模型升级行为frontier协调、规划、深度推理等主干角色gpt-5.5自gpt-5.4提升默认值迁移fresh/default 配置路径生效standard / mini标准能力 workerexecutor 等gpt-5.4-mini不变保持精确匹配spark快速、低延迟检索explore 等 fast-lanegpt-5.3-codex-spark不变保持精确匹配这三条车道在 src/agents/definitions.ts 的AgentDefinition中对应modelClass: frontier | standard | fast角色通过posturefrontier-orchestrator/deep-worker/fast-lane与modelClass共同决定落到哪条车道。explore、style-reviewer属于fast类走 spark 默认executor等属于standard类architect、planner、critic等协调类角色属于frontier类。需要特别说明的是当前仓库主干已演进到 GPT-5.6 契约src/config/models.ts 中DEFAULT_FRONTIER_MODEL gpt-5.6-sol、DEFAULT_STANDARD_MODEL gpt-5.6-terra、DEFAULT_SPARK_MODEL gpt-5.6-luna即 frontiergpt-5.5 → gpt-5.6-sol、standardgpt-5.4-mini → gpt-5.6-terra、sparkgpt-5.3-codex-spark → gpt-5.6-luna见 CHANGELOG.md 中 GPT-5.6 迁移条目。但三车道结构、解析优先级与精确匹配语义自 0.14.4 起保持一致本文以 0.14.4 时点的契约为主线源码机制部分以当前实现佐证其设计。变更执行路径一次升级动了哪些代码面发布就绪文档列出五类受影响的执行路径这是理解模型默认值升级牵动范围的关键清单src/config/*默认 frontier 模型契约以及 generator/setup 的回归覆盖src/cli/*Codex agent 默认值、setup-refresh 预期、uninstall/doctor fixtures、explore fallback 提示文案src/team/*、src/hooks/*、src/agents/*展示或校验 frontier 默认值的 runtime / prompt-contract 预期crates/omx-explore/*explore fallback 的默认模型行为文档与模板README.md、docs/*.html、docs/prompt-guidance-contract.md、templates/AGENTS.md——面向用户与生成式指引对齐新默认值同时保留 mini/spark 车道。外加发布 collateralpackage.json、package-lock.json、Cargo.toml、Cargo.lock、CHANGELOG.md、RELEASE_BODY.md与 release notes/readiness 文档。可见提升一个默认模型并不是改一个常量那么简单而是一次跨 TS 配置层、CLI 层、团队运行时、Rust harness、模板与发布元数据的全链路对齐。CHANGELOG 特别强调0.14.4的发布基线与dev候选的关系v0.14.4尚不是dev的祖先提交因此本发布使用v0.14.3作为已验证可达的比较基准compare base并在发布 collateral 中记录该范围限制。验证证据发布就绪门禁与回归套件发布就绪文档给出了明确的验证证据表这是 0.14.4 可以进入 PR/CI 与打标签阶段的前提GateCommandResultTypeScript buildnpm run buildPASSTargeted model/default suitesnode --test dist/agents/__tests__/definitions.test.js dist/agents/__tests__/native-config.test.js dist/team/__tests__/model-contract.test.js dist/utils/__tests__/agents-model-table.test.js dist/cli/__tests__/setup-agents-overwrite.test.jsPASSTargeted executor launch defaultsnode --test --test-name-pattern... dist/team/__tests__/runtime.test.jsPASSScope checkgit diff --name-status v0.14.3..HEAD加 plugin-path grepPASS配套的 docs/release-notes-0.14.4.md 补充了更完整的验证链npm run lint、npm run check:no-unused与cargo test --workspace均已在分支上通过完整npm test在最后一项 executor 推理快速路径调整后有意未重跑——这是对定向回归 已知范围的诚实声明而非疏漏。源码纵深模型解析链与车道路由机制配置解析优先级src/config/models.tsOmX 的模型解析统一收敛到 src/config/models.ts其注释明确给出解析顺序mode-specific default key OMX_DEFAULT_FRONTIER_MODEL DEFAULT_FRONTIER_MODEL。核心函数getMainDefaultModel的实现在当前代码中按OMX_DEFAULT_FRONTIER_MODEL环境变量 →config.toml根model→DEFAULT_FRONTIER_MODEL常量三级回退src/config/models.ts这正是 0.14.4 提升默认常量即可切换 fresh 路径 的机制基础getStandardDefaultModel与getSparkDefaultModel分别维护 standard 与 spark 车道其中 spark 还兼容OMX_SPARK_MODEL旧环境变量src/config/models.ts。配置载体是用户主目录下的.omx-config.json支持env块OMX_DEFAULT_FRONTIER_MODEL/OMX_DEFAULT_STANDARD_MODEL/OMX_DEFAULT_SPARK_MODEL、models块按模式覆盖、agentReasoning与agentModels块按角色覆盖。src/config/tests/models.test.ts 用隔离环境删除全部OMX_*相关环境变量 临时CODEX_HOME系统验证了shell 环境变量优先于.omx-config.json、显式模式配置优先于环境变量、canonicalOMX_DEFAULT_SPARK_MODEL优先于 legacyOMX_SPARK_MODEL等优先级矩阵。Agent 角色模型解析src/agents/native-config.tsOmX 会把角色定义渲染为 Codex 原生 agent TOML写入~/.codex/agents/。src/agents/native-config.ts 的resolveAgentModel展示了角色级模型路由优先级per-agent 显式覆盖agentModels→ 角色精确锁定exactModel→ 按modelClass落入 frontier / fast / standard 车道默认。其中executor特殊地直接解析到 frontier 默认与executor 与 leader 模型保持同步的设计一致getStandardDefaultModel的注释同样说明 standard 子代理默认继承主模型OMX_DEFAULT_STANDARD_MODEL只是可选逃生舱。0.14.4 的回归套件中专门包含definitions、native-config、agents-model-table与setup-agents-overwrite测试正是为了守住这条角色 → 车道 → 默认模型的解析链。团队运行时契约src/team/__tests__/model-contract.test.ts模型契约的核心测试位于 src/team/tests/model-contract.test.ts。该套件验证了 worker 启动参数的分词、规范化与优先级环境显式 继承inherited fallbackmodel_reasoning_effort显式值优先于角色默认推理级别且最终只保留一个 canonical--model与一个model_reasoning_efforttoken。角色默认推理级别的映射explore→low、executor→medium、architect→xhigh见 src/team/tests/model-contract.test.ts 中resolveAgentReasoningEffort用例正是 0.14.4 setup 与 executor 默认推理降为 medium 的测试化表达。resolveTeamWorkerLaunchDiagnostics还会输出modelSourcefallback/inherited/env与reasoningSourcerole-default/explicit/none让 worker 实际使用的模型来源可审计。Explore 降级机制crates/omx-explore/src/main.rsomx explore是 Rust 实现的内置只读检索 harness其双模型降级逻辑位于 crates/omx-explore/src/main.rs先以--model-sparkspark 模型发起codex exec成功即输出失败则记录FallbackEventfrom/to/exit_code/stderr并改用--model-fallbackfrontier 默认重试。0.14.4 中 explore fallback 默认模型随 frontier 车道一同切到gpt-5.5且降级会在 stdout 输出## OMX Explore fallback块与 stderr 事件明确标注成本/行为边界可能不同于低成本 spark 路径。该 harness 还内置了 180s 超时、进程数限制默认 96、输出字节限制默认 8 MiB与命令白名单rg/grep/ls/find/...是低成本的 read-only 检索的工程化保障。配置实操0.14.4 时点的推荐参数0.14.4 的 config seeding 文档与回归覆盖在描述gpt-5.5的同时保留了以下上下文推荐来自 docs/release-notes-0.14.4.mdmodel gpt-5.5 # frontier 默认车道0.14.4 时点 model_context_window 250000 # 上下文窗口推荐值 model_auto_compact_token_limit 200000 # 自动压缩触发阈值推荐值若希望保留旧语义或显式固定车道可依赖环境变量覆盖该机制在 0.14.4 与当前实现中均成立export OMX_DEFAULT_FRONTIER_MODELgpt-5.4 # 显式回退到旧 frontier 默认 export OMX_DEFAULT_STANDARD_MODELgpt-5.4-mini # 固定 standard/mini 车道 export OMX_DEFAULT_SPARK_MODELgpt-5.3-codex-spark # 固定 spark 车道官方兼容性声明docs/release-notes-0.14.4.md确认已存在的gpt-5.4-mini与gpt-5.3-codex-spark覆盖保持原语义只有 fresh/默认的 frontier 管理路径才会优先解析到gpt-5.5。这一默认迁移 显式覆盖不受扰的模型是后续 GPT-5.6 大迁移Sol/Terra/Luna沿用同一套契约结构的前提。已知限制与发布判定发布就绪文档明确记录了两项已知限制CI merge 门禁依赖外部合并门禁仍取决于替换 PR 在 GitHub 上转绿分支范围刻意收窄本分支基于v0.14.3重建刻意排除了无关的 dev/plugin-layout 变更。最终判定为一旦上述验证门禁在本分支通过且 GitHub CI 转绿0.14.4就绪进入 PR/CI 验证与发布 cut。官方给出的后续操作序列是将 hotrelease 合并进main→ 将版本 bump cherry-pick 到dev→ 从合并后的main创建 tagv0.14.4。这份 verdict 文档docs/qa/release-readiness-0.14.4.md本身也是仓库 QA 流程的模板化产物它用 Scope / Changed execution paths / Verification evidence / Known limits / Verdict 五段式结构把改了什么、动了哪里、验证了什么、还剩什么限制、能不能发压缩成可仲裁、可追溯的单页结论与docs/qa/下其他release-readiness-*文档共同构成 OmX 的版本发布质量基线。【免费下载链接】oh-my-codexOmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-codex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
