https://www.woyaofei.cn/465.html阅读路径:这是一份可以直接照着实现的技术方案,价值集中在三处:四类变化的口径边界、统一事件模型、告警状态机。第一组看「什么不算变化」(比「什么算」更重要);第二组看集合比较怎么写出确定行为;第三组是全篇的纪律核心——数据未知不得推断业务异常;第四组是运行形态,短任务而非常驻服务。工程细节多,但只记一条也够:采集失败与业务异常是两件事。
一句话结论:每日巡检的可靠性不来自规则更多,来自两件事——只比完整快照(分页不全、字段缺失就不比),以及把「查不到」单独建模(UNKNOWN),否则系统会把「数据没拿到」写成「一切正常」。
| 类型 | 定义 | 关键边界 |
|---|---|---|
| 新增差评 | 新增 1–3 星 Review 数量 > 0 | 不重复告警历史存量;领星一天最多一条汇总,不能当单条评价详情讲 |
| 评分变化 | 记录旧值、新值、变化时间 | 升分降分都留痕;Rating变动(评价条数)≠ 星级分数变化,必须两种事件 |
| 父体成员变化 | 子 ASIN 集合变化 | 数量不变但成员被替换也算;首次快照只建基线 |
| 购物车丢失 | Buybox 持有者切给他人或无人持有 | 仅价格变化不算掉购物车 |
他在 0.3 写了三个业务目标:降低人工巡检成本(覆盖全部启用 ASIN,人只处理异常)、主动触达(每日窗口内识别变化并飞书告警)、控制误报与重复(区分数据源失败与业务正常,同一事件最多发一次)。
三条里最难的是第三条——它决定了这套系统是「每天几十条噪音」还是「每周三条真事」。
这一组的方法论是「用排除法定义口径」:不只说监控什么,还明确说「价格变化不算掉购物车」「数量不变但成员被替换也算」。前者防误报,后者防漏报,两种错误在业务上的代价完全不同。
你的浮卡规则里也有类似问题:「跌破 MA20」用的是收盘还是盘中?「量能 2 倍」是与 5 日均量还是昨日比?现在这些口径散在代码里,没有一处写清。照他 0.2/0.4 的写法,给每条规则补一行「算什么 / 不算什么」,比如「跌破 MA20:收盘价低于 MA20,盘中瞬破不算」。
| 字段 | 示例 | 用途 |
|---|---|---|
| event_type | PARENT_MEMBERS_CHANGED | 业务事件枚举(另有 NEGATIVE_REVIEW_ADDED、RATING_CHANGED、BUYBOX_LOST 等) |
| subject_type | PARENT_ASIN | 区分单 ASIN 事件与父体集合事件 |
| subject_key | B0DM7H5QZ8 | 告警主体,父体变化以父 ASIN 为主 |
| 旧值 / 新值 / 时间 | 5 → 4 / 2026-09-03 | 可核对 |
按 sid + marketplace_id + parent_asin 分组,对子 ASIN 去重后生成有序集合与 SHA-256 哈希;比较集合而不是只比数量:
added = current.children - previous.children
removed = previous.children - current.children
if not added and not removed:
return Decision.silent()
if removed:
alert_level = "P0" if target.business_level == "CORE" else "P1"
else:
alert_level = "P3"| 变化 | 级别 |
|---|---|
| 明确丢失购物车 | P0 |
| 购物车卖家变化 | 核心链接 P0,普通 P1 |
| 评分下降 / 新增 1–3 星差评 / 中差评净增 | P1 |
| 父体移除或替换成员 | P1 |
| 父体仅新增成员 | P2–P3 |
| 显式开启通知后的评分上升 | P3 |
这一组是「把业务语言编译成代码」的过程。注意两个细节:一是用集合差而不是数量差,避免「走一个来一个」被漏掉;二是分级绑定 business_level(CORE / NORMAL),同一事件在不同链接上严重度不同——这不是技术判断,是业务判断,所以写在配置里。
你的提醒系统只有「发/不发」两种状态,没有分级。照这套加三级:P0(立即发,比如跌破关键位且放量)、P1(进当日报告)、P3(只记录不打扰)。分级一上,「每天七条推送」就不再是拍脑袋定的数字,而是每条规则的级别加出来的。
业务异常和采集异常必须分开。运营日志或 Listing 快照失败时,状态只能是「数据未知」;不得据此推断掉购物车、评分下降或父体成员减少。只有完整快照比较产生的成员差异,才能进入业务告警状态。
| 情形 | 处理 |
|---|---|
| 分页不完整 / 总数不一致 / 关键字段缺失 | 只记技术失败,不发运营告警,也不更新基线 |
| 首次拿到父体完整名单 | 只作后续比较的参照,不能推断「之前移除了谁」 |
| 领星不返回 Buybox 持有者 | 首接需人工确认当前持有者并配置自营别名;未完成时标 UNKNOWN,不做「已掉购物车」推断 |
| 未配置赛狐 | 明确标降级:评价数据仅来自领星,中差评净增告警不可用 |
| 策略 | 会发生什么 | 适用 |
|---|---|---|
| 正常巡检、暂不发送 | 采集、保存变化、生成报告,保留符合规则的待发告警 | 想看并保留当前窗口内的告警 |
--baseline-only | 保存状态、快照、审计,不创建基线期告警 | 明确不要历史存量告警 |
他强调:「这次不发送」和「这次不生成告警」是两件事,别混。
这一组是整套方案的信誉来源。多数监控系统的失败方式不是「漏报」,而是把失败包装成正常——接口挂了,报告写「无变化」,看报告的人以为一切安好。他把「查不到」提升为一个显式状态,并且规定它不许污染基线,这在工程上等价于「失败不写缓存」。
这条几乎是照着你写的。你的 K 线五源全挂时,报告会写「无数据」,读起来像「没变化」;基金净值只拿到 20 期时,也没标降级。改法很小:报告里加一个运行状态栏——ok / degraded / unknown,只要有一个关键源失败就标黄,全挂标红并禁止输出「今日无异常」。
不建常驻 Web 服务,不上 Java/Spring/Redis/消息队列。一次每日巡检就是一次短任务:定时器唤起 Skill → 启动本地 Python 入口 → 通过领星 Open API/SDK 取运营日志与完整快照 → 批量调度、分页、重试、解析、父体聚合、规则判定 → SQLite 落库 + Outbox → 飞书投递并回写结果。
| 组件 | 职责 | 边界 |
|---|---|---|
| 每日调度 | Codex Scheduled Task | 只读最终摘要,不承担采集与状态存储 |
| 流程入口 | Skill + Python Runner | Skill 定义配置与汇总契约,Runner 跑完整链路 |
| 数据源 | 领星(必需)、赛狐(可选) | 赛狐缺失只降级,不阻断 |
| 模型 | 只读紧凑运行汇总 | 不读原始响应 |
运行目录、.env、SQLite、expected-targets.json 分离;升级 Skill 时保留外部运行目录与数据库,不要「按天建新账本」,否则状态与去重记录断链。
这一组回答的是「为什么不做得更重」。他给出的理由是成本与可维护性:一次短任务能跑完的事,不需要常驻服务、不需要消息队列;反过来,一旦引入常驻,就要处理部署、监控、重启、内存泄漏——这些成本跟业务价值无关。
你的 report_html.py 是短任务,这条没问题;问题在状态外置——快照、去重标记、缓存都散在 reports/ 里,没有「一次运行一个目录」。改成 runs/<日期>/,升级脚本时不会误删历史,也能对比昨天和今天的产物差异。
| 这篇里的什么 | 对应你手上的什么 | 具体怎么用 |
|---|---|---|
| 用排除法定义口径 | 规则口径散在代码里 | 每条规则补「算什么 / 不算什么」两行 |
| 集合差而非数量差 | 持仓变化只看条数 | 比集合(标的名 + 权重),覆盖换仓场景 |
| P0–P3 分级 | 只有发/不发 | 规则带级别,推送数由级别加出来 |
| UNKNOWN 态 | 源全挂写「无数据」 | 报告加运行状态栏,全挂禁止输出「无异常」 |
| 失败不更新基线 | 失败后照常写缓存 | 失败不落缓存(K 线已做,净值没做) |
| Outbox 投递回写 | 发送失败即丢 | 先落库再投递,失败进重投队列 |
| 短任务 + 运行目录外置 | 产物直接覆盖 | runs/<日期>/ 保存 raw / db / html / manifest |
原文:Jax丰哥《如何用 Skills 做 Listing 每日巡检(硬核完整技术方案)》,2026-09-04,约 3.2 万字。
本篇依据:原文 0.2 四类变化、5 事件模型、6 四类规则判定(含代码)、7 告警状态机、8 技术选型、9 目录设计逐节核对。分级表照原文「当前包的主要分级」摘录。
更正与边界:文中规则与分级对应「20261008 分享包」及此前版本,作者自己提示功能边界以包内 SKILL.md 与代码为准;另外这套方案依赖领星 Open API 的字段能力,换平台需要重写采集层,不能直接迁移。
定位:中文深蒸馏,不是译稿也不是逐字摘要。标「对你的实际应用」的部分是我的分析,与原文分开;引用原文处标「原文在说什么」。