前言¶
报销季常见流程是:在邮箱里按关键词翻发票和行程单、逐个下载附件、再手工拼 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。
典型用法¶
官方页面未单独给出逐步操作截图,可复现的入口如下。
- 按上一节完成
@user_b8af0005/invoice-from-email的安装,并配置 Skill 要求的 API Key。 - 在对话中说明任务范围(例如:某邮箱、时间范围、发票/行程单类型),让 Agent 按 Skill 流程执行:搜索下载附件 → 文字提取(必要时触发 OCR 降级)→ 合并 A4 PDF → 导出单 Sheet Excel。
- 核对输出: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