BLOG / sku-md-platform-publishing-guide.mdx
SKU.md 平台发布指南:Shopify、WooCommerce、BigCommerce 与 SHOPLINE
比较四个平台的严格根发布与兼容展示路径,并说明官方能力证据和发布前必须重查的边界。
平台名称不会让一次 SKU.md 部署自动合规。是否严格发布,只能由商家同源 /sku.md 的真实响应证明;平台能力只决定可能采用哪条路。
SKU.md 是由商家托管的商品发现与稳定商品知识:agent 可以找到商品、理解有来源的事实,并知道去哪里复查实时商业状态;它不是新的结账协议。
严格发布与兼容展示不是一回事
严格根发布需要直接 HTTP 200、text/markdown、精确 canonical 与已接受字节、有效文档图、可预测缓存替换和正确失败。兼容展示可以提供发现或可读内容,却可能没有根路径或媒体类型控制权。
| 平台路径 | 官方能力能支持什么 | SKU.md 判断 |
|---|---|---|
| Shopify 主题 | Shopify 记录了自有 agents.md/llms 模板 |
兼容发现;不能证明任意 /sku.md Markdown |
| Shopify App Proxy | 允许前缀下的一条可配置路由 | 不能承诺根路径 |
| WooCommerce 路由 | WordPress Rewrite API可注册根路由 | 线上验证后可成为严格候选 |
| BigCommerce Stencil | 自定义模板绑定既有页面类型 | 兼容发现,不是任意根 Markdown |
| BigCommerce headless/edge | 商家掌控的同源应用或 edge | 线上验证后可成为严格候选 |
| SHOPLINE 托管店面 | File Library 加官方 llms.txt 301 替代做法 |
仅兼容;跳转不是直接 200 |
Shopify:自有 agent 文件不等于采用 SKU.md
Shopify 记录了自己 /agents.md、/llms.txt 和 /llms-full.txt 的主题行为,证据只覆盖这些路径。主题可以链接 SKU.md,也可以提供商品 alternate 展示,但托管主题无法据此证明根级 text/markdown。
App Proxy 只能使用 /apps 等允许前缀,商家还可以改 prefix 与 subpath。商家掌控的 Hydrogen 或 custom headless 店面可以实现 /sku.md,但只有真实响应通过后才是严格交付。
WooCommerce 与 BigCommerce:路由控制方式不同
WordPress 上的 WooCommerce 可以注册 ^sku\.md/?$,再从 template_redirect 提供预生成文件。请求时不应临时重建 Knowledge,rewrite rule 只应在插件启用与停用时 flush。Web server、插件或同源 edge 都要接受相同线上检查。
BigCommerce Stencil 自定义模板只绑定既有品牌、分类、商品和页面类型,不能证明任意根资源。商家控制的 headless 应用或同源 edge 可以拥有该路由;当前目录、价格、库存、购物车和 Checkout 仍由 BigCommerce 负责。
SHOPLINE 的 301 做法暴露了什么限制
SHOPLINE 的 LLMS.txt 指南说明根目录上传不可用,并为该文件建议 File Library 加 301。File Library 格式清单列出 .txt,没有列出 .md。
这些事实不能证明严格 /sku.md、正确 Markdown MIME 或官方 SKU.md 支持。商家掌控的 headless、代理或 edge 路由也必须完成直接同源验证。
每次发布前都要重查
平台能力会变化。采用本表前,应重新打开四份本地化平台指南及其官方来源,核对当前路由和文件限制,再测试真实店铺。不要把带日期的能力快照写成永久保证。
| 重查对象 | 所需证据 |
|---|---|
| 平台能力 | 当前一手官方文档 |
| SKU.md 交付 | 真实状态、跳转、MIME、字节、canonical、文档图、缓存、404 |
| 采用声明 | 明确点名 SKU.md 的平台声明 |
当前 v1 三平台系列
当前实施请阅读对应平台的 v1 文章:
延伸阅读
先看发布第一份 SKU.md的通用合同,再用什么是 SKU.md校准范围。