最重要的 6 个发现

1. 它能自动做的事只有三样：暂停广告（可设 4–48 小时后自动重开）、调日预算、调目标 ROAS。其余都是「看」和「提醒」。
2. 规则引擎很简单：时间窗（当天/3/7/14/30 天）× 指标 × 比较符 × 阈值，多个条件「全满足或任一满足」，再接动作。没有任何「懂利润」的成分——它不知道进货成本，判断不了保本线。
3. 它的数据比我们旧：页面自己写明「数据最多延迟 1 小时」，实测同步时间停在凌晨 04:00；我们是直接读虾皮后台，数据是当下的。
4. 它拿数据的路我们大概率走不了：字段名和虾皮开放平台广告接口一模一样（强推断），那是给软件服务商的通道；我们之前查过台湾站开放平台只对商城卖家开放。好消息是我们现有的「借浏览器登录读后台」已经能拿到同样甚至更细的数据。
5. 我们已经有、而且做得更好的：到点复盘、保本 ROAS、规格级成本、广告组内单品拆分、修改单 + 批准后执行 + 回读核对、不可逆操作禁区。货憨憨一个都没有。
6. 我们缺的：① 阈值类的即时提醒（预算快烧完、有花费没库存、余额不足、点击率突然掉）；② 分时段调预算；③ 判断前检查「数据够不够新」；④ 规则上线前的「空跑试算」。

最终建议（三句话）

图例：实测 亲眼看到页面或接口返回　推断 有依据但没看到底层　未验证 没法确认

规则 = 最多 5 组策略（按优先级，命中多组只执行最高的）
每组策略：
  条件之间：全部满足 / 任一满足
  条件 = 时间窗 + 指标 + 比较符 + 阈值
    时间窗：当天 / 近3天 / 近7天 / 近14天 / 近30天
    比较符：≥  >  ≤  <  =  环比降低≥  环比提升≥
  动作（最多 4 个）：
    暂停广告      → 自动重开：不重开/4/8/12/24/48 小时
    调整日预算    → 加固定值/减固定值/加%/减%/直接设为
                    + 封顶或保底值
    调整目标ROAS  → 同上
执行对象：手动勾选具体广告
执行频次：每天定时 / 每隔 1–24 小时 / 每周 / 每月
执行路径：自动执行  或  指定审核人通过后执行
通知：站内消息

注意：模板默认都用「当天」数据。虾皮广告成交有归因延迟，只看当天 ROAS 就暂停很容易误杀——这正是我们规则里「新品 14 天内不设比率上限」要避免的事。

方案 A · 预警清单 第一优先

做什么：每次同步广告数据后，多跑一组「出事了吗」的检查，命中就发飞书，每条附一段可直接复制给 agent 的话。

最小版本：先上前两条（数据现成），其余等方案 D。工作量：1 天。

要不要一天多跑几次：「预算快烧完」「空烧」一天只看一次意义不大。建议借用现有每天 4 次的数据抓取时段（10:30 / 14:30 / 18:30 / 22:30）顺带检查，不新增定时任务。

方案 B · 数据新鲜度检查 第一优先

做什么：任何判断、出修改单、执行之前，先确认三件事，不满足就不判断，并在晨报里明说原因：

• 数据是不是刚读的（超过 1 小时算过期）
• 该有的广告是不是都读到了（和上次比条数）
• 关键数字是不是齐全（花费、点击、订单任一为空算缺漏）

跳过原因固定成 5 类（照抄货憨憨的分类）：数据缺失 / 数据过期 / 数据缺漏 / 前置检查不过（广告状态变了）/ 其他。

工作量：0.5 天。风险：几乎没有。

方案 C · 规则空跑试算 第二优先

做什么：改任何阈值之前，先对全部广告跑一遍「如果按新规则，会命中哪几条、各会建议做什么」，只出清单不建修改单。

输出：测试广告总数 / 命中数 / 未命中数（货憨憨的三个数）+ 每条命中的依据。

前提：方案 D 的每日留档。工作量：0.5–1 天。

方案 D · 每日数据全量留档 第二优先（A、C 的地基）

做什么：每天把每条广告（含已暂停的）当天的浏览、点击、花费、订单、销售额、加购、预算、目标 ROAS 存一行。现在本地只存「最新一次」和「节点当天」。

