kans-livestream-chartslisted

# KANS 越南直播运营 · 标准图表三件套 把日常复盘里反复要画的三张图固定成脚本。给数据 → 跑脚本 → 出 PNG。 配色、字体、口径三张图统一，可直接进周报/月报。 ## 何时用 - 用户上传直播间或大盘的日度数据，要画下面任意一张或多张图。 - 关键词：周对比 / GMV ROI / 相关性 / 脱钩 / 大盘趋势 / 堆叠 / 复盘图。 ## 通用约定（已写死在 `scripts/common.py`） - **中文字体**：自动探测 Noto Sans CJK SC（找不到退化到文泉驿），无需手动设置。 - **ROI 口径**：`ROI = 总收入 / 成本`（毛口径，平台展示口径）。 - **汇率**：USD→RMB 默认 `6.8`（图1可用 `--rate` 改；`--no-rmb` 保持美元）。 - **大盘只用『直播』列**：相关性图严禁拿大盘总 GMV 对比 KANS 直播，必须用 `live_k`。 - 输出统一 PNG，`bbox_inches="tight"`，可直接贴。 ## 输入数据契约 两张表，列名固定（CSV 直接用；xlsx 走自动解析器，按表头定位列，列序变了也能读）： **KANS 日度** —— 驱动图1，并作为图2的 KANS 序列 | 列 | 含义 | |---|---| | `date` | `MM-DD`，如 `06-08` | | `spend_usd` | 当日花费(USD) | | `gmv_usd` | 当日直播 GMV / 总收入(USD) | > 原始 xlsx：KANS 直播间 Campaign 导出（含 `启动时间/成本/总收入` 列）。解析器按日聚合、自动跳过无数据的排期占位行。 **大盘日度** —— 驱动图3，并作为图2的大盘序列 | 列 | 含义 | |---|---| | `date` | `MM-DD` | | `short_k` | 短视频 GMV(千USD) | | `live_k` | 直播 GMV(千USD) | | `card_k` | 商品卡 GMV(千USD) | > 原始 xlsx：TTMS · Serums & Essences 导出（含 `日期/短视频GMV/直播GMV/商品卡GMV`）。解析器自动跳过『区间最大值』汇总行。 示例数据见 `examples/kans_daily.csv`、`examples/market_daily.csv`（即今天 06 月这批）。 ## 三张图怎么跑（在 `scripts/` 目录下） ### 图1 · 每日 GMV 与 ROI（周对比） 柱=每日 GMV(折RMB)，按周换色；线=ROI(右轴)；含退款后盈亏线 + 每周小结框 + 环比。 ``` python 1_gmv_roi_weekly.py --input ../examples/kans_daily.csv \ --start 06-08 --end 06-21 --out out1.png ``` 常用参数：`--rate 6.8` 汇率 ｜ `--breakeven 4.1` 盈亏线 ｜ `--no-rmb` 保持USD ｜ `--title "..."`。 按周切分：从 `--start` 起每 7 天一周（自动画第1周/第2周…，≤3周时画小结框）。 ### 图2 · KANS 直播 vs 大盘直播 · 相关性验证 左 Panel A 两条指数曲线看共振；右 Panel B 散点+回归+相关系数。 `