跳至主要內容

SKU.md 平台發布指南:Shopify、WooCommerce、BigCommerce 與 SHOPLINE

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

比較四個平台的嚴格根發布與相容展示路徑,並說明官方能力證據和發布前必須重查的邊界。

發布於

作者 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 發布指南