发票 OCR 识别技能
批量识别发票并汇总到 Excel 表格。
⚠️ 首次使用必须配置凭证
此技能需要阿里云 OCR 服务，使用前必须先配置凭证！
方式一：向用户提供凭证（推荐）
主动询问用户：
"使用此技能需要阿里云 AccessKey ID 和 AccessKey Secret，请提供这两个凭证。
获取方式：阿里云控制台 → 开通票据凭证识别 → 创建 AccessKey"
然后运行：
python scripts/recognize_invoices.py --config
方式二：引导用户自行配置
告诉用户：
"请先运行以下命令配置阿里云凭证："
python ~/.openclaw/skills/invoice-ocr/scripts/recognize_invoices.py --config
特点
- ✅ 17+ 发票类型 - 自动识别发票类型
- ✅ Excel 输出 - 生成标准 xlsx 文件
- ✅ 支持 PDF/OFD - 电子发票友好
依赖安装
pip install openpyxl
支持的发票类型
| 类型 | 说明 |
|---|---|
| 增值税发票 | 专用发票、普通发票、电子发票 |
| 火车票 | 火车票识别 |
| 出租车发票 | 机打发票 |
| 定额发票 | 手撕发票 |
| 机票行程单 | 航空运输电子客票 |
| 机动车销售发票 | 购车发票 |
| 网约车行程单 | 滴滴等平台发票 |
| 过路过桥费 | 高速公路发票 |
| 客运车船票 | 汽车票、船票 |
| 税收完税证明 | 完税凭证 |
| 银行承兑汇票 | 票据识别 |
支持的文件格式
| 格式 | 扩展名 |
|---|---|
| OFD | .ofd |
| 图片 | .jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp |
输出字段
按以下顺序输出到 Excel：
| 字段 | 说明 |
|---|---|
| 发票号码 | 发票代码 + 发票号码 |
| 开票日期 | 开票日期 |
| 购买方信息 | 购买方名称 |
| 销售方信息 | 销售方名称 |
| 项目名称 | 商品/服务名称 |
| 规格型号 | 商品规格 |
| 单位 | 计量单位 |
| 数量 | 商品数量 |
| 单价 | 商品单价 |
| 金额 | 不含税金额 |
| 税率 | 税率百分比 |
| 税额 | 税金金额 |
| 价税合计 | 含税总额 |
注意： 如果发票上某字段不存在，默认填空值。
使用方法
识别发票
# 识别文件夹中的所有发票
python scripts/recognize_invoices.py /path/to/invoices
# 指定输出文件
python scripts/recognize_invoices.py /path/to/invoices --output 发票汇总.xlsx
配置管理
# 设置阿里云凭证
python scripts/recognize_invoices.py --config
# 查看当前配置
python scripts/recognize_invoices.py --list-config
获取阿里云 AccessKey
详细 API 说明见 阿里云 OCR API 参考
工作流程
发票文件 → OCR识别 → Excel表格
↓ ↓ ↓
PDF/图片 混贴识别 xlsx文件
注意事项
- 图片需清晰，建议长宽 > 500px
- 单个文件不超过 10MB
- 阿里云 OCR 按次计费，注意费用控制
- 配置文件保存在技能目录下的 config.json