Scott出海实操

代码包 · SCT AI 超级个体营 · 第一期 · Week 3

Week 3 代码包:GMV Max 飞书日报机器人

每天自动拉投放数据,生成飞书日报,含脱敏演示数据

解锁后下载(1.2 MB)已购买?登录后直接下载

包里有什么

46 个文件 · 解压后 2.3 MB

├── .github
│   └── workflows
│       └── gmvmax-daily.yml
├── docs
│   ├── screenshots
│   │   ├── 01-project-folder.png  (67 KB)
│   │   ├── 02-sanitized-sample-data.png  (108 KB)
│   │   ├── 03-field-mapping.png  (45 KB)
│   │   ├── 04-report-preview.png  (259 KB)
│   │   ├── 05-feishu-dry-run-preview.png  (98 KB)
│   │   ├── 06-acceptance-checklist.png  (60 KB)
│   │   ├── 07-command-chain.png  (40 KB)
│   │   ├── 08-feishu-auth-permission.jpg  (89 KB)
│   │   ├── 09-real-send-success.png  (51 KB)
│   │   ├── 10-module-card-e2e-proof.png  (59 KB)
│   │   ├── 11-module-01-kpi.png  (90 KB)
│   │   ├── 12-module-02-trend.png  (44 KB)
│   │   ├── 13-module-03-top-spend.png  (116 KB)
│   │   └── 14-module-04-actions.png  (120 KB)
│   ├── build-log.md  (3 KB)
│   ├── codex-schedule.md  (2 KB)
│   ├── deploy.md  (4 KB)
│   └── research-notes.md  (11 KB)
├── ops
│   ├── codex-daily-prompt.md
│   └── com.scott.gmvmax.codex.daily.plist.example  (1 KB)
├── prompts
│   └── gmv-max-daily-report.md  (1 KB)
├── scripts
│   ├── analyze_gmv_max.py  (24 KB)
│   ├── feishu_bot_sender.py  (9 KB)
│   ├── gmvmax_bot.py  (7 KB)
│   ├── local_daemon.py  (3 KB)
│   ├── make_sanitized_sample.py  (5 KB)
│   ├── make_tutorial_screenshots.py  (10 KB)
│   ├── make_visual_report.py  (22 KB)
│   ├── package_template.py  (2 KB)
│   ├── run_e2e_acceptance.py  (9 KB)
│   ├── send_feishu_report.py  (5 KB)
│   ├── send_lark_module_card.py  (7 KB)
│   └── validate_project.py  (1 KB)
├── week-03-gmvmax-sanitized-demo-data
│   ├── README.md
│   ├── gmv-max-demo-ads-export-sanitized.csv  (925 KB)
│   └── gmv-max-demo-settings-sanitized.csv  (1 KB)
├── .dockerignore
├── .env
├── .env.example
├── .gitignore
├── Dockerfile
├── README.md  (6 KB)
├── config.example.json
├── docker-compose.example.yml
└── requirements.txt

README

GMV Max 投流日报机器人

这个项目把 GMV Max / TikTok Ads 导出表变成飞书群里的手机可读日报卡片。

学员主路径不是手动敲命令，而是：

下载项目包
-> 用 Codex Desktop / cloud desktop 打开项目
-> 复制任务卡给 Codex
-> Codex 跑 demo、生成日报图、配置飞书测试群
-> 你检查报告、截图和 e2e 结果

你先做什么

  1. 解压课程 zip。
  2. 用 Codex Desktop 打开这个文件夹。
  3. 把下面任务卡发给 Codex。

推荐：先复制这段总控 Prompt

你是我的 Week 3 GMV Max 飞书日报机器人实施助教。

我的身份：
- 我是没有 coding 经验的运营同学。
- 我希望你带我完成，而不是让我自己研究代码。
- 我可以授权你读取和运行当前项目文件夹内的脚本。

本次目标：
1. 先确认你已经打开正确项目：GMV-Max投流日报机器人。
2. 用脱敏样例数据跑通 demo。
3. 生成文字日报、4 张手机可读模块图、飞书 dry-run 预览。
4. 如果我准备好了飞书测试群和应用密钥，再帮我配置测试群发送。
5. 最后做 e2e 验收，并告诉我作业应该提交哪些截图。

硬性约束：
1. 不要把我的 app secret、token、webhook、.env 内容打印到聊天里。
2. 不要第一次就发送正式运营群，只能先发测试群。
3. 不要为了跑通而大改业务代码；如果失败，先解释失败原因。
4. 每一步执行前先告诉我要做什么，执行后告诉我成功信号。
5. 如果需要我手动提供权限、密钥、广告导出表，请停下来明确告诉我放在哪里。

