BLOG / introducing-sku-md-webmcp-readiness.mdx
من معرفة المنتج إلى إجراءات موثوقة داخل الصفحة: تقديم SKU.md WebMCP Readiness
دليل للتجار لاستخدام SKU.md WebMCP Readiness في فصل الاكتشاف الساكن ودليل التشغيل والإجراء المرئي والسلطة التجارية الآنية.
تاريخ النشر
إصدار المواصفة الأصلي: v0.10
لنفترض أن متسوقًا طلب من وكيل العثور على حقيبة يد تطابق حدود شركة الطيران، ومقارنة مادتين للغلاف، وإظهار اللون الصحيح في صفحة المنتج لدى التاجر. تبدو مهمة شراء واحدة، لكنها تمر بمرحلتين. قبل الزيارة يحتاج الوكيل إلى معرفة موثوقة بالمنتج: المعرفات والأبعاد وادعاءات المادة والخيارات المتوافقة والأدلة التي تدعمها. وبعد فتح الصفحة يحتاج إلى طريقة موثوقة للعمل في الواجهة المرئية للمستخدم: اختيار اللون، أو عرض الإعداد المطابق، أو الانتقال إلى الجزء المناسب.
لا ينبغي دمج المرحلتين في وعد واحد. يتيح SKU.md للوكيل فهم المنتج بدقة قبل الزيارة. ويتيح WebMCP له العمل بصورة موثوقة بعد الوصول إلى صفحة التاجر، داخل الواجهة المرئية للمستخدم. أما الحقائق التجارية النهائية، مثل السعر الحالي والمخزون والتسليم والضريبة والدفع وحالة الطلب، فتملكها الأنظمة الآنية. منصة SKU.md WebMCP Readiness تساعد التاجر على اختبار هذا التسليم من دون تقديم إشارة ساكنة على أنها دليل تشغيل.
ثلاث طبقات وثلاثة أنواع من السلطة
تبدأ المنصة بقاعدة منتج بسيطة: تجيب كل طبقة فقط عن الأسئلة التي تستطيع إثباتها. بذلك تظل معرفة المنتج الدائمة مفيدة من دون أن تتجاوز الصفحة العاملة أو الأنظمة التي تحسم المعاملة.
| الطبقة | ما تملكه من سلطة | ما يجب ألا تدعيه |
|---|---|---|
| معرفة المنتج في SKU.md | الحقائق والمعرفات والادعاءات والإفصاحات والتوافق والمصادر والنطاق ووقت المراجعة قبل الزيارة، بعد مراجعة التاجر. | أن أداة الصفحة مسجلة الآن، أو أن قيمة تجارية متغيرة ما تزال حالية. |
| WebMCP والواجهة المرئية | الأدوات التي تسجلها الصفحة في سياق المتصفح الحالي، والاستجابة المحدودة التي يستطيع المستخدم رؤيتها. | السعر أو المخزون أو الإذن أو حالة المعاملة التي لم تتحقق منها الصفحة. |
| Catalog الآني والنظام الخلفي وCheckout | السعر الحالي والمخزون وأهلية التسليم ومدخلات الضريبة وتفويض الدفع وحالة الطلب والتأكيد النهائي. | أن وثيقة ساكنة أو ملاحظة سابقة للصفحة ما تزال حالية. |
هذه هي رواية المنتج بصيغة تشغيلية: يقدم SKU.md الدليل قبل الزيارة، ويربط WebMCP القصد بإجراء مرئي بعد الوصول، وتحسم أنظمة التجارة الآنية الحقائق التجارية النهائية. تكمل الطبقات بعضها ولا تستبدل إحداها الأخرى.
إشارة الجسر لا تساوي أداة عاملة
قد يتضمن مصدر الصفحة علامة تصريحية أو استدعاء WebMCP API أو مسارًا لجسر. هذه إشارات اكتشاف مفيدة، لكنها تثبت وجود أثر فقط. لا تثبت أن المتصفح تعرف إلى الواجهة، أو أن الأداة مسجلة في حالة الصفحة الحالية، أو أن Schema المدخلات صالح، أو أن الاستدعاء سينجح.
تتغير حالة التشغيل. قد تظهر الأداة بعد تحميل مكوّن، أو تلغى حين يصبح اختيار غير صالح، أو تعتمد على تجربة متصفح غير متوفرة في بيئة أخرى. وقد ينتهي سكربت الجسر بلا فعل في متصفح غير داعم. كما قد يكون الوصف مضللًا، أو يتضمن نص خارجي أو نص التاجر تعليمات تشبه حقن المطالبة. لذلك يفصل Readiness بين الاكتشاف والتحليل والتسجيل والاستدعاء والاستجابة المرئية ومراجعة السلامة والتحقق من البيئة، بدل دمجها في شارة خضراء واحدة.
لا ينفذ الفحص الساكن JavaScript للصفحة الهدف، ولا يستدعي نقطة MCP لديها. أقوى نتيجة صادقة هي العثور على إشارة. يجب أن يأتي دليل التشغيل من الصفحة الهدف داخل سياق متصفح حقيقي.
مسار التاجر في خمس خطوات
تحصر المنصة الاختبار في نطاق يستطيع التاجر فهمه ومراجعته وتكراره.
- أدخل صفحة دقيقة واحدة. اختر URL عامًا عبر HTTPS لمنتج أو سلة أو Checkout أو Order. ويمكنك طلب مقارنة وثيقة المنتج الجذر من الأصل نفسه، مع بقاء الصفحة والوثيقة موردين منفصلين.
- شغّل الفحص الساكن. يفحص SKU.md عقد الاستجابة وإشارات WebMCP في المصدر، ويسجل موانع السلامة الصريحة، ويقارن نطاق الصفحة في وثيقة المنتج الاختيارية. ولا ينفذ الصفحة.
- اكتشف الأدوات محليًا. افتح الصفحة الهدف نفسها، وراجع سكربت الاكتشاف المولد، ثم شغله في سياق المتصفح لتلك الصفحة. تسجل الوصلة اسم الواجهة وسياق المتصفح وURL والوقت وقائمة الأدوات المنقحة. لا يثبت الاكتشاف وحده قابلية الاستدعاء.
- استدع أداة قراءة فقط. لا يمكن اختيار إلا أداة تحمل
readOnlyHint: trueصراحة. استخدم أقل مدخل لازم بعد تأكيد أن الصفحةpublic،unauthenticated، وخالية من موانع السلامة المذكورة. تبقى المدخلات والمخرجات الخام مؤقتًا في الصفحة. - أكد وصدّر. إذا كان التغيير متوقعًا، فسجل هل تزامنت حالة الصفحة المرئية، ثم استورد الوصلة المنقحة. نزّل تقرير JSON أو Markdown محليًا، ولا تنشئ مرشح قدرة WebMCP للمراجعة البشرية إلا بعد اجتياز كل الشروط.
الاستدعاء الواحد حد مقصود وليس مشغل أتمتة عام. الهدف إنشاء سلسلة أدلة قابلة للدفاع لصفحة وبيئة محددتين، لا تشغيل المتجر أو تنفيذ المعاملات.
اقرأ مستويات الدليل الستة منفصلة
يحافظ التقرير على ستة مستويات لأن كل مستوى يجيب عن سؤال مختلف.
- اكتشاف إشارة الصفحة: هل احتوى HTML الساكن على أثر WebMCP أو الجسر؟
- تسجيل الأداة: هل أعادت واجهة متصفح معروفة أداة واحدة على الأقل ذات Schema صالح؟
- نجاح استدعاء القراءة: هل حملت الأداة المختارة علامة القراءة فقط وأتمت استدعاءً أدنى؟
- تزامن الواجهة المرئية: عندما كان التغيير متوقعًا، هل أكد التاجر تغير URL أو المرشح أو الخيار أو الحالة المرئية؟
- اكتمال مراجعة السلامة: هل أكد التاجر السياق العام بعد تسجيل الخروج، وراجع الأصل والمحتوى غير الموثوق ومخاطر حقن المطالبة؟
- التحقق من بيئة التشغيل المسماة: هل تحدد الوصلة الواجهة والمتصفح والصفحة الدقيقة وسياق الأمان ووقت الفحص؟
يحصل كل مستوى على واحدة من حالات الدليل الأربع.
passedتعني أن الدليل المطلوب جمع واستوفى القاعدة.failedتعني أن الفحص قدم دليلًا على مخالفة محددة أو نتيجة غير ناجحة.incompleteتعني أن الدليل غائب أو قديم أو غير مدعوم أو غير كاف، ولا تعني تلقائيًا عطلًا في المنتج.not_applicableتستخدم فقط حين لا ينطبق المستوى فعلًا، مثل تزامن الواجهة لاستعلام صرف لا ينبغي أن يغير الصفحة.
تستخدم النتيجة الإجمالية passed أو failed أو incomplete فقط. تبقى الصفحة التي تملك إشارة جسر ساكنة غير مكتملة عادة حتى يتوفر دليل التشغيل. هذا التحفظ هو المقصود: يصف التقرير ما ثبت، لا ما توحي به قراءة متفائلة.
ما الذي يتعلمه التاجر من التقرير
تجيب الصفحة الأولى عن أسئلة عملية بدل إعطاء درجة عامة.
- كم أداة اكتشفت بيئة التشغيل المسماة في هذه الصفحة الدقيقة؟
- ما الأدوات التي تملك Schema مدخلات صالحًا وعلامة قراءة فقط صريحة؟
- ما المشكلة التي تمنع الاستخدام الآمن حاليًا، وما الذي يستطيع التاجر إصلاحه؟
- هل استجابت الصفحة فعلًا للاستدعاء المختار، وهل تزامنت الحالة المرئية المتوقعة؟
- هل يغطي إعلان SKU.md الاختياري هذه الصفحة الدقيقة من دون ادعاء السلطة الآنية؟
- هل اجتاز الدليل كل بوابات إنشاء مرشح قدرة beta؟
يسجل التقرير وقت الفحص والهدف والنطاق وواجهة التكييف وسياق المتصفح. لا تستطيع وصلة أقدم من 24 ساعة، أو لا يطابق URL أو نطاقها، إنشاء مرشح. بذلك يظل الاختبار الناجح مرتبطًا بالبيئة التي أنتجته بدل أن يتحول إلى وعد دائم.
يوثق الشكل المقروء آليًا في مخطط تقرير الجاهزية الإصدار الأول المحايد. إنه عقد تقرير أداة من SKU.md، وليس جزءًا من Schema وثيقة المنتج في SKU.md v0.10 ولا معيار WebMCP.
الخصوصية المحلية وحد سلامة ضيق عمدًا
يرسل URL الدقيق للصفحة وURL وثيقة المنتج الاختيارية من الأصل نفسه إلى نقطة الفحص من الأصل نفسه لدى SKU.md، كي تنفذ قراءة عامة محدودة. هذا الطلب ليس تسجيل دخول في المتصفح ولا يحمل ملفات جلسة صفحة التاجر. ولا ينفذ الفحص الساكن JavaScript أو أدوات الهدف.
يحدث اكتشاف التشغيل واستدعاء الأداة المختارة في متصفح التاجر على الصفحة الهدف. لا ترسل مدخلات الأداة الخام أو مخرجاتها الخام أو أسرار الجلسة أو الرموز أو المحادثة الكاملة إلى SKU.md، ولا تدخل في التصدير. يحتفظ التقرير ببيانات منقحة فقط، مثل اسم الأداة وحالة النتيجة والملخصات المشفرة والحجم والمدة وحالة الصفحة قبل الاستدعاء وبعده.
يقتصر الإصدار الأول على صفحة عامة بعد تسجيل الخروج وأداة واحدة واضحة للقراءة فقط. لا يختبر سعر العضوية أو البيانات الشخصية أو الطلبات الموثقة أو الدفع أو الإرجاع أو إكمال Checkout أو أي إجراء يغير الحالة التجارية. تعامل أوصاف الأدوات وSchema المدخلات وملخصات المخرجات ونص التاجر ومحتوى الأطراف الأخرى كنص غير موثوق؛ إعلان القدرة ليس إذنًا بالتنفيذ.
مرشح beta مادة للمراجعة لا سلطة
عندما يجتاز الفحص الساكن وبيئة تشغيل معروفة والتسجيل وSchema صالح وتأكيد الجلسة العامة واستدعاء قراءة واحد وكل فحوص السلامة ضمن المهلة، تستطيع المنصة إنشاء مرشح قدرة beta. يستخدم المرشح نمط صفحة دقيقًا واحدًا، وينص على ضرورة سياق صفحة المتصفح وحضور المستخدم.
هذا الملف محدود عمدًا. لا ينسخ قائمة الأدوات الديناميكية، ولا ينشئ نطاقًا عامًا، ولا يمنح إذنًا، ولا ينشر نفسه، ولا يرفع وثيقة أساسية تلقائيًا إلى وثيقة تجارية، ولا يصرح بمعاملة. إنه مادة يراجعها التاجر ويدمجها يدويًا. إذا تعارض إعلان تجاري حالي، يعرض التقرير الفرق؛ وإذا كانت الوثيقة أساسية، يسرد المتطلبات التجارية الأخرى التي ما تزال ناقصة.
لذلك لا يمثل Readiness جسر إنتاج وعدت به إشارة ساكنة. إنه مسار الدليل الذي ينبغي أن يسبق قرار الجسر. تتطلب حزم الإنتاج وإجراءات الكتابة وCheckout وOrder واتصالات MCP الخلفية تصميمًا ومراجعة أمان مستقلين.
ابدأ بصفحة منتج حقيقية واحدة
اختر صفحة منتج مستقرة وعامة تعيد HTML مباشرة، ثم ابدأ بالفحص الساكن. إذا كانت النتيجة مجرد إشارة، فلا تصفها بأنها ناجحة. تابع الاكتشاف المحلي فقط داخل الصفحة الدقيقة نفسها التي تديرها، ثم اختبر أداة قراءة واحدة واضحة المعنى. تقرير incomplete صادق أنفع من شارة passed مبنية على افتراضات.
افتح منصة الجاهزية المحلية لاختبار صفحة. ولفهم الفصل الكامل بين معرفة المنتج وإجراءات صفحة المتصفح، اقرأ المقال المفاهيمي عن معرفة المنتج قبل الزيارة والإجراءات المنظمة في الصفحة.
قراءة إضافية
تعرّف إلى الحدود بين المعرفة وإجراء الصفحة والطلب في خريطة تسليم السلطة