技能介绍

票据识别与凭证生成的痛点

在财务自动化场景中，处理海量且格式不一的票据（如银行回单、对账单、发票）一直是个工程难题。特别是银行回单，单页PDF中往往包含多张回单混排，传统OCR工具难以自动拆分，导致后续数据提取和人工录入成本极高。此外，解析完成后的记账凭证生成往往依赖外部系统，科目匹配逻辑不透明，且异步API的轮询与结果落盘在沙箱环境中容易引发文件污染或超时重试问题。

核心能力与调用机制

该技能通过深度学习OCR引擎解决了上述问题，核心能力包括：

多回单自动裁剪：针对银行回单，服务端能自动识别单页内的多张回单并裁剪，直接返回单张回单的独立数据与原始图片URL。
异步解析与自动轮询：所有文件解析接口均为异步，脚本默认内置 --wait 参数，最长自动轮询120秒，开发者无需手动编写轮询逻辑。
本地HTML预览生成：解析完成后，脚本会自动在本地生成单文件HTML预览（包含回单视图、表单视图、JSON视图），直接使用公网图片URL，避免base64导致脚本过大。
本地记账凭证生成：通过 --voucher 参数，系统在本地基于《小企业会计准则》精简版科目体系生成凭证，输出借贷分录、置信度及复核建议，不调用远程API，无额外费用。

适用边界与工程注意

在实际接入时，需注意以下工程边界：

严禁重复提交：异步解析接口同一文件只能提交一次，重复提交不会加速且会浪费每日体验配额。若 --wait 超时，必须使用返回的 task_id 继续轮询。
凭证仅供参考：生成的记账凭证虽包含置信度和复核建议，但仅为辅助参考，最终科目选择和金额必须由会计人员人工复核后方可入账。
沙箱环境降级：在不可写目录或沙箱环境中，HTML预览文件可能生成失败，但接口仍会正常返回完整的JSON解析结果，开发者需做好降级处理。
密钥安全：API KEY 采用基于机器特征的本地加密存储，更换机器时需重新配置。