深蒸馏 · 亚马逊运营 × Codex

Listing 巡检 Skill 安装与使用教程 · 深蒸馏(475)

图文原件 | 2026-10-12 | 已深蒸馏 7 / 9 | 4 组 · 4 表 · 一次读完
来源:原文 | Jax丰哥 | 2026-10-12 | 1.02 万字
直链(在飞书/企微预览里点击可能被拦截,复制到浏览器打开):https://www.woyaofei.cn/475.html
阅读路径:上一篇(465)讲方案,这一篇讲「怎么在自己的电脑上真的跑起来」。第一组是凭据,三种凭据最容易混,混了就一直是 401;第二组是安装与自检,核心一句「安装完成只代表 AI 能找到工具」;第三组是首次巡检怎么选(要不要发历史存量);第四组是通知验证与排错清单。要动手的话,第一组和第四组是最省时间的。
一句话结论:安装不是「装完就好」,是一次逐层验收——凭据对了、白名单开了、自检过了、联网能查到、报告能核对、最后才是通知能不能送到;跳过任何一层,都会在半夜以「一切正常」的形式静默失败。

第一组 · 三种凭据,别混

最容易卡住的一步

1.1 需要的六样东西
项用途是否必需
能执行本地命令的 Codex 环境读 Skill、调本机程序、解释结果是
Python 3.9+跑包内程序是
领星 AppId / AppSecret调 Open API是
领星允许的出口 IP过平台白名单是
飞书群机器人 Webhook + 签名密钥发告警是
自己的店铺/站点/ASIN 清单定检查范围是
赛狐登录认证补评价数量与中差评净增可选
1.2 三种凭据不能互相替代
常犯的错正确做法
用领星登录密码填 AppSecret用企业开放平台的应用凭据(AppID / AppSecret)
用接口文档的访问密钥同上;文档密钥不是应用凭据
用飞书自建应用的 AppId/AppSecret 填 Webhook用群自定义机器人的 Webhook + 签名密钥,成对使用
1.3 IP 白名单是平台侧配置

不是往 .env 里加一个 IP 字段。要查「运行程序的机器」的公网出口 IP(不是浏览器看到的那个也行,但代理/服务器场景要以程序实际出口为准),填进领星后台并保存。换 Wi-Fi、换代理、换服务器都要重新核对;填 127.0.0.1 或局域网地址无效。

原文在说什么

这一组的价值是把「凭据」当类型系统看:登录密码、文档密钥、应用凭据、Webhook、签名密钥,五样东西长得都像「一串字符」,但填错位置的表现都是同一个 401。他花了两千字讲这件事,因为这是实际部署里最高频的阻塞点。

关键概念
对你的实际应用

你的 ~/.workbuddy/cli-env/ 里现在混着企微 aibot token、飞书 app 凭据、小鹅通 profile 三套身份,出问题时只能靠猜。照他的表做一份 CREDENTIALS.md:每行写「用途 / 类型 / 存放位置 / 过期方式 / 失效表现」。这一步做完,上次企微「消息权限过期」那种事一眼就能定位。

第二组 · 安装与三层自检

装完 ≠ 能用

2.1 安装顺序

先拿凭据 → 再下载分享包 → 交给 Codex 安装并生成 .env → 自己填凭据(不要让 AI 猜) → 让 Codex 自检 → 确认监控清单 → 联网验证 → 首次巡检 → 最后开真实通知。

2.2 三层检查的差别
层检查什么通过意味着
安装自检(本地)依赖、目录、.env、数据库结构Codex 能找到这套工具
对象对账expected-targets.json 与实际目标库是否一致清单没写错
联网预检(--probe-api)授权店铺、目标商品、接口能力账号真的能查到东西

他写了一句很关键的话:ready: true 但采集失败是常见的——本地自检不等于接口验证通过。

2.3 鉴权失败不能解释成业务结论

「鉴权失败」不等于「商品不存在」;「缺页」不等于「父体少了一个子体」。这两句是整篇的纪律核心。

原文在说什么

这一组把「安装」拆成了能力递进:能找到工具 → 清单对得上 → 接口真能查。多数教程停在第一层,于是用户第一次跑就遇到 401,然后开始怀疑代码。他提前把这三层分开,等于给了排错的坐标系。

关键概念
对你的实际应用

你的 doctor 应该是三层:doctor.py --local(依赖、PATH、凭据文件存在)、doctor.py --auth(真调一次最轻的只读接口)、doctor.py --data(今天有没有抓到数据、条数是否正常)。现在只有第一层的影子(凭据文件在不在),所以 nvm PATH 缺失、aibot 权限过期这类问题都要等到发送失败才发现。

