信箱大掃除 Mailbox Cleanup

收件匣幾千封的時候，手動點是不可能的。這支用 API 批次分類搬移，並且每一步都回查驗證。

三條硬原則

1. 只搬移不刪除（明確詐騙除外）——分類錯了還救得回，刪掉就沒了
2. 每步用伺服器端計數回查——搬完重新查實際數字，不信本地的成功訊息
3. 垃圾夾預設假定是誤判——實測抽樣 77 封垃圾夾信件，真垃圾只有 1 封

第三條特別重要。多數人的垃圾夾裡塞的是自家系統通知、金流信、學術邀請，整批清掉會出事。

Outlook 不用註冊 app

一般教學都叫你去 Azure 註冊應用程式、設權限、等審核。不用。

用 Microsoft 官方公開的 Graph PowerShell client id 走 device code 流程：你登入一次拿到一小時的 token，對一次整理綽綽有餘。scope 只要 Mail.ReadWrite，而且不要加 offline_access（安全機制會擋）。

八個實測踩坑

最值錢的是第一個：

401 會被當成「收件匣 0 封」靜默跳過。
授權過期時，整支流程會回報「成功，收件匣已清空」——實際上什麼都沒做。呼叫端一定要偵測回應裡的 error 欄位並丟例外。

其他七個包括：batchDelete 權限不足要改用 TRASH 標籤、API 回傳的信件總數估計值不準、$batch 上限 20 請求、Graph API 根本沒有設定垃圾郵件安全寄件者的端點、垃圾過濾在投遞階段執行所以收件匣規則救不了、誤判默默救回會掩蓋規則失效、Google OAuth 在「測試中」狀態下 refresh token 強制 7 天到期。

這包裡有什麼

• SKILL.md — 完整流程、三條原則、八個踩坑、回報格式
• routing-rules.example.json — 分類規則模板（含不動區與垃圾夾白名單）

沒有附現成腳本，這是刻意的：每個人的資料夾結構、標籤體系、寄件者組成都不一樣，硬套別人的腳本只會分類錯。AI 會依這份規格和你的實際信箱現況產生對應的呼叫，重點是流程和判準不會走偏。

需求

Node.js 18+。Outlook 需要登入一次拿 token；Gmail 需要 Gmail API 憑證或官方 CLI。

授權

MIT。