Gmail 自动删除邮件工具

一键批量删除 Gmail 中的垃圾邮件，告别手动删除的烦恼！

中文 | English

功能特点

• 关键词搜索删除 - 自动搜索包含特定关键词的邮件并删除
• 批量处理 - 一次性删除所有匹配的邮件，无需手动翻页
• 配置保存 - 记住你的设置，下次使用更方便
• 自动启动浏览器 - 程序自动打开 Chrome 并连接
• 绿色免安装 - 下载即用，无需复杂配置

效果预览

程序会自动：

1. 打开 Chrome 浏览器
2. 搜索包含关键词的邮件
3. 全选并删除
4. 重复直到没有匹配邮件

下载和使用

方法一：直接下载可执行文件（推荐新手）

1. 从 Releases 页面下载最新版本的 Gmail_Auto_Delete_Tool.zip
2. 解压到任意文件夹
3. 双击 Gmail_Auto_Delete_Tool.exe 运行

重要：_internal 文件夹必须和 .exe 文件放在一起！

方法二：使用 Python 运行

如果你的电脑已安装 Python：

1. 下载本项目（点击绿色 Code 按钮 → Download ZIP）
2. 解压后双击 start.bat 运行

使用教程

第一步：启动程序

双击运行程序，你会看到一个命令行窗口。

第二步：选择环境（如果提示）

程序会自动检测你电脑上的 Python 环境，直接按回车使用默认即可。

第三步：设置 Chrome 路径

程序会自动找到 Chrome 浏览器，确认后按回车。

第四步：设置关键词

程序会显示默认的删除关键词（Google Scholar），你可以：

选项	说明
1	使用当前关键词
2	添加新关键词
3	删除现有关键词
4	重新设置所有关键词
5	只使用部分关键词（本次）

添加关键词时，每输入一个按回车，输入完成后直接按回车（空行）结束。

第五步：确认并开始

确认设置后，程序会自动打开 Chrome 浏览器。

第六步：登录 Gmail

在浏览器中登录你的 Gmail 账户，登录完成后回到程序窗口按回车。

提示：登录过程中可能会打开新标签页，这是正常的，请勿关闭任何标签页。

第七步：自动删除

程序开始自动搜索和删除邮件，你可以看到进度：

搜索关键词: Google Scholar
  → 查找搜索框...
  → 正在搜索...
  ☑ 已全选
  🗑️ 已删除
  第 1 批删除完成

常见问题

Q: 程序提示"无法连接Chrome"怎么办？

请确保：

1. Chrome 浏览器已关闭所有窗口
2. 没有其他程序占用 Chrome

Q: 为什么要用 Chrome 的调试模式？

这是 Selenium 自动化的技术要求，不会影响你的浏览器安全。

Q: 会删除所有邮件吗？

只会删除包含指定关键词的邮件，其他邮件不受影响。

Q: 可以恢复删除的邮件吗？

可以！删除的邮件会进入 Gmail 的"垃圾箱"，30天内可以恢复。

Q: 支持 Mac 或 Linux 吗？

目前只支持 Windows，Mac/Linux 版本可能在未来推出。

高级用法

命令行参数

# 直接指定关键词（跳过交互）
python gmail_auto_delete.py -k "关键词1" "关键词2"

# 使用默认配置，跳过所有提示
python gmail_auto_delete.py -y

# 指定 Chrome 路径
python gmail_auto_delete.py --chrome "C:\path\to\chrome.exe"

# 跳过环境检测
python gmail_auto_delete.py --skip-env-check

配置文件

程序会自动生成 config.json 保存你的设置：

{
  "chrome_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
  "keywords": ["Google Scholar", "Google 学术"],
  "debug_port": 9222
}

文件说明

gmail_auto_delete/
├── gmail_auto_delete.py   # 主程序
├── start.bat              # 快速启动脚本
├── build_exe.bat          # 打包为 EXE
├── config.json            # 配置文件（自动生成）
└── 运行说明.txt           # 中文说明

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License - 可自由使用、修改和分发。