技能介绍

要解决什么问题

会计需要把银行 relevé 上的每一笔动账，和文件夹里的发票、费用单对上号：谁付了哪张票、还剩多少、有没有重复入账或漏开票。本技能对应 Pocket-Claw 流水线的第 ⑤ 步：在 clients/… 上只读扫描，把核销结果写进 company.json 与 rapprochement.json，供后端直接给前端用。

如何工作

入口是 scripts/main.py。整库重算（缓存可重建），按客户产出 rapprochement.json 和汇总，并在 stdout 做不变量自检。

确定性解析 + 算术门禁：解析器只提议结构化数据；门禁检查 relevé 的期初 + Σ 操作 = 期末、发票 HT + TVA = TTC 等。对不上或扫描 PDF 无文本的，进 needs_vision.json，不能静默信任。
视觉校正（每次 run 若被点名则必做）：为文档准备页图与 sidecar 骨架；用 Read 读图，修正金额（贷记为正、借记为负）、不可读字段写 null，写入 .vision.json 后重跑。Sidecar 优先，但仍过同一门禁。
核销规则：方向决定匹配（vente 用 crédit，achat / 费用用 débit）；不能只看绝对值。除金额外还要参考、对手方或近日期；一操作只消一张票；银行杂项进 excluded_bank_lines。
输出与汇报：rapprochement.json 的 periods[] 含发票状态（paid / partial / unpaid / overdue）、未匹配行、排除行、异常与 relances。向会计汇报时按：已结 / 待 vision / 双付与 TVA / 无票流水与催款分层组织话术。

边界与注意

不为每家银行写专用解析器：未知格式失败进 vision，不静默错。
不负责文档分类（classement-document）和邮件催款正文（workflow e-mail）；费用单按 décaissement 核销，不参与对外 relance。
已整月锁定的 batch.lock.json 在源文件不变时保持不动；文件变更会重开该月。