发票识别

发票 OCR 识别技能。扫描文件夹中的发票文件（PDF/图片），调用阿里云 OCR API 识别发票信息并导出到 Excel 表格。支持 17+ 种发票类型（增值税发票、火车票、出租车票、机票行程单、定额发票、机动车销售发票、过路过桥费发票等）。使用场景：(1) 用户提到"发票识别"、"发票统计"、"发票整理"、...

Security Scan

The skill's code, instructions, and requirements are consistent with an Aliyun OCR invoice-recognition tool, but it stores user AccessKey credentials in a plaintext config file and will upload invoice images to Aliyun's OCR endpoint—so treat keys and data carefully.

Purpose & Capability

Name/description, SKILL.md, aliyun-ocr-api.md and the Python script all align: the skill scans invoice files, calls the Aliyun OCR endpoint, parses results and exports to Excel. The single external endpoint (ocr-api.cn-hangzhou.aliyuncs.com) matches the described purpose.

Instruction Scope

Runtime instructions are narrowly scoped to asking the user for Aliyun AccessKey ID/Secret (or guiding them to run --config), scanning a user-provided folder, calling Aliyun OCR, and exporting results. The skill does not instruct reading unrelated system files or contacting other endpoints. Note: it asks the agent to actively request secrets from the user, which is necessary for operation but sensitive.

Install Mechanism

No install spec; only a pip dependency (openpyxl) is recommended. The skill is instruction + single Python script; nothing is downloaded from arbitrary URLs. This is proportionate for the described functionality.

Credentials

The skill requests no environment variables but requires Aliyun AccessKey ID and Secret to operate. Those credentials are collected via interactive prompt or by running --config and are saved to a local config.json under the skill directory in plaintext. Saving secrets unencrypted to disk is a practical but sensitive choice—it's proportionate to the task but requires caution (prefer RAM subaccount, minimal permissions, and local key management).

Persistence & Privilege

always:false and no special privileges. The script writes its own config.json inside the skill directory and writes output Excel files—expected behavior. It does not modify other skills or system-wide settings.

Assessment

This skill appears to do what it says: it will read invoice files you point it at, upload image/PDF bytes to Aliyun's OCR API, parse the response, and write an Excel file. Before installing or running it: (1) understand it will ask for and store your Aliyun AccessKey ID and Secret in config.json (plaintext) — avoid using root account keys; create a RAM sub-account with minimal AliyunOCR permissions and use those keys only; (2) invoices contain sensitive financial data — recognize that image bytes will be sent to Aliyun (cloud) and you may incur API charges; (3) review the script if you need to confirm no additional endpoints/behaviour; (4) consider running on a copy of invoice files and rotating keys after use. If you are uncomfortable storing credentials in plaintext, modify the script to use environment variables or a secure secrets store before use.

发票 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

支持的发票类型

类型	说明
增值税发票	专用发票、普通发票、电子发票
火车票	火车票识别
出租车发票	机打发票
定额发票	手撕发票
机票行程单	航空运输电子客票
机动车销售发票	购车发票
网约车行程单	滴滴等平台发票
过路过桥费	高速公路发票
客运车船票	汽车票、船票
税收完税证明	完税凭证
银行承兑汇票	票据识别

支持的文件格式

格式	扩展名
PDF	.pdf
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

1. 登录 阿里云控制台
2. 开通 票据凭证识别 服务
3. 创建 AccessKey（建议使用 RAM 子账号）
4. 授予 AliyunOCRFullAccess 权限

详细 API 说明见 阿里云 OCR API 参考

工作流程

发票文件 → OCR识别 → Excel表格
   ↓           ↓         ↓
 PDF/图片   混贴识别   xlsx文件

注意事项

1. 图片需清晰，建议长宽 > 500px
2. 单个文件不超过 10MB
3. 阿里云 OCR 按次计费，注意费用控制
4. 配置文件保存在技能目录下的 config.json