Gmail Cleaner 是一款基于 Gmail API 的批量邮件管理工具，专为需要高效清理和整理 Gmail 收件箱的用户设计。它通过自动化脚本实现大规模邮件操作，支持对数千封邮件进行快速分类、删除或归档，显著提升邮箱管理效率。该工具采用 OAuth2.0 认证机制，确保用户数据的安全访问，并允许通过配置文件灵活定义清理规则。无论是个人用户还是多账户管理者，Gmail Cleaner 都能提供稳定可靠的批量处理能力，避免手动逐条操作的繁琐与遗漏。
工具的核心优势在于其模块化工作流程：从首次授权获取访问权限，到扫描收件箱识别垃圾或促销邮件，再到执行批量删除或深度整理，每一步都经过精心设计以适配不同需求。所有操作均可在本地安全运行，无需依赖第三方云服务，保护隐私的同时也降低了使用门槛。此外，Gmail Cleaner 支持多种清理策略组合，包括按发件人、类别、时间范围等条件精准定位目标邮件，极大增强了操作的灵活性和可控性。
值得一提的是，该工具不仅适用于常规清理任务，还能应对突发性误删后的紧急恢复场景。例如，当重要邮件被错误归类至垃圾箱或被批量清理时，可通过 restore.py 脚本迅速将其还原并重新标记标签。这种双向管理能力使得 Gmail Cleaner 成为一个集预防、维护与修复于一体的全面解决方案，特别适合长期积累大量邮件、亟需系统化管理的企业用户或重度邮箱使用者。
核心功能特点
- 支持通过 Gmail API 批量处理高达 1000 封邮件/次调用，大幅提升清理效率
- 提供扫描功能，可统计收件箱各分类邮件数量及前 40 大高频发件人，辅助决策
- 支持按发件人、搜索查询（如 category:promotions）、JSON 配置等多种方式批量删除或归档邮件
- 内置深度清理流程，一键完成清理促销邮件、归档旧邮件、标记已读、清空垃圾箱四步操作
- 具备邮件恢复功能，可从垃圾箱中抢救被误删的重要邮件并自动应用标签
- 支持创建 Gmail 过滤器与自定义标签体系，实现长期自动化邮件组织
适用场景
Gmail Cleaner 最典型的应用场景是定期维护个人或工作邮箱，尤其是那些因长期未整理而堆积大量促销、广告或低优先级邮件的用户。例如，电商订阅、新闻简报、社交媒体通知等来源的邮件往往占据收件箱空间，影响关键信息的检索效率。借助该工具，用户可设定每周自动清理“促销类”邮件超过 30 天的内容，或将特定营销域名下的邮件直接移至垃圾箱，从而保持收件箱清爽有序。
对于拥有多个 Gmail 账户（如个人账户与工作账户）的管理者而言，Gmail Cleaner 的多账户支持特性尤为实用。只需为每个账户配置独立的 token 文件，即可并行执行扫描、清理或深度整理任务，避免账号混淆或操作冲突。此外，企业 IT 管理员也可利用其批量处理能力，协助员工统一清理公司邮箱中的冗余信息，符合内部数据管理规范。
另一个高频使用场景是应对误操作后的紧急恢复。假设某次批量清理中不慎将重要邮件包含在内，此时 restore.py 脚本能快速从垃圾箱中筛选指定发件人或关键词匹配的邮件，并将其还原至原始位置同时附加标签，极大降低数据丢失风险。这种容错机制让日常维护更加安心，尤其适合不熟悉高级搜索语法的普通用户。