Shopify变体渠道发布审计

适用场景

给使用 Shopify Admin GraphQL API 2026-07+ 或导出快照的商家，在上新、补货或渠道切换前检查“父商品已发布但变体渠道状态不一致”的风险。脚本只读取本地脱敏 JSON，不登录 Shopify，不修改发布状态。

输入与输出

• - 输入：JSON，包含 product_status、product_publications、variants；每个变体包含 variant_id、sku、publication_states 和可选 intended_publications。
• 输出：variant_publication_audit.json，逐变体给出渠道差异、默认已发布风险、父商品前置条件和人工复核项。

执行

CODEBLOCK0

规则

先检查父商品是否为 ACTIVE 且在目标渠道发布；父商品未满足时，任何变体都不应被判定为可见。再按渠道比较当前状态与 intended_publications。若快照标记变体是在父商品发布后创建且未提供明确目标状态，则标记 DEFAULT_PUBLISHED_REVIEW，提醒 Shopify 变体默认按父商品已发布渠道暴露。脚本不模拟 API，不执行 publish/unpublish。

错误恢复

缺少顶层字段、变体数组或渠道状态时直接报出字段路径；状态值不是布尔值时停止并要求修正导出。目标渠道缺失只产生 MISSING_INTENT_REVIEW，不猜测商家意图。

权限与隐私边界

只处理买家有权使用的脱敏快照。不要输入店铺域名、客户信息、访问令牌或真实 URL。输出用于发布前人工复核，不代表 Shopify 公开可见性最终结果。

验收

示例运行后应输出 3 条变体审计，至少包含 CHANNEL_MISMATCH、DEFAULT_PUBLISHED_REVIEW 和 READY_FOR_REVIEW，且 external_write_executed=false。