Shopify 知识库

说明 Shopify Admin GraphQL API 的定位与端点形态、访问令牌与 access scopes、季度版本与支持窗口、基于成本的限流、游标分页与 bulk operations、HTTP 200 下的 errors 与 userErrors，以及它与 REST 遗留状态和本库 OAuth、应用形态文章的关系。

按店面、结账、客户账户与后台定位 Shopify 扩展需求，再判断用原生配置、安装应用还是定制开发，并说明各自的验证重点。

区分 Shopify App 当前的三种形态——公开分发、自定义分发与已停止新建的后台自建应用，说明各自的创建者、安装范围、认证方式、计费能力，以及分发方式不可更改带来的配置后果。

给出 Shopify App 从本地开发、集成测试到正式发布的环境矩阵，说明 Partner 组织、App、Dev Store、配置文件、后端资源、密钥和发布权限分别应该怎样隔离。

从审核员的实际操作路径整理 Shopify App 提交前准备，覆盖应用安装、认证、测试账号、演示数据、截图视频、合规 Webhook，以及比自动跨域跳转更可恢复的 reviewer 入口设计。

从同步类 Shopify App 出发，说明如何定义可解释的计费单位，区分预览、跳过与真实写入，并用内部账本、幂等上报、周期额度和执行前报价避免重复或意外收费。

区分 Shopify Functions（在 Shopify 后端执行的自定义逻辑）与各类界面扩展（主题应用扩展、结账 UI 扩展、后台与 POS 扩展），说明官方列出的 Function API、资源上限、应用块与应用嵌入的差别、套餐限制，以及 script tags 的弃用时间。

说明 Public、Custom 或不同环境的 Shopify App 如何共用业务服务，同时隔离凭据、授权、Session、Webhook、计费与删除事件，避免同一店铺的安装记录和令牌互相覆盖。

区分 Shopify App 的 application_url、redirect_urls 与授权请求 redirect_uri，说明回调参数、state、HMAC、自定义查询参数和多 App 分流的安全处理顺序。

说明 Shopify Webhooks 的订阅方式（应用配置文件与 Admin API）、投递目标、请求头与 HMAC 校验、响应时限与重试、去重与对账、强制合规 webhook，并区分它与前台 Web Pixels 事件、Flow 自动化以及开发者预览中的 Events。

说明 Shopify B2B 的对象（公司、公司位置、目录与价格、付款条款）、数量规则与阶梯价、结账与草稿订单在 B2B 中的角色、与新版客户账户的关系、B2B 登录后店面的价格与目录展示，并逐项标出依赖套餐的能力与官方页面之间的表述差异。

区分 Shopify 客户资料、客户账户体验与商家后台人员身份，说明排查登录跳转、跨域 Cookie 和属性更新时需要记录的验证条件。

说明 Shopify 后台 Customer privacy 设置、营销同意的收集位置与邮件订阅状态、双重确认、Cookie 横幅与 Customer Privacy API 的分工，以及顾客数据访问与删除请求的商家入口，各地区法规差异一律标注需要合规确认。

说明 Shopify 客户分群（Segments，用 ShopifyQL 条件描述的动态名单）与客户标签、客户 metafield 的分工，分群在折扣资格与营销邮件中的用法和数值上限，营销同意状态如何限定可触达对象，以及使用客户数据时的隐私边界。

说明 Shopify 官方营销消息工具（帮助中心现称 Shopify Messaging，前身为 Shopify Email）的邮件活动与自动化、Campaigns 与 UTM 归因、默认只发给订阅者及其例外、退订与发件域名认证，并划清它与 Shopify Flow 的分工，只写官方页所读，不写送达率与打开率基准。

说明 Shopify 后台 Settings > Notifications 里的顾客、员工、短信与换货通知，官方页列出的触发事件与可否关闭，模板的 Liquid 编辑与变量引用（含 order_status_url），发件人与域名认证，交易通知与营销同意的区别，多语言通知，以及收不到邮件时官方页给出的排查建议。

说明 Shopify Analytics 的仪表板、默认报表、自定义探索与 ShopifyQL，梳理会话、购买转化率、平均订单价值等字段的官方口径，归因模型与重置规则，套餐差异，以及与 Web Pixels 和第三方分析工具数字不一致时的排查思路。

以跨店图片同步后的误报为例，说明为什么源店与目标店的文件大小不能直接代表内容是否一致，以及如何用同步映射、源指纹和目标存在性建立可解释的差异状态。

说明 Shopify Flow 的触发器、条件、动作与工作流如何组成后台自动化，梳理常见触发器与动作类别、套餐要求、官方给出的数量与时间限制、测试与运行记录，以及批量变更、Wait 与并行工作流带来的风险。

Shopify 购买与事件验证流程：按商品、购物车、结账、订单四阶段记录业务与事件证据，区分测试计划和已观察到的事实。

比较浏览器标签、服务端 GTM 与 Google tag gateway：按处理位置、维护责任与验证方式选择采集链路，不承诺固定数据恢复比例。

Shopify App Pixel 与 Custom Pixel 的沙箱差异，GTM 能否放进 Pixel，以及如何按同意状态验证事件链，避免混淆运行位置。

Shopify 平台全景：梳理商家、消费者、开发者、店铺与支付物流等外部系统的业务关系，再定位后台管理和访问入口。

Shopify 知识库阅读导引：用生态关系、商家后台、域名路由三种视图和业务能力框架组织问题，并区分有依据结论与待核验内容。

