CleanYourMail

開源 · 代理技能 · 本機應用程式

清理你的收件匣。
每一步都能復原。

CleanYourMail 是一個開源代理技能，用於清理 IMAP 信箱，並可選用本機應用程式。它只讀取郵件標頭，在變更任何內容前先顯示計畫，保護重要郵件，並提供復原指令。取消訂閱一律獨立進行，且無法復原。

開啟技能 下載應用程式

免費 · MIT · 不需帳號 · 無遙測 · 不會永久刪除

CleanYourMail · 技能
代理技能主要產品

交給你的 AI 代理。

從以下網址讀取 SKILL.md
https://github.com/jparedesDS/cleanyourmail
並完全遵照執行。
使用 python tools/mail.py。
僅讀取郵件標頭。絕不永久刪除。
在變更任何內容之前，先給我看計畫。
先移動，確認無誤後，再單獨取消訂閱。
給我復原指令。

貼到 Claude Code、Cursor、OpenCode，或任何能存取 shell 的代理中。

技能優先 · 應用程式選用 · CLI 在 GitHub

選擇你的方式

使用技能，或使用應用程式。

技能是主要產品：交給你的程式開發代理，並檢視計畫。應用程式是更簡單的方式，適合偏好按鈕操作的人。CLI 仍為進階使用者保留在 GitHub 上。

技能 · 主要產品

使用技能

交給 Claude Code、Cursor、OpenCode 或其他能存取 shell 的代理。它只讀取郵件標頭，先顯示計畫，並提供復原指令。

開啟技能

或者，貼到 Claude Code、Cursor 或 OpenCode 中。

應用程式 · 早期 MVP

下載應用程式

一款本機、安全的應用程式，適合偏好按鈕操作而非提示詞的人。在同一個畫面中掃描郵件標頭、檢視計畫、執行可還原的移動並復原。不需帳號、無遙測；意見回饋完全自願。

下載 Windows 版

Windows 10/11 · 安裝程式 · 早期 MVP

偏好終端機？CLI 仍保留在 GitHub 上。

運作方式

在你核准計畫之前，不會有任何變更。

  1. 01

    本機連線

    在代理中開啟技能，或使用應用程式。選擇服務商並輸入認證資訊。它會先測試連線，再進行其他操作。

  2. 02

    掃描並檢視

    技能或應用程式只讀取郵件標頭中繼資料：寄件者、主旨、日期、大小和標記。它會顯示分類、受保護郵件、目的地資料夾和取消訂閱目標。此時還不會有任何變更。

  3. 03

    小批量移動

    執行少量移動。日誌會記錄這次執行，復原可將其還原。先檢查結果，再單獨處理取消訂閱。

服務商

支援你的郵件服務商。

無需遷移。你需要 IMAP 存取權限，以及服務商允許的驗證方式。

  • Gmail應用程式密碼 + 兩步驟驗證
  • Outlook / Microsoft 365Microsoft 365：租用戶系統管理員同意
  • Yahoo應用程式密碼
  • iCloud應用程式專用密碼
  • Fastmail應用程式密碼 + Sieve
  • ProtonProton Bridge

任何支援 UIDPLUS 或 MOVE，且能解析垃圾桶、垃圾郵件和封存資料夾的 IMAP 伺服器皆可使用。服務商說明 · 驗證狀態。

服務商名稱和標誌是其各自所有者的商標。

安全

先檢視。移動可復原。

不會永久刪除

沒有永久刪除指令。CleanYourMail 從不清空垃圾桶或垃圾郵件，也從不執行整個信箱的永久清除。

僅讀取郵件標頭

它會讀取寄件者、主旨、日期、大小、標記和取消訂閱標頭，並將這些中繼資料儲存在本機。它從不下載郵件內文或附件。

受保護郵件維持原位

個人、交易、安全、銀行、發票、旅遊、醫療、政府、法律類郵件，以及已加星號、已回覆和近期郵件，都不會被自動移動或提出取消訂閱要求。

檢視、移動、復原

scan、report 和 plan 不會變更任何內容。檢視計畫，先從少量移動開始，並使用日誌和 undo 還原這次執行。取消訂閱是獨立操作，且無法復原。

本機執行：沒有 CleanYourMail 代管服務、不需帳號、無遙測。查看程式碼、安全模型和測試。

常見問題

連線前的常見問題。

它會刪除郵件嗎？

不會。它沒有永久刪除指令，從不清空垃圾桶或垃圾郵件，也從不執行整個信箱的永久清除。移動和封存都會記入日誌；取消訂閱要求無法復原。

它會讀取什麼？

僅讀取郵件標頭：寄件者、主旨、日期、大小、標記和取消訂閱標頭。它從不下載郵件內文或附件。本機快取只儲存中繼資料，不儲存郵件內文。

需要具備技術背景嗎？

應用程式是更簡單的方式。技能是主要產品，需要能存取 shell 的程式開發代理。CLI 適合偏好終端機的開發人員。三者都採用相同的計畫與復原機制。

支援我的郵件服務商嗎？

Gmail、Outlook/Microsoft 365、Yahoo、iCloud、Fastmail、Proton Bridge，以及相容的自訂 IMAP 伺服器。Gmail 需要開啟兩步驟驗證並使用應用程式密碼；Microsoft 365 登入需要租用戶系統管理員同意；個人 Outlook.com 需要已驗證的發行者（待完成）；Proton 需要 Bridge。自訂 IMAP 移動需要 UIDPLUS 或 MOVE。服務商或租用戶原則可能會封鎖存取，本工具不會繞過這些限制。

如果出了問題怎麼辦？

停下來並檢查錯誤。技能、CLI 和應用程式會在執行前重新檢查計畫，並記錄每一次執行。使用輸出的 undo 指令復原該次執行的移動。如果找不到某封郵件，日誌仍會保留，供手動復原。取消訂閱要求無法復原。

真的免費嗎？

是的。採用 MIT 授權，沒有付費方案，不需 CleanYourMail 帳號，也沒有遙測。你需要自備電腦、安裝 Python，並擁有郵件服務商的存取權限。

意見回饋

告訴我們哪裡需要修正。

發現錯誤，或有新的想法？請傳送到 CleanYourMail 的 Discord。不會自動傳送任何內容：填寫詳細資訊、勾選同意聲明，然後按下傳送。請移除你不想送出的內容，切勿包含密碼、權杖或完整的郵件內容。

從計畫開始。
在你同意之前，不做任何變更。

免費且開源。不需帳號、無遙測，也不會永久刪除。

開啟技能 下載應用程式