物料仓库台账

v1.0.0 · 行业专用 · 官方

物料仓库库存低库存盘点采购行业小紫

简介

小紫物料仓库台账面向 仓库管理员、采购、生产计划、后勤，解决物料库存管理中的重复事务：

分级预警：低库存 → 严重不足（≤50% 安全库存）→ 零库存 → 负库存
自动计算库存/安全库存比率，按紧急程度排序
汇总各仓库、各类别 SKU 数量与库存总量
盘点检查：缺仓库/库位、未设安全库存、盘点逾期（默认 90 天）
评分一键库存管理健康度与补货待办

标准库实现，无需 pip。 库存快照维护 CSV 台账即可，可从 ERP 导出后定期更新。

本插件管 库存台账与预警，不做采购下单或入库操作（那些走业务系统）；AI 可据此给出补货建议。

包含能力

action	功能
`scan`	库存概览 + 管理评分 + 待办建议
`low_stock`	低库存/严重不足清单（含库存比率）
`zero_stock`	零库存与负库存清单
`by_warehouse`	按仓库汇总 SKU 数、库存量、预警数
`by_category`	按物料类别汇总
`inventory_check`	盘点检查（异常项 + 问题标签）
`report`	Markdown/JSON 库存报告
`info`	检查配置与默认路径

适用场景

场景	怎么说
每日巡检	「做库存概览」「今天库存怎么样」
补货决策	「哪些物料库存不足」「严重不足的有哪些」
紧急处理	「有没有零库存」「有没有负库存」
仓库对比	「按仓库统计库存」「原料仓情况如何」
类别分析	「包材类库存汇总」
盘点前检查	「做盘点检查」「哪些物料盘点逾期了」
报告归档	「出库存管理报告」

台账字段（CSV）

列名	说明
物料编号	SKU 唯一编码
物料名称 / 规格 / 类别	如不锈钢螺栓、M8×30、五金
仓库 / 库位	如原料仓、A-01
当前库存 / 安全库存	数值，支持小数
单位	个、kg、桶、卷等
最后盘点日期	YYYY-MM-DD，超期会标记「盘点逾期」

配置项 count_overdue_days（默认 90）控制盘点逾期判定天数。

预警规则：

级别	条件
低库存	0 < 库存 ≤ 安全库存
严重不足	0 < 库存 ≤ 安全库存 × 50%
零库存	库存 = 0
负库存	库存 < 0（需立即核对账务）

安装

1. 下载解压

解压到例如：

D:\xiaozi-plugins\行业专用\物料仓库台账\

2. 配置

复制 config/stock_log_config.example.json 为 config/stock_log_config.json：

{
  "org_name": "本公司",
  "stock_file": "D:/warehouse/stock_log.csv",
  "count_overdue_days": 90
}

3. 测试

run.bat --action info
run.bat --action scan
run.bat --action low_stock
run.bat --action inventory_check

看到 "success": true 即表示安装成功。

注册技能

技能名： stock_log

描述：

物料仓库台账 v1.0。scan/low_stock/zero_stock/by_warehouse/by_category/inventory_check/report。仓库物料库存与补货预警。库存台账CSV。

脚本路径：

D:\xiaozi-plugins\行业专用\物料仓库台账\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": ["scan", "low_stock", "zero_stock", "by_warehouse", "by_category", "inventory_check", "report", "info"]
    },
    "filepath": {"type": "string", "description": "库存台账 CSV 路径"},
    "output": {"type": "string", "description": "报告输出路径"},
    "date": {"type": "string", "description": "参考日期 YYYY-MM-DD"},
    "format": {"type": "string", "description": "report 输出格式：markdown 或 json"}
  },
  "required": ["action"]
}

AI 怎么说

做库存概览
哪些物料库存不足
有没有零库存的
负库存有哪些
按仓库统计库存
做盘点检查
出库存管理报告