物资入库清单清洗助手

你在处理入库表时遇到的麻烦

物资入库的原始表格几乎没有两张长得一样。表头可能写成 物资名称，也可能写成 名称、品名、中文名；单位可能是 个、台、套，也可能整列留空；数量列里混着 10、10个、约 10 这类不一致写法。更麻烦的是，这类文件往往带着肉眼看不见的问题——合计行藏在数据中间、同一批物资被拆成多行、库房名和地址码对不上。手工逐行改，一版几百行下来，出错的地方通常比改对的还多。

这个技能要做的，是把这些散乱的表清洗成一份可以提交给仓库系统的导入准备文件。

它的工作方式

清洗过程完全离线，只读取你上传的 Excel，不访问任何仓库系统或生产数据库。流程大致分为五步：

1. 扫描工作簿，识别出真正的表头行，而不是把标题行或说明行误当成表头；
2. 将杂乱的表头映射到标准模板字段，依赖的是一份别名映射表而非猜测；
3. 逐行归一化到规范列结构，按固定顺序输出：物资编码、物资名称、规格型号、单位、数量、设备类型、库房、地址码、单价、批次号、导入批次号、价格状态、备注；
4. 标记而不是静默丢弃——校验失败的行会保留在 errors.csv 中，带明原因，方便你回头找原始文件核对；
5. 产出三份文件：cleaned_inbound_template.xlsx（清洗后的待导入表）、import_report.md（人读的校验报告）、errors.csv（机器可处理的错误清单）。

合计行的处理也做了特殊对待。凡是首格为 合计、总计、小计、共计、累计、总额、total、sum 的行，会被跳过并单独计数，不会计入错误行。把合计行算成数据行是这类工具最常见的坑，因为它会让错误率虚高，掩盖真实问题。

适用边界与注意点

这个技能不是入库系统本身，也不会替你完成入库动作。它不创建物料、不执行入库、不发通知、不调用任何仓库 API，也不读写生产数据库。它产出的 cleaned_inbound_template.xlsx 是一份导入准备文件，在真正提交给仓库之前，仍需人工逐项确认，尤其是单价、批次号、库房这三项。

另一个容易误解的地方是：它不做单据类型识别。如果你上传的是出库单或盘点表，技能不会主动切换到别的模板——你选择这个技能本身就代表了意图。唯一的例外是，当所有行都校验失败时，报告末尾会出现一条提示，指出这张表可能属于另一个场景。这只是给使用者的提醒，报告里写了什么就转述什么，由你来决定下一步怎么做。

完整的别名映射表、字段校验规则和从仓库上下文推导的启发式规则，都在 references/field-mapping.md 里，需要做二次调整时可以直接查阅。