Skip to main content

Shopify Winter '26 版本：完整开发者指南

Shopify Winter '26 版本（2026 年 1 月）是 Shopify 历史上最大的平台更新，包含 150+ 项新功能和改进。本指南按影响领域分类，详细解析所有对开发者重要的内容。

为什么这个版本不同

Winter '26 标志着 Shopify 全面转向代理商务——AI 代理（不仅仅是人类）将代表消费者浏览、协商和购买的理念。这个版本中的每一个主要功能要么启用 AI 代理，要么是在 AI 辅助下构建的。作为开发者，理解这一转变对于在 2026 年及以后构建相关应用至关重要。

AI 与代理商务​

Winter '26 的核心。Shopify 押注下一波电子商务成长来自 AI 驱动的购物代理。

Shopify Sidekick（重大升级）​

Sidekick，Shopify 为商家内建的 AI 助手，获得了自推出以来最重大的升级。

新功能：

  • Sidekick Extensions API —— 第三方 App 现在可以为 Sidekick 扩展自定义功能。当商家要求 Sidekick「优化我的电子邮件活动」时，你的 App 可以处理它。
  • Sidekick Actions —— Sidekick 现在可以执行多步骤工作流程：建立产品、设定折扣、在单次对话中安排行销活动。
  • 情境感知 —— Sidekick 现在会读取商店分析、最近的订单和客户数据，以提供情境化的建议。
  • 商家核准流程 —— Sidekick 在执行前会提出移动建议并等待商家确认。对于信任至关重要。

开发者影响：

  • 新的 Sidekick Extension Points 供 App 开发者使用
  • sidekick.action.propose 和 sidekick.action.execute API 端点
  • 通过 Partner Dashboard 的自定义工具注冊
# Register a Sidekick Extension
mutation sidekickExtensionCreate {
  sidekickExtensionCreate(input: {
    title: "Email Campaign Optimizer"
    description: "Analyzes store data and optimizes email campaigns"
    actionDefinitions: [
      {
        name: "optimize_campaign"
        description: "Optimize an email campaign based on store analytics"
        inputSchema: "{ ... }"
      }
    ]
  }) {
    sidekickExtension { id }
    userErrors { field message }
  }
}
Sidekick Extensions 处于开发者预览阶段

截至 Winter '26，Sidekick Extensions 可供已批准的 Partner 使用。请通过 Partner Dashboard 的「Beta Programs」申请。

Catalog API（新功能）​

Catalog API 让 AI 代理和外部系统能以结构化的机器可读格式与商店的产品目录互动。

关键功能：

  • 为 AI 消费优化的结构化产品数据
  • 跨产品属性的语义搜索
  • 具有即时准确性的价格和库存查询
  • 产品比较和推荐支持
  • 多语言和多币别支持

重要性： 传统产品 API 返回为人类构建的前端设计的数据。Catalog API 返回结构化数据，让 AI 代理能够理解和推理。

# Catalog API: semantic product search
query {
  catalog {
    productSearch(
      query: "comfortable running shoes for flat feet under $150"
      semanticMatch: true
      limit: 10
    ) {
      results {
        product {
          id
          title
          semanticDescription
          priceRange { minVariantPrice { amount currencyCode } }
          attributes { key value confidence }
        }
        relevanceScore
      }
    }
  }
}

AI 代理 Checkout Kit​

一个新的 SDK，让 AI 购物代理能代表消费者完成购买。

组成：

  • 代理验证 —— 代表使用者的 AI 代理的安全身份验证
  • 购物车组装 —— 具有代理优化验证的程序化购物车建立
  • 支付委托 —— 代理可使用的 Token 化支付方式，无需查看卡片资讯
  • 同意框架 —— 代理发起购买前的使用者核准流程

开发者影响： 如果你正在构建 AI 购物助手、聊天机器人或语音商务，这是你的主要整合点。

SimGym​

