跳到主內容

Theme / v0.21.46

Oh My Codex (OMX)

Codex CLI 工作流增強層

基礎觀念

v0.21.39~v0.21.41:GPT-6.1 Terra、Session Pointer Ownership 與自訂 Quality Gates

🔴 進階|掌握 OMX v0.21.39~v0.21.41 patch:v0.21.39 將 GPT-6.1 Terra 納入 known Codex model catalog 並修復 detached session 的 canonical state root、v0.21.40 修復 managed Codex daemon 不當持有 OMX session pointer,以及 v0.21.41 為 deep-interview/Ralplan/code-review 新增 .omx-config.json 可設定的自訂 quality gates。含互動測驗與檢查清單。

概述

OMX 在兩天內連發三個 patch release:v0.21.39(2026-10-28 17:41 UTC)、v0.21.40(2026-10-29 08:02 UTC)、v0.21.41(2026-10-29 19:25 UTC),官方對各版定位皆為 patch release。主軸:v0.21.39 辨識 GPT-6.1 Terra 模型並修復 detached session 的 canonical state root;v0.21.40 修復 managed Codex daemon 的 session pointer ownership;v0.21.41 為 deep-interview、Ralplan 與 code-review 三個 stage 加入可設定的自訂 quality gates。

模型辨識與 detached-session 修復(v0.21.39,2026-10-28)

v0.21.39 官方定位:「a patch release that recognizes GPT-6.1 Terra in the known Codex model catalog and fixes canonical state-root publication for detached session leaders」。

  • GPT-6.1 Terra model recognition(#3933):將 gpt-6.1-terra 加入 known Codex model catalog 與 routing reference。explicit model strings 與既有 model defaults 維持不變——未明確指定 model 的行為不受影響。
  • Canonical detached-session state roots(#3935):把 leader binding 所持有的 canonical state root 記錄進 detached leader state,讓 strict reuse guard 能辨識經 aliased 或 symlinked root 啟動的 session。
  • Test harness reliability:per-file HOME isolation(#3936,避免 caller HOME/USERPROFILE 汙染測試)、VSCode log-write completion synchronization(#3937,log 寫入完成後才 assert VSCode output)、deterministic tmux/team fixture boundaries(#3938)。官方明言無 breaking API changes。

Managed daemon 的 session pointer ownership(v0.21.40,2026-10-29)

v0.21.40 官方定位:「a patch release that fixes OMX session-pointer ownership when a long-lived managed Codex app-server is running and improves tmux shim-log test reliability」。

  • Managed Codex session pointer ownership(#3949,修 #3946):當長時間運行的 managed Codex app-server 存在時,經驗證的 codex app-server --managed-daemon process 不再被 republish 為 OMX session owner,也不再阻塞 omx resume 與 fresh launches。omx session pointer recover 與 doctor 提供可用的 recovery action——可在不停止 daemon 的前提下從已驗證的 managed-daemon owner 恢復。
  • 安全性邊界:live interactive OMX owners 仍受保護;unknown 或 mismatched process identity 一律 fail-closed。此問題由 @nascyimento 回報。
  • tmux shim-log 紀錄保留(#3941):command writes 交錯時保留已完成、無 trailer 的非尾端 shim-log 紀錄,僅捨棄未完成的尾端片段。官方註明這是 test-harness coverage,不是 runtime behavior change。

自訂 quality gates(v0.21.41,2026-10-29)

v0.21.41 官方定位:「a patch release that adds configurable custom quality gates to the deep-interview, Ralplan, and code-review stages」。這是本次跨度中唯一的新功能主軸(#3956,由 @iqdoctor 於 #3955 提出)。

  • 設定方式:透過 .omx-config.json 的 qualityGates 條目,為 deep-interview、ralplan、code-review 三個 stage 加入選用的 skill-based reviewers。
  • 條目格式:字串條目預設為 blocking;物件條目可設定 mode(blocking 或 advisory)與選填的 model。
  • 與內建 review 的關係:gates 是補充(supplement)內建 review,而非取代。advisory verdicts 會被保留但不阻塞流程;blocking 的 Ralplan reject/iterate verdicts 會餵入 revise loop。
  • 失敗語意:unavailable gate 會呈現為 unavailable,而不是被當成 approval——避免 gate 掛掉時誤判為通過。
  • 檢視設定:omx quality-gates list --stage ... 回報 normalized 後的 stage configuration。
隨堂測驗

在 v0.21.41 的 qualityGates 設定中,字串條目與物件條目的預設行為差別是什麼?

💡 想先看個提示?

想想哪一種寫法能同時表達兩種 mode。

隨堂測驗

當 v0.21.41 的 quality gate 無法使用(unavailable)時,系統如何處理?

💡 想先看個提示?

重點是避免 gate 掛掉時被誤判為通過。

升級 v0.21.41:動手檢查清單

逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)

0 / 6