configurator-recipes

用途

Configurator Recipes 提供可直接使用的 config.yml 模板，对应常见店铺类型。用户挑选与自身业务匹配的配方，进行定制后即可部署，从而省去从零构建店铺配置的工作。

主要能力

目前提供的配方包括：

时尚店（Fashion Store）：适用于服装、鞋履、配饰。关键特性包括尺码/颜色变体、季节性集合、多币种。
电子产品店（Electronics Store）：适用于科技产品、小工具。关键特性包括规格属性、存储/内存变体、保修信息。
订阅服务（Subscription Service）：适用于经常性产品、SaaS。关键特性包括套餐层级、计费周期、附加服务。
骨架模板（skeleton template）：用于空白起点，具备正确结构但不含业务内容。

各配方细节：

时尚店：面向服装与时尚零售的完整配置，包含两个渠道（美国/欧盟）、五个产品类型、完整分类树与精选集合。渠道为 US Store（USD）与 EU Store（EUR）。产品类型为 T-Shirt、Pants、Dress、Shoes、Accessory，各自带有合适的尺码/颜色/材质变体。分类结构为 Clothing -> Men's（T-Shirts、Pants、Shoes）/ Women's（Dresses、Tops、Shoes）/ Accessories（Bags、Jewelry）。集合包括 New Arrivals、Best Sellers、Sale Items、Seasonal Collection。属性包括 Size（XS-XXL）、Color（色板）、Material、Brand、Care Instructions。完整配置见 templates/fashion-store.yml。

电子产品店：单一渠道（USD），产品类型包括 Smartphones、Laptops、Tablets、Accessories、Software。属性包括 Brand、Storage、RAM、Screen Size、Warranty。见 templates/electronics-store.yml。

订阅服务：订阅门户渠道，产品类型包括 Monthly/Annual subscriptions、One-Time Purchases、Add-Ons。属性包括 Plan Tier、Billing Cycle、User Limit、Storage Limit。见 templates/subscription-service.yml。

使用方式

快速开始：

# Copy a template directly
cp skills/configurator-recipes/templates/fashion-store.yml config.yml

# Customize and deploy
pnpm dlx @saleor/configurator deploy --url=$SALEOR_URL --token=$SALEOR_TOKEN

复制配方后的定制建议：

重命名渠道以匹配品牌与地区
调整货币与国家代码以匹配市场
修改分类以匹配实际产品目录
添加或删除不需要的产品类型
部署到生产环境前先在预发布环境测试

常见错误与修正：

使用配方但未定制标识符：部署前更新所有 slug 与名称以匹配品牌。
未调整货币/国家代码：将 currencyCode 与 defaultCountry 改为实际市场。
直接将配方部署到生产环境：始终先在预发布实例上测试。
保留不需要的实体类型：移除未使用的产品类型、分类等，保持配置整洁。
忘记更新渠道引用：产品通过 slug 引用渠道，重命名后需确保二者匹配。

创建自己的配方：

模板结构应遵循以下形式：

# Recipe: [Business Type] Store
# Description: [What this recipe sets up]
# Customize: [List key things users should change]

channels:
  - name: "Main Store"          # <- User should rename
    slug: "main"                # <- User should update
    currencyCode: USD           # <- User should set region
    defaultCountry: US
    isActive: true

productTypes:
  # Each type should have a comment explaining its purpose
  - name: "[Type Name]"
    isShippingRequired: true
    productAttributes: [...]
    variantAttributes: [...]

categories:
  # Keep hierarchy to 3 levels max
  - name: "[Root Category]"
    slug: "[root-slug]"
    subcategories: [...]

每个配方必须包含：头部注释（配方名称、描述、定制清单）、至少一个渠道（含有效货币与国家代码）、产品类型（定义产品与变体属性）、分类（至少基本层级）、注释（说明各部分作用与需定制之处）。

测试配方：

# 1. Deploy to a fresh Saleor instance
pnpm dlx @saleor/configurator deploy --url=$STAGING_URL --token=$STAGING_TOKEN

# 2. Verify idempotency (second deploy should show no changes)
pnpm dlx @saleor/configurator deploy --url=$STAGING_URL --token=$STAGING_TOKEN

# 3. Introspect and diff to confirm round-trip fidelity
pnpm dlx @saleor/configurator introspect --url=$STAGING_URL --token=$STAGING_TOKEN --config=introspected.yml
pnpm dlx @saleor/configurator diff --url=$STAGING_URL --token=$STAGING_TOKEN

文档检查清单：每个部分都有注释说明用途；所有占位值都清楚标记为需定制；货币/国家代码使用有效 ISO 标准；slug 具有描述性并遵循小写连字符约定；README 或头部说明该配方创建的内容。

适用场景

当用户询问模板、示例、起点，或提到以下问题时使用：如何搭建时尚店、是否有电子产品模板、能否看一个 config.yml 示例、店铺有什么好的起点、如何搭建订阅服务。

不适用于：查找 CLI 命令（应使用 configurator-cli）；设计自定义产品类型（应使用 product-modeling）。

限制

资料未提供配方的收费、价格、平台兼容范围、性能效果等具体信息。配方为模板性质，需用户自行定制标识符、货币与国家代码等，并建议先在预发布环境测试后再部署到生产环境。

技能介绍

用途

主要能力

使用方式

适用场景

限制

相关技能