Shopify 商店如何做第一次 SKU.md 驗證
v1.0.0 專題
以證據為中心的 Shopify 驗證流程，覆蓋路由控制、發現宣告、HTTP 證據、文件驗證，以及尚未驗證的 App Proxy 方案邊界。
目前狀態： 本文依據目前 v1.0.0-beta 邊界撰寫，只陳述方法和證據要求，不把尚未驗證的平台採用、排名、引用、推薦或銷售結果寫成事實。
Shopify 驗證只有在另一位人員能夠請求公開資源並重現相同結果時才算成功。主題設定或 App Proxy 設定只是準備工作，不是成功證據。本文說明形成 Shopify 已驗證支援結論前必須留下哪些證明。
目前狀態與證據條件
倉庫尚未把 Shopify PoC 標記為完成。App Proxy 是候選路線，因為 Shopify 可以在設定的應用路徑下轉發請求；主題範本也能聲明發現資訊。但任何一項能力都不能單獨證明規範 SKU.md 資源已經按要求的位元組、重新導向、來源和媒體類型公開。
本文現已作為驗證指南公開。由於尚未歸檔可重複的公開執行，本文不宣稱 Shopify 支援已經得到驗證。
先確認商家真正控制的路由
列出所有可用發布面：主題輸出、App Proxy、Headless 店面或同源外部服務。記錄誰能修改、精確路徑是否可用、快取和重新導向由誰負責。優先提供根 /sku.md；如果使用宣告式備用入口，必須滿足規範的發現和同源規則。
不要同時設定多個互相競爭的目錄地址。規範資源必須能夠確定性選出。
發布並聲明發現入口
從已審核商品資料生成最小目錄，透過選定路由公開。如果不能提供精確根路徑，就從商家控制的頁面或回應加入規範支援的 HTML 或 HTTP 發現宣告。宣告應指向規範目錄，不能指向管理預覽或需要登入的地址。
使用乾淨客戶端請求公開 URL，儲存最終地址、完整重新導向鏈、狀態碼、回應頭、媒體類型和回應位元組。
同時驗證文件和文件圖
把線上實際回應交給 SKU.md Validator，再至少遍歷一份商品知識文件，檢查回鏈、來源、識別碼和被排除的即時欄位。本機檔案驗證適合編輯階段，卻不能證明公開路由可用。
還要測試失敗路徑：應用缺失、代理關閉、商店網域錯誤、返回 HTML、跳轉到站外和快取陳舊。
必須儲存的證據包
| 證據 | 必須觀察到的結果 |
|---|---|
| 路由 | 無需登入的公開請求成功 |
| 重新導向 | 每一跳都有記錄並符合策略 |
| 傳輸 | 返回 UTF-8 Markdown 和允許的媒體類型 |
| 文件 | 目錄及抽樣商品知識通過驗證 |
| 發現 | 乾淨消費者能夠解析規範 URL |
| 可重複性 | 另一位人員之後可以重複執行 |
按正確順序排查
先檢查原始 HTTP 回應，再修改文件內容。返回 HTML 往往表示請求落入店面回退；302 迴圈指向代理或鑑權設定；位元組正確但驗證失敗才是文件問題；文件有效卻無法發現，則要檢查宣告和優先順序。
每類觀察要分開記錄，避免把路由修復誤判為內容修復。
何時可以形成支援結論
證據包必須寫明測試商店、路由設定、公開地址、時間戳、Validator 版本和預期結果，並允許公開證明持續可存取。滿足這些條件前，這套流程仍是測試方案，不能表述成 Shopify 支援已經得到驗證。
把路由當作實驗，不當作平台承諾
Shopify 商店會因套餐、主題、應用設定、自訂網域、Markets 和快取路徑而不同。App Proxy 是候選機制，因為它可以在商店路徑下暴露應用回應；但這並不能自動證明精確根路徑、MIME、重新導向和發現行為滿足 SKU.md 契約。PoC 必須從獨立消費者實際存取的公開自訂網域開始。
記錄初始請求、每次重新導向、最終 URL、狀態碼、Content-Type、快取頭、回應正文雜湊和時間，並在乾淨客戶端與內容更新後重複。若平台返回主題 HTML、登入頁或跨域跳轉，應原樣進入報告，不能只保留成功截圖。
分開驗證發現和內容
先請求首選根路徑；若不可用，再檢查商家可控頁面或回應中的允許發現宣告，並按 HTTPS、同源、憑證、查詢、片段、重新導向和衝突規則解析。只有測試者手工貼上隱藏地址才能通過 Validator，不算完成了發現驗證。
隨後驗證 Catalog 位元組和所有商品知識文件，檢查必需標題、版本、連結、來源、Catalog 回鏈和圖一致性。還應故意測試一個壞商品連結和互相沖突的發現宣告，以證明失敗能被識別，而不是隻證明順利路徑能渲染。
支援結論需要什麼證據
Shopify 支援結論至少需要公開商店 URL、可重現設定步驟、HTTP 證據、文件與圖驗證結果、已知套餐或設定限制，以及非實作者完成的第二次執行。報告要明確寫出實際生效的機制，不能把一家店的設定推廣為所有 Shopify 商店都支援。
若只有備用發現路徑可行，就誠實標為相容模式；若根路徑能穩定工作，再提供嚴格模式證據。無論哪種結果，即時庫存和結帳仍由 Shopify 負責。PoC 只證明穩定知識能夠公開、發現和驗證，不證明平台推薦、排名或銷售結果。
一套最小可重複驗證順序
初次設定和每次路由變化後都運行同一流程：無 Cookie 請求根路徑，按記錄的規則跟隨重新導向，檢查頭與位元組，必要時解析發現宣告，驗證 Catalog，在固定請求預算內抓取商品文件並比較文件圖。把命令或指令碼隨報告儲存，讓其他人能重現。
還要測試刪除和回滾：移除商品後 Catalog 不應留下斷鏈；恢復上一批准版本後應重新得到記錄中的雜湊。這些操作能暴露一次成功截圖看不到的快取與部署問題。