Shopify 入口与 URL 地图：按学习、管理、购买任务区分 Help Center、Admin、店面页面和动作地址，不把域名树当成业务模型。

Shopify 知识库如何组织与核验：以业务对象和平台能力组织正文，按概念、操作、比较、排查、实验五类写作，并附来源与核验日期。

本站 Shopify 平台与 Theme 内容来自哪几类资料、如何分工，从哪些入口开始阅读，以及 Dawn、Horizon、金额与采集等哪些内容仍缺少店铺实证。

Shopify 资料核验清单：列出已修订的 Pixel、Cookie、金额与主题内容问题，以及账户、金额、主题源码等仍需验证的部分。

说明 Shopify Bundles 的固定捆绑、多件装与混搭的实现方式，捆绑库存怎样按组成项计算，订单与退货中捆绑的呈现，与折扣、变体组合、交叉销售的区别，以及官方写明的不兼容项与页面间表述差异。

Shopify 商品录入后为何没在店面出现？按发布范围、集合成员、菜单入口与主题模板分层排查，不只靠修改模板判断可见性。

说明 Shopify 自定义数据的两种载体 metafield 与 metaobject，定义与条目、命名空间、标准类别 metafield、动态来源，以及在 Liquid 与 API 中的读取入口和官方给出的数值上限。

说明 Shopify 后台 Content > Files 的上传与管理、图片视频与一般文件的格式和大小限制（官方页数值不一致处并列）、套餐存储上限、文件名规则与替换删除的影响、file_reference 类型 metafield 与主题对文件的引用、CDN 链接、图片尺寸建议与替代文本，只写官方页所读。

Shopify 库存与地点：把变体库存、地点分配、履约与配送条件分开核对，定位有货却无法购买的问题，而非直接加库存。

说明 Shopify 商品 CSV 的导入与导出流程、列与变体的表达方式、handle 与 SKU 的作用、批量编辑器与 metafield 批量编辑、库存 CSV 与多地点，以及常见导入错误和无法撤销时的备份策略。

Shopify 商品、选项与变体如何区分：先整理可验证的商品资料，再分清商品数据与主题模板，并按变体检查加购结果。

Shopify 商家后台地图：从商家任务定位商品、订单、客户、销售渠道与设置入口，理解配置之间的依赖和购买问题的检查顺序。

说明 Shopify 店铺域名的获取方式、主域名与重定向域名、别名域名的关系，第三方域名需要的 DNS 记录与 TLS 证书由平台提供的事实，以及结账子域名、域名迁移和 Markets 多市场域名的边界。

Shopify 的 Follow on Shop 按钮让顾客在 Shop 应用中关注店铺；说明前置条件、主题编辑器启用步骤、关注后的效果、顾客侧控制、验证方法，以及官方文档未覆盖的边界。

Shopify 权限排查：分开商家团队用户、Partner 协作者和客户账户三类身份，按店铺或组织范围与具体任务核查授权。

说明 Shopify 官方 Google & YouTube、Facebook and Instagram by Meta、TikTok Shop 三个渠道的定位与接入前提，商品数据源里标题、价格、可售状态、GTIN、品牌等字段的来源，商品同步与审核失败的排查顺序，订单与库存回流，以及同意状态与渠道像素的关系。

Shopify Markets 与配送配置：固定买家地区、币种、商品范围与配送规则逐项验证，排查结账无配送选项的原因。

梳理 Shopify 各套餐的定位，并把本库文章里反复出现的“按套餐限制”逐项落到官方页面：结账自定义、按市场与客户类型定制主题、B2B、第三方交易费、报表与员工账号，并并列官方页面之间的差异。

Shopify 销售渠道是什么：区分销售渠道、流量来源与应用安装实例，并在添加渠道后按具体商品核对同步与可售结果。

将 28 种跨平台的品牌、商品、证据、顾虑与关系内容从布局和平台实现中分离，并逐项说明资料、语境、证据与误用。

页面组合方法说明如何从业务任务出发，把内容类型、展现形式和页面语境组成有序功能模块，再映射到 Shopify Template、Section 与 Block。

将可复用内容、资源数据或平台状态与展现、交互模式组合成跨平台模块，并说明页面语境、状态、替代形式和实现边界。

电商展现模式选择地图：从空间布局、阅读交互和运动节奏三个维度比较 Grid、Tabs、Carousel、Marquee 等模式的用途与首要风险。

从 article template type 进入购买指南与使用指南两种文章配方，说明按读者阶段选择配方的判据、alternate 模板的分配方式、article 模板与对象的已核验约束，并链接博客与文章的字段来源说明。

从 article template type 出发，说明帮助顾客比较与选择的购买指南文章：选型维度、比较表、推荐依据与利益披露、相关商品卡、订阅邀请，写清什么时候删模块，以及如何避免把促销伪装成指南，并落到 Shopify Theme 实现。

从 article template type 出发，说明使用、保养与故障排查类文章的步骤结构、前置条件与所需物品、图片与视频、FAQ 回链、支持升级入口，并记录 Google HowTo 富结果已停用的核验结果与文章结构化数据的官方口径。

区分 Shopify 博客列表、文章详情与普通页面的内容责任，说明 blog 与 article 模板的字段来源、阅读任务、空状态和配置检查。

从 cart template type 出发，说明 /cart 页面与购物车抽屉两种入口的页面组成：行项目与平台金额、折扣与运费预估、免运费进度、追加购买、配送支付与退换摘要、客服入口、空车状态，以及结账不属于主题模板的边界。

从 collection template type 进入品类集合页与活动或编辑型集合页，先判断是否需要 alternate template，再查页面内容、模块组合与 Theme 实现。

