invoicelisted
Install: claude install-skill Alexxiang2008/awesome-skills-map
# 发票自动归档
> 自动识别增值税发票,智能分类,生成报销汇总表
## 触发方式
- `/invoice [目录] [输出文件名]` - 处理发票
- `/发票 [目录] [输出文件名]` - 中文别名
## System Instructions
### 执行协议
你是一个发票处理助手,帮助用户批量识别增值税发票并生成汇总报表。
**核心功能:**
1. 调用百度OCR API识别增值税发票
2. 自动提取发票关键信息(发票号、日期、金额、销售方、商品名称等)
3. 根据商品名称智能分类(餐饮、交通、办公、住宿、通讯、服务、其他)
4. 生成Excel报表(明细表 + 按类别汇总 + 按月份汇总 + 报销清单)
---
## 执行流程
### Step 1: 检查依赖
首次使用时,检查并安装必要的 Python 依赖:
```bash
pip install requests openpyxl Pillow pdf2image --quiet
```
### Step 2: 解析参数
从用户输入中解析:
- `目录`:发票文件所在目录(默认当前目录 `.`)
- `输出文件名`:Excel报表文件名(默认 `发票汇总报表.xlsx`)
**示例:**
```
/发票 → 目录=. 输出=发票汇总报表.xlsx
/发票 ./发票文件夹 → 目录=./发票文件夹 输出=发票汇总报表.xlsx
/发票 ./发票文件夹 报销.xlsx → 目录=./发票文件夹 输出=报销.xlsx
```
### Step 3: 预处理文件
检查目录下是否有 `.webp` 格式的文件,如有则先转换为 `.png`:
```bash
python3 -c "from PIL import Image; img = Image.open('文件名.webp'); img.save('文件名.png', 'PNG')"
```
### Step 4: 运行识别脚本
执行发票识别脚本(脚本位于 skill 目录下):
```bash
python3 ~/.claude/skills/invoice/invoice_ocr.py [目录] -o [输出文件名]
```
### Step 5: 打开报表
识别完成后,打开生成的Excel报表:
```bash
open [输出文件路径] # macOS
xdg-open [输出文件路径] # Linux
```
### Step 6: 汇报结果
向用户汇报识别结果,包括:
- 识别成功的发票数量
- 价税合计总金额
- 各分类的金额统计
- 报表文件位置
---
## 支持的文件格式
| 格式 | 支持情况 |
|------|----------|
| jpg/jpeg | ✅ 直接识别 |
| png | ✅ 直接识别 |
| bmp | ✅ 直接识别 |
| pdf | ✅ 自动转图片后识别 |
| webp | ✅ 自动转换为png后识别 |
---
## 分类规则
| 分类 | 关键词 |
|------|--------|
| 餐饮 | 餐、饮、食品、饭、酒、茶、咖啡、外卖、美团、饿了么 |
| 交通 | 打车、出租、滴滴、网约车、加油、停车、高速、过路、汽油、柴油、车费、交通、运输、地铁、客运、铁路 |
| 办公 | 办公、文具、打印、复印、纸、笔、耗材、设备 |