概述

v0.21.9（2026-10-12 發布）是一個修補版 (patch release)，凍結範圍為 v0.21.8..e4653cd8e115f923014be72cf0f7fb6645384246，規模為 10 commits、24 files、+1693/−96。四個主軸：

1. 累計 session token 用量報告 (cumulative session token usage reporting)：新增 omx session usage 指令。
2. 原生 subagent 完成證據 (native subagent completion evidence)：Stop 事件開始記錄可診斷的完成欄位。
3. astra-defaults 即時評測收集器 (live evaluation collector)：新增收集器與腳本，但尚無評測結果。
4. 相依套件更新 (dependency refreshes)：一輪 dependency refresh。

Release notes 明確標示：這是沒有蓄意破壞性 CLI 或 package-layout 變更的修補版。

Session token 用量報告（#3760）

omx session usage 會回報每個本地 Codex session 的最後一組累計 token 計數器，並支援篩選 (filtering)、排序 (sorting) 與 JSON 輸出。

文件見 docs/session-usage.md，由 @hiSandog 撰寫（#3760）。上一課的 session 匯出處理「把 session 內容帶走」，這一版則讓「這個 session 累計用了多少 token」變成可查詢、可進 pipeline 的資料。

原生 subagent 完成證據（#3761，修復 #3729）

原生 subagent 的 Stop 事件現在會在 subagent tracking 中記錄有界的完成證據 (bounded completion evidence)，供 doctor 診斷使用。記錄的欄位為：

• completed_at
• completion_source: "native_stop_event"

Release notes 的 Fixes 段另以一句重申同一件事：「Record typed completion evidence for native subagent Stop events (#3761, fixes #3729)」。completion_source 的值固定為 native_stop_event。

astra-defaults 即時評測收集器（#3764）

這是 #3655 的一部分（#3655 仍為 open）：

• 新增 RunRecord collector
• 新增 collect-astra-defaults 腳本
• 搭配三種設定：GPT-6 Sol 作為 control、GPT-6.1 Sol 作為 candidate、以及 Luna-uniform 設定

相依套件更新與相容性

• libc 0.2.190（#3751）
• @biomejs/biome 2.5.15（#3753）
• @types/node 26.6.4（#3754）
• @modelcontextprotocol/sdk 1.32.0（#3755）
• tar-stream 3.2.2 / @types/tar-stream 3.1.5（#3757）
• #3762 被 #3763 還原 (reverted)，淨變化為零
• 無蓄意破壞性 CLI 或 package-layout 變更

驗證證據：凍結候選版 (frozen candidate) 在 dev CI 全綠；本地 build、typecheck 與完整編譯測試套件 (full compiled test suite) 均已記錄。完整 readiness 證據見 docs/qa/release-readiness-0.21.9.md；可重現範圍記於 artifacts/release-0.21.9/inventory.md。

隨堂總結測驗

動手升級檢查清單

延伸閱讀

• 官方 v0.21.9 release notes
• 上一課：v0217-v0218-windows-team-and-session-export——v0.21.7/v0.21.8 的 Windows 相容、Team 指令檔分離與 Session 匯出
• 版本紀錄：本主題的 Changelog 頁有完整的 v0.21.9 條目