用于测试 AI 代理与 Shopify 商店互动的模拟环境，不会影响真实数据或触发真实支付。

功能：

  • 用于代理测试的沙盒商店副本
  • 模拟支付处理
  • 可设定的库存、定价和运送情境
  • 代理决策的性能基准测试
  • 代理策略的 A/B 测试

使用案例：

  • 在连接到真实商店之前测试你的 AI 购物代理
  • 在不同的商店设定下对代理性能进行基准测试
  • 在模拟的电子商务互动上训练自定义模型

Tinker App​

一个新的 Shopify App，用于在管理后台直接原型设计和实验 AI 驱动的商店功能。

功能：

  • Sidekick Extensions 的视覺化提示构建器
  • 用你商店的即时数据测试 AI 代理互动
  • 预览 AI 生成的产品描述在主题上的外观
  • 实验动态定价算法
  • 原型设计自定义推荐引擎

开发者平台​

Shopify Dev MCP Server​

用于 AI 辅助 Shopify 开发的官方 MCP Server。请参阅我们的详细指南。

Winter '26 新增：

  • 完整的 API 2026-01 Schema 支持
  • JavaScript 和 Rust 的 Shopify Functions 脚手架
  • Checkout Extension 文件和范例
  • 改善的搜索相关性和响应质量
  • 新的 validate_graphql 工具用于查询验证

Shopify Functions（正式发布）​

Shopify Functions 从开发者预览版升级为 正式发布（Winter '26）。

支持的 Function API：

Function 类型用途状态
Delivery Customization自定义运费和选项GA
Payment Customization自定义支付方式筛选GA
Discount自定义折扣逻辑GA
Cart Transform修改购物车内容（捆绑、赠品）GA
Fulfillment Constraints限制出货选项GA
Order Routing Location Rule自定义出货路由GA
Validation自定义结帳验证GA
GateToken 门控商务GA

Winter '26 新增：

  • JavaScript 支持（与 Rust 并列，使用 Javy 执行时）
  • 增加的执行限制 —— 5MB 记憶体，10ms 执行时间
  • 网路访问（有限）用于外部 API 呼叫
  • 持久储存通过 Function 输入中的 Metafield 读取访问
  • 测试框架使用 shopify app function test
// Example: Delivery Customization Function (JavaScript)
// @ts-check
import { DeliveryCustomization } from "@shopify/shopify-functions";

export default function deliveryCustomization(input) {
  const operations = [];

  // Block express shipping for oversized items
  for (const delivery of input.cart.deliveryGroups) {
    for (const option of delivery.deliveryOptions) {
      const hasOversizedItem = input.cart.lines.some(line =>
        line.merchandise?.product?.hasTag("oversized")
      );

      if (hasOversizedItem && option.title.includes("Express")) {
        operations.push({
          hide: { deliveryOptionHandle: option.handle }
        });
      }
    }
  }

  return { operations };
}

主题编辑器大改版​

线上商店编辑器进行了重大重新设计：

  • 即时协作编辑 —— 多位团队成员可以同时编辑主题
  • 版本历史 —— 完整的变更历史，包含差异对比和回滚功能
  • AI 辅助内容 —— 在编辑器中生成 Section 内容、替代文字和文案
  • 元件库 —— 拖放预建元件（Hero Section、产品网格等）
  • 性能预算 —— 编辑时的即时性能评分

开发者仪表板​

新的集中式 Shopify App 开发者仪表板：

  • API 使用分析 —— 即时监控 API 呼叫量、错误率和延迟
  • Webhook 可靠性 —— 按主题追踪 Webhook 传递成功率
  • App 性能 —— 载入时间、错误率和商家满意度指标
  • 营收分析 —— MRR、流失、安装/卸载趋势
  • 合规状态 —— GDPR、数据访问和安全要求追踪

Tangle（内部框架，现已文件化）​

