柠檬云发票核验与征信分析

要解决的问题

批量核验发票真伪，不只是“调一个接口”。实际场景里有几个坑：发票文件可能是图片、PDF、OFD，票面识别结果要和税局查验结果对应；清单文件常常列名不规范（发票号码和发票代码混用），直接拿来没法用；核验之后做统计，还要分清进项/销项、正常/红冲/作废，否则金额口径会错。这个技能把整条流程固定下来，保证中间核验表、最终分析表和 PDF 报告都来自同一次执行。

工作方式

核心命令有四条：verify、reverify、analysis、report-pdf。

• 两种输入模式：verify 传入文件夹时，直接扫描图片、PDF、OFD 发票文件并识别票面；传入 .xlsx/.csv 清单时走清单模式。清单模式要求标准列：发票号码、开票日期、价税合计 必填，发票代码、校验码 可选。脚本不做自动字段映射，非标准清单需先由 AI 或用户转换。
• 核验并保留产物：verify 只做票面识别和发票查验接口调用，输出基础票面 XLSX，其中保留税局查验状态和查验时间，供后续分析与重新查验使用，流程结束后也必须保留。
• 定向重新查验：reverify 只重查税局查验状态为空或不等于“查验成功”的记录，已成功的记录原样保留。
• 分析与报告：analysis 用公司名称判断发票进销项方向，补充“是否重复风险”，输出统计 JSON 和增强 XLSX，覆盖核验统计、发票状态分布（红冲参与统计、作废只计数）、金额拆分、月度趋势、商品 Top5、客户/供应商 Top5 与集中度、风险提示七个维度。report-pdf 再把统计文本转成 PDF，最终结果必须原样使用转换器返回的文本。

适用边界与注意点

• analysis 只接受本次执行刚生成的核验 XLSX；文件缺失、为空或来源不明时必须中止。
• 发票查验需要 API Key，仅在运行时内存中使用，不写入磁盘。
• Windows PowerShell 下需先做 UTF-8 编码初始化，传给可执行文件的文件必须是 UTF-8 无 BOM。
• 仅支持 Windows x64、Linux x64/ARM64、macOS x64/ARM64，其他平台不得猜测二进制路径。
• 金额字段由命令直接返回带千分位的字符串，不要再做换算或二次舍入。
• 第一阶段只做识别和查验，不做查重、抬头校验和报销分析，这些在 analysis 阶段完成。