投流数据官（Touliu Data）
投手的素材衰减预警台。核心信条：素材生命周期就 3-7 天，衰减早发现一天，冤枉钱少烧一天。
核心能力（M1–M3）
| 模块 | 能力 | 说明 |
|---|---|---|
| M1 | 报表合并 | 巨量/千川素材维度 csv/xlsx 混放：列名六套别名归一、日期归一、同键新值覆盖旧值、乱表跳过进清单 |
| M2 | 衰减预警 | CTR 连降破六成 → 红「衰减」；消耗腰斩 → 红；不足 3 天 → 黄「观察期」不瞎预警；规则写死可复核 |
| M3 | 诊断报告 | 台账红黄分级带建议 + 每日明细 + 汇总三表；HTML 四图：消耗/CTR 趋势、状态占比、消耗 TOP10 |
工作流：导出 → 演练 → 台账 → 换弹药
- 导出：巨量/千川后台按素材维度导出 csv/xlsx，全丢进一个文件夹。
- 演练：
python scripts/main.py analyze 报表目录 -o 输出/→ 看状态分布和红标清单，不落盘。 - 执行：
--do→ 素材衰减台账.xlsx + 衰减报告.html。 - 换弹药：红标的停投或降价，去「投流素材官」批量补新文案跑 A/B。
能力边界与免责声明
- 预警不是裁决：消耗腰斩也可能是你自己降了出价——先查账户操作记录，再怪素材。
- 素材维度 only：导出的必须是「按素材」报表，按账户/按计划的汇总表看不出素材衰减。
- 明细截断标注：每日明细超 2 万行截断并红字标注（台账和报告永远全量，明细本来就是原始数据的转印）。
- 纯本地：账户数据不出本机。
文件结构
touliu-data/
├── SKILL.md
└── scripts/
├── main.py # 统一入口：analyze（dry-run 默认，--do 执行）
├── common.py # 底座：读取/GBK 嗅探/日志/人话报错
├── data_load.py # csv/xlsx 装载 + 列类型推断
├── decay.py # M1 合并 + M2 衰减规则 + M3 HTML 报告
├── chart_svg.py # 纯 Python SVG 图表（零依赖，matplotlib 不可用环境的安全牌）
└── report.py # Excel 报告（单遍写入 O(1) 取格，6 万行 7 秒）
示例命令
# 演练：看状态分布
python scripts/main.py analyze 巨量导出/ -o 投流分析/
# 执行：台账 + HTML 报告
python scripts/main.py analyze 巨量导出/ -o 投流分析/ --do
与家族联动
- 衰减了要补弹药 → 找「投流素材官」批量出文案（本报告建议列已写明）
- 公众号数据合并 → 找「公众号数据官」（同一套列名归一化底座）
安全承诺
纯本地处理，零外部数据传输，不联网、不上传。你的账户数据，不出你的电脑。
