PDD Shop Report

安装指南

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

什么是

PDD Shop Report 可根据 pdd-sync-shop 同步的数据，生成清晰、专业的 HTML 仪表板。您可以为单个拼多多店铺创建专属报告，也可以使用多店铺驾驶舱，比较各店铺的 GMV、订单、在售商品、库存以及需要关注的商品。
报告优先呈现实用指标和高信噪比的信息，包括趋势、库存健康状况、可执行的后续事项，以及指标计算方式说明。作为面向电商运营的 Openclaw Skills 之一，它能将本地店铺数据转化为实用概览，无需依赖外部图表 CDN。

应用场景

查看单个拼多多店铺的 KPI、销售趋势、库存状态和待办事项。
比较多个店铺的 GMV、订单、在售商品、库存以及需要关注的商品。
pdd-sync-shop --all
同步所有店铺后，创建综合运营驾驶舱。
使用平台历史交易数据调查近期销售表现。
点击商品名称或缩略图打开商品后台详情页，或从需要处理的 KPI 跳转到后台商品列表。

工作原理

使用 pdd-sync-shop 同步店铺数据；如需生成多店铺驾驶舱，请使用 pdd-sync-shop --all 同步所有店铺。
报告脚本从本地数据库读取可用数据，并在完成配置时读取企业 ClickHouse 数据源。它还可以从店铺注册表中读取店铺显示名称。
使用 --mall 选择单店铺报告，或使用 --cockpit 生成综合店铺概览。
脚本会生成包含 KPI、图表、库存信息和相关待办事项的 HTML 报告。图表使用内嵌 SVG，并支持悬停提示和十字准线。
打开生成的报告路径。如果缺少所需数据，请按照操作指引先运行 pdd-sync-shop。

配置指南

要求：Python 3（python3、python 或 py）以及由 pdd-sync-shop 同步的店铺数据。
使用环境变量配置可选的数据源和注册表路径：
PDD_DB_PATH：本地 SQLite 数据库路径；默认为 ~/.pdd-data/pdd.db。
PDD_CH_URL：ClickHouse HTTP URL，例如 http://host:8123，用于使用企业 ClickHouse 数据源。
PDD_DATA_DIR：用于定位店铺注册表的数据目录；默认为 ~/.pdd-data。
运行单店铺报告或生成全店铺驾驶舱：
python3 {baseDir}/scripts/report.py --mall --theme clawschool --out report.html
python3 {baseDir}/scripts/report.py --cockpit
脚本返回包含 ok、生成的 report 路径以及 actions_needed 数量的 JSON。如果没有可用数据，请先同步店铺数据，再生成报告。

数据架构

此技能读取已同步的店铺数据；本文档未指定底层数据库表结构。默认本地数据库为 ~/.pdd-data/pdd.db，也可以通过 PDD_CH_URL 配置可选的 ClickHouse 数据源。
数据或元数据 用途与处理方式
店铺注册信息 ~/.pdd-data/shops.yaml 为多店铺驾驶舱中的店铺提供显示名称。可以通过 PDD_DATA_DIR 更改目录。
销售历史 最近 30 天的交易金额和订单量使用平台实际的日历日历史数据，并自动同步。
库存历史 由于平台不提供库存历史，库存趋势根据一系列同步快照推导。
商品价格历史 商品价格趋势以基于快照的迷你折线图显示。
生成的报告 HTML 文件会写入指定的 --out 路径；如果未提供路径，则写入脚本默认输出位置。
运行结果 JSON 会报告是否成功、报告路径以及需要关注的行动事项数量。

高级特性

--cockpit 生成多店铺驾驶舱，对所有本地可用店铺进行比较，并按 GMV 排序。
在综合驾驶舱中汇总每个店铺排名前六的待处理事项。
使用带悬停十字准线和提示框的内嵌 SVG 图表；报告不依赖图表 CDN。
查看指标旁的计算说明，并通过商品或需要处理的 KPI 链接前往相关拼多多后台页面。
从支持的主题中进行选择：
clawschool
是获批的默认主题；
boardroom
slate
是预览主题，展示前需要创始人批准。
保持报告的商务文档风格：避免使用表情符号和不必要的文字，除非用户要求使用受支持的替代主题，否则保留默认主题；如需进行少量布局或内容调整，请使用用户专属的
report.py
副本。

name: pdd-shop-report description: Generates business-grade HTML dashboards for Pinduoduo shops - single-shop report or multi-shop cockpit - from data synced by pdd-sync-shop. Use when the user asks for a PDD shop report or operations overview. 基于 pdd-sync-shop 同步的数据生成商务版经营报表（KPI、趋势、库存健康、待办清单）与店群驾驶舱；用户要看报表、经营情况时使用。 homepage: https://claw-school.com