邮箱自动拉取¶
如果你的电子发票都发到邮箱，可以配置一个邮箱账户，让系统定时自己把发票附件抓进解析管道——你就不用手动下载再上传了。
支持 QQ 邮箱、163、Gmail、企业邮箱等一切 IMAP over SSL 的邮箱。
配置一次¶
需要工作区所有者/管理者权限。 路径：设置 → 邮箱账户 → 新增账户。
| 字段 | 说明 |
|---|---|
| 邮箱地址 | 你的收票邮箱 |
| IMAP 服务器 | 例如 imap.qq.com、imap.163.com、imap.gmail.com |
| 端口 | 一般是 993（SSL） |
| 授权码 | 不是邮箱登录密码，是邮箱设置里生成的 IMAP 授权码；保存后只显示"已配置" |
| 轮询间隔（秒） | 多久检查一次新邮件，最小 60 秒，默认 300 秒 |
| 回看天数 | 首次配置时往回捞几天；默认只处理此后收到的新邮件 |
| 发件人白名单 | 只收这些发件人的邮件，逗号分隔（留空=不限制） |
| 主题关键词 | 邮件主题包含这些词才收，逗号分隔，如 发票, 行程单 |
| 附件扩展名 | 只收这些扩展名的附件，逗号分隔，如 pdf, jpg, png |
| 拉取后标记为已读 | 默认开启，避免邮件一直显示未读 |
授权码怎么拿
到邮箱网页版的「设置 → 账户/安全」里开启 IMAP/SMTP 服务，按提示生成"授权码"。QQ、163 都需要先开启服务才能生成。
存好后先验一下¶
账户列表里每一项都有一个状态行，能直接看出问题：
- 徽章
已启用/已停用，授权码已配置/缺少授权码 最近拉取：时间（没有则显示"从未"）- 有异常时追加
· 最近错误：具体原因
行内操作：
| 操作 | 结果 |
|---|---|
测试连接 |
成功提示"连接成功：INBOX，共 N 封" |
立即拉取 |
提示"已入队，稍后自动收取"，不用等下一次轮询 |
编辑 |
改配置；授权码留空表示不修改 |
删除 |
需要确认；删掉后不再自动收款 |
拉取时的行为（要点）¶
- 只收附件：命中筛选的邮件，其附件写进上传管道，后续 OCR、分类、查重完全一致。
- 不重复收：用邮箱的 UID 水位做增量，再加邮件 ID 兜底防重，同一封邮件不会被处理两次。
- OFD / XML 跳过：这类电子发票附属格式直接忽略，不入库。
- 默认只标已读：不会移动或删除你的邮件。
- 有新发票会通知你：提示"邮箱收到新发票：xx@example.com 本轮新增 N 个附件，已进入解析。"
- 失败要连续 2 轮才会告警：偶尔一次网络抖动只在设置页记
最近错误；连续失败会发一条"邮箱拉取连续失败"的紧急通知给账户创建者。
常见问题¶
- 测试连接失败
- 依次检查：IMAP 服务是否开启、授权码是否重新生成过（改密码后旧授权码会失效）、服务器地址和端口是否正确（注意 993 是 SSL，不是 143）、是否有邮箱端的安全限制。
- 提示"已入队"但一直没新发票
- 大概率是筛选条件太严：先看主题关键词/发件人白名单/附件扩展名是否填得过窄；也可以在保留条件的情况下用"立即拉取"重试一次。
- 想让系统去捞历史邮件
- 把
回看天数调大（1~365）再触发一次拉取。注意首次回溯会把符合条件的历史附件都拉进来。 - 能不能配置多个邮箱
- 可以，同一个工作区可以加多个账户，各自独立筛选。