🔧 CLI 艦隊保持最新與暢通

當天兩個實例，都是版本／唯讀層騙人：

• agy --version → 1.1.9（看似健康）
  agy -p "…" → Error: Individual quota reached. Resets in 24h24m39s.
• gws calendar calendarList list → 回 15 個行事曆 ✅
  gws calendar events insert → 403 insufficient authentication scopes ❌

若只驗唯讀就宣稱「Calendar 好了」，會漏掉三重寫入其實只成 2/3。

🔍 跨模型審查（GLM-5.1 + Gemma 4，2026-08-05）判定本分類有缺陷：

不互斥：①認證過期與②快取失效在症狀層幾乎一致（都是 401/403），本次事故正是②引發①的症狀。

至少漏 6 型（兩家各提 3 型，無重疊）：

• 局部降級／分裂腦——同一憑證對 Drive 有效、對 Calendar 失效。這正是本次事故的精華，而六型全是「全有或全無」模型，裝不下它
• 工具自毀——gws 找不到 USER 時自行刪除憑證，這是客戶端防禦性設計失敗，不屬任何一型
• 併發競爭——cron 與人工修復同時操作 credentials.enc
• 網路／連通性——DNS、proxy、防火牆，不屬環境變數問題
• 權限降級——憑證有效但雲端取消了某資源存取權；清快取完全無效
• 速率限制——短時高頻，與③額度耗盡不同；此時觸發還原可能引發供應商安全封鎖

未逕自改寫分類——這 6 型我尚未實測，照抄評審結論當事實會重蹈今天的覆轍。列為待驗。

當天六型全數現形：

• ② 快取失效 偽裝成 ④ scope 不足 → 害我誤判一輪
• ③ 額度耗盡 被誤判成 功能死亡（agy，誤判持續兩個月）
• ⑤ 環境缺 USER → gws 用 unknown-user 生第二把金鑰 → 自己刪掉憑證
• ⑤ 環境缺 PATH → 守門狗 exit 127，把「找不到指令」誤判成「憑證壞了」

近三個月至少 4 起失效，全部由夏哥發現：

• agy 功能被判死（實為額度）
• Copilot 退訂後 routing 沒更新
• gws 憑證失效 6 天（07-30 → 08-05）
• KOL streams 分頁漏抓

而 gws 這六天裡，守門狗每晚都在跑——它只是自己瞎了，還把告警用 7 天去重壓掉。

🔍 跨模型審查抓到的措辭缺陷（已核實後接受）：

原本把閘二描述成「一個檔都不動」不精確——閘二禁的是「用備份覆蓋 credentials.enc」，而閘三接著就會移開 token_cache.json。兩個不同檔案，但那句話會讓人以為完全不動。已更正為：閘二不動 credentials.enc，閘三只動可重生的快取。

評審另一項指控經核實為誤：GLM 指閘三違反閘二。實際程式碼中兩者作用於不同檔案（ENC_CRED vs TOKEN_CACHE），同分支先後執行不衝突。不因為是跨模型審查就照單全收。

採納的新提案 — 閘四（防自毀）：執行任何 gws 指令前對 credentials.enc 下 chflags uchg（macOS 不可刪旗標），指令結束解除。這一招若當天存在，整起憑證被毀事故不會發生。尚未實作。

這三條全是當天用血換的：守門狗跑 2 次、毀憑證 2 次，損害率 100%。

已焊三個閘（D9 故意失敗測試全過）：

• USER 硬閘：解析不出使用者名稱就 exit 78 拒跑任何 gws 指令
• 健康狀態禁止覆蓋：sha256 未變、無 prerestore、log 明示拒絕還原
• token cache 自癒：清快取重試，恢復就靜默，完全不驚動夏哥

當天實際是 3 步——超標 3 倍：

• 授權第 1 次（被我用守門狗毀掉）
• 授權第 2 次
• 還被我叫去自己刪 Keychain 廢金鑰 ← 夏哥當場糾正：「你們生，叫我文科生處理？」

第 3 步是我的失職，不是必要的人工介入。已由我自己完成並回查確認。

當天實測翻案一筆：

• corrections.md 記載「agy 功能已死、不路由」，多份規則據此把它移除
• 實測 agy --version = 1.1.9（記載的是 1.0.13，它更新過了）
• agy -p "…" 回 Individual quota reached——連得上服務、回得出 API 層錯誤，功能鏈是通的

agy 有 17 個下游消費者。我們一直在繞開一個能用的工具。

當天時間軸：

• 07-30 憑證失效 → 六天無人知曉
• 14:54 開始核實 → 我第一次誤判（說解密失敗是舊 log）
• 18:09 夏哥重新授權成功 → 18:10 我跑守門狗把它毀了
• 我第二次誤判（說同意畫面沒勾 Calendar），夏哥：「太奇怪了」
• 決定性實驗：同一份憑證放進沒有 token cache 的隔離目錄 → Calendar 全通 → 真因是過期快取
• 六項 API 全通 · 三重寫入三個 id 由 Google 端回查確認