126 邮箱清理

一款通过 IMAP 清理、备份并优化您网易 126.com 邮箱账户的分步式助手。旨在帮助您回收云存储空间、减少邮箱杂乱，并构建可靠本地归档。

为何使用此技能

• 本地备份：将全部邮件及附件下载至您的本地设备——数据归属您自己，而非云端服务商
• 节省云存储空间：126 免费账户存储空间有限（通常为 3–5 GB）；剥离大体积附件可释放数 GB 空间，避免为高级存储付费
• 收件箱卫生管理：批量删除多年累积的广告、订阅邮件与平台通知，同时保留重要个人邮件
• 安全优先：所有破坏性操作均包含预览、确认与备份步骤——未经您明确批准，不会永久删除任何内容

命令列表

设置 — 分步指南

步骤 1：在 126.com 启用 IMAP 访问

1. 在浏览器中登录 https://mail.126.com
2. 进入 设置 (设置) > POP3/SMTP/IMAP
3. 启用 IMAP/SMTP 服务
4. 生成一个 授权码（授权码）——此非您的登录密码
5. 妥善保存该授权码

步骤 2：配置该技能

按提示提供您的凭据：

MAIL126_ADDRESS=your_email@126.com
MAIL126_AUTH_CODE=your_authorization_code

步骤 3：验证连接

运行 /126mail setup 测试 IMAP 连接。该技能将执行以下操作：

• 连接至 imap.126.com:993（SSL 加密）
• 发送必需的 ID 命令（126 会拒绝未发送该命令的客户端）
• 列出所有文件夹及其邮件数量与总大小

IMAP API 参考文档

126.com 的 IMAP 实现有若干特殊行为。本技能已自动处理这些细节，但为确保透明性，以下为技术参考：

连接要求

文件夹名称编码（Modified UTF-7）

中文文件夹名采用 Modified UTF-7 编码。常见映射如下：

速率限制

关键规则：始终使用 UID，切勿使用序号（Sequence Numbers）

这是最重要的一课。 IMAP 序号会在任意删除操作后发生偏移。例如，若您删除第 5 封邮件，则原第 6 封将变为第 5 封，原第 7 封变为第 6 封，依此类推。在删除后继续使用序号，将导致操作作用于错误的邮件。请务必始终使用 UID FETCH、UID STORE、UID COPY 和 UID SEARCH。

阶段 1：本地备份（/126mail backup）

功能说明

• 从所有文件夹下载全部邮件（含附件）
• 每封邮件保存为 message.eml，并附带一个 _meta.json 元数据文件
• 目录结构为：backup_dir/folder_name/UID_subject/
• 支持中断后恢复 — 进度记录于 _download_progress.json

批处理策略

• 按每批500 封邮件或 4 GB（以先达到者为准）进行下载
• 批次之间暂停，以避免触达 126 的速率限制
• 每处理 20 封邮件即重新建立连接，防止超时
• Socket 超时设为 300 秒，适配大附件传输

用户需做的关键决策

阶段 2：邮件分类（/126mail classify）

功能说明

1. 通过 IMAP 获取全部邮件的元数据（主题、发件人、收件人、日期、大小）——无需下载正文内容
2. 按发件人域名对邮件分组
3. 分类为以下几类：
   • 平台/广告类：LinkedIn、Amazon、PayPal、京东（JD）、淘宝（Taobao）等
   • 金融通知类：银行、券商、支付服务
   • 服务类：云服务、SaaS、旅行预订
   • 个人类：个体发件人、已知联系人
4. 输出 all_emails_meta.json（完整索引）与 email_classification.json

元数据优先策略

• SEARCH 与 ENVELOPE 操作在 126 上不受速率限制
• 可在数分钟内完成 40,000+ 封邮件的索引
• 每条记录均标记 UID，便于后续操作

用户需做的关键决策

阶段 3：批量清理（/126mail cleanup）

功能说明

1. 按类别展示已分类邮件的数量统计
2. 用户审核并确认待删除域名列表（DELETE_DOMAINS）与保留域名列表（KEEP_DOMAINS）
3. 安全防护机制：在从 INBOX 删除前，先将目标邮件复制至暂存文件夹（如“广告邮件”）
4. 通过 UID STORE +FLAGS Deleted + EXPUNGE 从 INBOX 中删除
5. 随机抽样验证（抽查 10 封邮件）

安全删除流程

INBOX 邮件  ──UID COPY──>  广告邮件夹（暂存副本）
     │
     └── UID STORE Deleted + EXPUNGE（从 INBOX 移除）

用户在网页客户端中确认...

广告邮件夹  ──永久删除──>  彻底清除（仅在用户确认后执行）

用户需做的关键决策

常用 DELETE_DOMAINS 示例

linkedin.com, crunchbase.com, amazon.com, jd.com, 
service.taobao.com, airbnb.com, booking.com, uber.com,
ctrip.com, trip.com, godaddy.com, coursera.org,
service.netease.com, insideapple.apple.com,
accounts.google.com, intl.paypal.com, citibank.com,
mail.meituan.com, sf-express.com, ...

常用 KEEP_DOMAINS 示例

svb.com, gusto.com, berkeley.edu, alibaba-inc.com,
live.com, 139.com, pku.edu.cn, ...

请始终允许用户基于自身邮件历史审阅并自定义上述列表。

阶段 4：大附件剥离（/126mail strip）

功能说明（双阶段安全流程）

阶段 A — 仅下载（只读，不修改服务器）

1. 在所有文件夹中搜索大于阈值（默认 50 MB）的邮件
2. 将每封邮件的附件下载至本地备份目录
3. 为每封邮件保存元数据（_meta.json）
4. 进度记录于 _progress.json
5. 每处理 5 封邮件即重新连接，防止超时

阶段 B — 剥离并替换（破坏性操作，需显式确认）

1. 对每封已下载邮件：
   • 获取完整邮件内容（含 FLAGS 与 INTERNALDATE）
   • 从 MIME 结构中移除附件部分
   • 添加提示语：[附件已移除 - 已备份到本地]，含文件列表与原始大小
   • 上传精简后的替代邮件（保留原始标志与时间戳）
   • 删除原始大体积邮件
2. 全程跟踪进度 — 若中断可断点续传

存储空间节省示例

用户需做的关键决策

错误处理

进度追踪

所有操作均将进度保存至 JSON 文件：

• _download_progress.json — 完整备份进度
• _progress.json — 大邮件剥离进度
• cleanup_progress.md — 人类可读摘要

这意味着所有操作均支持断点续传。若网络中断、遭遇速率限制或您关闭了笔记本电脑——只需再次运行对应命令，即可从中断处继续执行。

推荐工作流

1. /126mail setup — 建立连接并验证
2. /126mail status — 查看当前邮箱状态
3. /126mail backup — 执行完整本地备份（若受速率限制，可多次运行）
4. /126mail classify — 索引并分类全部邮件
5. /126mail cleanup — 审核并批量删除广告/订阅类邮件
6. /126mail strip — 通过剥离大附件回收空间
7. /126mail status — 验证最终结果

技术说明

• 基于 Python 3.6+，仅依赖标准库 imaplib 与 email（无需 pip 安装额外依赖）
• 所有 IMAP 操作均使用 SSL（端口 993）
• 自动处理中文文件夹名的 Modified UTF-7 编码
• 每次连接均发送 ID 命令，以满足 126 的强制要求
• 所有文件名均已过滤非法字符
• 重复附件文件名通过追加编号方式处理