SuperAPI AI 工具集

shopify-development

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:当用户需要构建 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,read_orders,write_orders,read_customers。文档给出针对 API 2026-01 的 GraphQL 查询商品、订单、写入 metafields 的写法,结账扩展的 React 组件示例,Liquid 商品卡片段,以及 Webhook 与 GDPR 隐私合规端点配置。脚本:python scripts/shopify_init.py 交互式脚手架,scripts/shopify_graphql.py 提供 GraphQL 工具。

实践要点:新开发优先 GraphQL 而非 REST,仅请求所需字段,用 pageInfo.endCursor 做游标分页,超过 250 条用批量操作,以指数退避处理速率限制。凭据存环境变量,处理 Webhook 前校验 HMAC 签名,校验 OAuth state 防 CSRF,遵循最小权限范围,嵌入式应用使用会话令牌。缓存不常变的数据,扩展中懒加载,主题用 img_url 优化图片,关注查询成本响应头。

排查:遇速率限制错误用指数退避、改用批量操作、查看 X-Shopify-Shop-Api-Call-Limit 头;认证失败检查令牌、权限范围与 OAuth 流程;扩展不显示检查目标类型、是否已部署、应用是否安装;Webhook 无事件检查 URL 可达性、HMAC 校验与后台日志;GraphQL 失败用 GraphiQL 校验 schema、检查废弃字段与权限范围。

限制:仅当任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。API 版本 2026-01 按季度发布,有 12 个月弃用窗口。具体收费、价格与效果类信息资料暂未提供。