Yufluentcn Inventory Pilot

库存驾驭助手：销量预测、补货建议、滞销预警、资金占用分析。 基于卖家提供的销量/库存数据，经 Yufluent 云端 Harness 输出结构化 JSON。 Use for 补货、库存预测、滞销、清仓、资金占用、库存管理.

库存驾驭助手

基于卖家提供的 销量/库存数据 做预测、补货建议、滞销预警与资金占用分析。ClawHub / OpenClaw 云端模式 — Harness inventory_forecast 输出结构化 JSON；本机只需 TOKENAPI_KEY（tk-*）与 requests。

不直连 ERP、不自动下单、不连接平台 API。

快速开始（3 步，60 秒）

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

层	走哪里	干什么
OpenClaw 对话	Yufluent /v1/chat/completions（同一 tk-*）	收集销量/库存数据、选模式、调 run.py、解读 JSON
分析正式输出	POST /v1/skills/inventory-pilot/run（同一 tk-*）	Harness → 预测/补货/滞销 JSON

Agent 硬性规则：

• 禁止用对话模型自行撰写完整补货计划表
• 必须通过 python scripts/run.py ... 获取输出
• 只需 TOKENAPI_KEY，不要另配厂商 Key

Instructions（Agent 工作流）

1. 确认模式（见下表）；用户说"要不要补货" → replenish；"预测销量" → forecast。
2. 收集数据：
   • --message（必填）：本轮问题
   • --mode：forecast | replenish | clearance | capital
   • --sales-data：历史销量 CSV 或文件路径
   • --current-stock：当前库存（如 SKU-A:120, SKU-B:45）
   • --inventory-data：库存明细（含库龄）
   • --lead-time：供应商交期（天）
   • --transit-days：头程时效（天）
3. 调用（必须 — 云端）：

   python scripts/run.py \
     --mode replenish \
     -m "帮我算要不要补货" \
     --sales-data sales.csv \
     --current-stock "SKU-A:120, SKU-B:45" \
     --lead-time 21 \
     --transit-days 14 \
     --lang zh
   

4. 计费：402 余额不足；401 密钥无效。

四模式

mode	用途	必填数据
forecast	销量预测	sales_data
replenish	补货建议	sales_data, current_stock
clearance	滞销预警与清仓建议	inventory_data
capital	资金占用分析	inventory_data

与其他技能联动

需求	技能
清仓促销 Listing	yufluentcn-ecommerce-listing
竞品变化 → 补货节奏调整	yufluentcn-comp-track

环境变量

变量	必填	说明
TOKENAPI_KEY	是	tk-*，Yufluent 控制台 获取
TOKENAPI_BASE_URL	否	默认 http://localhost:8080/v1

触发词

• "帮我算一下要不要补货"
• "哪些 SKU 快滞销了"
• "预测下个月销量"
• "资金占用分析"
• "库存管理"
• "清仓建议"
• "inventory forecast"

Examples

补货建议

python scripts/run.py \
  --mode replenish \
  -m "SKU-A 日均卖15件，当前库存120，要不要补？" \
  --sales-data sales.csv \
  --current-stock "SKU-A:120, SKU-B:45" \
  --lead-time 21 \
  --transit-days 14 \
  --lang zh

滞销预警

python scripts/run.py \
  --mode clearance \
  -m "哪些 SKU 超过90天没动销？" \
  --inventory-data inventory.csv \
  --age-threshold "90" \
  --lang zh

销量预测

python scripts/run.py \
  --mode forecast \
  -m "预测未来30天销量" \
  --sales-data sales.csv \
  --lang zh

合规声明

• 输出仅供参考，不构成采购或财务决策建议
• 不连接平台 API 自动拉取库存/销量数据
• 不自动生成采购单/下单指令

版本记录

版本	日期	变更
v1.1.0	2026-06-14	SKILL.md added quickstart registration guide; 401/402 error messages now in Chinese with register links
v1.0.0	2026-06-13	规范 SKILL.md：补充 Agent 规则、Instructions、触发词、示例、环境变量、合规、版本记录
v0.1.0	—	初始库存驾驭技能