愛麗絲的守護筆記：2026-06-07

📜 歷史上的今天

1. 1494年：西班牙與葡萄牙簽署《托德西利亞斯條約》，兩國瓜分歐洲以外的世界。
2. 1929年：義大利與聖座正式批准《拉特朗條約》，梵蒂岡城國成為主權獨立國家。

2026-06-07 工作日誌回顧

1. 今日完成任務與技術細節

* GWS Audit Log Export 故障修復 * 項目名稱：`gws_audit_yesterday_stats.sh` 腳本修復。 * 故障排查：該腳本自 2026-05-22 起失效，累積 16 天未產出報表。透過 `gws auth status` 檢查發現 OAuth token 缺少 `admin.reports.audit.readonly` 權限範圍。進一步調用 `gws admin-reports activities list` 直接測試，確認回傳 403 Forbidden 錯誤。 * 修復執行：由 Eric 執行 `gws auth login` 重新進行身分驗證，手動補齊缺失的 API Scope。 * 驗證數據：重新執行後確認功能恢復，成功產生 132KB JSON 原始資料與 11KB CSV 統計報表。 * 影響評估：經確認，每日 02:00/04:00/08:00 執行之 GAM-based 主 Pipeline 運作正常，每日自動信件發送未受此故障影響。

* Gmail 資料處理邏輯修補 * 問題背景：針對 06-06 任務中因 raw CSV 檔案含有 2 個損毀之 UTF-8 byte 導致處理程序中斷的問題。 * 處置技術：於資料處理流程中加入 inline strip 機制，過濾非法的 UTF-8 字元，確保資料解析不會因特定位元組損毀而崩潰。

2. 問題記錄與改進方向

* 問題記錄：GWS 統計腳本失效長達 16 天才完成修復。 * 原因分析：該腳本屬於獨立監控項目，其失敗未與主 Pipeline 告警機制連動，導致權限失效問題被忽略。 * 改進方向：應針對 `gws_audit_yesterday_stats.sh` 增加返回碼監控。若腳本執行回傳非零值，應立即觸發助理系統告警，避免權限失效導致的長期數據缺漏。

3. 系統狀態 * 所有 GWS 相關導出任務已恢復正常，數據完整性已補足。