الفحص قبل الإصدار
MCP Abilities – Check Runner: اكتمال الفحص لا يعني دائمًا اجتيازه
قد يفشل الفحص رغم عدم وجود أخطاء. يربط Check Runner مساعد الذكاء الاصطناعي بأداة Plugin Check الرسمية من WordPress، ويعدّ التحذيرات أيضًا سببًا لعدم الاجتياز. استخدموا النتيجة لتحديد ما يجب إصلاحه قبل إصدار الإضافة.
تحذير واحد يكفي لمنع الاجتياز
لنفترض أن نسخة مرشحة للإصدار لا تحتوي على أخطاء مُبلّغ عنها، لكن بها تحذيران. اكتمل الفحص، ومع ذلك يسجّل Check Runner النتيجة على أنها غير مجتازة. يجب أن يكون عدد الأخطاء وعدد التحذيرات صفرًا معًا.
يشغّل المنفّذ جميع الفحوص المتاحة في المحرّك الرسمي، بما فيها الفحوص التجريبية. ويتجاهل طلبات تقليص قائمة الفحوص أو فئاتها. يحدّد إصدار Plugin Check المثبّت الفحوص المتاحة.
تتضمن الملاحظات الملف والسطر والعمود والرسالة ورمز التشخيص عندما يوفّر Plugin Check هذه البيانات. استخدموها لتحديد موضع المشكلة وإصلاح الشفرة ثم فحص الإضافة المعدّلة مرة أخرى.
التحذير الأصفر سبب للتوقف أيضًا. لا يُجتاز الفحص إلا مع صفر أخطاء وصفر تحذيرات.
مرجع المهمة إيصال استلام، وليس موافقة
للتشغيل في الخلفية، اطلبوا async: true. يعيد Check Runner مرجعًا للمهمة بينما يجدول WordPress الفحص. أما الاستدعاء الافتراضي فيعمل بصورة متزامنة.
اقرؤوا المهمة نفسها باستخدام plugin-check/job-status. تعني pending أنها لم تبدأ، وتعني running أنها لم تنتهِ. وقد تتضمن المهمة بالحالة complete نتيجة مجتازة، أو ملاحظات تمنع الاجتياز، أو خطأ في التنفيذ.
يعتمد التشغيل في الخلفية على cron في WordPress والموارد التي يسمح بها الخادم لـ PHP. استلام مرجع لا يضمن بدء التنفيذ أو اكتماله. افحصوا سبب تعلّق المهمة أو انقطاعها قبل طلب مهمة أخرى.
يتتبع الإيصال مهمة واحدة. اقرأوا نتيجتها النهائية المحفوظة قبل تقييم الإضافة.
من النسخة المثبّتة إلى نتيجة يمكن الاستفادة منها
1. حدّدوا الإضافة بدقة
ثبّتوا النسخة المرشحة على موقع WordPress مناسب للاختبار، مع تفعيل Plugin Check الرسمي. أعطوا المساعد معرّف الإضافة المختصر أو اسم ملفها الأساسي، واختاروا وضع الإضافة الجديدة أو التحديث وفقًا لغرض المراجعة.
2. شغّلوا الفحص الكامل
اطلبوا الفحص الكامل، واختاروا التشغيل في الخلفية عند الحاجة. احتفظوا بمرجع المهمة واقرؤوا حالتها. نجاح الجدولة لا يعني اجتياز الفحص.
3. اقرأوا الأعداد والملاحظات معًا
تأكدوا أولًا من اكتمال التنفيذ، ثم اقرأوا حالة الاجتياز وعدد الأخطاء والتحذيرات. إذا كانت القائمة مختصرة، فلن تعرض جميع الملاحظات، حتى إن كانت الأعداد تشمل نتيجة الفحص كاملة.
4. أصلحوا وأعيدوا الفحص واختبروا الوظائف
أصلحوا المشكلات المُبلّغ عنها، ثم شغّلوا فحصًا كاملًا جديدًا للإضافة المعدّلة. اختبروا أيضًا وظائفها وتكاملاتها الفعلية. خلو نتيجة Plugin Check من المشكلات لا يثبت أن الإضافة تعمل بصورة صحيحة، ولا يضمن قبولها في WordPress.org.
للنتائج المعروضة حد أقصى
يعرض الرد افتراضيًا حتى 100 ملاحظة. ويمكن رفع الحد إلى 500 باستخدام max_results. تأتي الأخطاء قبل التحذيرات، لذلك قد تؤدي قائمة أخطاء طويلة إلى عدم ظهور تفاصيل التحذيرات في الرد.
لا توجد صفحات إضافية لاسترجاع بقية الملاحظات. إذا كانت قيمة truncated هي true، فاستخدموا واجهة Plugin Check الرسمية للاطلاع على مزيد من التفاصيل. لا تصفوا هذا الرد بأنه قائمة كاملة بالملاحظات.
إجراءان بصلاحيات مختلفة
يبدأ plugin-check/run الفحص ويتطلب صلاحية تفعيل الإضافات في WordPress. ويقرأ plugin-check/job-status مهمة محفوظة ويتطلب صلاحية إدارة خيارات الموقع.
استخدموا حسابًا مخوّلًا للإجراءين عند التعامل مع مهام الخلفية. لا يصلح Check Runner ملفات المصدر، ولا يثبّت النسخة المرشحة، ولا ينشر الإصدارات. ولا يتضمن هذا الإصدار إجراءً لإلغاء المهام أو حذفها.
جهّزوا اتصال WordPress
يعلن Check Runner أن الحد الأدنى هو WordPress 6.9 وPHP 8.0. ويتضمن WordPress 6.9 واجهة Abilities API. استخدموا إصدار PHP ما زال يتلقى الصيانة ويدعمه موقعكم.
يجب تثبيت إضافة Plugin Check الرسمية وتفعيلها. اربطوا عميل MCP موثّقًا عبر WordPress MCP Adapter، ثم تحققوا من ظهور الإجراءات المطلوبة عند اكتشاف الأدوات.
بحسب إعداد MCP، قد تحتاجون إلى طبقة تتيح الإجراءات للعميل، مثل MCP Expose Abilities، حتى يظهر إجراء تشغيل الفحص. تحققوا من الاتصال قبل بدء الفحص.
اعرفوا ما الذي يثبته الفحص التالي فعلًا
ثبّتوا Check Runner، وتأكدوا من توفر الإجراءين، ثم اطلبوا فحصًا كاملًا للنسخة المرشحة المثبّتة. اقرأوا النتيجة النهائية وحدودها قبل اتخاذ قرار الإصدار.