跳至主要內容

SKU.md 1.0.0 的檔案格式與驗證規則。

v1.0.0 定義目錄檔案和可選的商品資料文件,均使用純 Markdown。目錄檔案提供商品目錄入口;商品資料逐條附上來源。固定標籤保持英文,說明文字可以使用任意語言。

根目錄檔案

必須精確發布在 /sku.md,用來標明商家、官方網站,以及至少一個同源的公開目錄連結。

# 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)

商品資料(Product knowledge)

每個標準商品頁對應一份文件;每條事實或視需要的知識,都以一個或多個絕對 HTTPS Source 連結結尾。

# UltraLight 2P Tent> A lightweight two-person tent for three-season backpacking. SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)Catalog: [Example Outdoor Gear](https://www.example-outdoor.com/sku.md)Product: [Official product page](https://www.example-outdoor.com/products/tent)Updated: 2026-08-11 ## Facts- Packaged weight is 1.35 kg. [Source](https://www.example-outdoor.com/products/tent)

商品 HTML 替代連結

商品頁可以宣告 Markdown 替代連結,但根目錄 /sku.md 與 Product knowledge 連結仍是主要的探索路徑。

<link rel="alternate" type="text/markdown" href="https://www.example-outdoor.com/products/tent.sku.md">

語法

使用標題、固定標籤行、清單與一般 Markdown 連結。未知的章節會保留給人閱讀,但不屬於規範欄位。

三種驗證範圍

範圍說清楚,驗證結果才有意義。

document

檢查單一 Markdown 的必備結構、安全連結、大小與來源規則。

published

增加精確 URL、HTTP 200、MIME、UTF-8、重新導向與最終資源檢查。

graph

增加根檔案與商品檔案互連、同源關係、來源可存取性、重複與循環檢查。

參考消費端行為

符合規範的消費端在回答事實時會保留來源,不把靜態檔案當成即時商務權威。

  • 為每條商品事實附上實際使用的 Source。
  • 區分事實、建議、限制和相容性。
  • 目前的價格、庫存、配送或結帳問題應轉向即時來源;無法確認時就明確回答不知道。

安全邊界

SKU.md 是普通的公開 Markdown,不是隱藏指令通道。

  • 拒絕原始 HTML、指令碼、表單、不安全的通訊協定、超過大小上限的檔案和無效的 UTF-8。
  • 未經人工審核,不會把自動擷取的內容說成商家已確認。
  • 不加入操縱排名的內容、隱藏的 Agent 指令或交易憑證。

版本歷史

1.0.0 與 v0.10 完全切開,不提供相容模式、轉換工具或版本選擇器。

延伸閱讀

歷史文章保留原始日期與當時的發布說明;目前的行為請以現行規範與工具為準。