BLOG / publish-your-first-sku-md.mdx
نشر أول مستند SKU.md: دليل دقيق مستقل عن المنصة
إعداد وإنشاء ونشر وفحص مورد /sku.md الجذري عبر استجابة HTTP 200 مباشرة ونوع text/markdown وهوية أساسية وفحوص حية.
لا يكتمل النشر إلا عندما يقدم عنوان HTTPS المعلن البايتات المقبولة مباشرة وتجتاز فحوص التسليم الحية. يظل الملف الصحيح محليا مجرد ملف محلي.
SKU.md هي طبقة يستضيفها التاجر بنفسه لاكتشاف المنتجات ومعرفة المنتجات المستقرة. وهي تساعد الوكلاء على العثور على المنتجات وفهم الحقائق المسندة إلى مصادر ومعرفة المكان الذي ينبغي فيه إعادة التحقق من بيانات التجارة الحية. وليست بروتوكول Checkout جديدا.
جهز أصغر مجموعة صادقة
| المدخل | اقبله | ارفضه أو أجله |
|---|---|---|
| هوية التاجر | اسم عام ونطاق مصدر مستقران | كيان قانوني مخمن |
| مدخل الفهرس | عنوان قائم على نطاق المصدر نفسه | عنوان إدارة خاص |
| المعرفة | قول مراجع مع مصدر | نص تسويقي رفع آليا |
| العرض | ملاحظة مؤرخة أو مصدر حي مصرح | وعد بسعر دائم |
يتطلب كل Variant في v0.10 قيمة sku غير فارغة يخصصها التاجر؛ فلا تخترعها ولا تستبدل بها معرف مصدر آخر.
أنشئ وافحص محليا
ابدأ ببيان فهرس جذري ونموذج manifest-basic. افحص المخطط والرابط الأساسي وروابط المستند الأب واتساق الهوية بين البيانات الوصفية الافتتاحية والمتن وProduct JSON-LD وغياب الحقائق غير المسندة. لا يثبت نجاح offline_document إلا البنية المحلية، وليس التسليم العام.
قدم المورد الجذري مباشرة
يجب أن يعيد GET https://example.com/sku.md حالة HTTP 200 مباشرة بلا تحويل، وأن يقدم نوع MIME بقيمة text/markdown والبايتات المتوقعة. لا تحقق صفحة HTML للتوافق أو استجابة بديلة لينة أو 301 عقد النشر الصارم. ويجب فحص ذاكرة التخزين المؤقت والتحويل على شبكة CDN في العنوان الحقيقي.
افحص المورد والرسم
| النطاق | ما يثبته | ما لا يثبته |
|---|---|---|
offline_document |
البنية والمعنى محليا | التسليم العام |
published_resource |
مورد حي دقيق واحد | الرسم الكامل |
document_graph |
عقدة الأب والابن القابلة للوصول | الاعتماد أو الترتيب الخارجي |
أضف الاكتشاف عبر llms.txt أو agents.md أو Product JSON-LD أو MCP حين تكون تلك الأسطح قائمة فعلا. وراقب الأعطال وأعد الفحص بعد تغيير المنصة أو المسار أو شبكة CDN أو المستند. ويجب أن يبقى /sku.md مدخلا أساسيا قابلا للفحص. وترد الخطوات في دليل الناشر.
قراءة إضافية
افهم الفرق بين المعرفة والبيانات الحية ثم قارن مسارات المنصات.