请你按这个顺序推进：
A. 检查项目结构，确认 README、data/raw、scripts、reports 是否存在。
B. 给我一个 5 步以内的执行计划。
C. 跑通 demo，并列出生成的文件。
D. 检查 4 张模块图是否生成，并说明每张图怎么看。
E. 询问我是否已经准备飞书测试群；如果没有，就停在 dry-run。
F. 如果我准备好了飞书测试群，只发测试群，并回报 message_id、msg_type、图片数量。
G. 做 e2e 验收，把结果写入 logs/e2e-acceptance-result.json。

最终你要给我：
- demo 是否成功；
- 4 张图的位置；
- 飞书是否发送；
- e2e 是否通过；
- 我应该提交的作业截图清单。

单步任务卡

如果总控 Prompt 卡住，再复制下面这些单步任务卡。

你现在是我的运营自动化助教。

请先检查当前项目，不要改代码，不要发送飞书消息。
请告诉我：
1. 项目入口文件是什么；
2. 样例数据在哪里；
3. 运行后会生成哪些报告和图片；
4. 下一步我应该复制哪张任务卡。

任务卡：跑通 demo

请帮我跑通这个项目的 demo。

要求：
1. 可以安装项目依赖；
2. 可以运行 demo；
3. 不要发送真实飞书群；
4. 成功后列出 reports/ 下生成的报告、4 张模块图、飞书 dry-run 预览；
5. 如果失败，先解释失败原因，不要直接大改代码。

demo 成功后应该看到：

reports/GMV-Max-投流诊断日报-脱敏样例.md
reports/modules/
reports/feishu-message-preview.md

任务卡：配置飞书测试群

先发测试群，不要直接发正式运营群。

请帮我配置飞书测试群发送。

要求：
1. 先复制配置模板，不要覆盖已有密钥；
2. 引导我把 FEISHU_APP_ID、FEISHU_APP_SECRET、FEISHU_CHAT_ID 填到本地环境文件；
3. 不要在聊天里打印我的密钥；
4. 先做 dry-run 或测试群发送；
5. 成功后告诉我 message_id、msg_type、图片数量。

需要准备：

信息用途
FEISHU_APP_ID飞书应用 ID
FEISHU_APP_SECRET飞书应用密钥
FEISHU_CHAT_ID飞书测试群 ID

生产发送推荐 app 模式：应用机器人上传 4 张图，发送 interactive 卡片。

任务卡：换自己的广告数据

先把 GMV Max / TikTok Ads 后台导出的 CSV 或 XLSX 放进 data/raw/。

我已经把自己的 GMV Max 广告导出表放进 data/raw/。

请你：
1. 找到最新放进去的 CSV 或 XLSX；
2. 识别字段映射；
3. 先生成清洗后的数据和字段映射报告；
4. 再生成 4 张日报模块图；
5. 先不要发送飞书群，等我确认图和结论没问题。

如果结果奇怪，先看：

data/clean/field_mapping.md

任务卡：e2e 验收

请帮我做一次 e2e 验收。

验收标准：
1. 数据能完成分析；
2. 生成 4 张模块图；
3. 飞书测试群收到 interactive 卡片；
4. 回读结果里 msg_type 是 interactive；
5. 图片数量是 4；
6. 把验收结果写到 logs/e2e-acceptance-result.json。

合格结果：

ok=true
msg_type=interactive
img_key_count=4

项目结构

README.md                 学员打开项目后先看这里
requirements.txt          Python 依赖
config.example.json       可复制成 config.json 的配置模板
.env.example              飞书应用密钥模板
data/raw/                 脱敏样例广告导出表
data/clean/               清洗后的标准字段表，运行后生成
reports/                  日报、模块图、飞书预览，运行后生成
reports/modules/          4 张手机竖版模块图，运行后生成
scripts/gmvmax_bot.py     统一入口，给 Codex 执行
docs/deploy.md            部署说明
docs/codex-schedule.md    Codex 定时监督说明
docs/screenshots/         教程截图
logs/                     运行日志，运行后生成

给 Codex / 老师的技术入口

普通学员不用手动跑下面内容。Codex 读到这里后，可以按需执行。

动作技术入口
检查环境python3 scripts/gmvmax_bot.py doctor
跑 demopython3 scripts/gmvmax_bot.py demo
发飞书应用机器人python3 scripts/gmvmax_bot.py send-bot --mode app
e2e 验收python3 scripts/gmvmax_bot.py e2e
打包课程 zippython3 scripts/gmvmax_bot.py package

自动化方案

场景推荐
上课第一次跑Codex Desktop + demo
不想买服务器GitHub Actions
老师自己每天跑本地 daemon 或 Docker
正式运营群服务器 Docker + app 机器人
想让 AI 看失败原因Codex 定时监督

详细说明见：

docs/deploy.md
docs/codex-schedule.md

安全要求

不要把这些放进公开群或教程截图：

  • 真实店铺名
  • 真实商品名
  • 真实广告计划名
  • webhook
  • app secret
  • token
  • 未打码的后台截图