核心用法
analyse-piece-comptable 是一款面向法国会计场景的专业文档分析技能。用户通过单一命令调用本地脚本分析单个PDF文件（发票、银行对账单或费用报销单），系统提取关键财务字段后返回结构化JSON，最终以自然语言向会计师汇报业务结论。
使用流程简洁：执行 python3 scripts/analyse.py <fichier> --date-ref <AAAA-MM-JJ>，脚本完成PDF文本层检测、字段提取、一致性校验后，Agent以商务口吻向会计师汇报"这是什么单据"、"关键数字是多少"、"有无异常需关注"三层信息。
显著优点
专业精准：针对法国会计实务设计，自动识别发票（购销双向）、银行对账单、费用报销单三类文档，精准提取TVA税率、金额勾稽关系、IBAN有效性等本地化字段。
安全可控：纯离线运行，零网络通信；仅使用Python标准库，无第三方依赖供应链风险；子进程调用固定参数的工具链（pdftotext/tesseract），无命令注入漏洞。
质量保障：内置9类业务规则校验（TVA计算误差>5%即告警、HT+TVA≠TTC即标记、日期逻辑异常等），避免人工"肉眼读数"的随机错误。
诚实透明：对扫描件/照片等无文本层PDF明确降级处理，主动声明"目视读取、需确认"，杜绝虚假自信。
潜在局限
单文档孤岛：严格限定"一次一文档"，不支持批量处理，不关联客户主数据、不比对历史记录，无法识别重复发票或付款状态。
纯只读模式：不执行分类归档（classement-document）或收付款核销（rapprochement-paiements），会计师需配合其他技能完成后续流程。
OCR依赖外设：需预装poppler-utils和tesseract-ocr，且对低质量扫描件的识别置信度有限。
T3来源风险：内部私有项目，未经过公开社区审计，代码量较大（1,777行）需持续监控。
适合群体
法国中小企业会计师、外包会计服务商、财务助理——特别是需要快速预审单据、在正式入账前排查明显错误的场景。适合处理发票真伪初筛、供应商账单快速理解、费用报销合规检查等任务。
使用风险
运行时依赖：若本地未安装pdftotext/tesseract或版本不兼容，将导致功能完全失效。路径遍历隐患：当前版本未对输入文件路径做严格验证，建议用户仅传入可信路径。敏感数据驻留：处理含IBAN、交易金额的财务PDF，虽不上传但临时目录需确保清理机制生效。置信度误判：高置信度提取结果仍需会计师最终复核，不可完全替代专业判断。