Shopify 公开记录了 Tangle，他们用于构建复雜、类型安全的 GraphQL API 的内部框架。虽然外部开发者无法直接使用，但理解 Tangle 有助于你更有效地使用 Shopify 的 API。

关键概念：

  • 每个 Shopify GraphQL 类型都由 Tangle 模型支持
  • Mutation 遵循一致的模式：input → model → output + userErrors
  • Connection（分页）在所有类型中标准化
  • 访问范围直接对应到 Tangle 授权规则

OAuth 凭证升级​

Shopify 的 OAuth 系统获得了显著改进：

  • Proof Key for Code Exchange (PKCE) —— 所有新 App 必须使用
  • 轮换 Refresh Token —— 自动 Token 轮换以增强安全性
  • 范围化 Access Token —— 每次会话只请求所需的范围
  • Token 内省端点 —— 无需商店往返即可验证 Token 有效性
  • 离线/线上 Token 的清晰说明 —— 更好的 Token 类型文件和工具

API 版本 2026-01​

2026 年的第一个 API 版本带来：

新的类型和字段：

  • CatalogProduct —— 为 AI 代理优化的产品表示
  • SidekickExtension —— 注冊和管理 Sidekick Extensions
  • FunctionRunResult —— 改善的 Function 执行结果类型
  • CheckoutBranding —— 扩展的结帳定制选项

从 2025-10 的破坏性变更：

  • Product.images 已弃用，改用 Product.media
  • Order.shippingLine 移至 Order.shippingLines（复数）
  • orders/create 和 orders/update 的 Webhook 载荷格式变更
  • InventoryLevel.available 已弃用，改用 InventoryLevel.quantities

弃用：

  • REST Admin API 产品图片端点（使用 GraphQL productMedia Mutation）
  • ScriptTag 资源（由 WebPixel 取代）
  • 旧版结帳定制（使用 Checkout UI Extensions）
API 迁移时间表
  • 2026-01 于 2026 年 1 月发布
  • 2025-04 将于 2026 年 4 月终止
  • 2025-07 将于 2026 年 7 月终止

如果你使用的是 2025-04 或更早版本，请立即开始迁移。

商店与主题​

Rollouts​

主题变更的新部署功能：

  • 阶段性部署 —— 先将主题变更推送给一定比例的流量
  • 自动回滚 —— 如果错误率飙升，变更会自动还原
  • A/B 测试整合 —— 根据转换指标比较主题版本
  • 计划部署 —— 在特定日期/时间排队主题变更

每个产品 2,048 个变体​

变体限制从 100 增加到 每个产品 2,048 个。

开发者影响：

  • 产品表单和变体选择器需要处理更大的选项矩阵
  • 库存管理 UI 需要变体列表的分页
  • 变体的 GraphQL 查询应使用带游标分页的 Connection
  • 每个变体的 Metafield 管理需要批量操作模式
