SKU.md 平台發布指南:Shopify、WooCommerce、BigCommerce 與 SHOPLINE
BLOG / sku-md-platform-publishing-guide.mdx
比較四個平台的嚴格根發布與相容展示路徑,並說明官方能力證據和發布前必須重查的邊界。
平台名稱不會讓一次 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校準範圍。