从一个商品开始：Shopify、SHOPLINE、WooCommerce 与 BigCommerce 商家的 SKU.md 接入指南
v1.0.0 专题
对照 Shopify、SHOPLINE、WooCommerce 与 BigCommerce 的发布条件，从一个商品开始生成、审核并验证 SKU.md。
为 Agent 购物准备商品知识，不必从全店改造开始。对 Shopify、SHOPLINE、WooCommerce 和 BigCommerce 商家，合理的第一步是选一个商品：整理真实资料，确认自己的店铺能怎样提供文件，再决定是否扩大范围。
SKU.md v1.0.0 提供一套开放、可检查的表达方式。它补充商品页面、结构化数据与渠道 Feed；店铺原有的库存、支付和订单流程继续承担实时交易。这里介绍的是可评估的接入路径，不代表四个平台已经原生支持 SKU.md。
先确定能发布什么，再选择路径
接入至少涉及两项不同工作：内容准确，以及在线交付正确。运营人员可以整理规格、变体、限制和来源；技术人员或服务商需要确认店铺域名下的实际响应。
下面的判断参考平台官方资料。具体方案仍取决于店铺的托管方式、权限和响应测试，不应只根据“可以上传文件”就宣布完成。
| 平台 | 商家可控制的部分 | 接入前要确认的条件 | 验证重点 |
|---|---|---|---|
| Shopify | 主题内容；自主管理店面的路由取决于架构 | App Proxy 有固定前缀，不能据此认定已控制根路径 | 实际地址返回 Markdown，而不是主题 HTML |
| SHOPLINE | 商品内容与允许配置的重定向 | 官方重定向功能不等于已提供规范文件；需确认同源交付方式 | 目标地址、响应内容与重定向链 |
| WooCommerce | 取决于托管权限的 WordPress 路由或静态文件 | 技术人员需配置正确响应；仅增加重写规则还不够 | 状态码、内容类型、缓存与正文 |
| BigCommerce | Stencil 模板或自主管理店面的路由 | 自定义页面模板不证明可输出根路径 Markdown；受控店面需单独实现 | 区分 HTML 页面与文件响应 |
这些是依据平台能力做出的实施判断，不是平台兼容认证。如果当前店面没有合适的发布路径，先维护准确的商品资料，并让服务商评估；不必仅为一个文件更换建站平台。
当前规范怎样发现文件
优先在同一网站的精确 /sku.md 路径提供根目录文件。只有该路径返回明确的 HTTP 404 时，消费者才可以检查同源首页的一条无歧义声明，例如：
<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">被声明的文件也必须满足当前规范，包括同源 HTTPS，且地址不带查询参数或片段。超时、服务器错误和格式错误都不是“根文件不存在”，不能用备用入口掩盖。
这是一种有条件的规范路径，不是任何主题都能直接使用的技巧。首页声明与实际文件都必须可控、可验证；普通 CDN 文件链接、HTML 介绍页或跨源跳转不能直接当成已合规。
从最小目录开始
以下是虚构店铺的最小根文件。替换为真实店铺名称、简介、域名与目录地址后，再生成和检查；它本身不声称已经描述某个商品的完整属性。
# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.
SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)
## Catalog
- [All products](https://www.example-outdoor.com/collections/all)商品知识文档是可选的。增加第一个商品时，应从根目录明确链接到它，并在商品文档中保留目录回链、商品页面和逐条事实的来源。涉及变体时，说明事实属于整个商品还是某个具体款式。
五步完成一次可验证的试点
- 选择商品。 优先选公开资料完整、经常有人询问规格的商品，不必先抓取整个店铺。
- 审核事实。 对照真实页面确认身份、规格、限制及证据；未知就是未知，不凭经验推断。
- 生成并检查。 使用生成器准备根文件，需要更细的属性审核时使用商品优化工具。
- 发布并验证。 由负责店铺的人提供文件，再用在线地址检查验证真实 URL；商品文档还要检查目录关联。
- 安排维护。 指定负责人，在规格、变体或来源变化时更新文档，并重新检查；保存上次审核依据。
验收时确认公开 HTTPS 地址、HTTP 200、UTF-8 Markdown 正文及规范允许的内容类型（text/markdown 或 text/plain）。还要检查安全跳转、目录关系和来源；浏览器里看见一段文字并不代表全部通过。
如何判断试点值得继续
一个可交付的试点，应能回答：文件是否真的可访问，事实是否有来源，变体范围是否正确，哪些购买问题仍需实时系统回答。再考虑扩大商品数量，而不是只统计生成了多少文件。
SKU.md 不会登录商家后台、自动发布商品或自动提交到外部购物渠道。商家仍决定发布哪些内容；Agent 是否消费这些知识，需要独立验证。价格、库存与配送承诺始终回到店铺实时系统。
从快速开始开始，把一份已审核的商品知识交给负责店铺的人。这一步小而具体，也最容易发现值得解决的问题。
平台资料与规范
- Shopify App Proxy：代理路由能力与限制。
- SHOPLINE 重定向：地址转发能力。
- WordPress 路由重写：WooCommerce 所用基础平台的路由机制。
- BigCommerce 店面类型与自定义模板：不同店面的控制范围。
- SKU.md 1.0.0 规范：文件、发现与验证要求的依据。