الاختبارات
افتح أدوات مساحة العمل → الاختبارات على الحاسوب أو الأدوات → الاختبارات على الهاتف، ثم اختر مشروعك. يقرأ قسم الاختبارات ملفات الاختبار في مشروعك كنص، ويعرض كل اختبار يعثر عليه: المجلدات والملفات وأسماء الاختبارات والكود المحيط بكل اختبار. لا تشغّل القراءة أي شيء ولا تستورده ولا تثبّته أبدًا؛ ولا تعمل اختباراتك إلا عندما تختار تشغيلها.
في أعلى الصفحة سطر حالة وبطاقتان. تعرض كلٌّ من اختبارات الوحدة واختبارات عدم التراجع عدد الاختبارات التي نجحت في آخر تشغيل، وما فشل أو كان غير مستقر، وعمليات التشغيل الأخيرة، وزر تشغيل. وتحتهما شريط علامات تبويب واحد يضم اختبارات الوحدة واختبارات عدم التراجع والتكامل وE2E والفحوصات (فحص الكود والأنواع والبناء والبرامج النصية للتحقق) والسجل.
قراءة سطر الحالة
يقدّم السطر الذي يعلو البطاقتين الجواب أولًا، استنادًا إلى أحدث نتائج اختباراتك:
- لم يُتحقق بعد ما دام لم يُشغَّل أي اختبار. شغّل اختباراتك مرة واحدة لمعرفة حالة مشروعك.
- عندما تفشل اختبارات، يعرض السطر عددها ويقترح عرض الإخفاقات: تُفتح الاختبارات الفاشلة مع عامل التصفية فشل، بدءًا باختبار عدم تراجع إذا عاد خلل سبق إصلاحه.
- عندما توجد اختبارات غير مستقرة (فشلت ثم نجحت عند إعادة المحاولة)، يعرض السطر عددها ويقترح عرض الاختبارات غير المستقرة.
- وفي غير ذلك، يعرض عدد الاختبارات الناجحة، وعدد ما لم يُشغَّل منها بعد، ووقت انتهاء آخر تشغيل.
يجمع العدد اختبارات الوحدة واختبارات التكامل والاختبارات من البداية إلى النهاية والفحوصات. أما اختبارات عدم التراجع فتعيد استخدام الاختبارات نفسها، لذلك لا تُحسب مرتين.
ويعرض السطر أيضًا، بجوار زر التشغيلات التلقائية، التشغيل التلقائي التالي مع موعده، أو التشغيلات التلقائية متوقفة. وإذا تعذّر بدء آخر تشغيل تلقائي، يوضّح السطر السبب.
عرض اختباراتك
تجمع كل علامة تبويب ملفات الاختبار حسب المجلد. افتح مجلدًا لرؤية ملفاته، ثم اختر ملفًا: تظهر اختباراته على اليسار (وعلى الهاتف في شاشة مستقلة)، مع عرض الاختبارات الفاشلة أولًا. يعرض الاختبار الفاشل القيمة المتوقعة والقيمة الفعلية كما أبلغ عنهما مشغّل الاختبارات، والكود الحالي المحيط بالسطر الفاشل. صفِّ النتائج حسب فشل أو غير مستقر أو لم يُشغّل بعد، أو ابحث باسم الملف أو المجلد.
يظهر الاختبار الذي لم يُشغَّل قط بحالة لم يُشغّل بعد. ولا تعرض حلقة النجاح 100% أبدًا ما دام هناك اختبار فاشل. ولكل حالة دائمًا أيقونة وكلمة، لا لون فقط.
يصنّف قسم الاختبارات الملفات تلقائيًا إلى اختبارات الوحدة، واختبارات التكامل والاختبارات من البداية
إلى النهاية (مجلدات مثل e2e أو integration أو routes أو api، وملفات Playwright، وسيناريوهات
الويب)، والفحوصات. وتشمل الفحوصات فحص الكود والأنواع والبناء والبرامج النصية للتحقق في مشروعك،
بما فيها البرامج التي تحمل لاحقة في اسمها مثل contrast:ui-check أو tabs:guard. إذا كان المجلد
في الفئة الخطأ، فافتح قائمة ⋯ الخاصة به واختر النقل إلى اختبارات الوحدة أو
النقل إلى التكامل وE2E.
تشغيل الاختبارات
اختر تشغيل اختبارات الوحدة أو تشغيل اختبارات التراجع أو زر التشغيل الخاص بمجلد أو ملف، أو تشغيل الملف في تفاصيله. لا تحتاج إلى إعداد أي شيء مسبقًا: يبني قسم الاختبارات الأمر من البرنامج النصي الذي يشغّل هذه الملفات بالفعل في مشروعك (مع الاحتفاظ بخياراته) أو من الأمر الافتراضي لمشغّل الاختبارات، ثم يحفظه ويبدأ تشغيله. يُفتح تقرير التشغيل ويعرض التقدّم وزر إيقاف. إغلاق التطبيق لا يوقف عملية التشغيل؛ إذ يحتفظ المثيل بالنتيجة.
أثناء تشغيل مجموعة من الاختبارات، يعرض سطر الحالة في الأعلى مدى تقدّمها، مع عرض التقدم الذي يعيد فتح التشغيل الجاري، وإيقاف الذي يوقف المجموعة كلها: لا تبدأ التشغيلات التي ما زالت تنتظر أبدًا. يمكنك مغادرة الاختبارات والعودة إليها؛ يبقى التقدّم معروضًا. يعرض تشغيل اختبارات الوحدة عبارة قيد التشغيل… حتى تنتهي المجموعة، فلا تبدأ نقرة ثانية الاختبارات نفسها مرتين أبدًا. عندما تنقص أداة اختبار على المثيل لديك، مثل pytest، تبقى اختباراتها وحدها دون تشغيل، وتعمل الاختبارات الأخرى رغم ذلك.
يبقى الأمر المحفوظ قابلًا للتعديل: يغيّر ⋯ → تعديل الأمر ملفه التنفيذي ووسائطه ومستواه ومتطلباته المسبقة وخدماته وبيانات الاختبار ومهلته.
اختيار عدد ملفات الاختبار التي تعمل في الوقت نفسه
يحدد ملفات الاختبار في الوقت نفسه، بجوار سطر الحالة، عدد ملفات اختبار المشروع التي تعمل في الوقت نفسه. ويحتفظ تلقائي، وهو الإعداد الافتراضي، بالإعداد الخاص بكل أداة اختبار. اختر رقمًا، حتى عدد معالجات المثيل لديك، فلا يشغّل كل تشغيل للمشروع، يدويًا كان أو تلقائيًا، أكثر من هذا العدد. تتبع هذا العدد أدوات الاختبار Node، Vitest، Jest، Playwright؛ وتحتفظ أدوات الاختبار الأخرى بإعدادها الخاص، وتجري تشغيلات المشروع عندئذٍ واحدًا بعد الآخر. ويحتفظ التشغيل الذي بدأ بالفعل بعدده.
تعمل الاختبارات دائمًا بأولوية معالج أقل من المثيل، فتبقى محادثاتك وتطبيقاتك سريعة الاستجابة أثناء تشغيلها. أنت وحدك من يغيّر هذا الإعداد: يمكن للمساعد المدمج قراءته أو تعديله بناءً على طلبك، ولا تغيّره محادثة في المشروع أبدًا.
تشغيل الاختبارات وفق جدول زمني
اختر التشغيلات التلقائية بجوار سطر الحالة لتشغيل اختبارات المشروع وفق جدول زمني خاص به. لكل مشروع جدول واحد:
- تشغيل الاختبارات تلقائيًا: يفعّل الجدول أو يوقفه.
- التكرار: كل ساعة، أو كل يوم، أو أيام العمل، أو كل أسبوع، أو كل شهر، أو تعبير cron مخصص. ويجب أن تفصل بين كل تشغيلين 15 دقيقة على الأقل.
- المنطقة الزمنية: المنطقة التي يتبعها الجدول. تُقترح أولًا المنطقة الزمنية التي تُعرض بها الأوقات لديك، وتغييرها لاحقًا لا يغيّر موعد جدول محفوظ.
- ما الذي يُشغَّل: نوع واحد على الأقل من اختبارات الوحدة واختبارات عدم التراجع والتكامل وE2E والفحوصات.
- أعلمني: مع فقط عندما يفشل شيء ما (الخيار الافتراضي) تمر عمليات التشغيل الناجحة بلا إشعار، بينما يصلك إشعار بأي تشغيل يفشل أو ينقطع أو يحتاج إلى مراجعة؛ ومع بعد كل تشغيل يصلك إشعار في كل مرة.
- التشغيلات الفائتة: إذا كان المثيل متوقفًا في موعد مقرر، فإن التشغيل مرة واحدة عند عودة المثيل للعمل (الخيار الافتراضي) يعوّض ذلك بتشغيل واحد مهما بلغ عدد المواعيد الفائتة، أما تخطي التشغيلات الفائتة فينتظر الموعد المقرر التالي.
التشغيل التلقائي تشغيل عادي: يحدّث البطاقتين وسطر الحالة، ويظهر في السجل مع تقريره. ولا يتداخل أبدًا مع التشغيل التلقائي السابق. وعند نقص الذاكرة أو أثناء التحديث، ينتظر ويعيد المحاولة لمدة تصل إلى ساعتين، ولا يُحتسب فشلًا أبدًا. وإذا تعذّر بدء تشغيل تلقائي، كأن يكون السابق لا يزال جاريًا، أو يحتاج المشروع إلى مراجعة، أو لا يوجد ما يُشغَّل، يوضّح سطر الحالة السبب، ويجري الموعد المقرر التالي كالمعتاد. ولا يوقف نوعُ اختبارات ليس فيه ما يُشغَّل الأنواعَ الأخرى. وبعد التحديث أو الاستعادة، تُستأنف التشغيلات التلقائية من تلقاء نفسها، ويخضع أي موعد فات في أثناء ذلك لاختيارك في التشغيلات الفائتة.
أنت وحدك من يضبط الجدول: يمكن للمساعد المدمج قراءته أو تعديله بناءً على طلبك، ويمكن لمحادثة في المشروع قراءته، لكنها لا تنشئه ولا تعدّله أبدًا.
إنشاء اختبار
اختر اختبار جديد في أعلى اليسار:
- كتابة اختبار باستخدام AI: صِف سلوكًا؛ يقترح الذكاء الاصطناعي الاختبار، وتراجعه أنت قبل حفظه. لا يُشغَّل أي شيء حتى تشغّله بنفسك.
- حماية خطأ تم إصلاحه: أنشئ اختبار عدم تراجع من الاختبارات التي تغطي هذا الخطأ.
- سيناريو ويب: خطوات يُنقر عليها ويُتحقق منها في المتصفح المدمج.
- إضافة أمر اختبار: برنامج نصي موجود في مشروعك، مثل
npm test.
تعديل اختبار
اختر ملفًا، ثم فتح في المحرر لتعديله بنفسك، أو التحرير باستخدام AI لفتح محادثة جديدة حول هذا الملف وهذا الاختبار (لا يُرسَل شيء قبل أن ترسله أنت). وعندما يفشل اختبار، يعيد الإصلاح باستخدام AI إنتاج الفشل ويصحّح الكود، ثم يعيد تشغيل الاختبار نفسه واختبارات عدم التراجع لديك. وفي اختبار عدم التراجع، يضيف تعديل الاختبارات الاختبارات التي تحميه أو يزيلها.
تشغيل اختبارات عدم التراجع
سمِّ المجموعة، وصِف السلوك أو الخلل الذي تحمي منه، ثم اختر مراجعات محفوظة ودقيقة للحزم أو الحالات أو السيناريوهات. يمكن لاختبارات الوحدة والتكامل وواجهات API والمسارات E2E أن تنتمي إلى المجموعة نفسها من دون تكرار المصادر. تبقى فحوص التنسيق والأنواع والبناء مستقلة.
احفظ المجموعة، ثم شغّل تلك المراجعة صراحةً. تحمل التحديدات الكاملة والجزئية تسميات منفصلة. تُنفّذ العناصر المتداخلة مرة واحدة؛ وتُرفض المراجعات المتعارضة والتحديدات الفارغة. لا تغيّر تعديلات المجموعة اللاحقة العضوية التي التقطتها عملية تشغيل سابقة.
تبقى المجموعات حالة خاصة بالمثيل، ولا تُصدَّر إلى Git. يمكن وضع ملفات اختبار المشروع الحالية ومصادر السيناريوهات المصدَّرة صراحةً تحت إدارة الإصدارات بالطريقة المعتادة.
الاختبارات المُصلحة تصبح اختبارات عدم تراجع
في كل مشروع، يُحمى الخلل بمجرد أن يثبت إصلاحه، من دون أن يحتاج أحد إلى الاحتفاظ بقائمة. فعندما ينجح اختبار كان يفشل، بعد أن تغيّر الكود، يحوّله قسم الاختبارات إلى اختبار عدم تراجع:
- يُعدّ الاختبار مُصلحًا عندما ينجح في كل محاولة من محاولات التشغيل، وتكون أحدث نتيجة له في التشغيلات الخمسة السابقة للمشروع فشلًا على كود مختلف. أما النجاح بعد إعادة المحاولة، أو على كود لم يتغيّر، فلا يُعدّ إصلاحًا.
- يصبح كل ملف مُصلح اختبار عدم تراجع واحدًا، يحمل اسم أول اختبار أُصلح فيه، ويشغّل ذلك الملف وحده بخيارات البرنامج النصي في مشروعك. ويسرد سلوكه المحمي الاختبارات التي أُصلحت.
- التشغيل الذي يُصلح أكثر من خمسة ملفات لا يحمي شيئًا: فهذا العدد من الإصلاحات دفعة واحدة يعني عادةً أن البيئة هي التي أُصلحت، لا أن أخطاء قد أُصلحت.
- يبقى الملف الذي يحميه اختبار عدم تراجع بالفعل على حاله.
لا يُشغَّل أي شيء عند إنشائه: يشمله التشغيل التالي لاختبارات عدم التراجع، سواء شغّلته بنفسك أو جرى تلقائيًا. عدّله أو احذفه كأي اختبار عدم تراجع آخر.
اختيار مرجع ومقارنة النتائج
اختر عملية تشغيل محفوظة لتكون مرجع المجموعة، ثم قارِن بها عملية تشغيل أخرى. المرجع هو خط أساس للمقارنة، وليس وضعًا ثالثًا لاختيار مصادر التنفيذ. لا يحلّ نجاحٌ محلّه تلقائيًا مطلقًا.
يتطلب المرجع شروط تحقق غير فارغة رُصدت بالكامل، وتوقعات معروفة، وبيانات معزولة، ومعلومات منشأ كاملة. يمكن لخط أساس فاشل أن يكشف الإخفاقات الموجودة مسبقًا؛ ولا تصلح الأدلة الجزئية أو المستوردة أو المتجاوزة أو غير المستقرة أو غير المكتملة للاعتماد مرجعًا.
تميّز المقارنة بين حالات التراجع الجديدة والإخفاقات الموجودة والإصلاحات والإضافات والإزالات والتجاوزات والحالات غير المنفَّذة وعدم الاستقرار. وتعرض التوقعات التي تغيّرت ومدى توافق الإعدادات والبيانات وبيئة التنفيذ والهدف. الغياب عن تحديد جزئي لا يعني الإزالة. قد تشمل أدلة المقارنة الكاملة إخفاقات؛ فاكتمالها لا يعني نجاح الاختبارات.
إضافة سيناريو ويب
حرّر سلوك السيناريو وهدفه وبياناته ومتطلباته المسبقة وخطواته وشروط تحققه وتنظيفه. استخدم محددات ثابتة تستند إلى الدور أو التسمية أو معرّف الاختبار أو النص. هذه ليست أداة لتسجيل النقرات.
مثلًا، احمِ استمرارية البيانات في تطبيق مهام بهذه الخطوات:
- افتح التطبيق باستخدام بيانات اختبار مخصصة.
- املأ حقل المهمة الجديدة بعنوان معروف، واختر إجراء الإضافة.
- تحقّق من ظهور المهمة، ثم علّمها كمكتملة.
- أعد تحميل الصفحة.
- تحقّق من أن المهمة نفسها لا تزال ظاهرة ومعلَّمة.
احفظ السيناريو قبل تشغيله. حفظ مصدر الاختبار إجراء صريح آخر: اختر مسار ملف نسبيًا إلى المشروع للاحتفاظ بمصدر الاختبار المُنشأ. يُرفض التصدير إن احتوى الملف الموجود على بايتات مختلفة. يؤدي تحرير ملف مُصدَّر إلى إبطال ربطه وحظر إعادة التشغيل. راجع مراجعة السيناريو وربطها بالمصدر؛ ولا تستبدل عملًا يجري بالتوازي. تبقى الأدلة السابقة أدلة تاريخية. لا يغيّر إعداد الاختبار إجراءَي «بدء» أو «إيقاف» المعتادَين للتطبيق أو تفعيله.
يستخدم المتصفح المدمج سياقات Chromium مؤقتة، ويحظر service workers. ولا يؤهّل سلوك offline/PWA أو Safari أو Firefox أو السلوك الأصلي لتطبيقات Android/iOS أو أداء جهاز حقيقي. قد تظل مطابقة الهدف الحالي للمصدر غير مؤكدة: عندها تظهر شروط التحقق الناجحة في المتصفح بالحالة ناجح مع ذكر هذه الحقيقة في التفاصيل، لكن عملية التشغيل لا تُعد تحققًا كاملًا ولا مرجعًا كاملًا صالحًا للاختيار. لقطة الشاشة دليل؛ أما التراجع المرئي فيتطلب شرط تحقق منفَّذًا وخط أساس مرئيًا يُدار صراحةً.
فحص الإخفاقات والاحتفاظ بالأدلة
يبدأ تقرير عملية التشغيل بإجابتها: ناجح أو فشل أو غير مستقر، أو جملة توضح سبب غياب الإجابة، مع اسم ما جرى تشغيله وعدد الاختبارات والمدة والتاريخ. تظهر الاختبارات الفاشلة أولًا، مع القيمتين المتوقعة والمستلمة عندما يوفّرهما المحرّك؛ ويفتح عرض السجل السجل، وتضم التفاصيل الملاحظات (الملفات التي تغيّرت أثناء التشغيل، والاختبارات التي استخدمت بيانات المشروع نفسه) والملفات المحفوظة وطريقة التشغيل والمقارنة مع عملية تشغيل أخرى. السجلات والقوائم محدودة ومقسّمة إلى صفحات؛ ويظل اقتطاع المحتوى ظاهرًا.
نجاح الأمر والحكم واكتمال التقرير ومعلومات المنشأ أمور منفصلة. الخروج برمز صفر من دون تقرير صالح يثبت نجاح الأمر فقط. لا تسمح الحالات الصفرية، أو التقارير أو المصادقة أو التبعيات المفقودة، أو التجاوزات والانقطاعات، بإثبات التحقق. يبقى الاختبار الذي يفشل في محاولة ثم ينجح في التالية بالحالة غير مستقر، وتُحفظ المحاولتان.
تبقى اللقطات وآثار التتبع والتقارير التي تحتفظ بها أداة الاختبارات بعد انتهاء جلسة المتصفح التي أنشأتها. تتطلب التنزيلات المصادقة في المثيل؛ ويُنزَّل HTML/SVG النشط كمرفق، ولا يُنفَّذ كتقرير. تُذكر الأدلة المفقودة أو التالفة صراحةً. يفتح المصدر ملف المشروع الحالي، من دون وعد بأن بايتاته لا تزال تطابق الاختبار التاريخي. لا تعيد التعديلات اللاحقة كتابة النتائج السابقة.
ينتظر إجراء إيقاف انتهاء العمليات التابعة المملوكة للتشغيل، ويحافظ على التطبيقات والمحادثات غير المرتبطة به. يظل رفض التنظيف ظاهرًا. إغلاق الشاشة أو فقدان الشبكة أو وضع العميل في الخلفية لا يوقف عملية التشغيل. افتح تقريرها الدقيق مجدّدًا بعد إعادة الاتصال. تسجّل إعادة تشغيل المثيل انقطاعًا إذا لم تثبت الاستمرارية، ولا تعيد تشغيل أمر تلقائيًا. يعيدك قسم «عمليات تشغيل» والإشعارات إلى نتيجة الاختبارات المحفوظة.
تحويل الخلل إلى سلوك محمي
حافظ على السلسلة: إعادة الإنتاج → حفظ اختبار أحمر → تصحيح الكود → التوقع نفسه ينجح بالأخضر → إعادة تشغيل مجموعة التراجع. تنشئ إعادات التشغيل سجلات مرتبطة. لا تؤدي تعديلات شروط التحقق أو حذفها أو إضعافها إلى حل العيب تلقائيًا.
يمكنك كتابة الاختبارات بنفسك، أو اختيار وصف سلوك للحصول على اقتراح قابل للتحرير لاختبار وحدة أو سيناريو. استخدم عناصر الاختيار الحالية «بيئة التشغيل» و«النموذج» و«جهد الاستدلال» والحساب. راجع شروط التحقق المحددة والملفات والبيانات والمتطلبات المسبقة؛ وأجب عن الأسئلة المتبقية قبل وضع علامة الجاهزية على المراجعة صراحةً وحفظها. تظل عمليات الإنشاء والحفظ والتشغيل منفصلة. عند حفظ اقتراح اختبار وحدة بعد مراجعته، يُكتب ملف اختباره في المشروع؛ أما حفظ سيناريو فيحفظ تعريفه، مع تصدير المصدر اختياريًا في إجراء منفصل آخر. لا يحمل الاقتراح حكمًا ناتجًا عن تنفيذ. قد تستلزم تغييرات المصدر مراجعة جديدة قبل الحفظ.
يربط إجراء الإصلاح باستخدام AI الإخفاق الدقيق بإعادة إنتاجه، وبمحادثة تصحيح ظاهرة، وبتحقق جديد. يبقى غياب إعادة الإنتاج وتغيّر التوقعات ونقص أدلة التراجع صريحًا. لا يحلّ تفسير النموذج محل شروط التحقق أبدًا. لا تحتاج الاختبارات المحلية إلى نموذج؛ ويستخدم الذكاء الاصطناعي الاختياري آليات المزوّد الحالية للاستخدام والتسعير والحصص. التكلفة المفقودة مجهولة، وليست صفرًا. راجع محاسبة الاستخدام. لا يُستدعى Ship ولا يجري أي نشر.
المحرّكات المؤهّلة والمتطلبات
اجتازت هذه الإصدارات الدقيقة تأهيل المصدر على Linux باستخدام Node 22.22.2/22.23.2. يجب أن تكون التبعيات موجودة؛ فلا تثبّتها أداة الاختبارات ولا ترقّيها. لا يُفهم من ذلك دعم نطاق من الإصدارات.
| المحرّك | الحالات وإعادة التشغيل المستهدفة | التغطية والحدود |
|---|---|---|
| Node test runner 22.22.2 / 22.23.2 | حالات منظَّمة وخطافات تنفيذ وskipped/todo؛ استخدام الملف التنفيذي الحالي لـNode مباشرةً. لا تتوفر إعادة تشغيل حالة دقيقة أو سجل لمحاولات الإعادة. | تغطية أصلية وصريحة للأسطر والفروع والدوال مع نطاقها المقاس؛ بحد أقصى 128 ملفًا/64 KiB من بيانات التغطية الوصفية. |
| Vitest 4.1.10 | نقطة دخول مباشرة؛ تحديد دقيق لحالة محفوظة بعد جمع خاضع للإشراف؛ تحتفظ المحاولات بإعادات التنفيذ. | لا توجد تغطية مؤهّلة أو ميزة لعكس نتيجة الفشل المتوقع. تُرفض أغلفة دورة الحياة والإعدادات التي لا تستطيع الاحتفاظ بإضافة الأدلة. |
| Jest 30.2.0 | اسم كامل فريد في ملف مثبَّت؛ حالة محددة واحدة لكل أمر، وعدد محدود من الأوامر لعدة حالات. | لا يُستورد قياس التغطية. تُرفض الأسماء الملتبسة والإعدادات المسبقة وإعدادات المشاريع المتعددة أو TypeScript والمشغّلات المخصصة. |
| pytest 8.4.2 / CPython 3.10.12 | استخدام Python الخاص ببيئة افتراضية مباشرةً مع -m pytest؛ هويات عقد دقيقة ومراحل setup/call/teardown. |
لا يشمل التأهيل التغطية أو الأغلفة أو التنفيذ الموزّع أو إضافات إعادة المحاولة. لا يُعالَج غياب pytest بصمت. |
| Playwright Test 1.63.0 | مشغّل المشروع المثبَّت؛ هويات المشروع والتكرار ومحاولات الإعادة والمرفقات. لا تتوفر إعادة تشغيل حالة دقيقة. | لا توجد تغطية أو ميزة لعكس نتيجة الفشل المتوقع. تختلف سياسة متصفح المشروع عن سياسة المتصفح المدمج. |
| أمر مخصص / JUnit | نتيجة الأمر بلا تفاصيل أو حالات يقدّمها فعلًا تقرير محدود. لا تتوفر إعادة تشغيل حالة دقيقة. | لا تُخمَّن التغطية أو العدّادات أو دلالات إعادة المحاولة؛ وتبقى لهجات XML غير المدعومة غير صالحة أو غير مكتملة. |
يجب أن يكتب أمر JUnit المخصص تقريره الحالي في مجلد التقارير الخاص
بعملية التشغيل باستخدام TEST_REPORT_PATH / TEST_REPORT_DIR أو رموز الوسائط الصريحة
{{TEST_REPORT_PATH}} / {{TEST_REPORT_DIR}}. لا يمكن لتقرير قديم من مساحة العمل
أن يثبت صحة تنفيذ جديد. يتوفر استيراد XML الخارجي عبر
الـAPI أو الإجراء tests.importJUnit، وليس عبر زر استيراد في الواجهة الحالية.
لا تثبت العدّادات المستوردة تنفيذًا محليًا أو معلومات منشأ حالية أو أهليةً كمرجع.
التنفيذ على Linux مؤهّل. يوجد مسار لملكية العمليات على Windows، لكن التنفيذ الأصلي على Windows لم يُؤهّل بعد. التنفيذ على مثيل macOS غير مدعوم حاليًا؛ ويمكن لعميل macOS التحكم في مثيل بعيد مدعوم. توفّر واجهة Android/iOS لا يعني اعتماد اختبار التطبيقات الأصلية. المصدر وحزمة الملفات الدقيقة والمرشح الخاص المثبَّت والعميل المقدَّم والإصدار العام وأدلة الأجهزة الفعلية مستويات منفصلة؛ فلا يثبت أحدها المستويات الأخرى.
أدوات المحادثة
تتيح محادثات المشروع العادية والمصرّح بها خمس أدوات MCP وأوامر CLI مطابقة:
aircode_tests_catalog / catalog وaircode_tests_describe / describe،
وaircode_tests_run / run وaircode_tests_status / status،
وaircode_tests_open / open. اقرأ المخطط قبل أي إجراء يغيّر البيانات:
aircode-tests catalog
aircode-tests describe --input '{"action":"tests.launchUnits"}'
aircode-tests run --input '{"action":"tests.units","input":{}}'
استخدم tests.launchUnits لحزم اختبارات الوحدة، أو tests.launchRegression لمجموعة
دقيقة، مع مراجع النطاق والمراجعة المثبَّتة التي أُعيدت والمفتاح الصريح في المخطط.
تحدّد قدرة التفويض الخاصة بالجلسة المشروع؛ فلا تضف حقل project.
يقبل --input - بيانات JSON محدودة عبر الإدخال القياسي. يقبل status
الهوية {scopeId,ownerKind,ownerId}؛ ويقبل open الهوية نفسها أو {} لفتح الاختبارات.
احتفظ بـopenPath المُعاد دون تغيير. في MCP، استخدم الوسائط نفسها
مع أداة aircode_tests_* المطابقة. راجع توثيق الذكاء الاصطناعي.
لا تقبل عمليات التشغيل من المحادثة إلا وصفات التنفيذ والخدمات التي تعرّفت إليها عملية الاكتشاف. استخدم برنامجًا نصيًا معروفًا للمشروع، أو شغّل أمرًا مخصصًا من واجهة المالك.
بعد فقدان رد، افحص الحالة، وأعد استخدام المفتاح والمدخلات نفسيهما لمحاولة مطابقة وصريحة. قراءة الحالة لا تعيد إطلاق العمل مطلقًا. لا يمكن لجلسات التخطيط أو الجلسات المخصصة للقراءة فقط أن تكتب؛ وتتطلب الأدوات المنتهية أو المسحوبة استئنافًا عاديًا للمحادثة. لا تمنح هذه الأدوات وصولًا عامًا إلى سطر الأوامر، ولا تسمح بنقل علني للأدلة. لا تحرّر مخزنًا ولا تصطنع بيانات اعتماد لتجاوز رفض.
التخزين والرفض مع إجراء واضح
توجد التعريفات والمراجع وحقائق التنفيذ غير القابلة للتغيير في نطاق الاختبارات الخاص داخل SQLite في المثيل. السجلات واللقطات وآثار التتبع الكبيرة ملفات خاصة مرافقة. لا تحتوي النسخ الاحتياطية لقاعدة البيانات وحدها على تلك البايتات: احتفظ بالملفات المرافقة مع نسخة احتياطية متسقة للمثيل. لا تنسخ قاعدة WAL حيّة باعتبارها نسخة احتياطية. تُحفظ الأدلة الفريدة أو الأساسية افتراضيًا؛ ولا يمكن حذف مرفق منتهٍ صراحةً إلا إذا ثَبُت أنه نسخة زائدة. لا يوجد حذف شامل للأدلة الفريدة. تُنقَّح الأسرار المعروفة أو يُرفض المحتوى؛ ولا تستطيع المرشحات التعرف إلى كل سر داخل السجلات أو الصور أو الأرشيفات أو بيانات المشروع الاعتباطية.
| الرفض أو الحالة التي تتطلب الانتباه | الإجراء التالي |
|---|---|
| لا توجد حزم وحدة / المجموعة فارغة | صنّف الحزم واحفظها، أو أضف أعضاء محددين بدقة إلى المجموعة. |
| محرّك مفقود أو غير مدعوم | راجع الملف التنفيذي والتبعية المثبَّتة والإصدار المؤهّل؛ واستخدم أمرًا مخصصًا يبيّن حدوده بصدق إن كان مناسبًا. |
| بيانات غير معزولة / مصدر غير مؤكد | يعرض التقرير ناجح مع ذكر هذه الحقيقة في التفاصيل؛ جهّز بيانات اختبار مخصصة قبل أن تصبح عملية تشغيل كهذه مرجعًا. |
| إعادة التشغيل المستهدفة غير متاحة | أعد تشغيل التحديد الكامل أو افحص تقريره المحفوظ. |
| تغيّر المصدر / المرجع غير مكتمل | راجع المصادر والتوقعات والتوافق الحالية، ثم اختر صراحةً تحديدًا جديدًا مناسبًا أو خط أساس جديدًا. |
| تأجيل بسبب الطابور أو الذاكرة أو القرص أو الحصة | عالج قيد الموارد المذكور، واطلب صراحةً تشغيلًا آخر أو استئنافًا. لا يُختلَق وقت لإعادة الضبط أو محاولة جديدة. |
| رُفض التنظيف / الأدلة مفقودة | افحص السبب والأدلة المحفوظة؛ واستخدم استعادة الأدلة المتاحة من دون إعادة تشغيل الاختبارات أو حذف الحالة الخاصة يدويًا. |