企业Excel清单清洗入口

解决什么问题

企业里的 Excel 清单往往不是统一模板：表头漂移、合并单元格、Sheet 名随意、说明文字和正文混在一起。即使知道大致属于入库、采购、盘点或报价，人工判断和逐行清洗既慢又容易出错。这个入口负责从混乱的工作簿出发，自动判断类型并清洗到规范模板，同时输出校验证据和报告。

如何工作

整个流程是离线、文件级的，分为四层：

• 识别：recognizer.py 综合结构、表头、标题、Sheet 名、文件名、合并单元格、说明文字和正文关键词，先打分再决定候选顺序。结构证据优先于标题关键词。
• 预检：precheck.py 对候选类型做只读兼容性检查，确认必填字段、专有字段、冲突字段和可用数据行。
• 调度清洗：dispatcher.py 按候选顺序选择第一个通过预检的模块执行清洗，模块内置在包内，不调用外部技能。
• 输出验证：validator.py 检查输出工作簿的 Sheet、表头、数量金额一致性以及 errors.csv，只有验证通过才返回成功；失败则丢弃中间产物。

支持四类：物资入库清单输出 cleaned_inbound_template.xlsx；采购清单/订单输出 cleaned_purchase_template.xlsx；盘点表输出 cleaned_stocktake_template.xlsx；供应商报价单输出 quotation_comparison.xlsx。命令行一次运行，退出码区分清洗成功、安全停止和内部错误，可用 --json 让程序读取结果。

适用边界与注意点

这个技能不连接采购、仓库或财务系统，不读写生产数据库，不下单、不审批、不做会计税务判断。它只处理单个工作簿，v0.1.0 不覆盖领料/申领清单、工资考勤财务报销等高风险场景，也不支持图片型表格、PDF 表格、扫描件 OCR，以及一个工作簿混合多种业务类型且要求一次全部清洗。

出现无法可靠识别、文件损坏、所有候选预检失败、多类型冲突或验证未通过时会安全停止，提示「不支持或无法可靠处理」，并在 处理报告.md 说明原因。请保持原始文件只读，不要把输出当成业务系统的正式凭证；自动检查覆盖结构和算术一致性，数量与金额的业务正确性仍需人工复核。