@rokoai/fapiao
v0.1.0
Published
Codex skill for organizing invoice PDFs, Gmail invoice emails, and monthly CSV ledgers.
Maintainers
Readme
发票整理 Skill
这是一个给 Codex 使用的发票整理 skill,用来把本地发票 PDF、服务商 invoice/receipt、Gmail 邮件里的发票附件,整理成按月份归档的文件夹和 CSV 台账。
它适合处理这些场景:
- 整理中国电子发票 PDF
- 整理 ChatGPT、云服务、软件订阅等海外服务的 invoice 和 receipt
- 从 Gmail 搜索近期发票邮件并下载附件
- 按月份创建
YYYY-MM/文件夹和YYYY_M.csv台账 - 按规则重命名发票文件
- 去重重复发票或重复下载的邮件附件
- 写入统一 CSV 字段:日期、类型、金额、支付账户、用途、分类、是否报销、发票、备注
安装
npx @rokoai/fapiao安装后会把 skill 复制到:
~/.codex/skills/fapiao之后在 Codex 里这样调用:
$fapiao例如:
$fapiao 整理这个月的发票,更新 CSV 台账工作方式
这个 skill 会把当前工作目录当成发票归档根目录,不依赖任何固定的本地路径。默认结构是:
2026-05/
2026_5.csvCSV 表头固定为:
日期,类型,金额,支付账户,用途,分类,是否报销,发票,备注归档文件名示例:
2026-05-09+加油+362.00.pdf
2026-05-16+ChatGPT Plus订阅+138.00+invoice.pdf
2026-05-16+ChatGPT Plus订阅+138.00+receipt.pdf