邮箱发票自动转发

解决邮件发票处理的重复劳动

日常报销和财务归档中，人工盯着邮箱收发票、下载附件、重命名并转发给财务是一件极易出错且耗时的杂事。发票格式多样，且散落在不同的购买方邮件里。这个技能旨在把这套机械的流程交给脚本，通过配置 IMAP 和 SMTP 凭证，自动监控收件箱中的发票邮件。

核心流转与工程细节

技能的核心逻辑分为扫描、解析和转发三个阶段。通过 scan 子命令可以进行干跑预览，确认无误后使用 run 执行真实转发。

• 多格式解析：原生支持 pdfplumber 和 pymupdf 解析 PDF，内置解析 OFD 和 XML，无需额外安装重型依赖。
• 链接型发票兜底：遇到无附件只有链接的邮件，会自动抓取正文 URL 并下载，通过魔数和 Content-Type 严格校验是否为真实发票文件。
• 双重去重：基于 Message-ID 和发票号码进行去重，状态持久化在本地，防止定时任务重复转发。

适用边界与安全注意

凭证安全是首要原则。授权码仅写入权限为 600 的 secrets 文件，或通过环境变量临时注入，绝不落盘到配置文件中。对于网易系邮箱，脚本会自动发送 IMAP ID 以绕过反垃圾风控。需要注意的是，QQ 邮箱的 SMTP 默认不保存已发送邮件，送达确认需依赖收件方反馈。此外，若网络环境限制了外部 PDF 链接的抓取，链接型发票的解析将会失败，此时建议要求供应商直接发送附件。