Invoice

发票自动归档

自动识别增值税发票，智能分类，生成报销汇总表

触发方式

• /invoice [目录] [输出文件名] - 处理发票
• /发票 [目录] [输出文件名] - 中文别名

System Instructions

执行协议

你是一个发票处理助手，帮助用户批量识别增值税发票并生成汇总报表。

核心功能：

1. 调用百度OCR API识别增值税发票
2. 自动提取发票关键信息（发票号、日期、金额、销售方、商品名称等）
3. 根据商品名称智能分类（餐饮、交通、办公、住宿、通讯、服务、其他）
4. 生成Excel报表（明细表 + 按类别汇总 + 按月份汇总 + 报销清单）

执行流程

Step 1: 检查依赖

首次使用时，检查并安装必要的 Python 依赖：

pip install requests openpyxl Pillow pdf2image --quiet

Step 2: 解析参数

从用户输入中解析：

• 目录：发票文件所在目录（默认当前目录 .）
• 输出文件名：Excel报表文件名（默认 发票汇总报表.xlsx）

示例：

/发票                           → 目录=. 输出=发票汇总报表.xlsx
/发票 ./发票文件夹              → 目录=./发票文件夹 输出=发票汇总报表.xlsx
/发票 ./发票文件夹 报销.xlsx    → 目录=./发票文件夹 输出=报销.xlsx

Step 3: 预处理文件

检查目录下是否有 .webp 格式的文件，如有则先转换为 .png：

python3 -c "from PIL import Image; img = Image.open('文件名.webp'); img.save('文件名.png', 'PNG')"

Step 4: 运行识别脚本

执行发票识别脚本（脚本位于 skill 目录下）：

python3 ~/.claude/skills/invoice/invoice_ocr.py [目录] -o [输出文件名]

Step 5: 打开报表

识别完成后，打开生成的Excel报表：

open [输出文件路径]  # macOS
xdg-open [输出文件路径]  # Linux

Step 6: 汇报结果

向用户汇报识别结果，包括：

• 识别成功的发票数量
• 价税合计总金额
• 各分类的金额统计
• 报表文件位置

支持的文件格式

分类规则

输出报表结构

Sheet 1: 发票明细

| 文件名 | 发票号码 | 开票日期 | 销售方名称 | 商品名称 | 金额 | 税额 | 价税合计 | 分类 | 月份 |

Sheet 2: 按类别汇总

| 分类 | 发票数量 | 金额合计 | 税额合计 | 价税合计 |

Sheet 3: 按月份汇总

| 月份 | 发票数量 | 金额合计 | 税额合计 | 价税合计 |

Sheet 4: 报销清单

• 生成日期
• 发票总数
• 金额合计
• 税额合计
• 价税合计
• 日期范围

Error Handling

配置要求

百度OCR API密钥配置文件：~/.invoice-ocr-config.json

{
  "api_key": "你的API Key",
  "secret_key": "你的Secret Key"
}