# Paginating through variants of a high-variant-count product
query {
  product(id: "gid://shopify/Product/123") {
    variants(first: 50, after: "cursor") {
      edges {
        node {
          id
          title
          price
          inventoryQuantity
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}

未列出产品​

产品现在可以被标记为未列出 —— 可通过直接连结访问，但不会在搜索、Collection 或网站地图中显示。

使用案例：

  • 特定客户群的专属产品
  • 与网紅分享的预发布页面
  • 仅通过自定义入口访问的 B2B 产品
  • 限量分发的活动专属商品

API：

mutation {
  productUpdate(input: {
    id: "gid://shopify/Product/123"
    status: ACTIVE
    publishedScope: UNLISTED
  }) {
    product { id status }
    userErrors { field message }
  }
}

移动主题生成器​

一个 AI 驱动的工具，可以从你现有的桌面主题生成移动优化的主题变体：

  • 自动的小屏幕布局调整
  • 触控目标大小优化
  • 图片调整大小和艺术指导
  • 导航简化
  • 移动网路的性能优化

商务与支付​

产品网路​

一个新的 B2B 功能，允许商店在 Shopify 商家网路中共享产品目录：

  • 供应商发布产品到网路
  • 零售商可以浏览并将产品加入自己的商店
  • 库存在网路中即时同步
  • 由供应商设定的定价和利潤规则
  • 由供应商处理的出货（代发货模式）

开发者影响： 网路管理、目录共享和跨商店操作的新 API 端点。

ACH 支付​

**ACH（自动清算所）**支付现在通过 Shopify Payments 支持：

  • 比信用卡更低的交易费用（0.5% 对比 2.9%）
  • B2B 商家可以接受银行对银行的支付
  • 订阅的周期性支付支持
  • 3-5 个工作天结算

POS 大改版​

Shopify POS 进行了重大更新：

  • 统一 API —— POS 和线上商店使用相同的库存、订单和客户 API
  • POS UI Extensions —— 使用与线上 Checkout 相同的 Extension 框架构建自定义 POS 体验
  • Tap to Pay —— 通过 iPhone 和 Android 设备的 NFC 支付
  • 员工权限 API —— 程序化管理 POS 员工角色和权限

Uber Direct 整合​

与 Uber Direct 的原生整合，用于当日本地配送：

  • 结帳时的即时配送报价
  • 订单出货时自动派遣司机
  • 商家和客户的即时追踪
  • 自定义配送工作流程整合的 API

基礎设施​

Oxygen V2​

Shopify 的 Hydrogen 店面托管平台获得了重大升级：

  • Edge 运算 —— 在 300+ 个全球 Edge 节点的服务器端渲染
  • 流式 SSR —— React Server Components 配合流式以获得更快的 TTFB
  • 自动扩展 —— 从 0 到数百万请求的自动扩展
  • 环境分支 —— 每个 Git 分支的预览部署
  • 日志流式 —— 即时日志输出到你的监控平台

Webhook 可靠性改善​

  • 保证传递 配合可设定的重试策略（最长 72 小时）
  • 死信队列 —— 失败的 Webhook 储存供手动检查
  • 开发者仪表板中的传递指标
  • Webhook 版本控制 —— 载荷格式锁定到你的 API 版本
  • 通过 GraphQL 的批量 Webhook 管理

GraphQL 成本改善​

  • 常见查询（products、orders、customers）的降低成本
  • 并行查询执行 —— 在单一请求中执行多个独立查询
  • 查询复雜度估算器 —— 执行前检查成本的新 API 端点
  • 突发速率增加 —— Shopify Plus 商店的更高突发限制

迁移清单​

对于更新 App 以适应 Winter '26 的开发者：

高优先级​

  • 更新到 API 版本 2026-01
  • 从 Product.images 迁移到 Product.media
  • 将 Order.shippingLine 更新为 Order.shippingLines
  • 为 OAuth 流程实作 PKCE
  • 在 UI 中处理 2,048 变体的产品

中优先级​

  • 探索你 App 类别的 Sidekick Extensions
  • 针对 Catalog API 测试 AI 代理兼容性
  • 更新 Webhook 处理以适应新的载荷格式
  • 如适用，将 ScriptTag 迁移到 WebPixel

低优先级（但值得探索）​

  • 评估 Shopify Functions 是否可取代目前在你 App 服务器中的自定义逻辑
  • 在 SimGym 中测试你 App 的代理兼容性
  • 设定开发者仪表板进行监控
  • 实验移动主题生成器

时间表​

日期事件
2026 年 1 月 15 日Winter '26 版本宣布
2026 年 1 月 15 日API 2026-01 发布
2026 年 2 月 1 日Sidekick Extensions 开发者预览开放
2026 年 3 月 1 日Catalog API 公开测试版
2026 年 4 月 1 日API 2025-04 终止
2026 年 4 月 15 日Functions JavaScript 执行时正式发布
2026 年 6 月Summer '26 版本（预计）

资源​