TechSpecs搜尋

Theme / v0.21.4

Oh My Codex (OMX)

Codex CLI 工作流增強層

主題首頁GitHub ↗

Changelog

版本更新紀錄

收錄 Oh My Codex (OMX) 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。

當前記錄版本

v0.21.4

查看上游所有 Release ↗

  1. v0.21.4

    當前版本2026-09-07
    • 版本定位：v0.21.0→v0.21.4，涵蓋四個 patch。主題是 Ralplan Advisory、detached / Team session reliability、macOS arm64 runtime hydration、長 session transcript 保留，以及 v0.21.4 的 Astra default policy。
    • 新增功能：v0.21.1 加入 Ralplan Advisory / Contract A，Planner → Architect → Critic 可以交換 cooperative evidence，但不取得 execution authority、不做全域 suppression，也不自動接手 implementation。這是一個「提供建議證據，但不越權執行」的治理模型。
    • 新增整合：v0.21.2 增加 opt-in GitGuardex HUD review/autofix progress；macOS arm64 global install / reinstall / update 能 hydrate 驗證過的 omx-runtime cache，而且網路失敗採 bounded non-fatal，不會因可選 native runtime 抓不到就讓整個安裝失敗。
    • 行為改變：v0.21.4 在沒有明確 model choice 時，leaders、specialists、standard/fast agents、low-complexity workers、Team children、planning/research roles 與 SparkShell summaries 預設改用 gpt-6-astra。這是 default policy 改變，不是強制 override。
    • 設定優先權：既有 model config、profiles、per-agent override、CLI/environment 選擇、provider-specific names、自訂 instructions 與 reasoning-effort defaults 都維持 authoritative，不會被 Astra default 蓋掉。
    • 長 session / Team 修正：已 terminal projection 直接退休，不再重複 wake Team；detached tmux scrollback 上限 500 → 5000 行並支援 OMX_TMUX_HISTORY_LIMIT，避免長 session 的多行回應過早被丟掉；HUD / pane ownership、cleanup、layout reconciliation 與 contention recovery 也持續加固。
    • Catalog / workflow 調整：agent catalog 只把 active/internal roles 顯示為可直接 invoke，merged / deprecated roles 會顯示替代；主流程對齊 $deep-interview → $ralplan → $ultragoal，$team 維持需要時才用的平行執行工具。
    • 移除 / Breaking Change：v0.21.1～v0.21.4 都是 patch release，官方未宣告新的 breaking CLI / package-layout change；但 v0.21.0 本身已移除大量 deprecated skills 與 MCP state writers。從 0.20.x 升級者仍要先處理 v0.21.0 的 migration。
    • 已知限制：v0.21.4 明確保留 #3623 未修——doctor/setup 仍可能使用 Codex CLI 0.153.4 已移除的 plugin_hooks feature flag 做 inference，造成誤導 diagnostics 或 obsolete config；目前尚未證明 native hooks runtime 本身因此失效。
    • 既有使用者影響：若你已 pin model，升級後模型不會被換掉；若完全依賴 defaults，輸出品質、速度與 token 使用模式可能因 Astra default 而改變，應重新驗證長流程、Team 與 automation。長 session 使用者則建議保留較大的 tmux history 或明確設定 OMX_TMUX_HISTORY_LIMIT。
    • 學習重點 / 建議用法：這版適合用來理解「預設值變更 ≠ 強制設定變更」與「advisory authority ≠ execution authority」。在 agent orchestration 中，清楚區分 recommendation、approval、state mutation 與 execution 權限可大幅降低非預期自動化。
    上游 Release Notes ↗

  2. v0.21.0

    舊版本2026-08-22
    • v0.20.5→v0.21.0：minor release（99 commits、310 files、44 個 referenced PRs），屬 post-epic consolidation train，刻意移除 deprecated skills 與 MCP state writer tools，每項均附明確的 migration error。
    • Removed skills with migration stubs：25 個移除的 skills 透過統一的 sunset-stub resolver 快速報錯，`$ralph` → `$ultragoal`（`omx ralph` CLI 與 ralph persistence runtime 不受影響）、`$ultrawork`/`$ecomode`/`$swarm` → `$team`、`$prometheus-strict` → `$plan`、`$review`/`$security-review` → `$code-review`、`$ask-claude`/`$ask-gemini` → `$ask`、`$deepsearch` → `$analyze`、`$frontend-ui-ux` → `$design`、`$visual-verdict`/`$web-clone` → `$visual-ralph`、`$help` → `$omx-setup`；`$tdd`、`$note`、`$trace`、`$build-fix` 無直接替代（#3506、#3502、#3508）。
    • `omx autopilot` 成為 canonical orchestrator：以 first-class CLI command 還原 `$deep-interview` → `$ralplan` → `$ultragoal` 鏈（#3518、#3517），支援 Ultragoal ordinary/strict modes，ordinary mode 另有 advisory completion cohort gate（#3500、#3505）。
    • 移除 hard workflow gates：workflow transitions 不再需要 host-issued consensus receipt；PreToolUse hooks 改為 advisory-only 並附 Codex App capability warnings（#3492、#3497）。
    • State single source of truth：改採 sole-writer state model，MCP surface 僅供唯讀（`state_write`/`state_clear` 已移除並回傳明確的 deprecation errors）；stale projections 透過 `omx doctor --repair-state` 退役（封存於 `.omx/archive/`），corrupt or laundered carriers 採 fail closed（#3507、#3498）。
    • Session authority 強化：identity-indeterminate pointers 的 read/write authority split、bounded unproven-pointer adoption、verified-dead pointer quarantine，以及 external state roots 的 team worker provenance verification（#3527、#3541、#3528、#3537）。
    • 修正與相容性：macOS 上 detached `--madmax` root identity 改為 path-alias canonical 並鎖定 regression（#3550、#3551）；`omx-runtime` 於 macOS arm64 npm installs 可正確 hydrate 與偵測（#3519、#3520）；URL reader 不再於精確上限處誤判 truncation（#3546）；HUD 相容 Fish `export`（#3480）；guarded split receipts 拒絕 format-string injection（#3489）；version display 優先採用 `OMX_VERSION_REVISION`（#3417）。
    • 升級注意事項（0.20.x）：呼叫已移除 skills 的指令現在會 hard-error 並在訊息中顯示替代名稱；MCP clients 若呼叫 `state_write`/`state_clear` 須改用 CLI 或 programmatic state operations；建議以 `omx doctor --repair-state` 退役 stale 的 0.20.x state projections。
    上游 Release Notes ↗

  3. v0.20.5

    舊版本2026-08-10
    • version 欄位更新為 v0.20.5；此 patch 無刻意 CLI 或套件版面破壞性變更。
    • Highlights：dead session-pointer lock recovery（#3261/#3262，issue #3256）、team startup rollback bound to exact owned panes with split-proof reconciliation（#3265；#3231–3232；issue #3224）。
    • Native hook trust and path canonicalization：exact absolute package CLI status trusted（#3333；issues #3320–3327）、conductor mutation roots 與 macOS policy/fixture paths canonicalized（#3343–3353）。
    • 包含一個 additive、backward-compatible feature：opt-in Herdr lifecycle/status bridge Phase 1（#3241、#3242）。
    • Current status / supersession (ADR 3212)：Local leader attestation 與 adapted role intent 不再授權；consensus 缺少官方 host receipt 時以 documented_host_consensus_receipt_unavailable 關閉。
    • 改善 Windows fsync EPERM、hook mode 與設定讀回的容錯，Doctor 會檢查 native process identity readiness。
    上游 Release Notes ↗

圖例

  • 當前版本　本站現在記錄的版本
  • 舊版本　已被取代，保留作歷史對照
  • 已同步　與上游 release 對齊
  • 僅上游變動　上游 main 有 commit，但未發佈新版