CleanYourMail

开源 · 智能体技能 · 本地应用

清理你的收件箱。
每一步都能撤销。

CleanYourMail 是一个开源的智能体技能，用于清理 IMAP 邮箱，并可选用本地应用。它只读取邮件头，在做出任何更改前先展示方案，保护重要邮件，并给出撤销命令。退订始终单独进行，且不可撤销。

打开技能 下载应用

免费 · MIT · 无需账号 · 无遥测 · 不会永久删除

CleanYourMail · 技能
智能体技能主要产品

把它交给你的智能体。

从以下地址读取 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。不会自动发送任何内容：填写详情，勾选同意声明，然后点击发送。请删除你不想发送的内容，切勿包含密码、令牌或完整的邮件内容。

从方案开始。
在你同意之前，不做任何更改。

免费且开源。无需账号，无遥测，不会永久删除。

打开技能 下载应用