v0.21.7～v0.21.8：Windows 相容、Team 指令檔分離與 Session 匯出 · Oh My Codex (OMX)

概述

OMX v0.21.7（2026-10-01 發布，凍結範圍 49 commits）與 v0.21.8（2026-10-06 發布，凍結範圍 14 commits）是兩個以「正確性與相容性」為主的版本。主軸：

Windows 相容：omx-runtime 二進位路徑的 .exe 後綴、writeAtomic EPERM 處理。
Team 指令分離：worker 指令改寫入 per-worker 檔案，經 OMX_MODEL_INSTRUCTIONS_FILE 傳遞，不再污染 leader 的 AGENTS.md。
Session 管理與匯出：thread 身分解析、detached leader 失敗可診斷，以及本地 session 匯出為 Markdown / JSON。

兩個直接影響 Windows 使用者的修復：

.exe 後綴：平台特定的 .exe 後綴現在正確套用到 omx-runtime 二進位路徑上，解決 Windows 平台上的解析失敗（#3736、#3737）
EPERM 處理：writeAtomic 的 Windows EPERM 錯誤改以 syncRegularFile 正確處理（#3744、#3746）

Plugin skill contract 解析：plugin skill 連結現在在 plugin snapshot context 內正確解析（#3708）
範本驗證：templates/AGENTS.md 納入 cache provenance 檢查，防止快取損壞（#3707）
Hook trust 保留：legacy hook 遷移期間保留 foreign hook trust（#3704）

這是最有架構意義的變更：

Worker 指令分離（#3717、#3718）：Team worker 指令改寫入 per-worker 檔案，經環境變數 OMX_MODEL_INSTRUCTIONS_FILE 傳遞——不再被 commit 進 leader 的 AGENTS.md。leader 的檔案回歸「只描述 leader 自己」。
queued leader notices 在關機後仍安全（#3692）
Team 停用時保留非 Team 指引（#3699、#3700）
omx setup 不再寫入 Codex 已移除的 features.child_agents_md 旗標，並清除既有副本（#3719、#3720）

隨堂測驗

v0.21.7 之後，Team worker 的模型指令存在哪裡？

💡 想先看個提示？

注意「per-worker file」與環境變數這兩個詞。

一連串讓 session 身分與失敗可診斷的修正：

native $ralplan --advisory 在 hook payload 沒有 thread 欄位時，從 session_id 解析 thread 身分（#3721/#3722；v0.21.8 以專屬 readPayloadSessionId helper 改善，#3740/#3741）
identity-indeterminate bindings 區分「符合但未驗證」的 selector（#3725、#3726）
detached leader 失敗附上 stderr 摘要與 exit status（#3723、#3727）
exec follow-ups 在 session-scoped Stop 路徑送達（#3724、#3728）
omx exec --help 不再在有 active owner 時嘗試建立 session（#3731、#3732）
‘ultragoal’ 加入支援的 state read modes（#3733、#3734）

Legacy 備份路徑：以 git rev-parse 支援 legacy v0.21.6 的 AGENTS.md 備份路徑，含 linked worktrees 的 --git-path 絕對路徑解析；優先採 team-state 備份（#3739、#3742）
Session 匯出（#3745，@hiSandog 貢獻）：本地 session 可匯出為 Markdown 或 JSON 格式，供整合與文件 pipeline 使用
非 OMX Codex session 的警告訊息澄清（#3747、#3749）

HUD：hook metadata 原子性寫入；消除閒置 reconciliation 的 CPU 風暴；native fixtures 對齊 authority frames；tmux probe 錯誤正確保留（#3706、#3711）
模型目錄：辨識 GPT-6 Sol 與 Luna 模型（#3701）；gpt-6.1-sol 加入模型目錄（#3716）
其他：通知剝離 OSC terminal escapes（#3694）、quoted TOML 值保留 hash（#3712）、相依套件更新（zod 4.6.5、@biomejs/biome 2.5.14、@types/node 26.6.3、@modelcontextprotocol/sdk 1.30.1）

隨堂測驗

阿榮在 Windows 上升級 OMX 後 runtime 仍無法啟動，團隊建議他直接升到 v0.21.8。哪個修復與他的情境最相關？

💡 想先看個提示？

「二進位找不到」先想路徑，再想權限。

升級 v0.21.8：動手檢查清單

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

0 / 5