概述
OMC v5.7.0(2026-10-12 發布,單一 release)的官方統計是 59 個已合併 PR、4 個新功能、45 個 bug fix、9 個其他變更。它是一個「小版本號、大修補量」的 release:
- HUD 補上 Claude Code 的執行資訊:effort level 與更穩定的 todo 呈現。
- Skill 的敘述與護欄收緊,並新增 session flow 地圖。
- shipyard 詞彙表欄位改名:
CONTEXT.md→GLOSSARY.md。 - 一批權限、快取與終端輸出的強健性修補,多數由 @rudycelekli 貢獻。
隨堂測驗
v5.7.0 的官方 PR 統計中,bug fix 有幾項?
💡 想先看個提示?
PR 總數、新功能數、修正數是三個不同的數字。
官方 release notes 的統計是「59 PRs merged | 4 new features | 45 bug fixes | 0 security/hardening improvements | 9 other changes」。59 是 PR 總數,4 是新功能,45 才是 bug fix。
一、HUD:顯示 Claude Code 的 effort level
- 顯示 effort level(#4249,@bengry):HUD 現在顯示 Claude Code 的 effort level。
- 從 TaskCreate/TaskUpdate 渲染 todos(#4243):HUD 的 todo 不再漏掉以這兩個工具建立的任務。
- 完成任務歷史設上限(#4303):保留 active 任務的同時,為已完成任務的歷史設下界線。
- ANSI 截斷改以可見文字計算(#4306):截斷與切片改以實際可見的文字為準;ANSI CSI 控制序列的測量支援 private 與 colon 參數(#4287)。
- 自訂 rate provider:診斷 stderr 會被排空(#4302),快取改以指令與期間為鍵(#4304)。
- 目錄 hyperlink 與檔名:編碼目錄 hyperlink、轉義檔名中的控制字元(#4305)。
- transcript context 使用量:保持在完整的 frame 內(#4292)。
二、Skill:敘述收緊、護欄與 session flow 地圖
- 收緊 skill 敘述與 prompt 護欄(#4271,@pangpang778):skill 的文字與 prompt guardrail 一併收緊——這是把「skill 寫得短而準」變成 repo 內的一致性要求,而不是個別 skill 的風格問題。
- 新增 session flow 地圖(#4319):給 agent 一張 session 內流程的地圖。
- shipyard 詞彙表改名(#4273,@pangpang778):shipyard glossary 的欄位由
CONTEXT.md改名為GLOSSARY.md。 - chain artifact 精簡(#4274,@pangpang778):shipyard 的 chain artifact 收斂為 tracker issue 與延遲浮現的介面(lazy surfaces)。
三、權限與安全強健性
- 限制 permission 自動核准的範圍(#4283):自動核准的適用範圍收斂,過去被自動放行的操作可能需要重新確認。
- 不持久化工具失敗中的秘密(#4284):工具失敗時不再把秘密寫進狀態。
- SSRF 防護(#4288):改為拒絕完整的 IPv6 local range。
- 輸入與設定解析:保留 JSONC 的註解 token 邊界(#4285)、拒絕沒有 JSON 表示的 payload(#4286)、保留帶有衝突分隔符文字的自訂筆記(#4289)。
- 通知與整合:JSON webhook 模板中的數值改為轉義(#4295)、忽略繼承而來的模板變數屬性(#4300)、驗證自訂整合設定的形狀(#4301)、reply 注入前先正規化 carriage return(#4308)、Telegram proxy exclusions 尊重埠(#4311)。
四、Team、hooks 與 worktree
- Team shutdown(#4247):start CLI 已退出時保留 active reservation,不再提前釋放。
- detached team session 建立(#4253):修正
-F格式被#轉義而導致的失敗。 - ralph hardMaxIterations(#4257):在 Stop hook 腳本中確實生效。
- worktree 路徑(#4255):接受位於 repo 子目錄的 Windows session cwd。
- antigravity(#4259):允許 Windows headless,並把 prompt 以單一 argv 傳遞。
- 暫存目錄(#4268):
/tmp/omc-jev-*用完即清;jev sweep 的擁有權與每小時鎖改為硬化的實作(#4320)。 - 其他:omc-doctor 保留 settings 中的自訂 hooks(#4281)、AFK links 的使用者設定改為 opt-in(#4282)、wiki-session-end 改匯入精簡的前景 bootstrap 讓 SessionEnd hook 維持在 300 ms 預算內(#4246)、cmux team 的擁有權驗證涵蓋 tmux 相容與 ref/UUID 不符(#4262)、為原生 Windows 產生對應 shell 的 tmux 防護條件(#4269)。
五、快取、版本管理與環境解析
- 孤兒版本目錄(#4265):不再被選用。
- active 重導目標不可用時(#4298):保留版本,而不是把可用版本一起丟掉。
- 佔用紀錄讀不到時(#4299):fail-closed。
- 版本管理器的 Node 安裝(#4293):跳過不完整的安裝。
- 本機 LSP 檔案 URI(#4313):以原生路徑解析。
- session 搜尋輸出(#4307):轉義 transcript 的控制字元。
- team usage:依 Unicode 字元計數(#4310)、跳過無效紀錄(#4315);pane 只在確認配額恢復後才 resume(#4316);PostToolUseFailure 的鎖工作設上限(#4322)。
六、安裝與升級:兩條獨立軌道
官方明言 CLI/runtime 與 Claude Code plugin 是兩條獨立的安裝軌道,不是二選一;兩者都裝就兩者都更新,而依賴 CLI 的 skill 路徑(例如 ask 與 CLI-backed team)需要 npm 套件提供的 omc CLI。
# CLI / runtime
npm install -g oh-my-claude-sisyphus@5.7.0
# Claude Code plugin
/plugin marketplace update omc
隨堂總結測驗
隨堂測驗
你的團隊用 shipyard 流程,升級到 v5.7.0 後 agent 說找不到詞彙表。最可能的原因是什麼?
💡 想先看個提示?
這題的答案是「改名」,不是「拿掉」。
#4273 的標題就是「rename shipyard glossary slot CONTEXT.md to GLOSSARY.md」——舊檔名不再被視為詞彙表欄位,既有的 CONTEXT.md 與指向它的引用都要一起調整。
動手升級檢查清單
升級 v5.7.0:動手檢查清單
逐項勾選,確認你已完成升級必要的步驟(進度會保存在此瀏覽器)
全部完成!你已就緒 v5.7.0 的所有新功能。可清除勾選重新練習。
延伸閱讀
- 官方 v5.7.0 release notes
- 官方 changelog:v5.6.2…v5.7.0
- 上一課:
v560-v562-factory-ralph-windows——Software Factory 閉環、ralph verify/afk/map 與 Windows 修復潮 - 版本紀錄:本主題的 Changelog 頁有完整的 v5.7.0 條目