OmX 0.14.4 发布解析：默认前沿模型车道升级至 gpt-5.5 的配置契约、兼容边界与验证实践

OmX 0.14.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标准/mini 车道与gpt-5.3-codex-spark火花车道的精确语义。读者将掌握 OmX 的多层模型默认值解析链、.omx-config.json与环境变量配置入口、推理档位（reasoning effort）的调整方式、上下文窗口种子参数的行为，以及该版本"零迁移、精确保边"的兼容性策略与验证门禁。

一、版本定位：一次针对默认模型契约的补丁发布

0.14.4是继0.14.3之后的补丁发布，其发布说明（见 docs/release-notes-0.14.4.md）将变更收敛在一个非常聚焦的目标上：把默认前沿模型车道从gpt-5.4提升到gpt-5.5，并且是有意（intentionally）保持以下两条车道的原样：

• gpt-5.4-mini标准/mini 车道：语义不变；
• gpt-5.3-codex-spark火花车道：默认值不变。

CHANGELOG 中对同一变更的描述（CHANGELOG.md）进一步确认了这次发布的动作边界："Docs, setup/config guidance, templates, regression coverage, and release metadata are aligned to that contract"——即文档、安装配置引导、模板、回归测试与发布元数据全部围绕这一模型契约对齐。

与通常的大版本发布不同，0.14.4没有引入新功能，而是完成了一次"默认值迁移"：它改写了三处执行路径的默认行为，却没有破坏任何用户已有的显式覆盖。

二、三层模型车道契约：frontier / standard(mini) / spark

OmX 作为 OpenAI Codex CLI 的多智能体编排层（见 package.json 中的项目描述 "Multi-agent orchestration layer for OpenAI Codex CLI"），其模型默认值并非单一值，而是按职责划分为若干"车道"（lane）。0.14.4的发布说明明确规定了三个层次的契约：

这一设计在后续版本中持续沿用：例如0.20.0的发布说明（docs/release-notes-0.20.0.md）仍然沿用model_context_window = 250000/model_auto_compact_token_limit = 200000的种子建议；而当前仓库中 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'。可以推断，0.14.4确立的"前沿车道随发布滚动升级、mini/spark 车道语义独立保留"的策略，是该系列后续版本沿用的一贯做法。

三、默认模型解析链与配置入口：gpt-5.5如何成为新默认

0.14.4的高亮条目提到三类路径都解析到gpt-5.5：运行时默认值、Codex agent 默认值、以及omx explore回退行为。要理解"默认"究竟指什么，需要阅读 src/config/models.ts 中的解析实现。

3.1 配置载体

OmX 的模型配置支持两层载体：

1. .omx-config.json（位于 Codex home 目录），文件头注释给出了完整格式（src/config/models.ts）：

{ "env": { "OMX_DEFAULT_FRONTIER_MODEL": "your-frontier-model", "OMX_DEFAULT_STANDARD_MODEL": "your-standard-model", "OMX_DEFAULT_SPARK_MODEL": "your-spark-model" }, "models": { "default": "o4-mini", "team": "gpt-4.1" }, "agentReasoning": { "architect": "xhigh" }, "agentModels": { "architect": "gpt-5.6-sol" } }

2. Codex 自身的config.toml（根级model字段），通过codexConfigPath()定位读取。

3.2 环境变量入口

src/config/models.ts 定义了四个核心环境变量常量：

• OMX_DEFAULT_FRONTIER_MODEL：前沿模型
• OMX_DEFAULT_STANDARD_MODEL：标准模型
• OMX_DEFAULT_SPARK_MODEL：火花模型
• OMX_SPARK_MODEL：火花模型的兼容别名入口
• OMX_TEAM_CHILD_MODEL：团队子模型

3.3 解析优先级（这是 0.14.4"默认值升级"生效的底层机制）

getMainDefaultModel（src/config/models.ts）的解析链为：

OMX_DEFAULT_FRONTIER_MODEL 环境变量 → .omx-config.json 中 env 块的同名键 → config.toml 根级 model → DEFAULT_FRONTIER_MODEL 编译期常量

getStandardDefaultModel（src/config/models.ts）的解析链为：

OMX_DEFAULT_STANDARD_MODEL → getMainDefaultModel()（即标准车道默认继承前沿车道） → ... 直至 DEFAULT_FRONTIER_MODEL

getModelForMode(mode)（src/config/models.ts）为按模式解析：

models.<mode> 模式专属覆盖 → models.default 键 → getMainDefaultModel()

getSparkDefaultModel（src/config/models.ts）的解析链为：

OMX_DEFAULT_SPARK_MODEL > OMX_SPARK_MODEL → models.team_low_complexity（或别名键 team-low-complexity / teamLowComplexity） → DEFAULT_SPARK_MODEL

正是这套"用户显式配置 > 环境变量 > Codex 配置 > 编译期默认常量"的降级链，保证了0.14.4将DEFAULT_FRONTIER_MODEL从gpt-5.4改为gpt-5.5后：凡是未显式配置前沿模型的"新鲜/默认托管配置路径"全部自动转向gpt-5.5，而所有已存在的显式覆盖不受影响——这也正是发布说明"Compatibility"一节所声明的行为。

四、推理档位调整：setup 与 executor worker 从 high 降为 medium

0.14.4的第二项行为变更体现在推理档位（reasoning effort）上：

• Setup：生成配置时的默认推理档位由high调整为medium；
• Executor worker：启动默认值同步调整为medium。

