OmX 0.14.4 发布就绪评估：默认 Frontier 模型车道从 gpt-5.4 升级至 gpt-5.5 的契约迁移实践

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-codex

oh-my-codex（OmX）在0.14.4补丁版本中完成了一次典型的"模型契约"升级：将默认 frontier 车道从gpt-5.4提升到gpt-5.5，同时严格保留gpt-5.4-mini（standard/mini 车道）与gpt-5.3-codex-spark（spark 车道）的精确匹配语义。本文基于仓库内的发布就绪评估文档 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.5；
• Mini 与 Spark 车道保持精确匹配：gpt-5.4-mini与gpt-5.3-codex-spark的语义不变，prompt 指引与测试仍强制 exact-match；
• Setup/配置文案对齐：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）：

这三条车道在 src/agents/definitions.ts 的AgentDefinition中对应modelClass: 'frontier' | 'standard' | 'fast'，角色通过posture（frontier-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 时点的契约为主线，源码机制部分以当前实现佐证其设计。

变更执行路径：一次升级动了哪些代码面

发布就绪文档列出五类受影响的执行路径，这是理解"模型默认值升级"牵动范围的关键清单：

1. src/config/*：默认 frontier 模型契约，以及 generator/setup 的回归覆盖；
2. src/cli/*：Codex agent 默认值、setup-refresh 预期、uninstall/doctor fixtures、explore fallback 提示文案；
3. src/team/*、src/hooks/*、src/agents/*：展示或校验 frontier 默认值的 runtime / prompt-contract 预期；
4. crates/omx-explore/*：explore fallback 的默认模型行为；
5. 文档与模板：README.md、docs/*.html、docs/prompt-guidance-contract.md、templates/AGENTS.md——面向用户与生成式指引对齐新默认值，同时保留 mini/spark 车道。

外加发布 collateral：package.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 与打标签阶段的前提：

配套的 docs/release-notes-0.14.4.md 补充了更完整的验证链：npm run lint、npm run check:no-unused与cargo test --workspace均已在分支上通过；完整npm test在最后一项 executor 推理快速路径调整后有意未重跑——这是对"定向回归 + 已知范围"的诚实声明，而非疏漏。

源码纵深：模型解析链与车道路由机制

配置解析优先级（src/config/models.ts）

OmX 的模型解析统一收敛到 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.ts）

OmX 会把角色定义渲染为 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）> fallback；model_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还会输出modelSource（fallback/inherited/env）与reasoningSource（role-default/explicit/none），让 worker 实际使用的模型来源可审计。

Explore 降级机制（crates/omx-explore/src/main.rs）

omx explore是 Rust 实现的内置只读检索 harness，其双模型降级逻辑位于 crates/omx-explore/src/main.rs：先以--model-spark（spark 模型）发起codex exec，成功即输出；失败则记录FallbackEvent（from/to/exit_code/stderr）并改用--model-fallback（frontier 默认）重试。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.md）：

model = "gpt-5.5" # frontier 默认车道（0.14.4 时点） model_context_window = 250000 # 上下文窗口推荐值 model_auto_compact_token_limit = 200000 # 自动压缩触发阈值推荐值

若希望保留旧语义或显式固定车道，可依赖环境变量覆盖（该机制在 0.14.4 与当前实现中均成立）：

export OMX_DEFAULT_FRONTIER_MODEL="gpt-5.4" # 显式回退到旧 frontier 默认 export OMX_DEFAULT_STANDARD_MODEL="gpt-5.4-mini" # 固定 standard/mini 车道 export OMX_DEFAULT_SPARK_MODEL="gpt-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