Back to Details

ziniao-workflow-store-patrol

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

店铺巡检工作流

店铺巡检工作流

CRITICAL — 开始前 MUST 先用 Read 工具读取 
../ziniao-shared/SKILL.md
CRITICAL — 开始前 MUST 先用 Read 工具读取 
../ziniao-shared/SKILL.md

适用场景

适用场景

  • "帮我检查所有店铺状态"
  • "批量截图所有店铺首页"
  • "巡检一下店铺"
  • "看看哪些店铺有问题"
  • "帮我检查所有店铺状态"
  • "批量截图所有店铺首页"
  • "巡检一下店铺"
  • "看看哪些店铺有问题"

前置条件

前置条件

  • 紫鸟浏览器客户端已启动
  • 已配置 apiKey（
    ziniao-cli config init
    ）
  • 紫鸟浏览器客户端已启动
  • 已配置 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>
    │
    └──► 汇总报告
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: 获取店铺列表

Step 1: 获取店铺列表

bash
ziniao-cli store list --format table
bash
ziniao-cli store list --format table

Step 2: 逐个巡检

Step 2: 逐个巡检

对每个店铺执行：
bash
undefined
对每个店铺执行：
bash
undefined

打开店铺并导航到目标页面

打开店铺并导航到目标页面

ziniao-cli store open --id <storeId> --url "https://www.amazon.com"
ziniao-cli store open --id <storeId> --url "https://www.amazon.com"

等待页面加载

等待页面加载

ziniao-cli page wait-nav --store-id <storeId>
ziniao-cli page wait-nav --store-id <storeId>

全页截图

全页截图

ziniao-cli page screenshot --store-id <storeId> --full-page
ziniao-cli page screenshot --store-id <storeId> --full-page

可选：提取页面数据

可选：提取页面数据

ziniao-cli page extract --store-id <storeId>
ziniao-cli page extract --store-id <storeId>

关闭店铺

关闭店铺

ziniao-cli store close --id <storeId>
undefined
ziniao-cli store close --id <storeId>
undefined

Step 3: 汇总

Step 3: 汇总

将结果整理为报告：
undefined
将结果整理为报告：
undefined

店铺巡检报告

店铺巡检报告

店铺状态截图备注
Rosehut正常已截图—
US Store异常已截图页面加载超时
undefined
店铺状态截图备注
Rosehut正常已截图—
US Store异常已截图页面加载超时
undefined

高级用法

高级用法

无头模式巡检（更轻量）

无头模式巡检（更轻量）

bash
ziniao-cli store open --id <storeId> --url "https://www.amazon.com" --headless
bash
ziniao-cli store open --id <storeId> --url "https://www.amazon.com" --headless

等待 SPA 页面完全加载

等待 SPA 页面完全加载

bash
ziniao-cli page visit --store-id <storeId> --url "https://sellercentral.amazon.com" --wait-until networkidle
bash
ziniao-cli page visit --store-id <storeId> --url "https://sellercentral.amazon.com" --wait-until networkidle

健康检查：检测异常页面

健康检查：检测异常页面

bash
undefined
bash
undefined

提取页面文本，判断是否出现错误提示（403、验证码、封号）

提取页面文本，判断是否出现错误提示（403、验证码、封号）

ziniao-cli page content --store-id <storeId> --content-format text
ziniao-cli page content --store-id <storeId> --content-format text

查询特定异常元素是否存在

查询特定异常元素是否存在

ziniao-cli page query --store-id <storeId> --selector ".captcha-container, .error-page, #auth-warning"
undefined
ziniao-cli page query --store-id <storeId> --selector ".captcha-container, .error-page, #auth-warning"
undefined

部分巡检（按关键词或数量限制）

部分巡检（按关键词或数量限制）

bash
undefined
bash
undefined

只巡检名称含 "US" 的店铺

只巡检名称含 "US" 的店铺

ziniao-cli store list --keyword "US"
ziniao-cli store list --keyword "US"

只巡检前 5 个店铺（调试用）

只巡检前 5 个店铺（调试用）

ziniao-cli store list --limit 5
undefined
ziniao-cli store list --limit 5
undefined

截图保存到指定路径

截图保存到指定路径

bash
ziniao-cli page screenshot --store-id <storeId> --full-page --path "./patrol/store-<storeId>.png"
bash
ziniao-cli page screenshot --store-id <storeId> --full-page --path "./patrol/store-<storeId>.png"

多页面巡检（单店铺访问多个 URL）

多页面巡检（单店铺访问多个 URL）

bash
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>
bash
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 简化单店操作

使用 automation run 简化单店操作

bash
ziniao-cli automation run --steps '[
  {"type": "visit", "url": "https://www.amazon.com", "waitUntil": "networkidle"},
  {"type": "screenshot", "fullPage": true, "path": "./patrol/<storeId>.png"}
]'
bash
ziniao-cli automation run --steps '[
  {"type": "visit", "url": "https://www.amazon.com", "waitUntil": "networkidle"},
  {"type": "screenshot", "fullPage": true, "path": "./patrol/<storeId>.png"}
]'

超时控制

超时控制

bash
undefined
bash
undefined

页面加载慢时增加超时（默认 30s）

页面加载慢时增加超时（默认 30s）

ziniao-cli page wait-nav --store-id <storeId> --timeout 60000 ziniao-cli page screenshot --store-id <storeId> --timeout 15000
undefined
ziniao-cli page wait-nav --store-id <storeId> --timeout 60000 ziniao-cli page screenshot --store-id <storeId> --timeout 15000
undefined

注意事项

注意事项

  • 逐个操作店铺，不要并发打开多个
  • 每个店铺操作完成后关闭再开下一个
  • 如果某个店铺操作失败，记录错误并继续下一个
  • 页面加载可能较慢，
    wait-nav
    默认超时 30 秒
  • 无头模式巡检更快但部分页面可能行为不同，按需选择
  • 逐个操作店铺，不要并发打开多个
  • 每个店铺操作完成后关闭再开下一个
  • 如果某个店铺操作失败，记录错误并继续下一个
  • 页面加载可能较慢，
    wait-nav
    默认超时 30 秒
  • 无头模式巡检更快但部分页面可能行为不同，按需选择

参考

参考

  • ziniao-store — 店铺管理
  • ziniao-page — 页面操作
  • ziniao-shared — 认证和全局参数
  • ziniao-store — 店铺管理
  • ziniao-page — 页面操作
  • ziniao-shared — 认证和全局参数