物资入库清单清洗助手 — Material Inbound Excel Cleaner

material-inbound-excel-cleaner · v0.1.2 · 免费 MVP

把供应商、采购、现场人员提交的杂乱物资入库 Excel 清单，清洗成可审阅的统一导入模板。

它适合处理这些问题：

• 表头叫法不统一，例如“品名 / 物资名称 / 物料名称”“实收数量 / 入库数量 / qty”
• 表头不在第一行，前面有标题、日期或说明
• 必填字段缺失，需要逐行指出
• 数量格式混乱，需要导入前预检
• 设备类型、库房、规格型号需要人工复核提醒

---

它不是什么

• 不是仓储系统
• 不连接任何服务器
• 不读取或写入生产数据库
• 不执行真实入库
• 不创建新物资
• 不发送通知
• 不替代仓管、采购或财务复核

使用前请阅读 DISCLAIMER.md。

---

输出内容

运行后生成：

| 文件 | 用途 | | --- | --- | | cleaned_inbound_template.xlsx | 清洗后的标准入库模板 | | import_report.md | 字段映射、统计、异常行、提醒 | | errors.csv | 异常行明细 |

标准列顺序：

物资编码, 物资名称, 规格型号, 单位, 数量, 设备类型, 库房, 地址码, 单价, 批次号, 导入批次号, 价格状态, 备注

---

本地使用

cd material-inbound-excel-cleaner
python3 scripts/clean_inbound_excel.py path/to/input.xlsx --out-dir outputs

要求：

• Python 3.9+
• openpyxl

---

示例

运行内置烟测：

python3 tests/run_smoke_test.py

预期结果：

• 生成一份乱表样例
• 清洗出 2 行有效数据
• 标记 2 行异常数据
• 生成三份输出文件

---

设计边界

本工具借鉴真实仓储系统中的“Excel 导入预检”思路，但第一版只保留离线文件清洗能力。它不会判断某个物资是否已存在于你的生产系统，也不会判断清洗后的结果是否可以直接入库。

清洗结果必须由人工确认后，才能进入任何真实仓储系统。

---

相关 Skill

同系列的采购清单场景请用 purchase-list-excel-cleaner。两者模板和必填项不同，不要混用 —— 入库版 物资编码 必填，采购版不必填。

本工具不会自己判断你上传的是什么表 —— 你选了它，意图就已经确定了。

唯一例外：如果一行都清洗不出来（全部数据行都没通过必填校验），报告顶部会给一句提示，指出这份表更像采购清单、盘点表还是领料单，并在对应 Skill 已发布时给出名字。这只是提示，不会自动切换模板，也不会替你重新处理。

---

反馈

如发现字段误识别、异常行误判或模板不适配，请反馈至：ruanchaoyin@ruancyai.com。