跳到正文

BLOG / sku-md-platform-publishing-guide.mdx

SKU.md 平台发布指南:Shopify、WooCommerce、BigCommerce 与 SHOPLINE

比较四个平台的严格根发布与兼容展示路径,并说明官方能力证据和发布前必须重查的边界。

发布于

作者 SKU.md Editorial Team

原始规范版本: v0.10

平台名称不会让一次 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校准范围。

下一步

查看 Shopify 发布指南