深蒸馏 · 亚马逊运营 × Codex

如何用 Skills 做 Listing 每日巡检 · 深蒸馏(465)

图文原件 | 2026-09-04 | 已深蒸馏 6 / 9 | 4 组 · 5 表 · 一次读完
来源:原文 | Jax丰哥 | 2026-09-04 | 3.2 万字(全站最长)
直链(在飞书/企微预览里点击可能被拦截,复制到浏览器打开):https://www.woyaofei.cn/465.html
阅读路径:这是一份可以直接照着实现的技术方案,价值集中在三处:四类变化的口径边界、统一事件模型、告警状态机。第一组看「什么不算变化」(比「什么算」更重要);第二组看集合比较怎么写出确定行为;第三组是全篇的纪律核心——数据未知不得推断业务异常;第四组是运行形态,短任务而非常驻服务。工程细节多,但只记一条也够:采集失败与业务异常是两件事。
一句话结论:每日巡检的可靠性不来自规则更多,来自两件事——只比完整快照(分页不全、字段缺失就不比),以及把「查不到」单独建模(UNKNOWN),否则系统会把「数据没拿到」写成「一切正常」。

第一组 · 四类变化,以及它们各自不算什么

口径定得越窄,误报越少

1.1 只监控四类
类型定义关键边界
新增差评新增 1–3 星 Review 数量 > 0不重复告警历史存量;领星一天最多一条汇总,不能当单条评价详情讲
评分变化记录旧值、新值、变化时间升分降分都留痕;Rating变动(评价条数)≠ 星级分数变化,必须两种事件
父体成员变化子 ASIN 集合变化数量不变但成员被替换也算;首次快照只建基线
购物车丢失Buybox 持有者切给他人或无人持有仅价格变化不算掉购物车
1.2 为什么口径要写到这么细

他在 0.3 写了三个业务目标:降低人工巡检成本(覆盖全部启用 ASIN,人只处理异常)、主动触达(每日窗口内识别变化并飞书告警)、控制误报与重复(区分数据源失败与业务正常,同一事件最多发一次)。

三条里最难的是第三条——它决定了这套系统是「每天几十条噪音」还是「每周三条真事」。

原文在说什么

这一组的方法论是「用排除法定义口径」:不只说监控什么,还明确说「价格变化不算掉购物车」「数量不变但成员被替换也算」。前者防误报,后者防漏报,两种错误在业务上的代价完全不同。

关键概念
对你的实际应用

你的浮卡规则里也有类似问题:「跌破 MA20」用的是收盘还是盘中?「量能 2 倍」是与 5 日均量还是昨日比?现在这些口径散在代码里,没有一处写清。照他 0.2/0.4 的写法,给每条规则补一行「算什么 / 不算什么」,比如「跌破 MA20:收盘价低于 MA20,盘中瞬破不算」。

第二组 · 统一事件模型与集合比较

一条事件长什么样

2.1 事件字段
字段示例用途
event_typePARENT_MEMBERS_CHANGED业务事件枚举(另有 NEGATIVE_REVIEW_ADDED、RATING_CHANGED、BUYBOX_LOST 等)
subject_typePARENT_ASIN区分单 ASIN 事件与父体集合事件
subject_keyB0DM7H5QZ8告警主体,父体变化以父 ASIN 为主
旧值 / 新值 / 时间5 → 4 / 2026-09-03可核对
2.2 集合比较的写法

按 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"
2.3 分级
变化级别
明确丢失购物车P0
购物车卖家变化核心链接 P0,普通 P1
评分下降 / 新增 1–3 星差评 / 中差评净增P1
父体移除或替换成员P1
父体仅新增成员P2–P3
显式开启通知后的评分上升P3
原文在说什么

这一组是「把业务语言编译成代码」的过程。注意两个细节:一是用集合差而不是数量差,避免「走一个来一个」被漏掉;二是分级绑定 business_level(CORE / NORMAL),同一事件在不同链接上严重度不同——这不是技术判断,是业务判断,所以写在配置里。

关键概念
对你的实际应用

你的提醒系统只有「发/不发」两种状态,没有分级。照这套加三级:P0(立即发,比如跌破关键位且放量)、P1(进当日报告)、P3(只记录不打扰)。分级一上,「每天七条推送」就不再是拍脑袋定的数字,而是每条规则的级别加出来的。

第三组 · 告警状态机:数据未知不是业务异常

全篇最硬的一条纪律

3.1 原则

业务异常和采集异常必须分开。运营日志或 Listing 快照失败时,状态只能是「数据未知」;不得据此推断掉购物车、评分下降或父体成员减少。只有完整快照比较产生的成员差异,才能进入业务告警状态。

3.2 落到规则上
情形处理
分页不完整 / 总数不一致 / 关键字段缺失只记技术失败,不发运营告警,也不更新基线
首次拿到父体完整名单只作后续比较的参照,不能推断「之前移除了谁」
领星不返回 Buybox 持有者首接需人工确认当前持有者并配置自营别名;未完成时标 UNKNOWN,不做「已掉购物车」推断
未配置赛狐明确标降级:评价数据仅来自领星,中差评净增告警不可用
3.3 首次运行的两种策略
策略会发生什么适用
正常巡检、暂不发送采集、保存变化、生成报告,保留符合规则的待发告警想看并保留当前窗口内的告警
--baseline-only保存状态、快照、审计,不创建基线期告警明确不要历史存量告警

他强调:「这次不发送」和「这次不生成告警」是两件事,别混。

原文在说什么

这一组是整套方案的信誉来源。多数监控系统的失败方式不是「漏报」,而是把失败包装成正常——接口挂了,报告写「无变化」,看报告的人以为一切安好。他把「查不到」提升为一个显式状态,并且规定它不许污染基线,这在工程上等价于「失败不写缓存」。

关键概念
对你的实际应用

这条几乎是照着你写的。你的 K 线五源全挂时,报告会写「无数据」,读起来像「没变化」;基金净值只拿到 20 期时,也没标降级。改法很小:报告里加一个运行状态栏——ok / degraded / unknown,只要有一个关键源失败就标黄,全挂标红并禁止输出「今日无异常」。

第四组 · 运行形态:短任务,不是常驻服务

刻意做轻

4.1 技术形态

不建常驻 Web 服务,不上 Java/Spring/Redis/消息队列。一次每日巡检就是一次短任务:定时器唤起 Skill → 启动本地 Python 入口 → 通过领星 Open API/SDK 取运营日志与完整快照 → 批量调度、分页、重试、解析、父体聚合、规则判定 → SQLite 落库 + Outbox → 飞书投递并回写结果。

4.2 组件边界
组件职责边界
每日调度Codex Scheduled Task只读最终摘要,不承担采集与状态存储
流程入口Skill + Python RunnerSkill 定义配置与汇总契约,Runner 跑完整链路
数据源领星(必需)、赛狐(可选)赛狐缺失只降级,不阻断
模型只读紧凑运行汇总不读原始响应
4.3 目录与状态

运行目录、.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 的字段能力,换平台需要重写采集层,不能直接迁移。

定位:中文深蒸馏,不是译稿也不是逐字摘要。标「对你的实际应用」的部分是我的分析,与原文分开;引用原文处标「原文在说什么」。