数据来源：已在用的广告列表读取，不需要新权限。注意：后台一次最多查 7 天，所以必须每天存，漏了补不回太久以前的。

工作量：0.5–1 天。顺带可以在看板加「单条广告每日曲线」（+0.5 天）。

方案 E · 修改单加「封顶值」 第三优先

做什么：加预算类修改单增加一个绝对上限（例如某商品日预算永不超过 X），与现有「单次 ±80%」并存。配合方案 A 的「预算快烧完且值得加」，变成：提醒 → 一句话出修改单 → 你批准 → 执行。

不做：无人批准的自动加预算；暂停后自动重开（等真有需求再做，它属于到点执行，必须走系统定时并回查）。

工作量：0.5 天。

方案 F · 看板体检卡片 第三优先

做什么：看板广告页顶部加一排卡片（预算快烧完 / 空烧 / 无转化 / 点击率骤降 / 低于保本 / 余额不足），点了只筛选，不带任何操作按钮；每张卡有「复制给 agent」的一段话。

前提：方案 A 的结果同步到看板数据库（属于写生产数据，届时单独确认）。工作量：1 天。

最值得借鉴的 5 个功能

1. 预警清单——尤其「空烧」「预算快烧完且 ROAS 高」「余额不足」。
2. 判断前先查数据够不够新，不够就跳过并说明原因。
3. 规则调试（空跑试算）——改规则前先看会命中谁。
4. 调整带封顶 / 保底值，暂停可带自动重开时间。
5. 体检卡片——一排「问题 + 命中数」的卡，点了就筛。

看起来高级、其实没必要做的

• 可视化规则编辑器和模板库：给不懂代码的多人团队用的；我们让 agent 改一份规则文件更快更准。
• 全自动执行：它不知道成本，自动暂停 / 加预算等于闭眼开车。
• 多店铺、多币种、子账号审核、排名榜：一家店用不上。
• 批量建广告、行内结束 / 删除：和我们的安全规矩相反。
• TikTok 广告：没有这块业务。

容易做、收益最大的

• 数据新鲜度检查（半天，零依赖）
• 「预算快烧完」「空烧」两条预警（1 天，数据现成）
• 每日留档（半天到 1 天，后面所有分析的地基）

这三样加起来 2–3 天，全部加在现有每日检查里。

受权限、数据或技术条件限制的

• 官方开放平台接口：台湾站对普通卖家大概率不开放（我们此前查到仅限商城卖家）。我们只能继续「借浏览器登录读后台」，后台改版时要跟着修。
• 分时调预算：缺分小时数据；与 24 小时冷却规则冲突；需要每小时可靠执行。
• 暂停后自动重开：属于「到点执行」，必须走系统定时并回查真实结果。
• 广告余额：后台有显示，但我们还没抓过对应接口。
• 历史数据：后台一次只给 7 天，过去没存的补不回来——越早开始留档越好。

证据存放

• shots/：18 张截图（已脱敏）
• raw/api-meta-metrics.json、api-meta-actions.json：规则可用的指标与动作字典
• raw/api-queryAdTemplateList.json、api-adAlert-template-page.json：7 + 11 个模板的底层定义
• raw/api-adlogs-*.json：日志状态与失败原因分类
• raw/shape-*.json：广告列表 / 报表接口的参数与字段结构（不含真实数值）
• raw/api-endpoints-from-bundle.txt：101 条接口路径
• raw/frontend-component-map-market.txt：117 个前端组件文件名
• SCAN-NOTES.md：扫描过程、路由对照、脱敏说明

本目录含经营信息，请勿提交到 Git。

尚未验证的关键问题

1. 规则真跑起来的表现（最小间隔、失败重试、自动重开是否准时）——没建规则，建了就是改动。
2. 「规则调试」「策略冲突检查」「设置建议」实际返回什么。
3. 通知除了站内消息还有没有别的渠道。
4. 广告模块是否收费。
5. 底层确实是开放平台广告接口吗（强推断，未见服务端）。
6. 虾皮是否提供分小时广告数据、我们读不读得到。
7. 它的数据为什么只有近 30 天。
8. 「点击率暴跌」是和哪段时间比。