SHOPLINE 商家如何為 AI Agent 準備商品知識
v1.0.0 專題
面向託管平台的準備指南，區分商家可控內容、發現提示、託管路由限制、嚴格驗證和相容性報告。
目前狀態： 本文依據目前 v1.0.0-beta 邊界撰寫，只陳述方法和證據要求，不把尚未驗證的平台採用、排名、引用、推薦或銷售結果寫成事實。
託管平台可能會限制商家能控制的根路徑與回應頭。這類限制無法靠聲明解決，必須拆成兩種定義清楚的發布模式，再用驗證報告說明哪一種在 SHOPLINE 上真的可行。
目前狀態與證據條件
目前尚未登記完成的 SHOPLINE 驗證報告。本文現已公開，用於定義嚴格模式和相容模式，但不宣稱任一路徑已在 SHOPLINE 上通過驗證。
嚴格模式
嚴格模式要求在商家自有來源和首選根路徑提供規範目錄，返回允許的 Markdown，並能確定性發現。當 SHOPLINE 路由、受支援的應用能力或同源邊緣函式可以提供回應，且不存在登入牆或店面回退時，應優先採用。
測試必須使用公開商店網域，不能使用內部預覽地址；重新導向、快取和自訂網域行為都屬於結果的一部分。
相容模式
託管店面無法控制 /sku.md 時，可以從商家控制的 HTML 頁面宣告備用 Markdown 資源。消費者必須依次執行規範規定的同源、HTTPS、憑證、查詢、片段、重新導向和衝突檢查。
之所以明確稱為相容模式，是因為信任路徑發生了變化。外部主機或跨來源 URL 不能自動等同於商店自身資源，除非規範明確允許並驗證該安排。
先準備知識，再選擇傳輸方式
盤點商家可以批准的穩定陳述：事實、建議、限制、相容性、識別碼和來源。排除即時價格、庫存、折扣、配送承諾、支付和訂單狀態。先建立小目錄，避免路由實驗掩蓋內容品質問題。
兩種模式應使用完全相同的知識文件，只讓發布和發現路徑發生變化。
驗證報告範本
| 範圍 | 要記錄的內容 |
|---|---|
| 商店 | 公開自訂網域和方案背景 |
| 模式 | 嚴格或相容 |
| 路由 | 請求 URL 與最終 URL |
| HTTP | 狀態、重新導向、MIME、快取回應頭 |
| 發現 | 宣告與解析軌跡 |
| 文件 | Validator 版本和結果 |
| 限制 | 平台約束與人工步驟 |
必須覆蓋的失敗情況
測試宣告缺失、宣告衝突、Markdown 地址返回店面 HTML、跨來源重新導向、私有預覽連結，以及文件有效但來源連結無效等情況。報告應說明每種情況被拒絕、警告還是接受。
驗證結論的證據條件
只有報告包含可重複公開執行、準確寫明使用的平台能力，並且沒有把候選技巧擴大成平台整體支援宣告時，才能把 SHOPLINE 相容性報告為已驗證。單個商店成功只能證明該設定可行。
盤點商家真正能控制的範圍
選擇路徑前，列出 SHOPLINE 公共自訂網域上可編輯的主題 head、頁面、應用端點、重新導向、回應頭、資源和代理能力。必須測試正式商店，預覽與後台地址可能有不同登入、快取和同源行為。平台文件只說明候選機制，實際回應才證明設定。
記錄每個範圍的 URL 歸屬、能否返回 Markdown、能否設定回應頭、更新是否原子。拒絕私有預覽和帶憑證連結。嚴格模式測試商家網域首選路徑；相容模式測試商家控制的 HTML 或 HTTP 宣告，並執行同源、重新導向、衝突和文件檢查。
把限制和結果一起發布
報告要包含商店背景、套餐假設、請求與最終 URL、MIME、快取、發現軌跡、Validator 版本、雜湊和重現步驟，並測試缺失或衝突宣告、HTML 回退、跨域跳轉和不可存取 Source。
只有其他人能重複公開執行後才能把 SHOPLINE 相容性報告為已驗證。一家店成功只證明一個有邊界的配方，不能代表全平台採用。即時報價、庫存、配送、支付和訂單繼續由交易系統負責。
託管限制下仍要守住安全邊界
發現目標仍是不可信輸入。消費者要強制 HTTPS、拒絕憑證 URL、執行同源政策、限制重新導向、阻止私網目標、限制回應大小和時間，並把文件當資料而非指令。外部檔案託管更方便，不代表可以降低這些要求；無法滿足時應在報告中標為不支援。
在平台報告完成前，商家仍可先盤點穩定說法、負責人、Source、Variant 識別碼和 Limitations，在本機驗證並排除即時商業欄位。路徑驗證後先發布小目錄，從後台會話之外重複發現並歸檔證據，理解更新和回滾後再擴大。
用結論表結束驗證報告
報告最後應明確三種結論之一：支援嚴格模式、在列明限制下支援相容模式，或暫不支援。每種結論都附精確證據與下一步，幫助商家選擇路徑，也防止一次充滿警告的實驗後來被概括成「原生支援」。
驗證材料應儲存指令碼、回應、雜湊、設定和日期。平台、主題或應用變化後，團隊可重新執行並和最後一次成功結果比較，而不是憑記憶重建環境。
上線後仍需持續驗證
報告要寫明維護負責人和重新測試觸發條件。主題升級、自訂網域變化、路由功能調整或安全策略更新，都可能讓原有證據失效。應安排公開健康檢查，並把「最後一次可存取驗證成功時間」和「最後一次內容編輯時間」分開顯示：前者回答檔案還能否被發現，後者回答知識是否已更新。
任何一項失敗，都應暫停整合結論，先定位問題並重新完成公開執行。這樣，SHOPLINE 整合報告是一份可維護的執行契約，而不是隻在發布當天成立的截圖。
相容模式必須保留安全邊界
當根路徑無法直接發布時，HTML discovery 只能提供候選地址，消費方仍需驗證連結關係、同源要求、回應類型、重新導向和內容大小。候選地址不可自動獲得信任，頁面中的其他連結也不能被當成商品知識入口。驗證報告應分別記錄嚴格模式和相容模式的結果，避免把相容路徑誤寫成平台原生支援。