跳到主內容

Theme / v0.21.46

Oh My Codex (OMX)

Codex CLI 工作流增強層

基礎觀念

v0.21.12~v0.21.14:完成證據、HUD 穩定性與 Session 時間軸

🟡 中階|掌握 oh-my-codex v0.21.12~14 三個 patch:requires_code_change 任務的 claim-bound 完成證據、HUD reconciliation 的界限與逾時、omx session timeline 的工具執行診斷。含互動測驗與檢查清單。

概述

oh-my-codex 在 2026-10-15 連發三個 patch:v0.21.12 要求 requires_code_change: true 的任務附上綁定 claim 的完成證據;v0.21.13 給 hook 起動的 reconciliation 加上逾時;v0.21.14 新增 omx session timeline 從 transcript 重建執行時間軸。三版官方皆聲明無 CLI/協定/套件佈局的破壞性變更。

Claim-bound 完成證據(v0.21.12,#3797)

標記 requires_code_change: true 的 implementation task,完成時必須:

  1. 在 .omx/evidence/ 下寫入綁定當前 task claim 的報告;
  2. 附上結構化驗證摘要與 evidence marker。

未標記的任務與轉入 failed 的轉移維持原本行為——只有「宣稱改了程式碼」的完成才需要證據。

HUD 可靠性(v0.21.12–13)

  • Watcher repair 界限(#3786):repair child 加上界限,一個掛住的 reconciliation 不再阻塞後續修復。
  • Git branch label 快取(#3791):快取到 HEAD、refs 或 git config 變更為止,HUD 不必每次重查。
  • Hook 起動的 reconciliation 逾時(v0.21.13,#3787 修 #3785):hook spawn 的 reconciliation process 加上 timeout——掛住的 child 不再讓後續 reconciliation 無限等待。

Session 執行時間軸(v0.21.14,#3793)

新指令:

omx session timeline <session-id>

從現役或封存的 transcript 重建:工具執行、turn 邊界與 context compaction。可以過濾排序工具事件、檢視每個工具的 duration、exit code、失敗、未完成呼叫與 per-tool 統計——回答「這個 session 到底把時間花在哪」的問題。

相依套件更新

  • v0.21.12:@modelcontextprotocol/sdk 1.32.0 → 1.32.1(#3794)
  • v0.21.13:serde_json 1.0.151 → 1.0.154(#3795)、@types/node 26.6.4 → 26.6.5(#3796)

隨堂測驗

隨堂測驗

哪一種任務完成時「不需要」附上 claim-bound 證據?

💡 想先看個提示?

原則是「誰宣稱改了程式碼,誰就要附證據」。

動手升級檢查清單

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

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

0 / 3

延伸閱讀