gmail-cleaner

“

一个基于 Web 的图形界面工具，用于清理 Gmail 邮箱。它可以删除邮件、标记为已读、批量取消订阅不需要的邮件列表等。

GitHub地址

https://github.com/Gururagavendra/gmail-cleaner

功能特点

• 批量取消订阅：能够快速找到邮件列表并一键取消订阅。
• 按发件人删除邮件：可以查看哪些发件人发送的邮件最多，并批量删除。
• 批量标记为已读：可以将大量未读邮件批量标记为已读。
• 智能筛选：可以根据邮件的天数、大小、类别（促销、社交、更新）等进行筛选。
• 隐私保护：完全在本地运行，数据不会离开用户的设备。
• 快速处理：使用 Gmail API 和批量请求（每次 API 调用处理 100 封邮件）。
• 熟悉界面：采用类似 Gmail 的界面设计，简洁易用。

使用方法

1. 获取 Google OAuth 凭证

• 需要用户自行创建 Google Cloud 项目并获取 OAuth 凭证。
• 启用 Gmail API 并创建 OAuth 同意屏幕。
• 添加测试用户并下载 credentials.json 文件。

2. 克隆仓库

  

   
  
git clone https://github.com/Gururagavendra/gmail-cleaner.git
cd gmail-cleaner

将 credentials.json 文件放置在项目目录中。

3. 启动应用

• 使用 Docker（推荐）：

       
  
        
       
  docker compose up -d
  

  打开浏览器访问 http://localhost:8766。

• 使用 Python（需要安装 uv）：

       
  
        
       
  uv sync
  uv run python main.py
  

安全与隐私

• 本地运行：所有操作都在本地完成，不涉及外部服务器。
• 开源代码：用户可以自行检查代码。
• 最小权限：仅请求读取和修改权限。
• 用户控制：用户使用自己的 Google OAuth 凭证。
• 敏感文件管理：credentials.json 和 token.json 不会被提交到 Git。