om-scogo 店铺巡检工作流
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../ziniao-shared/SKILL.md
适用场景
- "帮我检查所有店铺状态"
- "批量截图所有店铺首页"
- "巡检一下店铺"
- "看看哪些店铺有问题"
前置条件
- 紫鸟浏览器客户端已启动
- 已配置 apiKey（
ziniao-cli config init）
工作流
store list ──► 获取所有店铺
│
├──► 对每个店铺:
│ store open --id <id> --url <target>
│ page wait-nav --store-id <id>
│ page screenshot --store-id <id> --full-page
│ store close --id <id>
│
└──► 汇总报告
Step 1: 获取店铺列表
ziniao-cli store list --format table
Step 2: 逐个巡检
对每个店铺执行：
# 打开店铺并导航到目标页面
ziniao-cli store open --id <storeId> --url "https://www.amazon.com"
# 等待页面加载
ziniao-cli page wait-nav --store-id <storeId>
# 全页截图
ziniao-cli page screenshot --store-id <storeId> --full-page
# 可选：提取页面数据
ziniao-cli page extract --store-id <storeId>
# 关闭店铺
ziniao-cli store close --id <storeId>
Step 3: 汇总
将结果整理为报告：
## 店铺巡检报告
| 店铺 | 状态 | 截图 | 备注 |
|------|------|------|------|
| Rosehut | 正常 | 已截图 | — |
| US Store | 异常 | 已截图 | 页面加载超时 |
高级用法
无头模式巡检（更轻量）
ziniao-cli store open --id <storeId> --url "https://www.amazon.com" --headless
等待 SPA 页面完全加载
ziniao-cli page visit --store-id <storeId> --url "https://sellercentral.amazon.com" --wait-until networkidle
健康检查：检测异常页面
# 提取页面文本，判断是否出现错误提示（403、验证码、封号）
ziniao-cli page content --store-id <storeId> --content-format text
# 查询特定异常元素是否存在
ziniao-cli page query --store-id <storeId> --selector ".captcha-container, .error-page, #auth-warning"
部分巡检（按关键词或数量限制）
# 只巡检名称含 "US" 的店铺
ziniao-cli store list --keyword "US"
# 只巡检前 5 个店铺（调试用）
ziniao-cli store list --limit 5
截图保存到指定路径
ziniao-cli page screenshot --store-id <storeId> --full-page --path "./patrol/store-<storeId>.png"
多页面巡检（单店铺访问多个 URL）
ziniao-cli store open --id <storeId>
ziniao-cli page visit --store-id <storeId> --url "https://sellercentral.amazon.com" --wait-until networkidle
ziniao-cli page screenshot --store-id <storeId> --path "./patrol/<storeId>-seller-central.png"
ziniao-cli page visit --store-id <storeId> --url "https://www.amazon.com/dp/ASIN" --wait-until networkidle
ziniao-cli page screenshot --store-id <storeId> --path "./patrol/<storeId>-listing.png"
ziniao-cli store close --id <storeId>
使用 automation run 简化单店操作
ziniao-cli automation run --steps '[
{"type": "visit", "url": "https://www.amazon.com", "waitUntil": "networkidle"},
{"type": "screenshot", "fullPage": true, "path": "./patrol/<storeId>.png"}
]'
超时控制
# 页面加载慢时增加超时（默认 30s）
ziniao-cli page wait-nav --store-id <storeId> --timeout 60000
ziniao-cli page screenshot --store-id <storeId> --timeout 15000
注意事项
- 逐个操作店铺，不要并发打开多个
- 每个店铺操作完成后关闭再开下一个
- 如果某个店铺操作失败，记录错误并继续下一个
- 页面加载可能较慢，
wait-nav默认超时 30 秒 - 无头模式巡检更快但部分页面可能行为不同，按需选择
参考
- ziniao-store — 店铺管理
- ziniao-page — 页面操作
- ziniao-shared — 认证和全局参数