单据录入

要解决什么问题

采购、仓储、财务同事手里常见的是纸质或拍照的单据：送货单、入库单、手写清单。人工把「物料名称、规格、数量、供应商、日期」逐行敲进 Excel，既慢又容易列错位。更麻烦的是，各家的 Excel 表头并不统一——有人用「品名」，有人用「物料名称」，表头也不一定在第一行。

本技能把「识图 → 结构化字段 → 写入表格」串成一条可重复执行的流程，并且不绑定固定模板规范：你可以直接上传自己的 Excel，也可以让系统在临时目录生成一份标准表头的 单据录入_.xlsx。

技能如何工作

Step 0：确定录入模板（二选一）

• 分支 A：读取你上传的模板，扫描前 10 行，用关键词（如「序号/物料/名称/数量/供应商/日期/备注」）定位真实表头行；合并单元格只取左上角文本。
• 建立「表头文本 → 标准字段（line_no、material_name、quantity 等）」映射；有歧义时会请你确认。
• 分支 B：未提供模板时，用 openpyxl 自建表头：序号 | 物料名称 | 规格型号 | 数量 | 供应商 | 日期 | 备注。

Step 1～2：识图与映射填充

对单张或多张图片提取字段；同一字段多处出现时优先打印体；数量带单位（如「5000片」）只取数字，单位可记入备注；日期缺失则用当天。序号从 1 自动递增。

写入时严格从 header_row + 1 起填数据，禁止覆盖表头行；模板里未匹配到标准字段的列（如单价、金额）留空。

Step 3：输出文件

在模板基础上逐行 ws.cell(...) 写入，保存为带 UUID 或时间戳后缀的文件名，避免覆盖原模板。

适用边界与注意点

• 图片模糊、缺角、反光导致字段不全时：只填能识别的部分，未识别字段留空或写备注，禁止猜测填充。
• 表头识别失败时不要假设第一行就是表头；字段映射顺序必须与识别结果一致，避免名称、数量错位。
• 流程依赖你明确模板来源（自带或自建）；列含义超出关键词表且未说明用途的列，不会被随意填入其它数据。