kans-vn-category-competitionlisted

# 越南美妆类目 · 竞争格局周报 固定输入：两周店铺级 GMV 榜单导出。固定输出：6 张图 + 1 个 xlsx + 一套结论。 每周重复的部分全部脚本化，人只需要做判断。 ## 关键原则 **这份数据只有"结果"，没有"原因"。** 能看出谁涨了、涨的量从哪个渠道来，看不出对手怎么做到的。所有归因都是推断，必须落到"要补什么数据来验证"。第 5 步的待补清单不是可选项。 **口径错了数字全对结论也是反的。** 开工前读 `references/pitfalls.md`，十条里至少有三条每周都会碰到。最容易犯的两个：拿两周 Top200 全量比总量（门槛不同）、按店铺而不是品牌看多店铺对手（结论会完全相反）。 ## 流程 ### 1 · 落盘 + 确认周期 把用户粘贴的两段文本各存成一个 TSV（保留平台原始表头，脚本按表头名定位列，列序变了也能读）。如果用户上传的是文件，直接用文件路径。 **开跑前必须跟用户确认两件事**（一次问完，别分两轮）： - 本周和上周分别是哪个日期区间（用于图标题和文件名） - 有没有大促（8.8 / 9.9 / 11.11 / 12.12 / 平台活动），大促周的解读方式完全不同 ### 2 · 查实时汇率 `web_search` 查当日 USD→CNY 中间价，记下来源和时间。`--rate` 必填，没有默认值——用旧汇率出的图会和财务口径打不上。 ### 3 · 跑脚本 ```bash cd scripts python run_all.py --cur <本周.tsv> --pri <上周.tsv> --rate 6.7476 \ --rate-note "Xe.com 中间价，2026-08-11 00:05 UTC" \ --cur-label "本周 08.03-08.09" --pri-label "上周 07.27-08.02" \ --outdir ./out ``` `run_all.py` 依次做：`metrics.py`（指标汇总，同时写 `metrics.txt`）→ 6 张图 → xlsx（自动调 `/mnt/skills/public/xlsx/scripts/recalc.py` 重算公式）。 常用参数：`--focus 店铺自播` 换散点图和梯队图看的渠道（默认达人直播）｜`--only 1,3,6` 只跑指定图｜`--skip-xlsx` 跳过工作簿。单张图也可以单独跑，参数同 `run_all`。 **每张图出来后 `view` 一遍。** 标签避让算法在数据分布变化时会失手，挤在一起的图不能给用户。常见修法见下面「图表微调」。 ### 4 · 写结论 读 `metrics.txt`，按 `references/analysis_playbook.md` 的五步走：大盘定调 → 增量来源 → KANS 定位 → 竞争格局（三类打法）→ 下周动作。 每个判断后面跟一个数。口径换了导致结论和上次不一样，明确说"上次说 X，改成 Y，原因是 Z"，不要悄悄改。 ### 5 · 交付 `present_files` 给图和 xlsx。用户要写进周报时，按 `references/report_template.md` 出正文（250–350 字 + 2 张图，不要写成竞品罗列）。 ## 六张图 | 图 | 内容 | 用在哪 | |---|---|---| | 01 渠道结构对比 | 左：大盘渠道占比两周对比；右：KANS 各