在源码中，推理档位是一套受约束的枚举集合。src/config/models.ts 定义了：

• 全局（root）支持的档位：low、medium、high、xhigh；
• 每 agent 支持的档位：low、medium、high、xhigh、max；
• 明确不支持的档位：max、ultra（仅限 root 诊断场景，会被归一化与告警）。

在配置生成器 src/config/generator.ts 中，生成的 setup 配置包含model_reasoning_effort = "medium"，与发布说明中"Setup and setup and executor worker reasoning defaults now use medium instead of high"的描述一致。该生成器的排序逻辑（src/config/generator.ts）将model_reasoning_effort视为 OmX 托管的顶层键之一，与notify、developer_instructions一起参与配置的生成与维护。

对使用者而言，这一变更意味着：全新安装执行omx setup后，默认的模型推理强度会低于上一个补丁版本；若希望恢复更强推理，可通过.omx-config.json的agentReasoning块按角色覆盖（如"architect": "xhigh"），或直接修改生成的model_reasoning_effort值。

五、上下文窗口种子参数：250000 / 200000 建议值保持不变

发布说明特别强调，gpt-5.5的文档与回归覆盖沿用了既有推荐值：

• model_context_window = 250000
• model_auto_compact_token_limit = 200000

这两个数值在 src/config/generator.ts 中作为种子常量出现（LEGACY_SEEDED_MODEL_CONTEXT_WINDOW、LEGACY_SEEDED_MODEL_AUTO_COMPACT_TOKEN_LIMIT），并在多个测试中验证了其"只在缺失时写入"的语义：

• src/cli/tests/setup-refresh.test.ts 验证刷新后的托管配置包含model_context_window = 250000，同时通过assert.doesNotMatch验证用户已有的上下文键不会被重复覆盖；
• src/cli/tests/doctor-context-window-warning.test.ts 展示了omx doctor对上下文窗口配置的诊断逻辑，包括对"种子标记块内被用户改动"（如将值改为250001或999）的识别——种子块使用# oh-my-codex seeded behavioral defaults标记，以便在用户未修改时于卸载流程中被精确移除。

这意味着0.14.4升级前沿模型时刻意保持了上下文窗口建议值不变：用户无需因为模型切换而调整自己的 context 配置。

六、omx explore回退模型行为

发布说明指出omx explore的回退行为也解析到gpt-5.5。对应的 Rust 实现位于 crates/omx-explore/src/main.rs：

• 命令行参数中定义了可选的--model-fallback（crates/omx-explore/src/main.rs），用于指定回退模型；
• 当 spark 尝试失败时，会发出FallbackEvent并调用invoke_codex携带回退模型重试（crates/omx-explore/src/main.rs）；
• 测试用例（crates/omx-explore/src/main.rs）验证了参数解析后spark_model与fallback_model的取值绑定。

可以推断，0.14.4将 explore 的默认回退模型常量随前沿车道一并从gpt-5.4更新为gpt-5.5，使 explore 场景与运行时、agent 默认值保持一致；显式传入--model-fallback的用户配置仍优先。

七、兼容性边界：为什么"无需用户迁移"

发布说明的 Compatibility 一节给出了三条明确承诺：

1. No user migration is required—— 不需要任何手工迁移步骤；
2. Existinggpt-5.4-miniandgpt-5.3-codex-sparkoverrides keep their current semantics—— 已存在的显式覆盖语义不变；
3. Fresh/default frontier-managed config paths now prefergpt-5.5—— 只有"新鲜配置/默认托管"路径才切换到gpt-5.5。

这与 src/config/models.ts 的解析链完全自洽：显式覆盖位于解析链最前端，永远优先于编译期默认常量。因此这次升级本质上是一次"低水位默认值"的替换，对存量用户零侵入。

八、验证门禁与发布证据

发布说明列出了该版本的验证矩阵：

完整证据记录在 docs/qa/release-readiness-0.14.4.md，其中还补充了发布准备度评审的细节：

• 发布基线与范围：以v0.14.3为比较基线，候选分支为hotrelease/0.14.4-gpt55；
• 定向模型/默认值套件包含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.js；
• 已知限制：CI 合并门禁仍依赖替换 PR 在 GitHub 上转绿；该分支从v0.14.3重建，刻意排除了无关的 dev/plugin-layout 变更。

值得注意的一个细节是：发布说明诚实地声明"Fullnpm testwas intentionally not rerun after the final fast-path executor reasoning tweak"——即最终一次执行器推理微调之后并未重跑全量测试，而是以定向套件兜底。这种对验证边界的透明披露，是评估该补丁版本可信度的重要依据。

九、后续演进：同一机制的延续

0.14.4确立的"前沿车道滚动升级"模式在后续版本中持续生效。当前仓库中：

• src/config/models.ts 的默认常量已推进为gpt-5.6-sol（frontier）、gpt-5.6-terra（standard）、gpt-5.6-luna（spark）；
• README.md 中注明"fresh OMX-managedgpt-5.6-solconfig seeding now recommendsmodel_context_window = 250000andmodel_auto_compact_token_limit = 200000, but only when those keys are missing"，与0.14.4的种子语义一脉相承；
• docs/release-notes-0.20.0.md 同样保留"250000 / 200000"的种子建议。

对希望固定模型的用户而言，最稳妥的实践始终是：在.omx-config.json的models块或环境变量中显式声明目标模型，而不是依赖随版本滚动的默认值——这正是0.14.4兼容性设计想要传达的核心信息。

【免费下载链接】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