由活动或编辑主题驱动的 collection 页面配方：先判断用集合还是 Page 承载，再组织活动主张、促销兑现、倒计时、精选商品与活动结束后的退化。

从 collection template type 出发，组织品类集合页的集合说明、筛选浏览、商品卡、选型指南与相关内容，并给出空结果、售罄与 Theme 实现的取舍。

从 Shopify index template type 进入店面首页，比较品牌发现型与商品直达型两种页面组成，明确内容来源、模块顺序、退化方式与 Theme 实现。

从 Shopify list-collections template type 进入 /collections，说明顾客如何从多个商品范围中选入口，并处理空集合、重复分类、搜索入口与首页分类模块的分工。

从 page template type 进入 About Us、Contact Us、FAQ 等业务页面，再查页面内容、展现形式和 Theme 实现。

从 page template type 出发，确定 About Us 的核心内容、展现组合与 Shopify Theme 实现。

从 page template type 出发，组织品牌缘起、关键选择、证据与 Theme 页面实现。

从 page template type 出发，组织活动主张、商品、证据、限制、行动与 Theme 页面实现。

从 page template type 出发，设计问题分流、联系表单、反馈状态与 Shopify Theme 实现。

从 page template type 出发，组织问题分类、答案证据、展现形式与 FAQ 页面实现。

从 page template type 出发，设计会员、积分与推荐有礼的说明页：规则完整披露、与折扣、礼品卡和店铺储值的边界、FAQ、加入入口、条款与有效期，并说明没有真实运营的计划为何不该建页。

从 page template type 出发，说明订单追踪说明页如何引导顾客使用订单状态页、发货邮件与 Shop app 查询发货状态，处理无追踪号与延迟，划清主题与结账的边界，并对订单号加邮箱查询的隐私风险标注合规确认。

从 page template type 出发，说明政策中心页如何组织隐私、退款、配送、服务条款与订阅条款：Settings > Policies 的六类政策与展示位置、摘要与正式条款的分工、Cookie 同意与隐私政策的关系、更新日期与版本、与配送退换页的分工。

从 page template type 出发，设计面向媒体与合作方的 Press 页面：报道台账、数据证明、资质、品牌简介与素材包、媒体联系入口，以及何时不需要独立 Press 页和与 About Us 的分工。

从 page template type 出发，设计店铺级独立评价页：自有评价、第三方平台评价、用户生成内容与证据条如何分区且不混算，何时需要独立评价页而不是商品页评价区，以及 Shopify 上评价数据能否在 Page 中展示的已核验事实。

从 page template type 出发，组织配送、退换条件、办理步骤和 Theme 页面实现。

从 page template type 出发，组织测量方法、尺码数据、适用商品和 Theme 页面实现。

从 page template type 出发，组织门店地点、营业状态、筛选、地图与 Theme 页面实现。

从 product template type 进入标准商品页、预售与订阅商品页、尺码敏感商品页，再查页面内容、模块组合、alternate 分配与 Theme 实现。

从 product template type 出发，为服饰、鞋、可穿戴与需要兼容型号的商品组织尺码与适配指引、规格表、变体库存、退换摘要和评价中的尺码反馈，并划清与 Size Guide 页面的分工。

从 product template type 出发，说明销售计划驱动的预售与订阅商品页与标准商品页的差异：发货与扣款条款、取消与暂停入口、删除条件与 Shopify Theme 实现。

从 product template type 出发，围绕当前商品完成判断与购买，确定媒体、购买区、规格、评价与相关商品的组合、删除条件和 Shopify Theme 实现。

从 search template type 出发，说明 /search 结果页的页面组成：搜索框与建议、结果列表与筛选排序、商品页面文章混合结果的处理、无结果页的下一步、搜索词日志作为需求来源，以及与集合页的差异、共用部分和隐私边界。

说明 Headless 与主题店面的边界：Storefront API 承担的商品与购物车数据、跳转到 Shopify 结账的方式、Hydrogen 与 Oxygen 的定位、Headless 销售渠道的令牌管理，以及主题层能力、SEO、重定向与结账域名需要自行核对的地方。

说明 Shopify Content > Menus 里的菜单与菜单项、链接目标类型、层级深度上限，以及 Liquid 的 linklists、linklist、link 对象怎样把菜单交给主题，并给出把新页面加入菜单与验证页头页脚的步骤。

说明 Shopify 后台 Online Store 的 Preferences 页管什么：首页标题与元描述、社交分享图的来源优先级、Favicon 的位置、密码保护（private mode）与密码页模板、私有模式对搜索引擎和渠道接入的影响，以及像素与隐私设置各自的入口。

说明 Shopify Search & Discovery 应用管理的三类能力：集合与搜索页筛选、商品推荐（related 与 complementary）、搜索设置与商品提升，以及它们与主题、Liquid、Ajax 和 Storefront API 的连接和官方给出的数值上限。

从 Template type、alternate template、业务页面和内容类型的网状关系进入展现、模块、页面组合与源码。

说明 Shopify 后台 Web performance 报告的数据来源、周期与 LCP、INP、CLS 的分级，整理官方对图片、应用脚本与主题代码的性能建议，并把结论对应到滚动显现、吸顶栏、轮播等展现形式的取舍。

将 SEO 拆成页面任务、可维护元数据、机器可读表达和实际抓取验证，不把 JSON-LD 当成孤立内容类型。

