تهيئة إضافات المشروع وضوابط الموافقة

إضافات Nibleaf إمكانات منتج مرتبطة بالمشروع، وليست اتصالات بمزوّدين خارجيين. افتح إعدادات المشروع ← الإضافات لفحص الإتاحة وحفظ الإعداد وتفعيل الإمكانية أو تعطيلها ومراجعة سجل تدقيق محدود. يستمد الخادم المشروع والمؤسسة من الجلسة المصادَق عليها أو مفتاح API المرتبط بالمشروع عند كل إجراء.

فهم دليل الإضافات

تعني حالة available أن التنفيذ قابل للاستخدام عندما يسمح استحقاق المشروع. وتحدد preview سلوكًا لا يزال قيد التقييم. يجب أن يبقى الاستحقاق غير المتاح أو المجهول غير متاح في الواجهة؛ فهو لا يساوي حدًا مقداره صفر أو اختيارًا معطّلًا.

تهيئة إجراءات القرّاء بأمان

يمكن وضع الملاحظات بعد محتوى الصفحة أو بعد روابط السابق والتالي، في صف مضغوط أو بطاقة. لا يسجل الإجراء إلا هدف الصفحة واختيار مفيدة/غير مفيدة عبر حد التحليلات القائم. ولا يجمع تعليقًا أو طلبًا أو عبارة بحث أو نصًا حرًا من القارئ.

تبقى روابط التعديل والبلاغات غير نشطة حتى ينجح التحقق من قوالب عناوينها. استخدم {path} أو {encodedPath} لروابط التعديل، ويمكن لروابط البلاغات أيضًا استخدام {url}. يجب أن تستخدم القوالب HTTP(S)، وألا تتضمن بيانات اعتماد، وأن تبقى ضمن حد الطول، وأن تخلو من عناصر نائبة مجهولة. افتح صفحة متداخلة ممثلة في المعاينة وتحقق من العنوان الخارجي النهائي قبل النشر.

الحفاظ على حدود الموافقة

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

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

تشغيل فحوص النشر

تعمل فحوص CI داخل عامل النشر القائم ولا تستدعي خدمة تدقيق مستضافة. يراعي فحص الروابط اللغة والفرع. والمدقق اللغوي محدود عمدًا ويحمل حالة المعاينة؛ تعامل مع نتائجه بوصفها مساعدة للمراجعة لا ادعاءً عامًا بجودة الكتابة.

أبقِ المظلة مفعلة في الإنتاج ما لم تتطلب حادثة تجاوزًا مؤقتًا. إذا سُمح عمدًا بنشر يحتوي نتائج لغوية فقط، فسجل القرار وصحح النص لاحقًا. لا تتجاوز فشل رابط معطل؛ أصلح الهدف أو أزل الرابط القديم.

احترام التفويض والمراجعات وسجل التدقيق

تحتاج مفاتيح API إلى النطاق الدقيق addons:read أو addons:write، ويجب أن ترتبط بالمشروع نفسه. لا يمنح نطاق حرف البدل القديم وصولًا إلى الإضافات. تستخدم كل عملية تغيير المراجعة المتوقعة، لذلك يفشل الحفظ المتزامن بالرمز addon:revision_conflict بدل الكتابة بصمت فوق قرار أحدث.

يتحقق التفعيل أيضًا من اكتمال الإعداد وحالة الاستحقاق. يمكن للعملاء التعامل مع addon:not_found وaddon:unavailable وaddon:configuration_required وaddon:revision_conflict من دون كشف خطأ داخلي في قاعدة البيانات أو السياسة. تحتوي سجلات التدقيق الفاعل والإجراء وحالة التفعيل قبل التغيير وبعده وإعدادًا منقحًا والمراجعة الناتجة.

يمكن لـMCP سرد الإضافات وقراءة إضافة واحدة وفحص سجل التدقيق بالنطاق addons:read. ولا يمكنه تهيئة إضافة أو تفعيلها أو تعطيلها. راجع ربط عملاء MCP بأمان للاطلاع على حدود القراءة فقط كاملة.

الترحيل والتراجع

ينشئ ترحيل الإضافات صفوفًا دائمة وأحداث تدقيق أولية للمشاريع القائمة. يحافظ على حالة الموافقة القديمة المعروفة، بينما يعيد الحالة غير الصالحة إلى الإعداد الافتراضي الحافظ للخصوصية. تصبح صفوف الإضافات الدائمة المصدر المرجعي، ويظل إعداد المشروع المنشور إسقاط توافق للقرّاء والعمال.

للتراجع عن التطبيق، انشر أولًا شيفرة لا تكتب في جداول الإضافات الدائمة ولا تتوقعها. احفظ أدلة التدقيق المطلوبة وأوقف عمليات تغيير الإضافات، ثم اتبع الترتيب العكسي في دليل ترحيل الإصدار المجمع. يحذف ملف rollback.sql المراجع حالة الإضافات وسجل التدقيق، ولذلك يُعد تراجعًا هدّامًا للمخطط لا مجرد مفتاح تعطيل للإمكانية.