拼多多补货检查

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install pdd-check-restock
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 pdd-check-restock。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

拼多多补货检查是一项库存巡检技能，适用于需要了解哪些商品应补货、促销或清仓的商家。它会结合当前库存和近期销售情况，标记缺货商品、面临售罄风险的商品、库存过剩商品以及近期没有销售的商品，并在适用时提供建议操作和补货数量。
该技能使用 pdd-sync-shop 流水线的数据，默认支持本地 SQLite，也可在配置后使用企业级 ClickHouse。补货阈值可根据商家的采购周期、期望库存覆盖天数和库存过剩上限进行调整，使这些 Openclaw Skills 能够用于可重复、基于策略的库存审核。

应用场景

找出近期有销售但当前缺货的商品，并优先安排紧急补货。
找出预计可售库存天数低于采购提前期的商品。
根据平均销量、提前期和安全库存覆盖天数计算建议补货数量。
找出库存天数超过配置值的商品，并考虑促销或暂停补货。
找出库存不为零但过去 30 天销量为零的商品，并考虑重新定价、开展营销活动或清仓。
针对指定店铺运行检查，或临时调整采购提前期以进行一次性审核。
使用 JSON 输出将库存检查结果传入基于 Openclaw Skills 构建的代理工作流或其他自动化流程。

工作原理

从已配置的数据源读取最新可用的库存和销售数据：默认使用本地 SQLite；设置 PDD_CH_URL 后使用 ClickHouse。
将过去 30 天的销量除以 30，计算日均销量；再用当前库存除以日均销量，估算库存可售天数。
对库存状况进行分类：近期有销售但库存为零属于紧急缺货；库存天数低于采购提前期表示可能缺货；库存覆盖天数超过库存过剩阈值表示库存过多；30 天内没有销售的库存则视为滞销。
对需要补货的商品，根据日均销量乘以配置的提前期加覆盖期，再减去当前库存，计算建议补货数量。
默认返回便于阅读的行动清单，也可使用 --format json 返回结构化 JSON。结果包含 as_of、methodology 等字段，首次运行时还会包含 first_run。
如果 first_run 为 true，说明所使用的阈值，并邀请商家分享其补货策略。只有在商家批准修订值后，才更新策略文件。

配置指南

该技能需要 Python 3，并读取由 pdd-sync-shop 提供的库存数据。默认数据源为本地 SQLite，基础设置无需数据库服务器。可设置可选环境变量来选择数据库路径、配置 ClickHouse 或指定自定义策略文件。
使用该技能已安装的 {baseDir} 路径运行检查：
python3 {baseDir}/scripts/check_restock.py
python3 {baseDir}/scripts/check_restock.py --format json
python3 {baseDir}/scripts/check_restock.py --mall
python3 {baseDir}/scripts/check_restock.py --lead-days 14 --format json 返回适用于代理编排的机器可读结果。 --mall 在检查多家店铺时选择一家店铺。 --lead-days 14 为本次运行临时覆盖采购提前期。 PDD_DB_PATH 可选，用于设置本地 SQLite 数据库路径；默认值为 ~/.pdd-data/pdd.db。
PDD_CH_URL 可选，用于设置企业级 ClickHouse 端点，例如 http://host:8123。
PDD_RESTOCK_POLICY 可选，用于设置补货策略文件路径；默认值为 ~/.pdd-data/restock_policy.json。
依赖报告进行判断前，请检查其 as_of 时间戳。如果源数据超过 24 小时，请先运行 pdd-sync-shop，再检查库存。如果数据不可用，应处理返回 JSON 中的 action 字段，而不要将结果视为正常库存报告。

数据架构

输入和配置
文件或设置 用途
~/.pdd-data/pdd.db 默认的本地 SQLite 数据源，由 pdd-sync-shop 填充。
PDD_DB_PATH 可选的本地 SQLite 路径覆盖值。
PDD_CH_URL 可选的企业数据 ClickHouse 端点。
~/.pdd-data/restock_policy.json 商家专属阈值；首次使用时自动创建。
PDD_RESTOCK_POLICY 可选的策略文件路径覆盖值。
策略字段
字段 默认值 含义
lead_days 14 用于标记潜在缺货的采购提前期。
cover_days 30 用于计算建议补货数量的安全库存覆盖期。
overstock_days 90 用于识别库存过剩的库存覆盖阈值。
customized false 商家批准自定义策略后设为 true；这会停用首次运行策略引导。
报告数据和分类
报告包含表示数据新鲜度的 as_of 时间戳，以及说明本次运行实际采用标准的 methodology 字段。首次运行的输出可能包含 first_run: true 和引导说明。JSON 输出适用于代理工作流；数据不可用时，会在 JSON 中通过 action 字段报告。该技能根据库存水平和过去 30 天的销售情况，将库存分类为缺货、可能缺货、库存过剩和滞销。

高级特性

可通过编辑自动生成的 JSON 文件自定义补货策略；获批的值会在后续库存检查中持续生效，无需更改代码。
单次采购提前期覆盖功能支持临时规划场景，不会更改已保存的策略。
多店铺工作流可通过 --mall 指定单个店铺。
易读报告可直接分享； --format json 则支持代理编排和下游自动化。
methodology
字段会明确显示所应用的阈值；解释报告时请使用该字段，而不要依赖记忆中的默认值。
新鲜度检查使用
as_of
；如果数据超过 24 小时，请使用
pdd-sync-shop
刷新过期数据。
首次运行引导商家定义自己的采购周期、安全库存和库存过剩标准。超出支持的策略参数范围的请求应转交 Claw School，而不是通过临时修改代码实现。
这些 Openclaw Skills 同时支持无需部署的本地 SQLite 设置和可选的企业级 ClickHouse 连接。

name: pdd-check-restock description: Inventory patrol for Pinduoduo shops that flags out-of-stock, low-stock, overstock and stale items with restock quantity advice; thresholds are customizable to the merchant's own replenishment policy. Use when the user asks what to restock or wants an inventory check. 拼多多补货/清仓巡检：断货、即将断货、积压、滞销分级行动清单与建议补货量，判定口径可按商家自己的补货思路原地定制；用户问该补什么货、库存巡检时使用。 homepage: https://claw-school.com