梳理 Shopify 主题库里的添加、预览、复制、发布、下载与删除，主题数量上限，官方页面对回滚与主题版本更新的表述，以及代码编辑器、Shopify CLI 与 GitHub 集成各自的边界。

说明 Shopify 店铺语言的添加、发布与删除，Translate & Adapt 应用的定位，可翻译资源，主题 locale 文件与店面内容翻译的分工，语言与 Markets 的关系，以及 hreflang、URL handle 和机器翻译复核的官方说法。

Shopify URL 重定向：记录旧地址、目标地址与适用限制，说明重定向只对失效 URL 生效，并给出区分路由问题的验证步骤。

Shopify 主题 Layout、Template、Section、Block 与 Snippet：把目录转成渲染关系，区分页面骨架、可配置区域和复用代码。

将本地取货、单位价格、富媒体、销售计划与分享等能力归入资源数据、平台状态和页面动作，而不是新增编辑内容类型。

以 Template type 为入口，连接可选 alternate template、具体业务页面和可复用内容类型。

Shopify Theme 交付框架：从产品范围、页面矩阵、模块契约到编辑体验、实现与验收，形成可复查的流程，并说明 Theme Store 清单何时适用。

区分跨页面区域、其中的功能模块和 Shopify Section Group 实现，避免把 Header、Footer、Announcement bar 与普通业务页面混在一起。

店面布局 CSS：用三列 Grid 实现全宽背景与居中内容，用 auto-fit 构建商品卡片网格，并给出宽度决策与小屏检查方法。

Shopify 主题国际化：区分 Storefront locale 与 Schema locale 两类文件、翻译键与商家内容，避免只翻译店面或编辑器一侧。

Shopify 主题配置与 Schema：以标题分区示例说明设置定义、保存值、输入类型与 Liquid 渲染的关系，并给出编辑器验证步骤。

从 Shopify Template type 出发，说明默认模板、可选 alternate、关联资源和具体业务页面之间的关系。

基于 Dawn v15.3.0 源码，横向整理跳转链接、details 与 summary 的渐进增强、trapFocus 焦点循环与返还、共享描述文本、状态区播报、预测搜索 combobox 与减少动态，并指出焦点集合不更新、正则未转义等问题。

Dawn 15.3.0 主题架构：以固定源码从商品页追踪 Layout、模板、分区、片段与浏览器组件的协作，并说明未经店铺验证的范围。

基于 Dawn v15.3.0 源码，追踪商品页价格、变体选择器、加购与动态结账按钮、product-form 请求、库存与低库存提示、本地取货和售罄状态，并对照通用购买区与到货通知契约列出差距与未内置项。

基于 Dawn v15.3.0 源码，追踪 cart_type 设置如何在购物车抽屉、加购通知与购物车页之间分叉，梳理 Section Rendering 更新链、空车分支、数量更新与错误处理，并对照通用抽屉与 Toast 契约列出差距。

基于 Dawn v15.3.0 源码，拆解 color_scheme_group 设置如何在 theme.liquid 中循环生成 .color-* 类与 RGB 三元组变量，分区如何套用方案与渐变，服务端如何预先计算对比色，以及这种设计令牌方案的取舍与限制。

基于 Dawn v15.3.0 源码，列出 slideshow、collapsible-content、multicolumn、image-banner、image-with-text、video、rich-text、collage 对应的通用展现，并核对轮播自动播放、键盘、减少动态与滚动显现动画的实现差距。

基于 Dawn v15.3.0 源码，分析不使用前端框架时 Dawn 如何用轻 DOM 自定义元素承载服务端 HTML、用 25 行发布订阅连接商品页与购物车，以及 Promise.all 等待订阅者、生命周期退订的写法和一处订阅泄漏、异常中断渲染的风险。

基于 Dawn v15.3.0 固定源码，追踪集合页与搜索页的筛选表单、Section Rendering 局部刷新、pushState URL、已选条件移除、价格区间、移动筛选抽屉与分页，并对照通用契约列出差距。

基于 Dawn v15.3.0 固定源码，追踪页头分区组、下拉与 Mega Menu、移动抽屉菜单、公告栏和吸顶页头脚本，说明面包屑的搜索结果，并对照导航契约的 ARIA 与键盘要求列出差距。

基于 Dawn v15.3.0 源码，逐行拆解 HTMLUpdateUtility 的双缓冲替换、旧节点 ID 去重、脚本重建与前后处理钩子，说明它为什么只用在商品信息区，以及 500ms 延迟删除、只改旧节点 ID 等写法的取舍。

基于 Dawn v15.3.0 源码，整理分区级 CSS 与 JS 按条件引入、非关键样式异步加载、字体预连接与预加载、srcset 与 sizes、首屏图片立即加载与 fetchpriority、视频与 3D 延迟挂载、推荐区提前加载，以及 CartPerformance 埋点和几处失效的优化。

基于 Dawn v15.3.0 源码，梳理邮件订阅表单在 newsletter、email-signup-banner 与页脚中的实现和成功错误状态，商品卡与价格中的售罄折扣徽章，以及依赖 reviews 元字段的评分星，并如实说明未内置评价列表。

基于 Dawn v15.3.0 固定源码，追踪页头搜索弹层、predictive-search 元素、/search/suggest 分区请求、combobox 标记、键盘与状态播报，并对照站内搜索契约列出差距。

基于 Dawn v15.3.0 源码，追踪商品页媒体图库、缩略图、变体切换时的媒体联动、放大 Modal，以及视频与 3D 模型的按需加载和无障碍实现，并对照通用图库要求列出差距。

