用途：帮助 Shopify 开发者使用最新版 Polaris Checkout UI 扩展框架编写界面代码，在结账流程的既定位置构建商家可安装的自定义功能，覆盖商品信息、配送、支付、订单摘要与 Shop Pay 等环节。
主要能力：提供结账扩展的目标位置（targets）清单，如 purchase.checkout.block.render、purchase.checkout.cart-line-item.render-after、purchase.checkout.payment-method-list.render-before、purchase.thank-you.block.render 等；列出可用 API（地址、分析、属性、买家身份、购物车行、费用、配送、折扣、礼品卡、本地化、元字段、订单、支付、Storefront API、会话令牌、设置、存储等）；提供 Polaris Web Components 组件（s-banner、s-badge、s-button、s-text、s-grid、s-stack 等）及属性写法规则。
使用方式：先用 CLI 脚手架创建扩展：shopify app generate extension --template checkout_ui --name my-checkout-ui-extension。代码使用 Preact 入口：import "@shopify/ui-extensions/preact"; import { render } from "preact";。Polaris Web Components 无需导入，直接作为 JSX 标签使用。属性用 camelCase；布尔属性可简写，字符串关键字属性必须传字符串值。
必要流程：编写代码前须调用 scripts/search_docs.mjs "<query>" --version API_VERSION 检索文档；返回代码前须调用 scripts/validate.mjs 校验，并传入 --target 等参数；校验失败时检索错误类型、修复并重试，最多 3 次。代码中不得包含 HTML 注释。
限制：目标位置决定可用组件与 API；校验必须提供扩展目标，否则失败；版本默认最新稳定版，可指定如 2026-04 或 unstable。搜索与校验脚本会向 Shopify 上报查询、校验结果、模型与客户端标识等信息，可通过设置 OPT_OUT_INSTRUMENTATION=true 退出。