用途：为 Shopify 商品变体生成 GTIN-14 条码预览、审计缺失条码，并在明确批准后写入店铺。生成算法为 0 + 03 + 10 位随机数字 + 校验位，随机源、算法和 500 条上限均为固定值。
重要限制：该工具生成的并非 GS1 授权条码，属合成 GTIN-14，仅用于 GMC 自定义渠道等容错渠道；不适用于 Amazon 等要求 GS1 验证码的严格渠道。生成前应阅读 references/gtin-rules.md，需要访问店铺时再读 references/onboarding-guide.md。
三种模式：Generate 不访问 Shopify，生成本地列表或 CSV；Scan 为只读店铺扫描，仅对条码为空的变体生成 HTML 摘要和审核 CSV；Apply 重新读取已批准 CSV，逐条复核变体与条码，仅在加 --execute 时写入并验证存储值。
常用命令： node <skill>/scripts/shopify-barcode-generator.mjs generate --count 20 --out barcodes.csv node <skill>/scripts/shopify-barcode-generator.mjs init-env --store <shop>.myshopify.com --env skill-hub.env node <skill>/scripts/shopify-barcode-generator.mjs connection-check --env skill-hub.env node <skill>/scripts/shopify-barcode-generator.mjs scan --env skill-hub.env --out gap-report.html --csv gap-preview.csv --limit 200 node <skill>/scripts/shopify-barcode-generator.mjs apply --env skill-hub.env --input gap-preview.csv node <skill>/scripts/shopify-barcode-generator.mjs apply --env skill-hub.env --input approved.csv --execute --out apply-results.csv
店铺流程：先 init-env，再用 read_products 完成只读 connection-check；运行 scan，它读取全部商品与变体，跳过已有条码，最多写 500 行；在 gap-preview.csv 中仅把目标行的 approved=false 改为 true；先不带 --execute 运行 apply 核对行数，取得商家明确批准后再加 --execute。写入会阻止变更过的变体、重复条码、无效 GTIN-14 及商品/变体不匹配，并通过 productVariantsBulkUpdate 执行后验证。CSV 列为 productId, variantId, product, variant, sku, existingBarcode, proposedBarcode, action, approved；scan 输出的 action=create，仅当 existingBarcode 与当前店铺值完全一致时才接受 overwrite。
连接错误处理：仅在请求失败后按所选访问方式处理。网络错误（fetch failed、ETIMEDOUT、ECONNRESET、ENETUNREACH）不要猜测代理端口，若运行时已配置批准代理可重试一次，否则请商家向该进程提供；407 需在运行时密钥库中修正代理凭据，切勿在聊天中粘贴；CLI_NOT_FOUND/ENOENT 属启动器错误，需修正配置的 CLI 入口；401/403 或 invalid_client 检查店铺、凭据与应用安装；SCOPE_UPDATE_REQUIRED 显示缺失范围、获批准后在 Shopify 授权、刷新令牌再重试；shop_not_permitted 应改用该店铺允许的应用，不要循环重试；GraphQL 错误应修正查询或输入，不要盲目重试。仅在此路径失败且用户同意后，才建议其他访问方式。