业务背景

飞书，OUTLOOK等常见工具没有批量筛选下载附件功能，在具体场景下，处理外包机构发送净值邮件时需要逐个邮件下载，费时、繁琐、且容易出错。

需求设计

使用者自行配置具有合法访问权限的 IMAP 邮箱账户，设置文件夹、日期、发件人、主题或正文条件后执行扫描，在客户端预览并选择需要下载的邮件或附件；需要删除邮件时须再次确认。完成后取得下载文件和对应 Excel 清单。

核心业务逻辑

1. 按账户配置连接 IMAP 服务器，读取邮箱文件夹，并使用日期、发件人、主题和正文条件筛选邮件。
2. 解析邮件头、正文和 MIME 结构，优先显示 HTML 正文，兼容常见字符集与传输编码。
3. 汇总全部匹配邮件的附件，按图片、文档、表格、PDF 和其他类型筛选并批量选择。
4. 支持将邮件保存为 EML，或并发下载选中附件；可按年度、月度或发件人建立目录，并自动处理重名。
5. 每次下载生成 Excel 清单记录邮件或附件元数据；删除邮件时要求输入“删除”二次确认，并支持跨文件夹处理。

数据安全与权责边界

• 本工作流运作于自研Antonio Toolbox基座，该基座为本地实体程序，无云端设计。
• 该模块需要使用人自行录入IMAP鉴权信息，鉴权信息由使用人自行获取填写，程序本身不对获取途径是否为合法授权负责。
• 输出结果的复核和使用由使用者负责。

交互与业务价值

对比项	原处理方式	程序处理
操作方式	人工在邮箱各文件夹中逐封检索、打开并保存邮件或附件	配置检索条件后集中预览、筛选并批量下载邮件或附件
处理时间	以100封目标邮件估算，人工检索、打开和保存约需100至300分钟	邮件扫描和筛选在5秒以内完成；海量邮件或附件下载耗时随邮件数量、附件大小和网络响应变化
差错风险	逐封处理可能出现邮件遗漏、附件漏存、重名覆盖或误删除	固定解析邮件结构、自动处理重名，并对删除操作要求文字二次确认
结果查看	人工在多个目录中核对已保存内容	按规则归档下载文件，并通过 Excel 清单追踪邮件和附件元数据