淘宝天猫市场排行洞察
一、它能做什么
当你在生意参谋 → 市场 → 市场排行 → 商品下，选定一个类目（如 面粉/食用粉、护肤品、宠物粮…），下载了若干「榜单」Excel 后，本技能：
- 逐维度分析：每个榜单（交易总量 / 交易增速 / 加购收藏 / 流量总量 / 新品流量）独立跑出一份金标准 HTML 报告 + Excel + 结构化 JSON。
- 跨维度联动：把所有维度的 JSON 喂给综合引擎，交叉出一份「综合洞察报告」（店铺跨维度生态、规模×意向象限、跨维度词根共识、机会/风险）。
> 📌 你给了几个维度就合并几个（2/3/5 任意），缺失维度自动优雅降级，不会报错。
二、设计原则（红线）
- 绝不写死类目：列名自动识别（别名映射），不硬编码第几列；词根词库通过
--lexicon外置，运行时按类目覆盖。 - 字段自适应：有「商品关键词」列才做关键词频次 + 词根×店铺护城河；无该列（如加购收藏）自动降级用标题语义词根推导，并诚实标注。
- 区间文本取中点："1万~2.5万" 取中点数值排序，绝不硬填 0。
- 缺失列诚实降级：无环比列（如交易增速）用排名趋势反推并标注；缺价格类字段标注"待补"，不造数。
- 三联产出：每份报告 = Excel明细 + 青绿 HTML（人读） + insights.json（机读/下游联动）。
- 10 大思考模型驱动：金字塔/MECE/归纳演绎/5W1H/黄金圈/笛卡尔/U型/头脑风暴/六顶思考帽，报告中以
mtag标注用到哪些模型。
三、输入数据
来源：生意参谋 → 市场 → 市场排行 → 商品 → 选类目 → 下载 Excel。
可下载的 5 种榜单（下哪几个都行）：
| 榜单维度 | 角色 | 关键列（引擎自适应识别） |
|---|---|---|
| 交易总量 | scale 规模 | 行业排名/趋势/商品名称/店铺名称/店铺类型/支付买家数 |
| 交易增速 | growth 增长 | 行业排名/趋势/商品名称/店铺名称 |
| 加购收藏 | intent 意向 | 行业排名/趋势/商品名称/店铺名称/加购人数/收藏人数 |
| 流量总量 | traffic 流量 | 行业排名/趋势/商品名称/店铺名称/访客数 |
| 新品流量 | newproduct 新品 | 行业排名/趋势/商品名称/店铺名称 |
引擎自动识别的列名（任一别名即可）：行业排名 / 趋势 / 类目名称 / 商品名称 / 商品关键词 / 店铺名称 / 店铺类型 / 商品ID / 支付买家数 / 访客数 / 加购人数 / 收藏人数。
四、使用流程
步骤 1：逐维度出报告
python scripts/analyze_market_ranking.py \
--input "样例数据/市场排行_商品_交易总量_....xlsx" \
--output "输出前缀_交易总量" \
--metric auto \
--lexicon references/商品词根词库模板.json
--metric默认auto（从文件名含"交易总量/交易增速/加购收藏/流量总量/新品流量"自动推断），也可显式指定。--lexicon可选：传一个 JSON 词根数组覆盖默认词库（不同类目换不同词库）。- 产出：
输出前缀_交易总量.insights.json+输出前缀_交易总量_洞察报告.html+输出前缀_交易总量.xlsx。 - 对每个维度表重复本步，得到 N 份
*_洞察报告.html与*.insights.json。
步骤 2：出综合报告
python scripts/build_synthesis_report.py \
--json 输出前缀_交易总量.insights.json 输出前缀_交易增速.insights.json 输出前缀_加购收藏.insights.json \
--output 输出前缀_综合
--json接收 N 份（2/3/5…）维度报告的insights.json，自动识别维度角色并交叉。- 产出：
输出前缀_综合.insights.json+输出前缀_综合_洞察报告.html。
五、依赖
openpyxl、jieba（中文分词兜底）。首次运行：pip install openpyxl jieba。
六、文件结构
市场排行洞察技能【已优化】/
├── SKILL.md
├── 使用前必读.txt
├── 数据准备清单.md
├── scripts/
│ ├── analyze_market_ranking.py # 单维度引擎（Excel→三联）
│ └── build_synthesis_report.py # 综合联动引擎（N份JSON→综合）
├── references/
│ └── 商品词根词库模板.json # 默认食品/面粉词库，复制改成你的类目即可
├── 样例数据/ # 3 张真实生意参谋导出表（食用粉类目）
└── 样例报告/ # 4 份示范 HTML（A交易总量/B交易增速/C加购收藏/综合）
七、注意事项
- 词根提取内置品牌过滤（新良/白鲨/五得利等）与通用根剔除（粉/家用/烘焙等），如需增删改类目专属品牌，编辑
analyze_market_ranking.py的BRAND_STOP/GENERIC_ROOTS。 - 综合报告读到缺某维度时（如没给加购收藏），对应交叉模块显示"补齐该表后可自动激活"，不会崩。
- 全部 HTML 均注入紫色✏️编辑按钮，可直接在预览里改文字。
