Shopify 店铺如何做第一次 SKU.md 验证
v1.0.0 专题
以证据为中心的 Shopify 验证流程，覆盖路由控制、发现声明、HTTP 证据、文档校验，以及尚未验证的 App Proxy 方案边界。
当前状态： 本文依据当前 v1.0.0-beta 边界撰写，只陈述方法和证据要求，不把尚未验证的平台采用、排名、引用、推荐或销售结果写成事实。
Shopify 验证只有在另一位人员能够请求公开资源并复现相同结果时才算成功。主题设置或 App Proxy 配置只是准备工作，不是成功证据。本文说明形成 Shopify 已验证支持结论前必须留下哪些证明。
当前状态与证据条件
仓库尚未把 Shopify PoC 标记为完成。App Proxy 是候选路线，因为 Shopify 可以在配置的应用路径下转发请求；主题模板也能声明发现信息。但任何一项能力都不能单独证明规范 SKU.md 资源已经按要求的字节、重定向、来源和媒体类型公开。
本文现已作为验证指南公开。由于尚未归档可重复的公开运行，本文不宣称 Shopify 支持已经得到验证。
先确认商家真正控制的路由
列出所有可用发布面：主题输出、App Proxy、Headless 店面或同源外部服务。记录谁能修改、精确路径是否可用、缓存和重定向由谁负责。优先提供根 /sku.md；如果使用声明式备用入口，必须满足规范的发现和同源规则。
不要同时配置多个互相竞争的目录地址。规范资源必须能够确定性选出。
发布并声明发现入口
从已审核商品数据生成最小目录，通过选定路由公开。如果不能提供精确根路径，就从商家控制的页面或响应加入规范支持的 HTML 或 HTTP 发现声明。声明应指向规范目录，不能指向管理预览或需要登录的地址。
使用干净客户端请求公开 URL，保存最终地址、完整重定向链、状态码、响应头、媒体类型和响应字节。
同时验证文档和文档图
把线上实际响应交给 SKU.md Validator，再至少遍历一份商品知识文档，检查回链、来源、标识符和被排除的实时字段。本地文件验证适合编辑阶段，却不能证明公开路由可用。
还要测试失败路径：应用缺失、代理关闭、商店域名错误、返回 HTML、跳转到站外和缓存陈旧。
必须保存的证据包
| 证据 | 必须观察到的结果 |
|---|---|
| 路由 | 无需登录的公开请求成功 |
| 重定向 | 每一跳都有记录并符合策略 |
| 传输 | 返回 UTF-8 Markdown 和允许的媒体类型 |
| 文档 | 目录及抽样商品知识通过校验 |
| 发现 | 干净消费者能够解析规范 URL |
| 可重复性 | 另一位人员之后可以重复运行 |
按正确顺序排查
先检查原始 HTTP 响应，再修改文档内容。返回 HTML 往往表示请求落入店面回退；302 循环指向代理或鉴权配置；字节正确但校验失败才是文档问题；文档有效却无法发现，则要检查声明和优先级。
每类观察要分开记录，避免把路由修复误判为内容修复。
何时可以形成支持结论
证据包必须写明测试商店、路由配置、公开地址、时间戳、Validator 版本和预期结果，并允许公开证明持续可访问。满足这些条件前，这套流程仍是测试方案，不能表述成 Shopify 支持已经得到验证。
把路由当作实验，不当作平台承诺
Shopify 店铺会因套餐、主题、应用配置、自定义域名、Markets 和缓存路径而不同。App Proxy 是候选机制，因为它可以在店铺路径下暴露应用响应；但这并不能自动证明精确根路径、MIME、重定向和发现行为满足 SKU.md 合同。PoC 必须从独立消费者实际访问的公开自定义域名开始。
记录初始请求、每次重定向、最终 URL、状态码、Content-Type、缓存头、响应正文哈希和时间，并在干净客户端与内容更新后重复。若平台返回主题 HTML、登录页或跨域跳转，应原样进入报告，不能只保留成功截图。
分开验证发现和内容
先请求首选根路径；若不可用，再检查商家可控页面或响应中的允许发现声明，并按 HTTPS、同源、凭据、查询、片段、重定向和冲突规则解析。只有测试者手工粘贴隐藏地址才能通过 Validator，不算完成了发现验证。
随后验证 Catalog 字节和所有商品知识文档，检查必需标题、版本、链接、来源、Catalog 回链和图一致性。还应故意测试一个坏商品链接和互相冲突的发现声明，以证明失败能被识别，而不是只证明顺利路径能渲染。
支持结论需要什么证据
Shopify 支持结论至少需要公开店铺 URL、可复现配置步骤、HTTP 证据、文档与图校验结果、已知套餐或配置限制，以及非实现者完成的第二次运行。报告要明确写出实际生效的机制，不能把一家店的配置推广为所有 Shopify 店铺都支持。
若只有备用发现路径可行，就诚实标为兼容模式；若根路径能稳定工作，再提供严格模式证据。无论哪种结果，实时库存和结账仍由 Shopify 负责。PoC 只证明稳定知识能够公开、发现和校验，不证明平台推荐、排名或销售结果。
一套最小可重复验证顺序
初次配置和每次路由变化后都运行同一流程：无 Cookie 请求根路径，按记录的规则跟随重定向，检查头与字节，必要时解析发现声明，验证 Catalog，在固定请求预算内抓取商品文档并比较文档图。把命令或脚本随报告保存，让其他人能复现。
还要测试删除和回滚：移除商品后 Catalog 不应留下断链；恢复上一批准版本后应重新得到记录中的哈希。这些操作能暴露一次成功截图看不到的缓存与部署问题。