邮箱发票自动整理:从邮箱拉附件到 A4 合并与费用清单

前言

报销季常见流程是:在邮箱里按关键词翻发票和行程单、逐个下载附件、再手工拼 PDF、抄金额进 Excel。电子发票越来越多,但扫描件、截图和行程单仍混在一起,OCR 装一套又占环境。若希望把「搜信、取附件、抽字、排版、出表」交给 Agent 按固定步骤跑,可以看下 SkillHub 上的社区 Skill「邮箱发票自动整理」(@user_b8af0005/invoice-from-email,当前 v1.1.2)。

这是什么

「邮箱发票自动整理」是 SkillHub 分类 office-efficiency 下的社区 Skill,坐标 @user_b8af0005/invoice-from-email,由发布者 user_b8af0005 维护。官方简介概括为:从邮箱自动搜索并下载发票、行程单附件;对附件做文字提取;将发票与行程单合并排版到 A4(火车票按真实车票尺寸上下排版);生成单 Sheet 费用清单 Excel(行程写入备注,火车票标注去返程)。页面标注 requires_api_key=true,使用前需按 Skill 说明准备相应 API 密钥(具体字段以安装后的 SKILL.md 为准)。

SkillHub 页面显示评分 100000,下载约 4724 次(统计以 SkillHub 为准)。

核心功能

下面按官方简介归纳已公开的能力,不展开未在资料中出现的实现细节。

邮箱侧:搜索与下载

从邮箱自动搜索目标邮件,并下载发票、行程单等附件,减少手工在客户端里筛选、保存的步骤。

文字提取:三级降级

对附件做智能文字提取,链路为 PyMuPDF → Tesseract → PaddleOCR,按效果自动降级。官方说明在零 OCR 依赖的前提下,可处理 90%+ 的电子发票(适合以 PDF 等可直接抽文本为主的场景)。

排版:发票 + 行程单合并到 A4

将发票与行程单合并排版到一张 A4;火车票按真实车票尺寸在页面上上下排版,便于打印归档。

输出:单 Sheet 费用清单 Excel

生成单个 Sheet 的费用清单:行程信息并入备注列,火车票在表中标注去程 / 返程,方便与纸质或 PDF 归档对照。

安装与启用

Skill 遵循通用 SKILL.md 格式。在 SkillHub 上安装时,官方给出的方式是让 AI 按安装文档操作,或直接调用 skillhub CLI。

方式一:提示词安装(SkillHub 页面推荐)

将下面提示发给当前使用的 AI Agent(Cursor、Claude Code、Codex CLI 等均可按各自 skills 目录落地):

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_b8af0005/invoice-from-email`。

Agent 会按 SkillHub 安装文档 检查 CLI、选择本机的 skills 目录并完成安装。

方式二:skillhub CLI

若本机已有 skillhub,安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别:

command -v skillhub && skillhub --version

未安装 CLI 时,可按官方文档执行完整安装(节选):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 示例(将 <skills 目录> 换成实际路径):

skillhub install @user_b8af0005/invoice-from-email --dir <skills 目录>

常用 skills 目录(来自 SkillHub 安装文档,按你当前环境选用其一):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装后一般需要重启或刷新 Agent,使新 Skill 被加载。因标签 requires_api_key=true,启用前请在 Skill 说明中配置邮箱或相关服务所需的 API Key。

典型用法

官方页面未单独给出逐步操作截图,可复现的入口如下。

  1. 按上一节完成 @user_b8af0005/invoice-from-email 的安装,并配置 Skill 要求的 API Key。
  2. 在对话中说明任务范围(例如:某邮箱、时间范围、发票/行程单类型),让 Agent 按 Skill 流程执行:搜索下载附件 → 文字提取(必要时触发 OCR 降级)→ 合并 A4 PDF → 导出单 Sheet Excel。
  3. 核对输出:A4 合并件是否包含发票与对应行程单、火车票排版是否符合预期;Excel 备注是否含行程、火车票是否标出去返程。

具体命令、邮箱协议与筛选条件以安装包内 SKILL.md 为准,本文不臆造配置项。

适用场景与注意

适合谁: 需要定期从邮箱汇总报销材料、希望统一 A4 打印版与一张费用表的人;电子发票占比高、希望尽量少装 OCR 的环境。

限制与注意:

  • 社区来源(community),版本与行为以 v1.1.2 及后续更新为准。
  • 扫描件、拍照件可能走 Tesseract / PaddleOCR,需自行准备依赖与环境;纯电子 PDF 更贴合「零 OCR 处理大部分发票」的描述。
  • 邮箱访问依赖 API Key 与 Skill 内配置,密钥不要提交到公开仓库。
  • 下载量、评分来自 SkillHub 展示,与你本地统计无关。

结尾

「邮箱发票自动整理」把搜信、抽字、A4 合并和 Excel 费用清单串成一条 Agent 可执行的流水线,适合作为 office-efficiency 类报销归档 Skill 使用。官方入口:

  • SkillHub 页面:https://www.skillhub.cn/skills/user_b8af0005/invoice-from-email
  • API 坐标页:https://api.skillhub.cn/user_b8af0005/invoice-from-email
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye