用途:为各广告平台重新生成近 30 天的变更参考文件,覆盖新功能、弃用项与政策更新,来源包括 Reddit、Hacker News、官方 changelog 与公开网络。
主要能力:按平台抓取并汇总信息,输出 ads/references/<platform>-changelog-30d.md,并把影响最大的 5 条追加到对应 audit 文件;支持 meta、google、tiktok 或 all。
使用方式:命令为 /ads update <platform|all>。运行前必须先读取并原样打印 ads/references/update-cost-warning.md,估算成本(单平台约 5 万–15 万 token,all 约 50 万以上),并通过 AskUserQuestion 让用户选择 Proceed、Switch to quick depth 或 Cancel;取消则不抓取不写文件。无参数时询问平台,不默认 all。all 按 meta、google、tiktok 顺序串行执行。
抓取步骤:用 python3 scripts/ads_sources.py --list <platform> 获取来源配置;Reddit 用 curl 请求 new.json 并筛选 30 天内帖子;Hacker News 用 Algolia API;官方 changelog 用 WebFetch;行业媒体用 WebSearch。深度模式控制每来源条数(quick/default/deep)。可选对 30 条以上结果做打分与去重。
限制:成本高,需用户确认;Reddit 可能被限流或 429,失败即跳过不重试;WebFetch 404 或搜索无结果也跳过;某平台全部来源为空时仍写出“未找到”文件;中途取消不回收已写文件。所有失败都会明确说明,不会静默失败。