1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | iflytek-ocr-invoice-iflytek-ifly-skills |
| 项目自述名称 | Invoice OCR(README 列表标题;SKILL.md 内部标识符为 iflytek-ocr-invoice,与正式名称含义一致,不作为名称使用) |
| 作者/维护者 | iFLYTEK(科大讯飞)官方 GitHub 组织 iflytek |
| 来源链接 | https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-ocr-invoice |
| 许可证 | Apache-2.0(GitHub API 确认,适用于整个 iFly-Skills 仓库) |
| GitHub Stars | 217(GitHub API,仓库整体;iFly-Skills 是含 11 个独立技能的合集仓库,此数字不代表本技能自身热度) |
| Forks | 27(GitHub API,仓库整体) |
| 最新版本 | SKILL.md 未标注独立版本号;本技能对应脚本自 2026-06-17 加入仓库后未再变更,仓库整体最近一次提交为 2026-08-11 |
| 安装方式 | git clone 后置入对应 Agent 的 skills 目录,或通过 Skills.sh 等第三方技能市场安装(见第 10 章) |
2. 功能介绍与亮点
Invoice OCR 是 iFLYTEK 官方“票据识别”能力的技能封装,将发票/收据照片或扫描件转换为结构化字段:
- 覆盖国内常见票据类型:增值税发票、出租车票、火车票、过路费发票、医疗票据、银行回单等
- 输入形态灵活:支持 png/jpg/bmp/gif/tif 图片及 PDF 直接识别,无需先转格式
- 两种输出:默认输出人类可读的结构化字段(票据类型、发票代码、发票号码、开票日期、金额等);
--raw可拿到完整 API JSON 原文,便于程序化对接 - 零依赖、单条命令:纯 Python 标准库实现(
urllib/hmac/hashlib),无需安装任何第三方包,配置好三个环境变量即可运行;HMAC-SHA256 签名鉴权由脚本自动完成 - 详尽故障排查文档:SKILL.md 内附 30+ 错误码对照表与常见问题 FAQ,覆盖认证失败、图片读取失败、额度用尽等典型场景
主要亮点:iFLYTEK 官方出品、完全开源可审计;专精国内常见票据类型的结构化字段提取,比通用文档 OCR 更贴合本地财务/报销场景;同合集姊妹技能已有真实第三方开发者提交并被合并的 bug 修复记录,显示团队对整个技能合集有持续维护投入。
3. 适用场景
固定分类:文档与办公自动化
面向需要将纸质或电子发票/票据快速数字化的用户:企业财务人员的报销单据录入、个人出差报销整理、会计做账前的票据信息核对。产出是结构化字段数据,可直接用于后续录入财务系统或表格,减少手工誊抄与录入差错。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式,直接放入 skills 目录即可 |
| OpenClaw | 原生支持 | 仓库已在 ClawHub 注册分发(README 分发渠道列表),SKILL.md 内置 openclaw 元数据块(emoji、维度、用户指令示例) |
| Codex | 需适配 | Codex CLI 采用开放 SKILL.md 标准,技能文件放入 .codex/skills/ 目录即可被发现,本技能脚本为纯标准库 Python,理论上零改动可运行 |
| Hermes Agent | 需适配 | Hermes Agent 官方文档支持通过 hermes skills install <URL> 或手动放入 skills 目录安装标准 SKILL.md 技能,机制兼容,但未找到针对本技能的专门适配记录 |
5. 推荐理由
对经常处理发票报销的用户来说,这个技能能把一张发票/票据照片直接转成结构化字段——不用安装任何第三方库,配置好 API 凭据后一条命令即可拿到发票代码、号码、日期、金额等信息,可直接用于报销录入或做账,覆盖国内 6 种以上常见票据类型。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | iFLYTEK 系科大讯飞官方出品;所属 iFly-Skills 是 11 个技能共享的合集仓库,217 star 不代表本技能个体热度;本技能自身在第三方技能市场暂无独立可查的采用数据 |
| 可用性 | 8 | 纯 Python 标准库实现零第三方依赖,单条命令即可运行;SKILL.md 含完整错误码表与故障排查 FAQ;仓库整体持续维护(最近一次提交 2026-08-11);需自行在讯飞控制台开通服务并配置三个环境变量凭据 |
| 安全性 | 8 | 仅通过标准库 urllib 向讯飞官方固定 API 端点(api.xf-yun.com)发起单次 POST 请求上传用户提供的票据图片,无 shell 命令执行,外联目标透明;凭据经环境变量读取,脚本内不落盘;License 为 Apache-2.0,明确;SKILL.md 与脚本全文未见可疑指令或夹带推广内容 |
| 综合 | 7.67 | 三项均值 |
安全检查清单逐项结果:① 仅执行本地 Python 脚本发起 HTTP 请求,无 shell 命令执行,权限范围明确;② 会将用户提交的票据图片发送至讯飞官方 API 完成识别,数据流向在文档中已注明且目标域名固定透明;③ 要求讯飞 API 凭据(AppID/Key/Secret),通过环境变量存储,为标准做法;④ 全文未发现可疑指令、混淆代码或隐蔽外发逻辑;⑤ 作者为科大讯飞官方组织,无信誉造假迹象;⑥ License 为 Apache-2.0,明确;⑦ 仓库整体近期(5 天内)仍有提交,保持活跃维护。
7. 跟同类 Skills 相比的优势
| 技能 | 识别对象 | 产出形态 | 依赖 |
|---|---|---|---|
| Invoice OCR(本技能) | 国内常见票据(增值税发票/出租车票/火车票/医疗票据等 6+ 类) | 结构化字段(发票代码、号码、日期、金额等) | 讯飞官方 API 凭据,纯标准库无第三方包 |
| iflytek-pdf-image-ocr(同合集) | 任意 PDF/图片中的通用文字 | 转换为可编辑 Word/Markdown 全文 | 同源凭据体系,异步任务轮询式工作流(创建/查询/详情三步) |
| pdf-anthropics-skills | 任意 PDF(含扫描件) | OCR 只是 PDF 全生命周期处理(合并/拆分/加水印/表单填写)中的一项能力 | Python + 第三方 PDF 处理库 |
Invoice OCR 专注国内常见票据类型的结构化字段提取,直接产出可用于报销/做账的具体字段;同合集的 iflytek-pdf-image-ocr 面向任意文档的通用 OCR,把 PDF/图片转成可编辑全文,不做票据字段结构化,且工作流复杂度更高;pdf-anthropics-skills 是通用 PDF 工具箱,OCR 只是让扫描件可搜索的辅助能力,不产出票据专项结构化数据。三者定位互不重叠。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。所属仓库存在真实第三方开发者提交并被合并的 bug 修复记录(涉及语音合成、图像理解等姊妹技能),显示该合集有真实使用者在跟进维护,但这些反馈并非针对本技能本身。
9. 其他补充
iFly-Skills 合集除本技能外还包含语音合成、图像理解、通用 OCR、文本校对、语音转写、视频翻译、声音克隆、合同智能审核等技能,均调用讯飞自有云 API;仓库同时向 ClawHub、Skills.sh、腾讯云 SkillHub、LobeHub 等多个第三方技能市场分发。
10. 安装使用方式
方式一:直接克隆子目录
git clone https://github.com/iflytek/iFly-Skills.git
cp -r iFly-Skills/skills/iflytek-ocr-invoice ~/.claude/skills/
方式二:通过第三方技能市场安装(以 Skills.sh 为例)
npx skills add iflytek/ifly-skills/iflytek-ocr-invoice
使用前配置(必需环境变量,在讯飞控制台开通“票据识别”服务后获取):
export XFYUN_APP_ID="your_app_id"
export XFYUN_API_KEY="your_api_key"
export XFYUN_API_SECRET="your_api_secret"
基本用法:
# 识别一张增值税发票
python3 scripts/invoice.py ./vat_invoice.jpg
# 识别医疗票据,输出原始 API JSON
python3 scripts/invoice.py ./medical_bill.png --raw
# 识别出租车票
python3 scripts/invoice.py ./taxi_receipt.jpg
安装后无需重启 Agent,下一次对话中提及“识别这张发票”“提取发票信息”“帮我 OCR 这张票据”等意图即可触发。
11. 注意事项
- 使用前需在讯飞控制台自行开通“票据识别”服务并生成 API 凭据,非零配置即用
- 待识别的票据图片会发送至讯飞官方服务器处理,若涉及需要保密的财务信息需自行评估是否适合通过云端 API 处理
- 免费额度用尽后(错误码 11201)需在控制台升级付费套餐才能继续使用
- 本技能脚本的鉴权实现方式与同合集其他技能存在代码重复,仓库维护者已在一个公开 issue 中记录该问题并计划后续整合,目前未见因此导致的实际识别故障报告
- 该技能代码自加入仓库以来未见后续变更,但同合集内其他技能有持续的问题修复记录,可作为团队维护活跃度的旁证