https://www.woyaofei.cn/475.html阅读路径:上一篇(465)讲方案,这一篇讲「怎么在自己的电脑上真的跑起来」。第一组是凭据,三种凭据最容易混,混了就一直是 401;第二组是安装与自检,核心一句「安装完成只代表 AI 能找到工具」;第三组是首次巡检怎么选(要不要发历史存量);第四组是通知验证与排错清单。要动手的话,第一组和第四组是最省时间的。
一句话结论:安装不是「装完就好」,是一次逐层验收——凭据对了、白名单开了、自检过了、联网能查到、报告能核对、最后才是通知能不能送到;跳过任何一层,都会在半夜以「一切正常」的形式静默失败。
| 项 | 用途 | 是否必需 |
|---|---|---|
| 能执行本地命令的 Codex 环境 | 读 Skill、调本机程序、解释结果 | 是 |
| Python 3.9+ | 跑包内程序 | 是 |
| 领星 AppId / AppSecret | 调 Open API | 是 |
| 领星允许的出口 IP | 过平台白名单 | 是 |
| 飞书群机器人 Webhook + 签名密钥 | 发告警 | 是 |
| 自己的店铺/站点/ASIN 清单 | 定检查范围 | 是 |
| 赛狐登录认证 | 补评价数量与中差评净增 | 可选 |
| 常犯的错 | 正确做法 |
|---|---|
| 用领星登录密码填 AppSecret | 用企业开放平台的应用凭据(AppID / AppSecret) |
| 用接口文档的访问密钥 | 同上;文档密钥不是应用凭据 |
| 用飞书自建应用的 AppId/AppSecret 填 Webhook | 用群自定义机器人的 Webhook + 签名密钥,成对使用 |
不是往 .env 里加一个 IP 字段。要查「运行程序的机器」的公网出口 IP(不是浏览器看到的那个也行,但代理/服务器场景要以程序实际出口为准),填进领星后台并保存。换 Wi-Fi、换代理、换服务器都要重新核对;填 127.0.0.1 或局域网地址无效。
这一组的价值是把「凭据」当类型系统看:登录密码、文档密钥、应用凭据、Webhook、签名密钥,五样东西长得都像「一串字符」,但填错位置的表现都是同一个 401。他花了两千字讲这件事,因为这是实际部署里最高频的阻塞点。
.env,改网络就要改它。你的 ~/.workbuddy/cli-env/ 里现在混着企微 aibot token、飞书 app 凭据、小鹅通 profile 三套身份,出问题时只能靠猜。照他的表做一份 CREDENTIALS.md:每行写「用途 / 类型 / 存放位置 / 过期方式 / 失效表现」。这一步做完,上次企微「消息权限过期」那种事一眼就能定位。
先拿凭据 → 再下载分享包 → 交给 Codex 安装并生成 .env → 自己填凭据(不要让 AI 猜) → 让 Codex 自检 → 确认监控清单 → 联网验证 → 首次巡检 → 最后开真实通知。
| 层 | 检查什么 | 通过意味着 |
|---|---|---|
| 安装自检(本地) | 依赖、目录、.env、数据库结构 | Codex 能找到这套工具 |
| 对象对账 | expected-targets.json 与实际目标库是否一致 | 清单没写错 |
联网预检(--probe-api) | 授权店铺、目标商品、接口能力 | 账号真的能查到东西 |
他写了一句很关键的话:ready: true 但采集失败是常见的——本地自检不等于接口验证通过。
「鉴权失败」不等于「商品不存在」;「缺页」不等于「父体少了一个子体」。这两句是整篇的纪律核心。
这一组把「安装」拆成了能力递进:能找到工具 → 清单对得上 → 接口真能查。多数教程停在第一层,于是用户第一次跑就遇到 401,然后开始怀疑代码。他提前把这三层分开,等于给了排错的坐标系。
你的 doctor 应该是三层:doctor.py --local(依赖、PATH、凭据文件存在)、doctor.py --auth(真调一次最轻的只读接口)、doctor.py --data(今天有没有抓到数据、条数是否正常)。现在只有第一层的影子(凭据文件在不在),所以 nvm PATH 缺失、aibot 权限过期这类问题都要等到发送失败才发现。
| 策略 | 结果 | 什么时候用 |
|---|---|---|
| 正常巡检、暂不发送 | 采集、保存变化、生成报告,保留符合规则的待发告警 | 想看一眼当前窗口有什么 |
--baseline-only | 保存状态、快照、审计,不创建基线期告警 | 明确不要历史存量告警 |
他的提醒:正常巡检即使不加发送参数,也可能留下待发记录,之后启用发送时仍要检查这些记录;不要因为是第一次就默认加 --baseline-only(它要求账本无历史,且不能与 --send-alerts 同用)。
| 看什么 | 判断标准 |
|---|---|
| 范围 | 计划查哪些、实际完成多少、有没有失败对象 |
| 证据 | 前后值、业务日期、成员变化能否核对 |
| 状态 | 零告警是「查完没事」,还是「部分没查到」 |
| 通知 | 这轮是否跳过发送、多少待发事件、多少合并提醒 |
这一组解决的是「第一次接入的心理陷阱」:要么一上来被历史存量淹没,要么把「没告警」误读成「没问题」。他用「范围—证据—状态—通知」四问把这件事变成可核对的动作,而不是凭感觉判断。
你上线新规则时也该有「基线期」:新规则头三天只记录不推送,看它一天会命中几次。否则你会遇到「加了条规则,一天被叫五次」然后直接关掉整套提醒——这是规则系统最常见的死法。
生成测试卡片(--dry-run 预览)→ 核对格式与通道 → 明确授权后发一张带「测试」标记的卡片。测试卡片用模拟变化,不代表真实异常。
| 变化 | 级别 |
|---|---|
| 明确丢失购物车 | P0 |
| 购物车卖家变化 | 核心 P0 / 普通 P1 |
| 评分下降、新增中差评、中差评净增 | P1 |
| 父体移除或替换成员 | P1 |
| 父体仅新增成员 | P2 |
| 开启正向通知后的评分上升 | P3 |
| 现象 | 先查什么 |
|---|---|
| Codex 找不到 Skill | 安装目录、是否多套一层文件夹、是否在运行的那台机器上 |
| 缺少依赖 | 装依赖与跑脚本是否同一个虚拟环境 |
ready: true 但采集失败 | 继续看联网预检,别停在本地自检 |
| 领星鉴权失败 | AppId、AppSecret、出口 IP、接口权限 |
| 目标与清单不一致 | 是否只改了 JSON 没配数据库目标 |
| 有报告但飞书没消息 | 是否跳过发送、有无可告警事件、有无投递失败 |
| 换目录报路径错误 | .env、认证文件、数据库是否仍指向旧绝对路径 |
升级 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 与代码为准;领星后台菜单可能调整,路径以实际账号为准。这篇只讲安装与首次运行,日常运维(换机器、换网络、多店铺)没有展开。
定位:中文深蒸馏,不是译稿也不是逐字摘要。标「对你的实际应用」的部分是我的分析,与原文分开;引用原文处标「原文在说什么」。