用途:该技能面向 Shopify 平台开发,帮助处理应用、扩展与主题三类任务。触发场景包括构建 Shopify 应用或扩展、定制结账/后台/POS 界面、使用 Liquid 开发主题、集成 GraphQL 或 REST API、实现 webhook 与计费、使用 metafields 或 Shopify Functions。
主要能力与路由:根据目标选择路径——需要集成外部服务、构建商家工具或对功能收费时构建应用;需要定制结账、后台 UI、POS 操作或折扣规则时构建扩展;需要定制店面设计或修改商品/集合页时构建主题;需要后端逻辑加店面 UI 时组合应用与主题扩展。
使用方式:安装 CLI 用 npm install -g @shopify/cli@latest;创建并运行应用用 shopify app init、shopify app dev、shopify app deploy;生成扩展用 shopify app generate extension --type checkout_ui_extension(或 admin_action、admin_block、pos_ui_extension、function);主题开发用 shopify theme init、shopify theme dev(本地预览 localhost:9292)、shopify theme pull --live、shopify theme push --development。访问范围在 shopify.app.toml 的 access_scopes 中配置,如 read_products,write_products 等。文中提供 GraphQL 查询商品、订单、设置 metafields 的示例,结账扩展的 React 组件示例,Liquid 商品卡片示例,以及 webhooks 与 GDPR 合规配置示例。
最佳实践:新开发优先用 GraphQL,只请求必要字段,使用游标分页,超 250 项用批量操作,限流用指数退避;凭据存环境变量,校验 webhook HMAC 与 OAuth state,最小化访问范围,嵌入式应用用会话令牌;缓存不常变数据,扩展中懒加载,主题图片用 img_url 优化,监控查询成本。
限制与排错:限流错误用退避与批量操作;认证失败检查令牌、范围与 OAuth;扩展未出现检查目标、是否已部署及测试店安装;webhook 未收到检查 URL 可达性、HMAC 与日志;GraphQL 失败用 GraphiQL 校验 schema 与范围。API 版本 2026-01,季度发布,12 个月弃用窗口。具体定价、收费方案及效果暂未提供。