invoice-master

invoice-master 是一个无界面的发票 PDF 处理 Skill 和命令行工具，核心逻辑来自发票打印项目。

支持：

• 多张电子发票合并为 A4 双联 PDF
• 从发票二维码和 PDF 文本层提取金额、日期、类型、号码
• 汇总发票总金额并输出 JSON
• 显式 OCR 模式，使用 PP-OCRv6 tiny 识别扫描型发票的金额区域

安装 Skill

npx skills add EnjoyWT/invoice-master

也可以在 Codex 中通过 $skill-installer 从 GitHub 仓库安装。

直接运行

从 npm 公共仓库直接执行：

npx --yes invoice-master merge \
  --output merged.pdf \
  --amount-mode default \
  invoice-1.pdf invoice-2.pdf

在克隆的仓库内运行：

npm install

node scripts/invoice-master.mjs merge \
  --output merged.pdf \
  --amount-mode default \
  invoice-1.pdf invoice-2.pdf

只统计、不生成合并文件：

node scripts/invoice-master.mjs analyze invoice-1.pdf invoice-2.pdf

扫描件需要显式启用 OCR：

npx --yes invoice-master analyze \
  --amount-mode ocr \
  scanned-invoice.pdf

OCR 模式首次运行时下载 PP-OCRv6 tiny 检测和识别模型，合计约 6 MB，默认缓存到 ~/.cache/invoice-master/models。default 和 none 模式不会导入 OCR 模块，也不会下载或初始化模型。

验证

npm test
npm run test:ocr

普通测试验证合并、金额汇总和默认模式不加载 OCR。test:ocr 会显式启动 OCR，并在首次运行时下载模型。

输出

命令将 JSON 写到标准输出，进度和诊断信息写到标准错误。每张输入 PDF 默认只处理第一页，与原发票打印项目保持一致。