用途：指导升级 Shopify API 版本（季度发布）并将旧版 REST 管理 API 迁移到 GraphQL 管理 API。资料指出 REST 已于 2024 年 10 月 1 日被弃用为旧版 API。
前提：已确定当前使用的 Shopify API 版本；具备 Git 版本控制；有可用测试套件；可访问 Shopify 发布说明。
主要能力与步骤：
- 检查当前版本和可用版本：用 grep 搜索代码中的 apiVersion / api_version，用 curl 调用 /admin/api/versions.json 查看支持的版本。Shopify 按季度发布（如 2025-01、2025-04、2025-07、2025-10），版本在发布后约支持 12 个月。
- 审查破坏性变更，例如 2024-10 的 ProductInput 拆分为 ProductCreateInput + ProductUpdateInput，REST 被声明为旧版；2024-07 InventoryItem.unitCost 移除；2024-04 购物车警告替换库存 userErrors；2025-01 新公共应用必须仅使用 GraphQL。
- 将 REST 端点迁移到对应 GraphQL 模式，含常见端点（产品、订单、客户、Webhook）的映射表。
- 更新配置中的 API 版本，可使用 @shopify/shopify-api 的 LATEST_API_VERSION，并同步更新 shopify.app.toml 的 api_version。
- 处理 2024-10 的 ProductInput 拆分。
输出：所有配置文件的 API 版本已更新；REST 端点迁移到 GraphQL 等价物；破坏性变更已处理；测试套件在新版本上通过。
错误处理：版本不受支持时检查支持版本端点；字段找不到时查看发布说明；ProductInput 未定义时改用新类型；REST 返回 410 Gone 时迁移到 GraphQL。
示例与限制：提供版本升级脚本与弃用监控代码片段；必要命令保持原样。资料未说明收费、价格、平台支持范围或具体性能效果。