阿里云企业邮箱

要解决什么问题

企业里用阿里企业邮箱做通知、对账或发票流转时，常见痛点是：SMTP/IMAP 参数和「已发送」文件夹名不直观（UTF-7 编码）、退信散落在收件箱里难批量归因、以及主题里写「发票 N 张」却和 ZIP/PDF 数量对不上。本技能用 Python 标准库 smtplib 与 imaplib 封装对接，不引入第三方邮件 SDK。

技能如何工作

• 发信（SMTP）：AliyunEmailClient.send_email() 支持 to/cc/bcc、HTML/纯文本、本地附件与 URL 附件；465 走 SSL（use_ssl=True），25 为明文。
• 读信（IMAP）：list_emails() 可按未读、since_days、日期区间（DD-Mon-YYYY）、主题关键词（如 发票）过滤。
• 退信检查：check_bounced.py 根据 From（mailer-daemon、postmaster）与主题关键词识别退信，并从正文提取原收件人（优先匹配阿里常见句式「无法发送到 xxx@xxx.com」），输出含主题、时间、地址、原因与预览的 CSV。
• 发票附件校验：check_invoices.py 仅处理主题含「X张」的邮件；单张查 PDF，多张解压 ZIP 后按「每票 PDF+OFD+XML」用 文件数 ÷ 3 核对；不一致时发 HTML 告警并附 CSV。

连接参考：smtp.qiye.aliyun.com（465/25）、imap.qiye.aliyun.com（993）；已发送文件夹 IMAP 名为 &XfJT0ZAB-。细节见 references/aliyun_email_config.md。

适用边界与注意点

• 面向 阿里企业邮箱（qiye） 端点与文件夹命名，换邮箱厂商需改配置。
• 退信识别依赖启发式规则，非标准 NDR 格式可能漏检或误报，重要投递建议人工抽检。
• 发票规则绑定主题里的「张数」文案与固定三文件结构，业务表述或打包方式不同需改脚本逻辑。
• 需要定时跑退信/发票检查时，可配合 WorkBuddy 等自动化按日调度上述脚本。