TAPEX 表格问答：查询结果如何核验

先划定表格问答边界

本文面向有基础 Python 能力的编辑和工具开发者。目标不是让模型直接写报告，而是从结构化表格中取得待核对答案。扫描件 OCR、开放式趋势判断和需要外部资料的问题不放入本流程。官方索引收录了 Efficient Table Pre-training without Real Data: An Introduction to TAPEX，但索引本身不能证明当前兼容性、准确率或生产接口。

准备可追溯的表格

1. 复制业务表格并登记文件版本、导出时间和负责人，不在原始文件上直接修改。
2. 保留一行字段名，每列只表达一个含义，例如“月份”“区域”“订单数”“销售额”。
3. 把数字列统一为数值类型，去除货币符号、千位分隔符和合计行中的混合文本。
4. 为每一行增加稳定行号，后续记录模型答案对应的行和列。
5. 把问题拆成单值查询、条件筛选和聚合计算三类，暂不混入解释性结论。

如果还需要从数据集查询流程中借鉴字段登记方式，可参考数据集查询字段与筛选流程，但不要把它当作 TAPEX 的接口说明。

设计能被表格回答的问题

问题应明确列名、筛选条件和计算范围。合适的问题包括“2月华东的订单数是多少”“1月各区域销售额之和是多少”。不合适的问题包括“华东市场为什么增长”“下季度销售额会是多少”，因为它们需要因果分析或预测，不能仅凭当前表格核验。

• 单元格定位：查询某个条件组合对应的一个字段值。
• 条件筛选：找出满足条件的行，并保留行号。
• 聚合计算：明确求和、计数、平均值以及参与计算的行。
• 不支持问题：缺少字段、依赖表外资料、需要预测或含糊限定词的问题。

记录模型输入与预测

资料包没有确认当前模型名称、处理器调用方式或可用语言，因此不要把下面的伪代码当作可直接运行的官方接口。开发时应先核对当前模型卡、处理器文档和版本，再把表格与问题编码成目标接口要求的结构。

table = {
  "月份": ["1月", "1月", "2月"],
  "区域": ["华东", "华南", "华东"],
  "订单数": [120, 80, 150],
  "销售额": [36000, 24000, 45000]
}
question = "2月华东的订单数是多少"
# prediction = model(table=table, question=question)
# 保存 question、table_version、prediction 和 raw_response

每次记录至少包含表格版本、问题原文、清洗规则、输入快照、预测答案、原始响应和人工复核状态。预测答案只能进入待核对区，不能直接写入报告。

定位单元格并独立计算

1. 先按问题中的月份和区域筛选行。示例问题应命中第3行。
2. 再读取“订单数”列，记录单元格位置为第3行“订单数”。
3. 若问题是“1月销售额之和”，明确参与计算的是第1、2行。
4. 用 Python 或表格软件独立计算：36000+24000=60000。
5. 比较模型答案、单元格值或计算值，保存一致或不一致的证据。

常见故障与修正动作

• 字段名称对不上：原因是问题使用了别名或表头含空格。修正动作是保留原始表头，同时建立别名映射，并在日志中保存映射版本。
• 聚合结果多算合计行：原因是表格同时含明细和汇总。修正动作是先标记行类型，只对明细行计算。
• 数字被当成文本：原因是货币符号、逗号或空值混入字段。修正动作是清洗后检查类型，并随机抽查原单元格。
• 答案看似合理但定位失败：原因是只保存了答案，没有保存筛选条件和行号。修正动作是把行号、列名和参与计算的记录一起归档。
• 问题无法由表格回答：原因是问题要求预测、解释原因或调用外部知识。修正动作是标记为“不支持”，转交代码分析或人工研究流程。

发布前验收清单

1. 表格文件版本、导出时间和清洗记录已登记。
2. 字段名、数据类型、空值和合计行已检查。
3. 每个问题都写明筛选条件、字段和计算范围。
4. 模型输入、原始响应和预测答案均已保存。
5. 单值答案已回查对应单元格，聚合答案已独立计算。
6. 不支持的问题和错误答案已单独列出，没有进入报告正文。
7. 报告引用的每个数字都能回到表格版本、行号和列名。
8. 当前接口、语言支持和表格规模限制仍未核对的部分，已明确标注为待确认。