الانتقال إلى المحتوى

BLOG / what-is-sku-md.mdx

ما هو SKU.md؟ معرفة منتجات يستضيفها التاجر للوكلاء

تعريف SKU.md وعائلة مستنداته والحدود بين المعرفة المقروءة والاستعلامات الحية والإجراءات الخاضعة للضبط.

تاريخ النشر

بقلم SKU.md Editorial Team

إصدار المواصفة الأصلي: v0.10

يربط SKU.md التفسيرات الدائمة بالمصادر المسؤولة عن الظروف التجارية المتغيرة، من دون أن يحل محل واجهة المتجر أو Catalog أو Checkout.

SKU.md هي طبقة يستضيفها التاجر بنفسه لاكتشاف المنتجات ومعرفة المنتجات المستقرة. وهي تساعد الوكلاء على العثور على المنتجات وفهم الحقائق المسندة إلى مصادر ومعرفة المكان الذي ينبغي فيه إعادة التحقق من بيانات التجارة الحية. وليست بروتوكول Checkout جديدا.

لماذا نحتاج إلى طبقة معرفة مستقلة

تتوزع بيانات المنتج الواحد عادة بين HTML وProduct JSON-LD والموجزات والأدلة وجداول المقاسات وCatalog الحي وCheckout. لا يوضح الاسم والسعر أي Variant يغطيه الاختبار، ولا وقت مراجعة المصدر، ولا النظام الذي يملك مخزون اليوم. لذلك يربط الرسم الصغير لمستندات SKU.md الهوية والمعرفة والأدلة والقيود ومداخل التحقق، من دون دمجها في مصدر حقيقة واحد زائف.

ثلاث طبقات لثلاث مسؤوليات

الطبقة الاستخدام الأنسب حدود السلطة
الويب المقروء التفسيرات المستقرة والأدلة والإفصاحات والاكتشاف يمكن أن يشارك SKU.md هنا
الويب القابل للاستعلام السعر والمخزون والشحن الحالي يملك Catalog الحي أو API أو MCP الإجابة
الويب القابل للتنفيذ السلة والدفع والطلب وإجراءات الصفحة يملك Checkout أو UCP أو WebMCP المراجع التنفيذ

تبدأ الدورة الآمنة باكتشاف المنتج وقراءة معرفته المسندة، ثم الاستعلام عن الظروف الراهنة وطلب تأكيد المستخدم قبل أي إجراء ذي أثر.

عائلة مستندات v0.10

تحدد مواصفة v0.10 بيان Catalog الجذري، وفهارس تقسيم اختيارية، ومستندات المنتجات. يسجل offer_snapshot ملاحظة تاريخية، بينما يشير live_offer إلى مصدر حي مستقل؛ ولا يحول أي منهما صيغة Markdown إلى عرض ملزم. تجعل الروابط الأساسية وروابط المستند الأب الرسم قابلا للفحص وتفصل صحة التسليم عن صحة المعنى.

مسؤولية الناشر والمنفذ والمستهلك

يراجع التاجر الهوية والمصادر والتواريخ والقيود. ويتوقف المنفذ عند الغموض ويتحقق من المورد العام، لا من المخطط المحلي وحده. أما المستهلك فيسند كلامه إلى المصادر ويعيد فحص الحالة المتقلبة. لا يمنح SKU.md إذنا، ولا يفوض دفعة، ولا يثبت أن نموذجا سيزحف إلى المنتج أو يستشهد به أو يوصي به.

قراءة إضافية

قارن llms.txt وagents.md وSKU.md ثم اقرأ دليل نشر أول SKU.md.

الخطوة التالية

ابدأ بالدليل السريع