阿拉丁盘点稽核工坊

解决什么问题

月末盘点，财务拿账面库存表，仓库拿实盘表，两边对不上。差异散落在各库位、各批次里，要人工翻 Excel、按 SKU 合并、逐行算金额、再手写整改单，半天起步。本技能把这一步压成一条流水线：两份 CSV 进去，盘点差异三件套出来。

核心能力

• 编码与表头自动适配：CSV 自动探测 UTF-8/GBK 编码；中文表头别名（物料编码/货号、账面数量/盘点数量、成本价/单价、库位/仓库、批次 等）直接识别，Excel「另存为 CSV」即可接入。
• 按 SKU 聚合对账：同一 SKU 分散在多库位、多批次时先合并计数再比对，不会拆成多行误判。
• 四类差异自动定位：盘亏、盘盈、疑似丢失（账面有实盘无）、账外物资（实盘有账面无），分别打标签。
• 成本折算：按 成本价 自动算差异金额与预计损失，缺价则标注无法量化，不编造数字。
• 容差设置：--tolerance 0.02 让 ±2% 以内的差异忽略，适配称重类与损耗类物料。
• 9 条体检规则：R1–R9 覆盖盘亏、盘盈、疑似丢失、账外物资、负数账面库存、实盘重复行、缺成本单价、单位不一致、实盘缺 SKU 编码；配合 100 分评分与 PASS/REVIEW/FAIL 结论，每条问题附带整改建议。

三步走完稽核

1. 接入（ingest）：两份 CSV 就位；没有真实数据可用 --demo 生成含 8 类埋雷问题的演示数据先看效果。
2. 稽核（audit）：输出 JSON，含评分、结论、账实一致率、预计损失、逐条问题与差异明细；退出码 0 = PASS，2 = 需人工复核。
3. 报告（report）：产出 stock_board.html（自包含差异看板）、stock_diff.csv（UTF-8-SIG，Excel 直开无乱码）、stock_fixlist.md（整改清单，可直接派单给仓管/财务）。

边界与注意点

• 只做盘点时点核对，不做需求预测、补货建议、安全库存，也不做进销存流水记账。
• 不做固定资产折旧与减值计提。
• 数据入口是导出的 CSV，不对接 WMS/ERP 接口。
• 只有一份表（只有账面或只有实盘）无法对账，先补齐数据。
• 全流程纯 Python 标准库、零第三方依赖，离线可跑；确定性排序 + sort_keys，同输入同输出，结果可复现、可审计。
• 中间层 _stock_ir.json 遵循 aladin.stock/v1 契约，可供下游资产/财务技能复用。