shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

阿拉丁盘点稽核工坊

账面库存+实盘数据 → 一键盘点差异稽核：盘亏盘盈自动定位、损失金额自动折算、整改清单直接派单，月底盘库对账从半天缩到1分钟。

personAuthor: user_d18c97eahubcommunity
downloadDownload package

阿拉丁盘点稽核工坊（aladin-stock-forge）

把账面库存表与实盘盘点表（CSV，Excel 另存即可）一键比对成盘点差异三件套：自包含 HTML 差异看板、Excel 直开的 CSV 差异明细、可直接派单的 Markdown 整改清单。自动核出盘亏/盘盈/疑似丢失/账外物资，按成本价折算差异金额与预计损失，并用 9 条体检规则把住盘点数据质量关。月底盘库对账从人工半天缩到 1 分钟。阿拉丁出品。

何时触发

  • "盘点对账" / "库存盘点差异" / "账实核对" / "账实不符"
  • "盘亏盘盈" / "仓库对不上" / "库存差多少" / "丢了多少货"
  • "月底盘库" / "年终盘点" / "盘点报告" / "盘点整改"
  • "负库存" / "账外物资" / "库存体检"
  • 英文关键词：stocktake / inventory audit / stock reconciliation / cycle count
  • 用户给出账面库存与实盘两份表格并希望比对差异

何时不触发

  • 用户要做采购/补货计划——本技能只管账实差异，不做需求预测
  • 用户要进销存系统记账（入库单/出库单流水）——本技能只做盘点时点核对
  • 用户只是问盘点方法论/制度咨询——直接回答即可，不需要跑比对
  • 用户要固定资产折旧计提——本技能不做折旧计算
  • 用户只有一份表（只有账面或只有实盘）——缺一侧无法对账，先补齐数据

能力边界

能做：

  1. 解析账面/实盘两份 CSV（自动探测 UTF-8/GBK 编码；中文表头别名：编码/物料编码/货号、名称/品名、账面数量/实盘数量/盘点数量、成本价/单价、单位、库位/仓库、批次）
  2. 按 SKU 聚合比对：同一 SKU 多库位多行自动合并计数后再对账
  3. 四类差异自动定位：盘亏（shortage）、盘盈（overage）、疑似丢失（账面有实盘无）、账外物资（实盘有账面无）
  4. 差异金额与预计损失按成本单价自动折算（缺价则标注无法量化）
  5. 支持 --tolerance 容差比例（如 0.02 = ±2% 内忽略），适配称重类/损耗类物料
  6. 9 条盘点体检规则：R1 盘亏 / R2 盘盈 / R3 疑似丢失 / R4 账外物资 / R5 负数账面库存 / R6 实盘重复行 / R7 缺成本单价 / R8 单位不一致 / R9 实盘缺 SKU 编码
  7. 100 分稽核评分 + PASS/REVIEW/FAIL 结论 + 账实一致率，每条问题附整改建议，整改清单可直接派单

不能做：

  1. 不做需求预测、补货建议、安全库存计算
  2. 不做进销存流水记账与单据管理
  3. 不做固定资产折旧、减值计提
  4. 不对接 WMS/ERP 接口（以导出 CSV 为数据入口）

使用流程（三步）

约定：{PY} 为 Python 3.8+ 解释器路径，{SKILL} 为本技能根目录。

第 1 步：数据接入（ingest）

{PY} {SKILL}/scripts/stock_ingest.py --book 账面库存.csv --count 实盘盘点.csv --out _stock_ir.json
  • 两份表都是 CSV（Excel「另存为 CSV」即可），表头支持中英文别名，自动探测编码
  • 没有真实数据想先看效果：{PY} {SKILL}/scripts/stock_ingest.py --demo 目标目录 生成含 8 类埋雷问题的演示数据

第 2 步：差异稽核（audit）

{PY} {SKILL}/scripts/stock_audit.py --ir _stock_ir.json --out _stock_audit.json [--tolerance 0.02]
  • 退出码：0 = PASS；2 = 有高危问题或评分不足（REVIEW/FAIL），需人工复核
  • 输出 JSON 含评分、结论、账实一致率、预计损失、逐条问题与差异明细

第 3 步：生成报告（report）

{PY} {SKILL}/scripts/stock_report.py --audit _stock_audit.json --outdir 输出目录 --title "XX仓库2026年7月盘点差异稽核"

产出三件套：

  • stock_board.html —— 自包含差异看板（评分/结论/一致率/损失 + 差异明细 + 问题清单），直接发老板
  • stock_diff.csv —— 差异明细台账，Excel 直开（UTF-8-SIG 无乱码）
  • stock_fixlist.md —— 整改清单，逐条附整改建议，直接派单给仓管/财务

契约与集成

  • IR 契约 aladin.stock/v1：_stock_ir.json 为标准化中间层，可供下游资产/财务技能复用
  • 全流程纯 Python 标准库，零第三方依赖，离线可跑，库存数据不出本机
  • 同输入同输出（确定性排序 + sort_keys），结果可复现、可审计

常见问题

  • 表头识别失败：确认 SKU 列名在别名表内（编码/商品编码/物料编码/货号/sku/item_code），或改列名后重试
  • GBK 乱码：无需转码，脚本自动探测 UTF-8/GBK/GB18030
  • 称重物料误报差异：加 --tolerance 0.02 设置容差
  • 多库位同 SKU：自动合并计数并以 R6 提示核实，不会算成两个 SKU

出品

阿拉丁（aladin）· 办公自动化技能系列。同系列覆盖排班、考勤、工资条等场景，契约互通、可组流水线。