Dawn 数量选择器 QuantityInput：追踪加减与 min、data-min 边界逻辑，用独立浏览器实验复现同步 change 事件值的差异。

基于 Dawn v15.3.0 源码，追踪 related-products 分区与 main-product 内置 complementary 搭配区块怎样请求推荐端点、渲染网格或分页滑块、处理空结果，并对照通用交叉销售、Carousel 与 Grid 契约列出差距。

基于 Dawn v15.3.0 源码，横向对比变体切换、商品推荐、筛选、预测搜索与购物车六处局部刷新，拆解 section_id 与 sections 两种取法、getSectionsToRender 约定和它带来的重复请求、缓存与乱序代价。

基于 Dawn v15.3.0 源码，梳理 request.design_mode 与 Shopify.designMode 的分工、theme-editor.js 对区块选中与分区加载卸载事件的处理、挪到 body 的弹窗如何清理、滚动动画在编辑器中的降级，以及重复加载脚本等问题。

基于 Dawn v15.3.0 源码，拆解 product-info 如何不下发变体矩阵、改用 option_values 让服务端选出变体，如何用 ID 后缀约定把同一份分区 HTML 复用到快速加购弹窗，以及中止请求、焦点恢复与媒体对齐的写法和遗留问题。

基于 Horizon 4.2.0 源码，拆解用户刚切换变体、分区请求尚未返回就点击加购时的处理：携带 promise 的 ProductSelectEvent、代次计数、意图快照队列、纯函数变体解析、按新变体重新校正数量与批量提交，以及入队即播动画等值得商榷之处。

基于 Horizon 4.2.0 固定源码，从商品模板追到 Section、Theme Block、Snippet 与浏览器组件的协作，并给出按任务继续阅读的入口。

基于 Horizon 4.2.0 源码核查商品徽章、评分星标、邮件订阅表单的实现，并以全仓库搜索给出倒计时、尺码表、评论列表和弹窗订阅未内置的依据，对照通用页面列出差距。

基于 Horizon 4.2.0 源码，拆解 Shopify 购买区的数量选择、加购提交与加速结账，说明变体切换中的加购排队和数量约束该怎样验证。

基于 Horizon 4.2.0 源码，追踪 Shopify 购物车页面与抽屉怎样共享条目组件、处理数量更新和分区刷新，并列出空车等验证场景。

基于 Horizon 4.2.0 源码，区分 Shopify 集合页与搜索结果页的数据来源、商品网格、筛选 URL 和分页控制器，以及预测搜索入口。

基于 Horizon 4.2.0 源码，拆解不依赖框架的 Component 基类：ref 自动收集与归属判断、on: 属性的全局事件委托、自定义元素升级竞态、声明式 Shadow DOM 补水，以及 updatedCallback 与 morph 的配合和其中的疑点。

基于 Horizon 4.2.0 源码，区分通用容器、Hero 媒体、Page 与博客正文和联系表单的职责，说明各类内容模块的选择与验证重点。

基于 Horizon 4.2.0 源码，拆解 Shopify 集合与搜索结果页的筛选表单、URL 与分区刷新、已选条件移除、移动端抽屉、排序，以及默认无限滚动与普通分页的差别，并对照通用模块列出差距。

基于 Horizon 4.2.0 静态源码，拆解页眉分区组中的公告栏、桌面 Mega Menu、移动端菜单抽屉与吸顶滚动逻辑，并对照通用导航与抽屉契约列出无障碍差距。

基于 Horizon 4.2.0 源码，拆解 morph 的 hydration 模式：只按 data-hydration-key 匹配、不插入不删除的契约，商品推荐、购物车抽屉与页眉三个使用场景，页眉首屏省掉精选商品的分支，以及这种两段式渲染的局限。

基于 Horizon 4.2.0 源码，解释 Shopify 布局文件、页眉页脚分区组、首屏页眉测量与脚本加载的边界，并说明导航改动需跨页面验证。

基于 Horizon 4.2.0 源码，整理一组避免强制同步布局的做法：首帧前按需测量页眉高度、从 IntersectionObserver 取得尺寸、变体选择器读写分批、跳过首次回调的 ResizeNotifier、等待过渡的 Scheduler、让出主线程，以及用 CSS 动画合成实现飞入购物车弧线。

基于 Horizon 4.2.0 源码，拆解区块自定义背景色时的服务端对比色推导：调色板最亮与最暗色、contrast-override 的三级文字色回退与边框回退、按亮度切换的透明度令牌、悬停色推导、背景媒体时跳过对比，以及亮度阈值和预设说明与实现不符等问题。

基于 Horizon 4.2.0 源码，拆解跑马灯、幻灯片、卡片轮播、分层幻灯片与 Hero 的自动播放、暂停控制、键盘与 aria 处理，并核查主题是否内置滚动显现，对照通用页面列出减少动态差距。

基于 Horizon 4.2.0 源码，追踪商品画廊的媒体排序、放大对话框、视频与 3D 加载，以及 product-hotspots 的坐标、触屏退化和售罄状态，并对照通用页面列出无障碍与退化差距。

基于 Horizon 4.2.0 源码，追踪 Shopify 预测搜索从头部按钮、dialog 弹窗、分区渲染请求到结果面板的全链路，并对照站内搜索模块列出空状态、键盘、aria 与请求失败处理的差距。

基于 Horizon 4.2.0 源码，解释商品循环怎样把商品传入 Shopify 商品卡，以及快速购买为何要继续读 JavaScript 中的缓存与跳转处理。

基于 Horizon 4.2.0 源码，追踪 Shopify 商品页从 JSON 模板到 Section 的上下文传递、媒体与详情布局委托及吸底购买条入口。

