跳到主內容

Theme / v0.21.46

Oh My Codex (OMX)

Codex CLI 工作流增強層

基礎觀念

v0.21.44:原生執行階段載入(Native Runtime Hydration)可重試修復

說明 OMX v0.21.44 如何修正原生執行階段載入 (native runtime hydration) 的逾時/中止路徑 (timeout/abort path):延長 postinstall timeout、加入前景重試指令、改善診斷資訊,並釐清 omx doctor 建議的適用狀態與修復範圍。

概述

v0.21.44 於 2026-10-31 12:15:10 UTC 發布(台灣時間 20:15)。官方主題句為:“0.21.44 is a small patch release that corrects native process identity recovery guidance in omx doctor.” 官方並明言:“No breaking API changes.”

這是 v0.21.43 doctor 指引修正的後續:前版調整原生程序身分 (native process identity) 修復指引;v0.21.44 則修正 native runtime hydration 的 timeout/abort 路徑,並提供可執行的前景重試方式(#3977;issue #3968)。與 release 綁定的中繼資料 (release-coupled metadata) 同步由 #3976 處理。

Timeout 路徑:延長等待並回報底層錯誤

  • 安裝後 (postinstall) hydration timeout 從 15 秒延長至 120 秒。
  • 發生 timeout 時,回報 timeout 與底層錯誤資訊,並遮蔽診斷 URL。
  • Native asset hydration 診斷提供經清理的 manifest/archive URL,以及底層 fetch/read 錯誤。

這讓 timeout 與讀取失敗的診斷包含更多底層資訊;URL 仍會經清理,不應將其解讀為輸出完整診斷 URL。

前景重試指令與 doctor 提示

新增前景重試指令:

omx native-runtime hydrate

當 omx doctor 遇到指定的不支援 (unsupported) Process identity readiness(程序身分就緒)狀態時,會建議使用這個指令。這項建議有特定觸發狀態,不代表所有 provider identity provider unavailable 情況都能由本版消除。

既有使用者影響

  • postinstall hydration 可等待至 120 秒,而非原本的 15 秒;timeout 會提供底層錯誤資訊並遮蔽診斷 URL。
  • 遇到指定的 unsupported Process identity readiness 狀態時,可依 omx doctor 建議執行 omx native-runtime hydrate 前景重試。
  • 官方明言無 breaking API changes;此修正不宣稱處理其他無關的 provider identity provider unavailable 原因。
隨堂測驗

v0.21.44 的 `omx doctor` 會在何種情況建議執行 `omx native-runtime hydrate`?

💡 想先看個提示?

注意問題問的是 doctor 提示的指定 readiness 狀態。

動手升級檢查清單

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

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

0 / 4

延伸閱讀

  • 官方 v0.21.44 release notes
  • 前一課:v02142-v02143-readonly-status-goal-reconciliation——唯讀狀態檢查與 native process identity doctor 指引