库存监控与补货提醒

库存监控与补货提醒技能。基于真实Excel台账（美兰中心C+服务.xlsx）监控库存水位，计算可用月数，生成补货提醒。触发场景：(1) 实时监听库存变化（出入库操作），(2) 定时任务每日09:00检查库存状态，(3) 手动触发库存检查（@企服助手库存检查）。

perrykono-debug@perrykono-debug

Install

openclaw skills install @perrykono-debug/inventory-monitor

库存监控与补货提醒技能 (Inventory Monitor Skill)

功能概述

本技能用于实时监控园区库存物资的水位，基于中集金地美兰中心真实Excel台账，自动计算可用月数，当库存低于安全阈值时生成补货提醒并推送到企微。

数据源配置

数据文件: /Users/mac/美兰中心C+服务.xlsx

工作表映射:

功能模块	工作表名	用途
秩序环境库存	📦库存管理📦秩序环境	主数据源（日常消耗品）
固定资产库存	📦库存管理📦固定资产	补充数据（固定资产）
工程库存	📦库存管理📦工程	补充数据（工程工具）

数据接口（真实Excel字段映射）

秩序环境库存表字段（11个）

关键字段:

Excel列序号	字段名	类型	说明	示例值
1	名称	TEXT	物资名称	香薰液
2	规格/单位	TEXT	规格	桶 / 5片/包
3	总库存	NUMERIC	总量	9
4	可用月数	NUMERIC/TEXT	计算字段	9 或 "计算错误"
5	图片	TEXT	图片链接	（可选）
6	入库	NUMERIC	入库数量	0
7	出库	NUMERIC	出库数量	0
8	部门	TEXT	所属部门	环境 / 安管
9	现库存	NUMERIC	当前库存	9
10	月使用量	NUMERIC	月消耗量	1
11	备注	TEXT	备注	常用物资

固定资产库存表字段（11个）

Excel列序号	字段名	用途
1	名称	物资名称
2	规格/单位	规格
3	总库存	总量
4	图片	图片链接
5	现库存	当前库存
6	入库	入库数量
7	入库日期	入库时间
8	出库	出库数量
9	出库日期	出库时间
10	部门	所属部门
11	备注	备注

核心逻辑

1. 库存水位计算

python

def calculate_inventory_status():
    """
    计算所有物资的库存水位
    
    Returns:
        dict: 分级库存状态
    """
    wb = openpyxl.load_workbook('/Users/mac/美兰中心C+服务.xlsx')
    
    inventory_status = {
        "缺货": [],     # 可用月数 ≤ 0
        "预警": [],     # 可用月数 ≤ 2
        "关注": [],     # 可用月数 ≤ 3
        "正常": []      # 可用月数 > 3
    }
    
    # 1. 检查秩序环境库存
    ws_env = wb['📦库存管理📦秩序环境']
    
    for row in ws_env.iter_rows(min_row=2, values_only=True):
        name = row[0]           # 名称
        spec = row[1]           # 规格/单位
        current_stock = row[8]  # 现库存
        monthly_usage = row[9]  # 月使用量
        
        # 计算可用月数
        if monthly_usage and monthly_usage > 0:
            available_months = current_stock / monthly_usage
        else:
            available_months = 999  # 无使用量，视为无限
        
        # 分级归档
        item = {
            "名称": name,
            "规格/单位": spec,
            "现库存": current_stock,
            "月使用量": monthly_usage,
            "可用月数": f"{available_months:.1f}",
            "部门": row[7]
        }
        
        if available_months <= 0:
            inventory_status["缺货"].append(item)
        elif available_months <= 2:
            inventory_status["预警"].append(item)
        elif available_months <= 3:
            inventory_status["关注"].append(item)
        else:
            inventory_status["正常"].append(item)
    
    return inventory_status

2. 补货提醒生成

python

