技能介绍

要解决的问题

实物盘点表很少是干净规范的：盘点批次、库房、盘点人、参与盘点人、盘点日期 这些批次级信息通常写在明细表上方的表头区，各表格式不一；列名常是别名或简称；明细中间还夹着 合计、小计 行。这类表无法可靠地对比账面数量与实盘数量。

核心能力

该技能完全离线、基于文件，直接处理用户提供的 Excel：

表头区回填：提取批次级信息并回填到每条明细，同时记录每个值的来源行，便于追查错填；同名明细列优先于表头区。
逐行校验：只有缺失或非数字的 实盘数量 才算失败行。
实盘为 0 是有效数据：代表货架为空，不过滤、不视为缺失，报告单列一节列出这些行。
缺账面数量时降级：找不到 账面数量 列时转入 待比对模板 模式，账面数量 / 差异数量 / 差异类型 留空，绝不虚构账面数量。
校验已有差异列：原表若已带差异列，按 实盘 − 账面 复核而非静默覆盖；不一致时写入重算值，并给出写明双方操作数的告警，例如 表中差异 -30 与实盘 280 − 账面 300 = -20 不符。
合计行单独计数：首个非空单元格为 合计 / 总计 / 小计 / 共计 / 累计 / 总额 / total / sum 的行跳过并单独统计，不报为无效行。

输出物

统一列序：盘点批次, 库房, 盘点人, 参与盘点人, 盘点日期, 物资编码, 物资名称, 规格型号, 单位, 账面数量, 实盘数量, 差异数量, 差异类型, 备注，其中 物资名称 与 实盘数量 为每行必需，差异类型 取 盘盈 / 盘亏 / 相符，缺账面数量时取 未比对 而不是留空。

运行生成 cleaned_stocktake_template.xlsx、stocktake_report.md、errors.csv。报告只呈现计算结果：差异明细 工作表仅含差异行并按绝对值排序，300 行的表里最大的问题要出现在第二行；同时给出 净差异 与 差异绝对值合计——+100 与 −100 净为 0，看起来是一次干净盘点，实际有两行出错；盘点覆盖率 直接标在数字旁。库存表通常不带单价，因此不计算差异金额，并明确说明。