用途 该技能用于对 Shopify 店铺商品图片进行只读审计，扫描所有启用商品及其变体，检查是否存在缺少图片或图片数量不足的情况。它会标记零图片商品、未分配图片的变体，以及图片数量低于指定阈值的商品。整个过程为只读，不执行任何数据修改，可随时安全运行。
前置条件 需要已认证的 Shopify CLI 会话，命令为：shopify store auth --store <domain> --scopes read_products。所需 API 权限范围为 read_products。
参数 store（string，必填）：店铺域名，例如 mystore.myshopify.com。 min_images（integer，选填，默认 1）：图片数量低于该值的商品会被标记。 check_variants（bool，选填，默认 true）：同时标记未分配图片的变体。 status_filter（string，选填，默认 active）：要扫描的商品状态，可选 active、draft 或 all。 format（string，选填，默认 human）：输出格式，可选 human 或 json。
安全说明 该技能为只读技能，不执行任何修改操作，可随时安全运行。
工作流程 使用 products 查询，输入 query 为 "status:<status_filter>"，first 为 250，选择 images、variants { image } 以及分页游标。预期输出为带图片数量和变体图片分配信息的商品列表，并持续分页直到 hasNextPage: false。标记条件：images.count < min_images 或 images.count == 0 的商品；若 check_variants 为真，则标记 image 为 null 的变体。
GraphQL 操作 该技能提供了一段针对 api_version 2025-01 验证过的 GraphQL 查询 ProductImageAudit，用于按分页方式获取商品、图片与变体图片信息。查询内容见官方资料，代码保持不变。
会话跟踪 技能运行过程中需要在各阶段输出固定格式信息：开始时输出带技能名、店铺域名和启动时间的横幅；每步之后输出当前步骤、查询或变更名称、关键参数摘要和结果计数或结果；完成时根据 format 输出 human 或 json 格式的总结。human 格式包含商品扫描数、完全缺图数、低于最低图片数数、缺图变体数，以及需要补充图片的商品列表，并提示输出 CSV 文件 image_audit_<date>.csv。json 格式包含 skill、store、min_images、products_scanned、missing_all_images、below_minimum、variants_missing_image、output_file 等字段。
输出格式 生成 CSV 文件 image_audit_<YYYY-MM-DD>.csv，列为：product_id, product_title, handle, image_count, issue, variant_id, variant_sku, variant_has_image。
错误处理 遇到 THROTTLED（API 速率限制超限）时，等待 2 秒后重试，最多重试 3 次。如果没有商品匹配筛选条件（空目录或状态筛选错误），则以 0 条结果退出。
最佳实践 零图片商品在大多数销售渠道（如 Google Shopping、Meta 等）无法销售，应优先处理。对于服装或有颜色、尺寸变体的商品，可将 min_images 设为 3，以确保每个商品至少有一张正面、背面和场景图。可在批量导入商品后运行，以发现导入批次中上传失败的图片。也可与 product-data-completeness-score 搭配，生成一份完整的商品目录质量报告。
限制 该技能为只读，不会修改任何商品或变体数据。资料中未提供关于定价、平台支持范围或具体效果保证的更多信息。