Skip to content

邮箱账单

邮箱账单功能通过 IMAP 监听邮箱,当账单邮件到达时自动拉取附件,识别账单类型并进入待处理列表,由你预览后再确认导入。

页面包含三个标签页:邮箱配置发件人规则待处理账单

邮箱配置

邮箱配置

配置用于接收账单邮件的 IMAP 邮箱:

  1. 点击右上角「新增」,填写邮箱信息:
    • 名称:便于识别的名称
    • IMAP 服务器:可从内置列表选择或自定义(选择后自动填端口 993 并开启 SSL)
    • 邮箱账号 / 授权码:授权码在邮箱设置中开启 IMAP 服务后生成
    • 监听文件夹:默认 INBOX
    • 默认归类:默认支出/收入分类与标签
    • 拉取范围:仅新邮件 / 最近 N 天 / 最近 N 封
    • 启用:开启后持续监听
  2. 点击「保存」。

邮箱配置弹窗

  • IMAP 服务器:可从内置列表选择(QQ、腾讯企业邮、163、126、网易企业邮、阿里云、新浪、139、189、Gmail、Outlook、iCloud)或自定义,选择内置服务器会自动填端口 993 并开启 SSL。
  • 邮箱账号 / 授权码:授权码而非登录密码(在邮箱设置中开启 IMAP 服务后生成)。
  • 监听文件夹:默认 INBOX
  • 默认归类:默认支出分类、收入分类与标签。
  • 拉取范围:仅新邮件(增量)/ 最近 N 天 / 最近 N 封。
  • 启用:开启后系统会持续监听该邮箱。

行操作:

  • 测试连接:验证 IMAP 配置。
  • 立即检查:实时展示检查进度,完成后提示新增待处理账单数量。
  • 编辑 / 删除

发件人规则

发件人规则

根据邮件发件人识别账单类型与解析参数:

  • 发件人匹配串:每行一个,支持完整地址、@域名 或关键字,包含匹配且忽略大小写。
  • 账单类型:支付宝 / 微信 / 美团 / 招商银行 / 交通银行。
  • 解压密码:账单压缩包加密时填写。
  • 默认归类:默认支出分类、收入分类与标签。
  • 优先级:值越小越优先。

系统为常见账单邮箱预置了默认规则(如支付宝 @alipay.com、微信 @wechatpay.com、美团 @meituan.com、招行 @message.cmbchina.com、交行 @bankcomm.com)。

待处理账单

待处理账单

展示已拉取、待处理的邮件账单,可按状态筛选(待解析 / 已导入 / 已忽略),列表每 30 秒自动刷新。

行操作:

  • 解析:选择账单类型与解压密码后解析,进入预览,确认后导入。
  • 忽略:标记为已忽略,不再处理。
  • 删除:删除该消息及本地附件。

工作流程

text
账单邮件到达


IMAP 监听(IDLE 实时 / 轮询降级)
   │  提取附件并保存

发件人规则匹配 → 确定账单类型、解压密码、默认归类


进入「待处理账单」(状态:待解析)
   │  手动点「解析」→ 预览 → 确认导入

写入收支记录(状态:已导入)

先预览再导入

邮箱账单不会自动写入账本,必须经过预览确认,避免误导入。

基于 Spring Boot 3 + Vue 3 的个人收支管理系统