业务台账对账

要解决什么问题

当两套业务台账——比如财务导出的付款记录与银行流水，或者订单系统与结算报表——需要交叉核对时，最常见的做法是手动复制粘贴到 Excel，用 VLOOKUP 或透视表匹配。这种方法看似简单，却容易在重复记录、空键、金额单位不一致、时区差异等问题上翻车。而且一旦匹配规则写错，错误会静默扩散，最终无人能说清差异的来源。本技能针对这种场景：在数据不动的前提下，对两份数据集做确定性的逐条核对，输出匹配记录、未匹配记录、模糊候选、控制合计以及完整的审计轨迹，让每一笔差异都有据可查。

对账流程

技能遵循六个步骤，每一步都有明确的产出和守卫条件。

1. 定义两侧：识别 Side A 和 Side B 的业务含义、报告期间、期望关系、币种、时区及权威来源。如果正确的关系不明确，必须获得用户确认才能继续。
2. 匹配前画像：对每个数据集报告行数、列数、候选键的唯一性、空键、重复键、畸形键、日期范围和金额合计，以及类型、编码、单位、符号、币种不一致，还有表头、小计、页脚行。在键和金额语义确认前，不得开始匹配。
3. 建立规则层级：从最严格的规则开始依次放宽：精确复合业务键；规范化复合键；规范化键加金额容差；规范化键加日期窗口；仅作为候选的模糊相似度用于人工审查。每条匹配记录都会分配一个规则 ID。
4. 确定性执行：对于明确给出键列的 CSV 输入，优先使用 scripts/reconcile_csv.py 脚本。对于 XLSX 输入，通过可用的电子表格工具导出工作副本为 CSV，或直接复制相同的控制，绝不覆盖原始工作簿。
5. 异常调查：将每个异常归类为“Side A 缺失”、“Side B 缺失”、“重复键”、“金额不符”、“日期不符”、“多个模糊候选”、“解析或格式错误”、“被批准的规则排除”或“未解决”。保留候选行并说明自动匹配停止的原因。
6. 报告与签核：交付对账范围和规则表、两侧控制合计、按规则统计的匹配数量与金额、按类别统计的异常数量与金额、匹配与未匹配明细文件、最重要的五处重大差异，以及假设、未解决问题和建议后续行动。

质量门会验证守恒等式：Side A 行数等于匹配行加未匹配行；Side B 同理；任何记录不会出现在超过一个确认配对中；所有数值解析失败均被报告；报告合计可由导出明细文件复现；模糊或模糊候选保持未确认状态。

边界与注意点

这套方法不是通用的数据集成工具，也不做模糊匹配的自动确认。如果两侧关系不是一对一，必须由用户显式定义，否则会直接拒绝。对于无法通过精确或规范化键定位的记录，技能只会给出候选，不会擅自拍板。同时，技能要求输入在转换前被完整复制，所有被过滤、排除或容差调整的行都记录在案，确保事后能逐条追溯。这意味着前期数据质量较差时，对账过程会花更多时间在画像和异常分类上，而不是直接出结果——这是刻意的取舍。