oh-my-codex 0.18.14 发布解析：agent/model 路由诊断、Ultragoal 与 Ralplan 加固、HUD/Team 运行时与插件打包的兼容性补丁版

oh-my-codex 0.18.14 发布解析agent/model 路由诊断、Ultragoal 与 Ralplan 加固、HUD/Team 运行时与插件打包的兼容性补丁版【免费下载链接】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-codexOmX是一个围绕 Codex CLI 构建的开源扩展层为 Codex 叠加 hooks、agent 团队、HUD 与状态管理等能力。0.18.14是紧随0.18.13之后的补丁版本patch release在保持既有 CLI、插件、native-agent、HUD、状态、hook、包布局与运行时契约完全兼容的前提下集中收紧 setup、hook、HUD、Team、Ralplan、Autopilot、Ultragoal 与 plugin-bundle 的边界行为。本文以官方发布说明 docs/release-notes-0.18.14.md 为主体骨架结合0.18.14就绪验证记录 docs/qa/release-readiness-0.18.14.md 与仓库源码逐项还原本次发布的技术动因、版本决策依据与可验证的加固细节帮助读者理解一次兼容性保持型补丁发布究竟改了什么、为什么这样改、以及如何从源码层面验证这些改动。发布定位与版本决策0.18.14是一次兼容性保持型的加固补丁。发布说明开篇即明确其定位在0.18.13之后围绕更安全的工作流编排、更清晰的 agent/model 路由诊断、更结实的插件/HUD/Team 行为、以及发布候选卫生进行收敛全程不改变现有 CLI 与包契约见 docs/release-notes-0.18.14.md 第 5 行。就绪记录给出了版本决策的正式理由docs/qa/release-readiness-0.18.14.md选定版本0.18.14被否决版本0.19.0理由发布范围审查未发现任何被移除的活动命令、package bin/engine 破坏、不兼容的公共 schema 或破坏性公共 API 变更当前范围是修复、诊断、文档、附加配置可见性以及兼容性保持的 runtime/hook/setup/plugin/HUD/Team 加固。版本边界上一标签为v0.18.13候选分支为基于origin/dev的release-0.18.14冻结候选提交为c437fcabfix: bundle skill agent tier references (#2912)。发布说明的对比区间为origin/main..origin/dev。同时明确排除了 5 个仍处于打开状态、且相对dev处于BEHIND的 PR#2902、#2856、#2840、#2839、#2838它们被视为待 owner 确认/面向用户的契约持有项而非本次发布阻塞项。版本与 lockfile 同步范围版本号变更覆盖了 npm 与 Cargo 双生态docs/qa/release-readiness-0.18.14.md资产同步内容根package.json/package-lock.json升至0.18.14根Cargo.tomlworkspace 版本及根Cargo.lockomx-api、omx-explore-harness、omx-mux、omx-runtime、omx-runtime-core、omx-sparkshell全部升至0.18.14plugins/oh-my-codex/.codex-plugin/plugin.json同步至0.18.14版本一致性门禁node dist/scripts/check-version-sync.js --tag v0.18.14版本一致性由专门的脚本守卫src/scripts/check-version-sync.ts负责校验根 package、workspace 包与 tag 三者一致防止npm 升了、Cargo 没升之类的漂移。Highlights 全景五条加固主线发布说明的 Highlights 可归纳为五条主线本文后续各节将逐一展开Agent/model 路由更透明新增 per-agent model overrides#2850与 model-routing 启动诊断#2900在不改变默认 operator 契约的前提下让所选角色、tier 与启动参数更容易被检视。规划与目标工作流更安全Ultragoal 架构不变量门#2848、已完成 Codex goal 清理指引显式化#2894、Ralplan 共识门批准与新鲜度检查#2884、转换诊断直接提交6917f59f以及受监督的 Autopilot review 返工阶段直接提交e392a190减少陈旧或歧义的工作流交接。Hooks 与插件打包更结实native hook 空输出成功处理#2874、PreToolUse stdout/schema 行为#2888、#2895、Windows hook 命令包裹规避#2859、dev 插件缓存诊断#2889、插件 AGENTS 策略保留#2877与 bundled skill agent tier 引用#2912。HUD 与 Team 运行时更干净陈旧 Autopilot HUD 报告#2906、狭窄 guard 显示#2896、独立 pane 级 HUD 状态#2861、tmux paste-buffer 清理#2896/#2873、supervisor paste-buffer 处理#2873、worker AGENTS 指引保留#2899与关闭时 HUD pane 归属#2828。Doctor 与 resume 发现更多本地边界场景doctor 检测 root 属主仓库产物#2897resume 搜索发现 madmax 运行历史#2852。Agent/model 路由per-agent 覆盖与启动诊断per-agent model overrides#2850的配置语法模型解析核心位于 src/config/models.ts。.omx-config.json支持的完整格式文件头注释即为此契约文档{ 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 } }其中agentModels就是 #2850 引入的 per-agent model overrides按 agent 名小写、匹配^[a-z0-9][a-z0-9_-]*$覆盖该角色启动时使用的模型。读取逻辑由readAgentModelOverrides/getAgentModelOverridesrc/config/models.ts实现与既有agentReasoningper-agent reasoning effort 覆盖取值low | medium | high | xhigh | max对称。默认模型常量与回退链同样定义于此DEFAULT_FRONTIER_MODEL gpt-5.6-sol、DEFAULT_STANDARD_MODEL gpt-5.6-terra、DEFAULT_SPARK_MODEL gpt-5.6-luna主/默认模型解析链OMX_DEFAULT_FRONTIER_MODEL config.toml 的 model DEFAULT_FRONTIER_MODELgetMainDefaultModelstandard 子 agent 默认继承主模型除非显式配置OMX_DEFAULT_STANDARD_MODELgetStandardDefaultModelspark/低复杂度模型解析链OMX_DEFAULT_SPARK_MODEL OMX_SPARK_MODEL 显式低复杂度 key(s)team_low_complexity / team-low-complexity / teamLowComplexity DEFAULT_SPARK_MODELgetSparkDefaultModelTeam 子模型可用OMX_TEAM_CHILD_MODEL环境变量或配置覆盖最终回退DEFAULT_TEAM_CHILD_MODEL standard 默认。Team worker 启动参数解析与模型路由诊断#2900Team worker 的模型路由核心在 src/team/model-contract.ts。它定义了 worker 启动参数解析、继承与归一化的完整机制parseTeamWorkerLaunchArgs解析OMX_TEAM_WORKER_LAUNCH_ARGS不经 shell 求值的 tokenize 传输语法抽取--model含--model内联形式、-c/--config中的model_provider、model_reasoning_effort、approval_policy、sandbox_mode等 override并分类策略种类none | bypass | direct-policy含mixed-policy分类。collectInheritableTeamWorkerArgs从 leader 参数中抽取可继承项bypass、model provider、reasoning、model传递给 workerresolveTeamWorkerLaunchArgs按优先级合并环境参数与继承参数并归一化resolveTeamWorkerLaunchDiagnostics则输出结构化诊断ResolvedTeamWorkerLaunchDiagnosticsrequestedAgentType、requestedDefaultModel、actualModel、modelSourceenv | inherited | fallback | none、reasoningSourceexplicit | role-default | none、inheritedParentModel与actualLaunchArgs。resolveAgentDefaultModel定义角色默认模型解析链per-agent override *-low后缀走低复杂度模型 agent 定义中的exactModelexecutor用主模型 按modelClassfast | frontier | standard回退。正是这一层请求 vs 实际的结构化对比支撑了 #2900 的 model-routing 启动诊断operator 可以一眼看出某个角色/tier 实际拿到的是环境变量模型、继承的 leader 模型还是回退模型而无需修改任何默认契约。相关测试覆盖见 src/team/tests/model-contract.test.ts。规划与目标工作流加固Ultragoal 架构不变量门#2848与已完成 goal 清理指引#2894Ultragoal 体系新增架构不变量 gate#2848用于在运行时校验 Ultragoal 的架构约束不被破坏同时 #2894 将已完成 Codex goal 的清理行为显式化避免已完成目标残留为歧义状态。相关工作流文档在 #2905 中得到澄清goal 与 skill 工作流指引。这些改动共同服务于同一个目标减少陈旧或歧义的工作流交接。Ultragoal 相关实现可参考 src/ultragoal/。Ralplan 共识门批准与新鲜度检查#2884/#2879RalplanRalph Plan 的规划/发布门体系在本次发布中强化了两处共识门批准检查#2884src/ralplan/下的 runtime-advisory、advisory-contract 与 documented-leader-preflight 等模块负责咨询生命周期#2884 修正了共识门consensus gate在批准与新鲜度freshness两条轴线上的校验防止基于过期/未批准状态做规划决策。可参考 src/ralplan/advisory-contract.ts 与 src/ralplan/runtime.ts。guard 与 HUD phase 权限修正#2879修正 Ralplan guard 及其在 HUD 中的 phase 展示权限归属使 HUD 上展示的 Ralplan phase 与真实 authority 一致。此外直接提交6917f59f为 Ralplan 转换校验器增加了诊断输出Explain Ralplan transition validator diagnostics让规划状态机在转换被拒绝时给出可读的原因。受监督的 Autopilot review 返工阶段直接提交e392a190Autopilot 的 review 流程被重构为受监督的返工rework阶段配合 #2878 修正陈旧 Autopilot stop 状态stale stop state确保 Autopilot 在停止/恢复流程中不把旧状态当作新状态。Autopilot FSM 实现见 src/autopilot/fsm.tscompletion gate 见 src/autopilot/completion-gate.ts。Beads tracker 元数据#2875#2875 允许规划阶段携带 Beads tracker 元数据Allow Beads tracker metadata during planning避免规划产物因额外跟踪字段而被误判为非法。Hooks 与插件打包加固Native hook空输出成功处理与 PreToolUse stdout/schema#2874Keep native hooks successful on null outputnative hook 在输出为null无内容时仍应视为成功而不是被当作失败/异常路径处理。这一点对 hook 生态至关重要——很多 hook 是观测型的不需要返回任何 payload。#2888Fix PreToolUse native hook stdout schema修正 PreToolUse native hook 的 stdout 输出 schema确保 hook 的标准输出格式与 Codex 期望的 schema 一致。#2895Preserve PreToolUse planning guard output保留 PreToolUse 规划 guard 的输出防止 planning guard 产生的提示内容在 hook 链中被吞掉。规划 guard 的 advisory 实现在 src/hooks/native/pre-tool-use-advisory.ts。native hook 的 payload 校验与执行面分别见 src/scripts/hook-payload-guard.ts 与 src/scripts/codex-native-hook.ts、src/scripts/codex-native-pre-post.ts。Windows hook 命令包裹规避#2859#2859Avoid shell-wrapping Windows native hook node避免在 Windows 上对 native hook 的 node 命令做多余的 shell 包裹。shell 包裹在类 Unix 环境下通常无害但在 Windows 上会引入引号转义与命令解析问题本次改为直接执行规避由此带来的 hook 启动失败。插件打包AGENTS 策略保留、dev 缓存诊断、skill tier 引用#2877Preserve plugin AGENTS policy blocks during setupsetup 阶段保留插件自带的 AGENTS 策略块不因安装/镜像流程而被覆盖或丢失。#2889Harden dev plugin cache diagnostics加固 dev 插件缓存的诊断输出让缓存失效/命中问题更容易定位。#2912Bundle skill agent tier references把 bundled skill 中的 agent tier 引用打包进发布产物保证安装后 skill 引用的 tier 名称可解析。相关验证在npm run verify:plugin-bundle验证 29 个 canonical skill 目录与插件元数据见 docs/qa/release-readiness-0.18.14.md。HUD 与 Team 运行时清理HUD陈旧报告、狭窄 guard、pane 级状态与关闭归属HUDHead-Up Display模块集中在 src/hud/本次涉及多项修正#2906Fix HUD stale Autopilot reporting修正 HUD 上 Autopilot 陈旧状态报告避免 HUD 展示已过时的 Autopilot 运行状态。#2896Fix HUD cramped guard and tmux buffer cleanup修复狭窄cramped的 guard 显示并清理 tmux paste-buffer防止残留文本污染下一个渲染周期。#2861Keep standalone pane-scoped HUD stable保持独立非 Team 场景下pane 级 HUD 状态稳定防止 pane 级状态在会话间漂移。#2828Preserve HUD pane ownership on shutdown关闭时保留 HUD pane 的归属关系避免进程退出时把不属于自己的 pane 一并回收。HUD 状态机与 tmux 交互实现在 src/hud/state.ts、src/hud/reconcile.ts 与 src/hud/tmux.ts相关测试见 src/hud/tests/。Teamworker AGENTS 指引保留与 tmux supervisor paste-buffer#2899Preserve AGENTS guidance in Team worker worktreesTeam worker 在独立 worktree 中运行时保留 AGENTS 指引防止 worker 因缺少项目级指引而产生与 leader 不一致的行为。Team 运行时代码见 src/team/runtime.ts。#2873Harden tmux supervisor paste buffers加固 tmux supervisor 的 paste-buffer 处理避免并发 paste 相互覆盖或残留。Doctor 与 resume 发现扩展Doctor 检测 root 属主仓库产物#2897Doctor 现在能检测 root 属主root-owned、属主不匹配owner-mismatch与不可写not-writable三类仓库产物问题。判定逻辑位于 src/cli/doctor.ts第 1520 行if (uid 0) return true;——root 进程视为特权上下文第 1554-1555 行当产物属主为 root 而当前用户非 root 时reason 记为root-owned第 1617 行汇总输出root-owned, owner-mismatched, or non-writable repo artifact(s)问题清单并给出安全修复建议自动修复仅当仓库根属主为当前用户时由omx doctor --force执行。这一检测的价值在于当仓库内混入 root 创建的产物例如在容器或 sudo 环境下生成的文件时普通用户进程无法正常读写doctor 提前暴露该风险而非等到运行时失败。Resume 搜索发现 madmax 运行历史#2852Resume/session 搜索现在能发现 madmax 运行历史。madmax 是 OmX 的--madmax模式对应--dangerously-bypass-approvals-and-sandbox的 bypass 运行见 src/team/model-contract.ts 中MADMAX_FLAG。搜索实现在 src/session-history/search.ts其中第 106 行将来自madmax-run来源的 codex home 标记为madmax:runtime-codex-home标签使 resume 界面能区分 madmax 运行历史与常规会话。相关 CLI 入口见 src/cli/session-search.ts。合并 PR / 提交清单速览0.18.14候选在origin/main..origin/dev区间内的主要合并证据完整清单见 docs/release-notes-0.18.14.md 与 docs/qa/release-readiness-0.18.14.mdPR / 提交主题领域#2912Bundle skill agent tier references插件打包#2906Fix HUD stale Autopilot reportingHUD#2905Clarify goal and skill workflow guidance文档#2900Add model routing launch diagnosticsagent/model 路由#2899Preserve AGENTS guidance in Team worker worktreesTeam#2897Detect root-owned repo artifacts in doctorDoctor#2896Fix HUD cramped guard and tmux buffer cleanupHUD/tmux#2895Preserve PreToolUse planning guard outputHooks#2894Make completed Codex goal cleanup explicitUltragoal#2889Harden dev plugin cache diagnostics插件#2888Fix PreToolUse native hook stdout schemaHooks#2884Fix Ralplan consensus gate approval and freshness checksRalplan#2879Fix Ralplan guard and HUD phase authorityRalplan/HUD#2878Fix stale Autopilot stop stateAutopilot#2877Preserve plugin AGENTS policy blocks during setup插件#2875Allow Beads tracker metadata during planning规划#2874Keep native hooks successful on null outputHooks#2873Harden tmux supervisor paste bufferstmux/Team#2861Keep standalone pane-scoped HUD stableHUD#2859Avoid shell-wrapping Windows native hook nodeHooks/Windows#2852Discover madmax run histories for resume searchSession#2850Add per-agent model overrides配置/路由#2848Add Ultragoal architecture invariant gateUltragoal#2828Preserve HUD pane ownership on shutdownHUD6917f59fExplain Ralplan transition validator diagnosticsRalplane392a190Add supervised Autopilot review rework phaseAutopilot保持打开、被排除的 PR#2902、#2856、#2840、#2839、#2838——均为 basedev、BEHIND状态作为待 owner 确认的契约持有项留在本次候选之外。验证与发布门禁从 release-prep 到最终发布0.18.14的验证分为两层docs/qa/release-readiness-0.18.14.md本地 release-prep 门禁全部 PASSnpm run build— PASSnode dist/scripts/check-version-sync.js --tag v0.18.14— PASSpackage0.18.14 workspace0.18.14 tagv0.18.14npm run verify:native-agents— PASS22 个可安装 native agent、37 个 setup prompt 资产npm run verify:plugin-bundle— PASS29 个 canonical skill 目录与插件元数据node dist/scripts/generate-catalog-docs.js --check— PASScatalog check oknpm pack --dry-run— PASSoh-my-codex-0.18.14.tgz包大小 4.1 MB解包 25.5 MB3072 个文件node dist/cli/omx.js --version— PASSoh-my-codex v0.18.14node dist/cli/omx.js --help— PASSgit diff --check— PASS。发布阶段门禁release-prep 阶段刻意未执行属 owner/最终发布 gate发布候选 PR CI、dev/main promotion CI、tag 触发的 release workflow、GitHub release 证明与 npm 发布证明。整体就绪结论为RELEASE_PREP_READY本地 release-prep 验证全部通过剩余门禁按流程在 PR 合并、dev/main promotion 与发布批准后由 owner 执行。发布交接清单包括发布文档CHANGELOG.md、RELEASE_BODY.md、docs/release-notes-0.18.14.md与本就绪文件、版本/包元数据package.json、package-lock.json、Cargo.toml、Cargo.lock、plugins/oh-my-codex/.codex-plugin/plugin.json以及上述本地 PASS 结果。总结一次不破坏兼容的纵深加固0.18.14的技术画像清晰没有新命令、没有破坏性 schema、没有 API 断裂全部改动落在让既有能力更可观测、更不容易出错的层面。从 per-agent 模型覆盖到 Team worker 启动参数的结构化诊断从 Ultragoal 架构不变量门到 Ralplan 共识门的新鲜度校验从 native hook 空输出成功语义到 Windows 命令包裹规避从 HUD pane 归属到 madmax 历史会话的 resume 发现——每一条改动都可在上述源码路径与测试文件中找到对应实现。对于使用0.18.13及更早版本的用户0.18.14可以直接平滑升级对于集成方本次发布的契约保持承诺意味着既有 CLI/插件/native-agent/HUD/状态/hook/package layout/runtime 集成均无需改动。【免费下载链接】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），仅供参考