README

打开项目先看这里

把广告后台导出的 CSV,变成一份老板能拍板的月报 PPT。三层架构,每层可插拔:

① Data     analyze_data.py   算数(CSV → summary.json,数字唯一来源)
② Outline  outline.md        判断(唯一中间格式:人和 AI 都改这个)
③ Render   render_deck.py    排版(确定性渲染 → 真正可编辑的 .pptx)

铁律:AI 只动②,数字全部来自①,③保证每次长得一样。 这就是为什么它敢叫"工厂":结构固化,每月只换数据。

最快路径(3 条命令,不要任何 API key)

pip install python-pptx        # 唯一依赖(国内加 -i 清华源)
python3 scripts/check_env.py   # 自检
python3 scripts/analyze_data.py && python3 scripts/render_deck.py

打开 output/6月投放月报.pptx，你的第一份 AI 月报。全程没花一分钱 API:因为"AI"就是你手里的 Codex / Claude Code 本体。

接 AI 玩法(这才是本课重点)

把项目文件夹丢给 Codex / Claude Code,直接说人话:

「读 input/data 的 CSV 和 output/summary.json,按 AGENTS.md 的规矩重写 outline.md,重点讲 7 月风险」
「结论页第 2 条的说法太软,改狠一点,数字保留」
「把主题色换成 forest(渲染器里加一套绿色 token)」
「给渲染器加一个 by_product 的柱状图槽位」

改完重跑 render_deck.py,10 秒出新版。所有不满意,改 outline.md 这一个文件。

换成你自己的数据

从 GMV Max / 千川 / 亚马逊后台导出 CSV,放进 input/data/(替换原文件)
列名对不上?让 Codex 改 analyze_data.py 的取数字段(它认识中文列名)
python3 scripts/analyze_data.py --month 2026-06 → 让 AI 重写大纲 → 渲染

⚠️ 敏感数据别直接发给 AI 云端:本项目的算数在你本机跑,AI 只需要看 summary.json 的聚合数(单条订单数据不出门)。

文件地图

位置	是什么
`outline/outline.md`	中间格式:判断、措辞、页面结构(人和 AI 的主战场)
`output/summary.json`	图表数字唯一来源(脚本算的,别手改)
`output/*.pptx`	成片(真可编辑:WPS / PowerPoint / Keynote 都能开)
`design/design-board.html`	风格契约:改设计先改这页,看顺眼再动渲染器
`scripts/make_demo_data.py`	课堂演示数据生成器(PawJoy 宠物店是编的)
`docs/why-not-saas.md`	「为什么不用 Kimi/WPS 一键生成」标准答案
`docs/troubleshooting.md`	排坑手册,报错先看这里
`AGENTS.md`	给 AI 看的项目规矩(防编数字、防跑偏)

一句话边界

本地渲染、零 key、零上传;AI 负责判断和措辞,数字永远机器算。

Week 7 代码包:AI 汇报工厂