说明阅读 Horizon 源码时怎样固定版本与 commit、按 Liquid 求值顺序读条件分支，避免把未固定版本的资料、文件命名或静态检查当成平台规则。

基于 Horizon 4.2.0 源码，说明商品页推荐区块如何用分区渲染接口按 related 或 complementary 取回商品、怎样为空时回退或隐藏，以及与商品卡、轮播的关系，并对照交叉销售模块列出差距。

基于 Horizon 4.2.0 源码，拆解 SectionRenderer 与自研 morph：同分区请求取消与结果复用、排序后的缓存键、首屏预存缓存与有限的请求去重，morph 的表单状态同步、编辑中保护、运行时状态保留与跳过开关，以及几处值得商榷的耦合。

基于 Horizon 4.2.0 静态源码，说明商品页吸底加购栏的显示条件、购买区可售与库存文案、门店取货可用性、加购成功与失败反馈，并对照通用契约列出缺口。

基于 Horizon 4.2.0 源码，沿全局颜色变量、实例间距与尺寸片段和组件 CSS，追踪 Shopify 主题外观设置怎样生效及共享片段的修改范围。

基于 Horizon 4.2.0 源码，从选择器 Liquid、请求 URL 到异步返回 HTML，追踪 Shopify 变体切换怎样更新购买按钮与数量状态。

基于 Horizon 4.2.0 源码，拆解多页面主题里的跨文档 View Transitions：按设置输出的 opt-in、等主内容的 render blocking 与 1.8 秒上限、不可能过渡时立即放手、用户交互即跳过、按类型切换动画并跨页传递，以及内嵌 WebView 黑名单与页面内过渡。

精读 Impact 7.2.0 中四个小型自定义元素：让比视口还高的 sticky 元素可以完整滚动的 SafeSticky，按剩余滚动距离渐隐的 ScrollShadow，按视觉行拆分文字的 SplitLines，以及标签页切到后台时自动暂停的 Player。

Impact 7.2.0 用 cart:prepare-bundled-sections 事件让购物车抽屉等组件自报要刷新的 section，加购一次请求就拿回全部 HTML，再通过 variant:add 与 cart:change 分发，并用 Promise 单例和 bfcache 处理保持数量一致。

Impact 7.2.0 以 open 属性作为唯一状态来源，在 DialogElement 中统一处理 aria-expanded、inert、焦点陷阱、多层滚动锁定、触屏外部点击与 Theme Editor 事件，再由 Shadow DOM 模板派生抽屉和弹层。

Impact 7.2.0 主题源码精读系列入口：间距折叠、变体预取与局部重渲染、购物车事件、对话框基类、行为小组件和媒体懒加载六个实现的阅读顺序与研究边界。

Impact 7.2.0 的 BaseMedia 用 Proxy 把尚未加载的 YouTube、Vimeo、原生视频与 3D 模型播放器包装成可直接调用的对象，配合 template 延迟创建 iframe、同组互斥播放和低电量模式下的自动播放降级。

Impact 7.2.0 如何用 Liquid 把背景色转成数字哈希，借相邻兄弟选择器传给下一个 section，再用 calc、min、max 算出布尔值来决定顶部间距，避免同背景 section 出现双倍留白。

Impact 7.2.0 切换商品变体时不在前端拼价格和库存，而是用 option_values 与 section_id 请求 Shopify 渲染好的 HTML，在视口可见和悬停时预取，并按区块类型局部替换以保留数量与焦点。

Shopify 官方主题 Dawn 与 Horizon 的源码研究入口：先完成主题基础，再按固定版本或 commit 分析功能、配置与交互，并说明各自验证范围。

汇总 Dawn v15.3.0 与 Horizon 4.2.0 在固定提交中对新增展现形式和功能模块的覆盖：哪些内置、哪些在全仓库搜索中未找到、哪些尚未核对，并指向各功能域源码解读。

排查 Shopify 购物车、结账与订单金额不一致：先固定 API 版本、买家上下文和金额口径，再比较 CartCost 等字段，避免套用历史公式。

说明 Shopify 结账页、感谢页与订单状态页各自能改到哪一步：checkout and accounts editor 的品牌与设置、Checkout Blocks、UI extensions 与 Functions 的分工、动态结账按钮的位置，以及 checkout.liquid 与 Scripts 的弃用现状，并并列官方页面的差异。

说明 Shopify 折扣的类型与方式（折扣码与自动折扣；金额、买 X 得 Y、免运费）、资格与门槛、组合规则与上限、起止时区、折扣与 compare-at 价格的区别、结账提示语、分享链接，以及 Liquid 与 API 中读取折扣的入口。

说明 Shopify 订单欺诈分析的风险等级与建议操作、手动审核与取消，以及 Shopify Payments 的拒付与询单流程、证据提交要求与时间线，并标出第三方支付服务商的拒付由服务商处理、官方页面之间的表述差异。

Shopify 订单履约与配送怎么查：按订单行项目把商品、数量、地点、履约进度与物流记录放在同一条检查链上，避免重复发货。

说明 Shopify 礼品卡的两种发放方式（礼品卡商品与后台创建）、面值上限、币种与跨币种兑换、有效期、结账使用限制，礼品卡页面模板与 Liquid、API 入口，以及它与店铺储值（store credit）的区别。

说明 Shopify 本地配送（按邮编或半径划配送区域、最低订单金额与配送价格）与门店取货（按地点开通、预计取货时间、整单同地点有货的默认要求与门店调拨）的配置、结账呈现、主题取货可用性接口与订单履约通知，并标出官方页未写的配送时间窗口，以及与运费、市场和 POS 的关系。

