讯飞发票识别

解决的问题

手工录入增值税发票、出租车票、火车票、医疗票据等纸质或扫描票据时，金额、日期、开票方等字段需要逐条抄录，既慢又容易出错。当票据数量上来之后，靠人工维护报销台账基本不可持续。这个技能把「拍一张照片 → 拿到结构化数据」这一步压缩成一次 API 调用。

核心能力与工作方式

• 纯标准库：脚本 scripts/invoice.py 只依赖 Python 3 标准库，不需要 pip install 任何第三方包。
• 鉴权自动化：通过 XFYUN_APP_ID、XFYUN_API_KEY、XFYUN_API_SECRET 三个环境变量配置，脚本内部完成 HMAC-SHA256 签名并请求讯飞接口，开发者不用手写签名逻辑。
• 格式覆盖：支持 png、jpg/jpeg、bmp、gif、tif/tiff、pdf，扫描件可以直接传 PDF。
• 两种输出：默认输出人类可读的结构化字段（金额、日期、供应商等）；加 --raw 返回完整 API JSON，方便接入自己的解析或落库流程。
• 错误可追踪：接口返回 0 表示成功，10105（签名无效）、10163（请求体过大）、11200（配额用完）等错误码有明确说明，便于排查。

适用边界与注意点

• 识别精度强依赖图片质量：模糊、遮挡或光照不均都会降低字段抽取准确率，拍摄时尽量清晰并裁剪到票据区域。
• 接口有图片大小与调用配额限制，具体上限取决于讯飞控制台中的服务等级，批量处理前需确认额度。
• 该技能面向中文票据场景（增值税发票、出租车票、火车票、医疗票据等），英文发票或其他非中文票据不在文档列出的支持范围内。