agg-creative-reportlisted

--- ## 开工前（必做）：环境自检 **换机器 / 第一次拿到这个技能，先跑这一条** —— 它会告诉你缺什么： ```bash python scripts/setup_check.py ``` 缺东西时，它会在结尾打印一段**兜底提示词**，整段复制给 Claude等Agent，Claude等Agent 会自己把 ffmpeg / Pillow / 浏览器 / API Key / 邀请链接 / pagepub 装好配好 —— **使用者不需要懂命令行**。 | 依赖 | 少了会怎样 | 必需? | |---|---|---| | Python ≥3.8 | 脚本跑不起来 | ✅ | | `YOUCLOUD_API_KEY` 环境变量 | 取数直接失败 | ✅ | | ffmpeg | 封面（视频抽帧）与关键帧做不出来 | ✅ | | Pillow | 封面不压缩 → 报告胀到 20MB+ | ⭕ 建议 | | Edge / Chrome | 只影响导 PDF，**HTML 报告照出** | ⚪ 可选 | | **邀请注册链接** | 报告右上角按钮与 PDF 页眉空白，客户回不到你名下 | ✅ **每人不同** | | **pagepub CLI + API 密钥** | 报告发布不成公开链接，只能传大附件 | ✅ | 装完 ffmpeg 要**重开终端**才认得到。详见 `references/setup.md`。 ### 两样「每人不同」的东西，先问全再动手 这两样**不能靠机器探测，也不能共用**，第一次用必须让使用者本人给： | 要什么 | 怎么让使用者拿到 | 怎么存 | |---|---|---| | **邀请注册链接** | AppGrowing Global → 邀请 / 推广 页复制 | `python scripts/set_profile.py --invite-url "<链接>"` → 写进 `profile.json`（**已在 `.gitignore`，不入库**） | | **pagepub API 密钥** | https://pagepub.net 登录 → 控制台「API 密钥」→ 新建（`pp_` 开头） | `pagepub login --api-key <密钥>` → 落在 `~/.pagepub/config.json`（技能目录之外） | - **一次问全，别反复来问。** 使用者最烦的是"分开问了三次"。清单一并给出： `YOUCLOUD_API_KEY` / 邀请注册链接 / pagepub 密钥。 - **两人不能用同一条邀请链接** —— 报告是各人分享给各人的客户，链接挂谁的， 注册就记在谁名下。技能里**不预置任何固定邀请链接**，占位符 `{{INVITE_URL}}` 必须由 `profile.json`（或环境变量 `AGG_INVITE_URL`）自动填上，`validate.py` 会拦住空值。 - **凭据不入库**：`profile.json` 与 `~/.pagepub/config.json` 都是本机文件； 推仓库前 `git status` 确认过一眼。 --- ## 两个入口 | 用户说的 | 从哪进 | |---|---| | 「分析 XX 的素材策略」「拆解这条素材」「和 YY 对比」 | → **直接进下面第 0 步** | | 「**本周有哪些值得分析的游戏**」「什么游戏在火」「榜单变化」「选品」 |