自动化发票助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f8fe3f14/email-invoice-downloader-invoice-auto。
技能介绍
要解决的问题
报销季或报税前,发票往往散落在 QQ、163、Gmail 等多个邮箱里:有的是 PDF 附件,有的是诺诺网、百望云邮件里的下载链接;文件名又是系统默认的乱码或重复。手工翻邮件、逐个点链接、自己建文件夹改名,既容易漏掉「行程单」「报销凭证」这类主题里不带「发票」二字的机票/酒店邮件,也很难按「本月/本年」和开票日期(不是收到邮件的日期)做统计。
技能如何工作
这是一套可落在工作目录里的 IMAP 下载 → 去重 → 可选分类重命名 → 统计报告 流程,由 Agent 按 SKILL 分步引导你配置。
- 范围先问清楚:每次执行前会用选项确认「本月 / 本年 / 自定义月份区间」。下载阶段仍全量扫描,避免漏单;在
rename_invoices.py里用DATE_FROM/DATE_TO按 PDF 内开票日期过滤统计与复制,范围外单独标注排除数量。 - 多邮箱直连:在脚本配置
IMAP_HOST与授权码(QQ/163 授权码、Gmail 应用专用密码等),遍历邮件并靠较广的INVOICE_KEYWORDS(含凭证、行程、客票等)识别发票邮件,拉取 PDF 附件。 - 链接类发票:从邮件正文筛真实发票 URL(过滤诺诺网 logo/js 等资源链),优先用 Node.js Playwright 打开页面下载;Outlook 个人号若 IMAP 基本认证失败,可走转发到 QQ +
scan_forwarded_invoices.py路线。 - 分类重命名:
pdfplumber解析多种版式(标准电子票、深圳旧式、诺诺网、图片型 PDF、保险合同等),按「项目名称 > 销售方 > 文件名」规则归入探店采购、差旅交通、差旅住宿或其他,输出形如探店采购_日期_餐饮费_金额元_商家.pdf及 Markdown 汇总、rename_metadata.json。
适用边界与注意点
- 凭据仅用于本次 IMAP/本地下载,技能声明不持久化授权码、不上传邮件内容;实际仍建议你用完轮换授权码。
- 纯图片扫描件若无法从正文抽字段,会部分依赖文件名兜底,分类可能需人工复核。
- macOS 上 Python Playwright/greenlet 有签名问题文档中明确建议走 Node Playwright;Gmail 必须两步验证 + 应用专用密码。
使用场景
- 月底报销前,需要从 QQ 和企业 Gmail 一次性扫出含 PDF 与诺诺链接的所有凭证邮件
- 税务核对要求按 2026 年 3–6 月开票日期汇总,要把范围内发票复制到统一命名目录并出明细表
- Outlook 个人邮箱 IMAP 登录失败,已将发票邮件转发到 QQ,需按转发信嵌套附件批量落盘
- 差旅机票主题仅为「电子报销凭证」,要用广关键词扫描后按差旅交通类目重命名并去重
适合人员
- 经常跨 QQ/163/Gmail 收电子发票、报销前要按自然月汇总金额与份数的职场报销经办
- 个体户或小企业主需要把邮箱发票按探店/差旅等类目整理成本地 PDF 档案备查
- 已配置邮箱授权码、愿意在工作区运行 Python/Node 脚本的技术型财务或本人报销者
- 使用 Outlook 且无法直连 IMAP、采用「转发到可 IMAP 邮箱」方案处理链接与附件发票的用户