def generate_replenishment_alert():
    """
    生成补货提醒清单
    
    Returns:
        list: 需要补货的物资列表
    """
    inventory_status = calculate_inventory_status()
    
    alerts = []
    
    # 1. 缺货物资（紧急）
    for item in inventory_status["缺货"]:
        alerts.append({
            "物资名称": item["名称"],
            "规格": item["规格/单位"],
            "当前库存": item["现库存"],
            "月使用量": item["月使用量"],
            "可用月数": item["可用月数"],
            "紧急程度": "🚨 缺货",
            "建议采购量": f"{item['月使用量'] * 3}（3个月用量）" if item["月使用量"] else "建议采购"
        })
    
    # 2. 预警物资（高优先级）
    for item in inventory_status["预警"]:
        alerts.append({
            "物资名称": item["名称"],
            "规格": item["规格/单位"],
            "当前库存": item["现库存"],
            "月使用量": item["月使用量"],
            "可用月数": item["可用月数"],
            "紧急程度": "⚠️ 预警",
            "建议采购量": f"{item['月使用量'] * 2}（2个月用量）" if item["月使用量"] else "建议采购"
        })
    
    # 3. 关注物资（中优先级）
    for item in inventory_status["关注"]:
        alerts.append({
            "物资名称": item["名称"],
            "规格": item["规格/单位"],
            "当前库存": item["现库存"],
            "月使用量": item["月使用量"],
            "可用月数": item["可用月数"],
            "紧急程度": "📢 关注",
            "建议采购量": f"{item['月使用量'] * 1}（1个月用量）" if item["月使用量"] else "建议采购"
        })
    
    return alerts

3. 出入库记录更新

python

def update_stock_transaction(item_name, transaction_type, quantity, department):
    """
    更新出入库记录
    
    Args:
        item_name: 物资名称
        transaction_type: 类型（入库/出库）
        quantity: 数量
        department: 部门
    
    Returns:
        bool: 更新是否成功
    """
    wb = openpyxl.load_workbook('/Users/mac/美兰中心C+服务.xlsx')
    ws_env = wb['📦库存管理📦秩序环境']
    
    # 查找物资
    for row_idx in range(2, ws_env.max_row + 1):
        if ws_env.cell(row=row_idx, column=1).value == item_name:
            # 更新库存
            current_stock = ws_env.cell(row=row_idx, column=9).value
            
            if transaction_type == "入库":
                new_stock = current_stock + quantity
                ws_env.cell(row=row_idx, column=9).value = new_stock
                ws_env.cell(row=row_idx, column=6).value = quantity  # 入库
            elif transaction_type == "出库":
                new_stock = current_stock - quantity
                ws_env.cell(row=row_idx, column=9).value = new_stock
                ws_env.cell(row=row_idx, column=7).value = quantity  # 出库
            
            # 更新可用月数
            monthly_usage = ws_env.cell(row=row_idx, column=10).value
            if monthly_usage and monthly_usage > 0:
                available_months = new_stock / monthly_usage
                ws_env.cell(row=row_idx, column=4).value = available_months
            
            # 保存Excel
            wb.save('/Users/mac/美兰中心C+服务.xlsx')
            
            return True
    
    return False

库存监控推送模板

每日库存检查

text

━━━━━━━━━━━━━━━
【库存监控日报】2026-05-28

━━━ 🚨 缺货物资 ━━━
{缺货清单}

━━━ ⚠️ 预警物资 ━━━
{预警清单}

━━━ 📢 关注物资 ━━━
{关注清单}

━━━ 统计 ━━━
物资总数：XX个
缺货：XX个 | 预警：XX个 | 关注：XX个

⚡ 操作链接：[腾讯文档-库存管理]
━━━━━━━━━━━━━━━

紧急补货提醒

text

⚠️⚠️⚠️ 【紧急补货提醒】⚠️⚠️⚠️

物资名称：{name}
规格：{spec}
当前库存：{current_stock}
月使用量：{monthly_usage}
可用月数：{available_months}

建议采购量：{purchase_quantity}

@采购人员 请尽快安排采购

━━━━━━━━━━━━━━━

执行流程

text

Step 1 → 读取Excel库存管理表
         工作表：📦库存管理📦秩序环境
         字段：名称、现库存、月使用量