第三组 · 首次巡检:先决定历史存量怎么办

两种策略不是一回事

3.1 选择
策略结果什么时候用
正常巡检、暂不发送采集、保存变化、生成报告,保留符合规则的待发告警想看一眼当前窗口有什么
--baseline-only保存状态、快照、审计,不创建基线期告警明确不要历史存量告警

他的提醒:正常巡检即使不加发送参数,也可能留下待发记录,之后启用发送时仍要检查这些记录;不要因为是第一次就默认加 --baseline-only(它要求账本无历史,且不能与 --send-alerts 同用)。

3.2 报告出来先看四件事
看什么判断标准
范围计划查哪些、实际完成多少、有没有失败对象
证据前后值、业务日期、成员变化能否核对
状态零告警是「查完没事」,还是「部分没查到」
通知这轮是否跳过发送、多少待发事件、多少合并提醒
原文在说什么

这一组解决的是「第一次接入的心理陷阱」:要么一上来被历史存量淹没,要么把「没告警」误读成「没问题」。他用「范围—证据—状态—通知」四问把这件事变成可核对的动作,而不是凭感觉判断。

关键概念
对你的实际应用

你上线新规则时也该有「基线期」:新规则头三天只记录不推送,看它一天会命中几次。否则你会遇到「加了条规则,一天被叫五次」然后直接关掉整套提醒——这是规则系统最常见的死法。

第四组 · 通知验证与排错

测试卡片先走 dry-run

4.1 通知的三步

生成测试卡片(--dry-run 预览)→ 核对格式与通道 → 明确授权后发一张带「测试」标记的卡片。测试卡片用模拟变化,不代表真实异常。

4.2 分级(首次使用拿自己的例子核对)
变化级别
明确丢失购物车P0
购物车卖家变化核心 P0 / 普通 P1
评分下降、新增中差评、中差评净增P1
父体移除或替换成员P1
父体仅新增成员P2
开启正向通知后的评分上升P3
4.3 排错清单(节选最常用的)
现象先查什么
Codex 找不到 Skill安装目录、是否多套一层文件夹、是否在运行的那台机器上
缺少依赖装依赖与跑脚本是否同一个虚拟环境
ready: true 但采集失败继续看联网预检,别停在本地自检
领星鉴权失败AppId、AppSecret、出口 IP、接口权限
目标与清单不一致是否只改了 JSON 没配数据库目标
有报告但飞书没消息是否跳过发送、有无可告警事件、有无投递失败
换目录报路径错误.env、认证文件、数据库是否仍指向旧绝对路径
4.4 升级与定时

升级 Skill 时保留外部运行目录与数据库,不要按天建新账本;定时执行放在手动验收之后,且「每天跑一次」不等于实时监控。

原文在说什么

这一组是运维视角:先证明通道通,再开真实告警;先保住数据,再替换代码。他反复强调的其实是同一条——把不可逆的动作放到最后(真实发送、删库、换目录)。

关键概念
对你的实际应用

你的提醒脚本没有 dry-run 通道——每次测试都是真发。加 --dry 打印将发送的文案与目标 chat_id,能省掉大量「测试消息轰炸自己」的尴尬。另外你的 cron-jobs.json 已经踩过「按天建新状态」的坑(cron-state.json 键带日期),这条他讲的是反面:状态要连续,不要按天重置。


与在用工作的关联

这篇里的什么对应你手上的什么具体怎么用
凭据类型化三套身份混在 cli-env/写 CREDENTIALS.md:用途/类型/位置/过期/失效表现
三层自检只有「文件在不在」doctor.py --local / --auth / --data 三级
联网预检发送失败才发现权限过期每天第一条消息前先打一次最轻只读接口
基线期新规则上线即推送新规则头三天只记录不推送
报告四问报告没有「状态」字段每份报告开头写范围、完成率、是否降级
测试卡片 dry-run测试即真发所有发送脚本加 --dry
升级保数据脚本覆盖式更新代码与 runs/、data/ 分离

原文:Jax丰哥《Listing 巡检 Skill 安装与使用教程》,2026-10-12,约 1.02 万字。

本篇依据:原文全文逐段核对。三类凭据的区分、三层检查、两种首次策略、报告四问、分级表、排错表均为原文表述;排错表为节选,原文共 10 条。

更正与边界:教程对应「20261008 分享包」,规则与字段以包内 SKILL.md 与代码为准;领星后台菜单可能调整,路径以实际账号为准。这篇只讲安装与首次运行,日常运维(换机器、换网络、多店铺)没有展开。

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