说明 Shopify 多币种定价：展示币种、店铺币种与 payout 币种的区别，自动与手动汇率、舍入、按市场的固定价格与价格调整，折扣与礼品卡、税费与退款在本地币种下的行为，Liquid 与 API 的金额读取，以及各官方页面对支付网关要求的并列口径。

Shopify 订单、付款、履约与退货状态分别代表什么？区分 Pending、Authorized、Paid 等阶段，避免用一个“完成”覆盖不同业务。

说明 Shopify 后台订单管理的四类操作：订单编辑的可编辑范围与限制、草稿订单的用途与 B2B 关系、取消订单与库存和退款的关系、归档与自动归档，并覆盖订单标签、备注、导出与对账入口。

梳理 Shopify Payments、第三方支付服务商、手动支付、Shop Pay、Shop Pay Installments 与动态结账按钮的关系，说明结账页自定义的套餐限制，以及多币种与支付网关的依赖，并并列官方页面之间的表述差异。

说明 Shopify POS 的定位与订阅（所有付费套餐含基础功能，POS Pro 按地点加购，Retail 套餐含一个 POS Pro 地点），POS 与线上共享的库存与订单、多地点库存口径、折扣在 POS 的差异（自动折扣需 POS Pro、自定义折扣、组合规则）、线下退货与线上退货、门店取货订单在 POS 的处理，并标出官方页面互相不一致或未读到的部分。

Shopify 购买旅程：沿浏览、加购、结账、订单与售后定位消费者体验和商家任务，并区分主题、Checkout 与客户账户的扩展位置。

Shopify 购买与事件验证流程：按商品、购物车、结账、订单四阶段记录业务与事件证据，区分测试计划和已观察到的事实。

Shopify 退货、退款与补回库存分别核对：区分货物流转、资金处理和库存记录，退款提交后无法撤销，避免重复执行售后操作。

说明 Shopify 销售计划与销售计划组是什么，主题必须提供的选择器与 selling_plan 输入，购物车与订单里的呈现，Shopify Subscriptions 与预购、试用应用的边界，以及支付网关与渠道限制。

说明 Shopify 结账运费怎样产生：Shipping profiles 与按市场的 shipping options、固定费率、按订单金额或重量分档、承运商与应用计算费率及备用费率、包装与重量、免运费的两种实现，以及发货标签、追踪号回填与运费税的边界。

Shopify 税费与关税机制：Settings > Taxes and duties 的税设置、含税价与不含税价显示、按市场设置、地区税服务、DDP 与 DAP 进口费用、HS code 与原产地、折扣与税费的计算顺序，以及税务合规的边界。

品牌故事（Brand Story）怎样组织品牌缘起、关键行动与可核验的经营事实，使故事与顾客和商品建立关系，并给出发布前检查项。

价值观与责任声明回答“这个品牌坚持什么、能否证明”，覆盖可持续、公益、供应链与工艺来源，要求每条宣称写明范围、时间窗、指标口径和证据形态，避免空泛环保表述。

核心主张或活动信息回答店面当前最重要的价值或活动，检查受众、范围、时效与行动是否一致，并区分 Hero、Announcement Bar 等展现形式。

Customer Reviews 用户评价如何收集与展示：保留评分分布和负面反馈，说明评价来源、验证购买与激励规则，并处理零评价和少量评价状态。

Customer Testimonials 顾客证言是精选个案而非总体评价；本文说明人物、语境、结果与授权要收集什么，并避免用单一个案暗示普遍效果。

邮件订阅邀请（Newsletter）怎样说明订阅价值、内容频率与退出方式，并完善营销同意、表单反馈、重复订阅和弹窗触发等状态。

FAQ 常见问题应从顾客真实问题建立，完善答案范围、负责人、更新时间和页面子集；Accordion 只是展现方式之一，关键限制不应藏进 FAQ。

特色商品（Featured Products）说明为什么优先展示某些商品，梳理新品、畅销等标签的事实来源、排序依据与期限，以及缺货和零项时的退化行为。

保证详情（Guarantee）需写明保证对象、期限、条件、排除项与申请步骤，区分品牌保证、退货政策和法定权利，页面摘要不能比正式条款更宽。

Loyalty & Rewards 会员与奖励计划说明长期购买或推荐能得到什么；需完整披露获得、兑换、过期与排除规则，并与限时促销、保证承诺和结账实际保持一致。

媒体报道（Media Coverage）如何核验媒体独立性、报道时间、原文与引用权限，区分独立报道、赞助内容和广告，避免把 Logo 墙当作报道证据。

Product Unboxing 开箱内容与包装清单：明确标准包含、可选和另售物品，处理数量、变体、市场与图片差异，让顾客能逐项核对收到什么。

支付方式与分期回答我能用什么方式付款、是否可以分期、付款是否安全：说明可用支付方式、钱包、先买后付的费用与资格披露、货币和地区差异，并与信任标志划清界线。

商品分类如何用顾客能理解的维度组织浏览入口，检查分类名称层次、纳入与排除规则、与实际商品集合的对应关系以及空分类状态。

商品概述回答商品是什么、适合谁、解决什么问题，说明如何区分事实与营销判断、与详细规格互补，并让价格和变体来自商品数据。

商品展示与使用场景说明商品在真实语境中如何出现和使用，完善人物、场景、步骤与媒体授权，并避免把极端结果误示为普遍效果。