Step 2 → 计算可用月数
         可用月数 = 现库存 / 月使用量
         特殊情况：月使用量=0 → 视为无限

Step 3 → 分级判断
         ├─ 可用月数 ≤ 0  → 缺货
         ├─ 可用月数 ≤ 2  → 预警
         ├─ 可用月数 ≤ 3  → 关注
         └─ 可用月数 > 3  → 正常

Step 4 → 生成补货提醒
         缺货 → 紧急采购（3个月用量）
         预警 → 高优先级（2个月用量）
         关注 → 中优先级（1个月用量）

Step 5 → 推送企微
         发送给采购人员

定时任务配置

json

{
  "name": "库存监控检查",
  "schedule": {
    "kind": "cron",
    "expr": "0 9 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "agentTurn",
    "message": "检查所有物资的库存水位，生成补货提醒并推送到企微"
  },
  "sessionTarget": "isolated"
}

手动触发方式

企微 @提及: @企服助手库存检查
OpenClaw指令: 检查库存
出入库操作: 入库 {物资名称} {数量} / 出库 {物资名称} {数量}

配置参数

json

{
  "inventory_monitor": {
    "excel_path": "/Users/mac/美兰中心C+服务.xlsx",
    "sheets": {
      "秩序环境": "📦库存管理📦秩序环境",
      "固定资产": "📦库存管理📦固定资产",
      "工程": "📦库存管理📦工程"
    },
    "alert_thresholds": {
      "缺货": 0,
      "预警": 2,
      "关注": 3
    },
    "wecom_webhook": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx"
  }
}

使用示例

示例1：检查库存

用户输入: @企服助手库存检查

输出:

text

━━━━━━━━━━━━━━━
【库存监控日报】2026-05-28

━━━ 🚨 缺货物资 ━━━
无

━━━ ⚠️ 预警物资 ━━━
1. 洗手液
   规格：桶 | 现库存：2
   月使用量：1 | 可用月数：2.0
   建议采购量：2（2个月用量）

━━━ 📢 关注物资 ━━━
1. 香片
   规格：5片/包 | 现库存：60
   月使用量：11 | 可用月数：5.5

━━━ 统计 ━━━
物资总数：8个
预警：1个 | 关注：1个 | 正常：6个

⚡ 操作链接：[腾讯文档-库存管理]
━━━━━━━━━━━━━━━

示例2：出入库操作

用户输入: @企服助手入库洗手液 5

输出:

text

━━━━━━━━━━━━━━━
【入库操作成功】

物资名称：洗手液
入库数量：5桶
更新后库存：7桶
可用月数：7.0

⚡ 操作链接：[腾讯文档-库存管理]
━━━━━━━━━━━━━━━

后续扩展接口

库存预测 - 基于历史消耗数据预测未来需求
自动采购单 - 当库存低于阈值时自动生成采购单
供应商管理 - 维护供应商信息，快速下单
成本分析 - 分析物资消耗成本，优化采购策略

注意事项

数据准确性 - 出入库记录需要及时更新
月使用量更新 - 定期更新月使用量数据
采购周期 - 考虑采购周期，提前安排补货
保质期管理 - 某些物资有保质期，需要特殊管理

当前状态: 技能已调整，数据源已映射到真实Excel库存管理表（3个工作表）。

核心改进: 从独立的知识库查询 → 改为直接读取Excel库存管理表 + 水位计算逻辑。

库存监控与补货提醒

Install

库存监控与补货提醒技能 (Inventory Monitor Skill)

功能概述

数据源配置

数据接口（真实Excel字段映射）

秩序环境库存表字段（11个）

固定资产库存表字段（11个）

核心逻辑

1. 库存水位计算

2. 补货提醒生成

3. 出入库记录更新

库存监控推送模板

每日库存检查

紧急补货提醒

执行流程

定时任务配置

手动触发方式

配置参数

使用示例

示例1：检查库存

示例2：出入库操作

后续扩展接口

注意事项

Related skills