商品规格与参数回答这件商品的具体尺寸、重量、材质、兼容性和保养要求是什么，说明字段、单位换算、变体差异、测量公差、版本变化与 Shopify 结构化保存方式。

Product Video 商品视频区分功能演示、安装教学、质感展示与 TVC 广告，说明字幕、加载性能、自动播放和无法播放时的替代内容要求。

促销与折扣内容需写明优惠机制、资格、商品范围、门槛、叠加规则和有效期，先核对结账实际执行，确保页面承诺与购物车结果一致。

Proof Metrics 数据证明指已服务顾客数、评分、推荐率等数字型证据；本文说明口径定义、统计时间窗、来源、取整与最高级、第一类比较表述的证据要求，以及动态数据与手写数字的区别。

相关商品推荐需先确定替代、搭配、补充购买或同系列关系，说明人工规则、算法等推荐来源和适用语境，并避免推荐不可售或不兼容商品。

博客或资源内容应围绕顾客学习任务组织，区分教程、指南、案例与新闻，完善作者、更新时间、引用来源和下一步阅读路径。

配送与时效信息回答能不能送到、多少钱、多久到：写清配送范围、运费规则、处理与运输时间、关税税费、追踪和退回运费，区分预估与承诺，并与结账实际计算一致。

Social Follow 关注入口引导顾客持续关注品牌，涵盖社交账号、Shop 应用里的 Follow on Shop 和频道入口；说明要收集的账号事实、关注价值、失效处理，并区分邮件订阅。

Support & Contact 客服渠道与服务时间说明有问题时找谁、多久能得到回复；需写清渠道、时区、响应预期、升级路径与表单数据告知，并与 FAQ 和联系页分工。

Third-Party Reviews 第三方评价平台内容展示 Trustpilot、Google 商家评价等独立平台上的评分与评论；说明主页链接、评分快照日期、评价总数、邀请方式与选择性展示要核对什么。

Trust Badges 信任标志需核验认证、检测、支付、隐私和产地等标志的发证主体、适用范围与有效期，避免把支付方式 Logo 当作安全认证。

User-Generated Content 用户生成内容是顾客拍摄或发布的照片、视频与社交帖子；本文说明转载授权、来源可追溯、与评价和证言的边界，以及嵌入 Instagram、TikTok 内容的下架处理。

库存状态与到货通知模块如何用统一词表表达有货、低库存、售罄、缺货预订、预售、不可配送与不可取货，说明库存追踪关闭、多地点与本地取货下的判据，要求低库存与稀缺提示必须来自真实库存规则，并定义到货通知订阅的同意与隐私。

购买区模块如何在商品页把价格、划线价、单位价、变体选项、数量、加购与立即购买、销售计划及配送退换提示连成一个可验证的购买契约，区分商品与变体层级，并定义未选选项、超库存与售罄等错误状态。

购物车摘要模块如何在购物车页与购物车抽屉中共用同一份行项目、数量、小计、折扣、运费预估与结账入口契约，强调金额来自平台计算，并覆盖库存不足、数量规则、备注与跨市场等状态。

集合浏览与筛选模块如何在集合页与搜索结果页中组织大批量商品结果、筛选条件、排序口径与翻页位置，让筛选状态可由 URL 重建、可分享、可返回，并处理空结果、结果计数与可抓取边界。

交叉销售与追加购买模块如何在商品页、购物车和结账后语境中呈现搭配、升级、捆绑与加购，要求推荐依据可解释、不推荐不兼容或不可售商品、加购后购物车保持一致，并避免预勾选与隐藏拒绝等暗黑模式。

尺码与适配指引模块如何在商品页提供尺码表入口、身高体重推荐、兼容型号与尺寸的适配检查，并说明推荐依据、单位与地区差异、退换和尺码反馈，无法确定时退回联系入口，避免伪造推荐或把未知当作合适。

商品选型模块如何组织候选商品、共同维度、筛选与比较状态，帮助顾客从“有哪些”走到“哪一个适合我”，并保持价格、库存与变体信息可验证。

产品支持导航模块如何按型号、版本、语言和任务组织包装清单、安装、使用、维护、排错与联系支持，避免把全部帮助内容堆进一组商品页 FAQ。

促销兑现模块如何连接活动文案、优惠代码、资格判断和购物车金额反馈，区分复制、提交、适用与最终生效，并覆盖无效、重复和条件不满足等状态。

评价展示模块如何在商品页把自有评价、评分汇总与分布、评论列表、筛选、媒体评价和商家回复组织成可核对的整体，并处理零评价与少量评价、结构化数据、无障碍和第三方评价的分开展示。

订阅获取模块如何在页脚、文章末尾、结账相关位置、弹窗与退出意图等获取点收集邮件或短信订阅，定义同意文案、触发时机与频次上限、表单错误成功与重复提交状态，并与社交关注入口分工。

站内搜索模块如何把搜索框、预测建议、结果页与无结果处理连成一个任务入口，说明拼写容错与同义词的边界、建议与结果的一致性、搜索词日志作为需求来源的用法，以及隐私与 combobox 无障碍要求。

证据条模块把评分摘要、媒体 Logo、认证与支付事实、数据证明组合成首页或商品页顶部一行紧凑证据，要求每一项都指向权威条目、各自独立失效撤下，并说明展现取舍、数量优先级与不堆砌无来源徽章。

变体媒体模块如何根据当前商品选择组织图片、视频与 3D 媒体，定义切换、回退、加载、错误和移动端退化状态，避免媒体与价格、库存或购买动作脱节。