عن المشروع

Divebell هي مجموعة أدوات قابلة للتوسيع مصممة لوكلاء البرمجة لتصحيح وفهم والتحقق من تطبيقات الويب الحقيقية. يجعل صفحة الويب نقطة الدخول الأساسية للوكيل، ويزوّد سياق الصفحة بقدرات المتصفح وأدوات التطوير والتصحيح الحالية للفريق. هذا يسمح للوكلاء بإعادة إنتاج المشكلات وتشخيصها والتحقق منها مباشرة ضمن سيناريوهات ويب حية. يمكن للوكلاء استدعاء مجموعات SDK الحالية وواجهات OpenAPI وCLI وقدرات التشخيص دون الحاجة إلى استخراج يدوي لمعلومات الصفحة أو ربط الأدوات. يُحضّر Divebell سياق متصفح قابلاً لإعادة الاستخدام ويكشف عمليات الصفحة وتشخيصات المتصفح والتحقق من النتائج كقدرات قابلة للاستدعاء مباشرة. يمكن للفرق توسيع وظيفته باستخدام الملحقات لدمج حساباتهم وبيئاتهم والمنصات الداخلية وسير عمل التشخيص والتحقق المخصص. تتضمن المجموعة أداة CLI للإعداد التفاعلي السريع، موضّحة بأمثلة مثل استكشاف أدوات WebMCP أو تصور توقيت موارد Module Federation. يعالج Divebell التحدي المتمثل في أنه بينما يمكن لوكلاء البرمجة قراءة التعديل على الشيفرة المصدرية، فإن مشكلات تطوير الويب الحقيقية غالباً ما تحدث داخل الصفحة نفسها، مما يتطلب معلومات مشتتة من إجراءات المستخدم وحالة وقت التشغيل وتشخيصات المتصفح والأدوات الموجودة. ومن خلال تركيز ذلك، يمكّن Divebell الوكلاء من التصرف بشكل أكثر استقلالاً. تشمل قدراته الأساسية: 1. **سياق الويب والتشخيص**: يوفّر سياق الصفحة والعمليات (مثل `click` و`fill` و`eval`) وتشخيصات المتصفح (Console وNetwork وScreenshot وCoverage) وأدوات WebMCP المعلنة من قبل الصفحة. يمكّن دعم Chrome التجريبي لـ WebMCP افتراضياً للإصدارات المحلية ويُدير مصادقة المتصفح وحالته باستخدام ملف تعريف Chrome الخاص بمستخدم النظام التشغيلي أو Restore State المحدد للمشروع. 2. **الملحقات**: آلية لربط صفحات الويب بالقدرات التطويرية الموجودة. يمكن للملحقات تحديد التطبيقات والبيئات واستدعاء مجموعات SDK وواجهات OpenAPI وCLI وكشف سير عمل التشخيص والتحقق. تشمل الملحقات الرسمية أدوات لتحليل الذاكرة وتحليل استخدام الشيفرة وتسجيل سير عمل المتصفح وفحص Module Federation واكتشاف Rspack HMR/React Refresh. 3. **SDK زمن التشغيل**: واجهة برمجية اختيارية على جانب الصفحة تتيح للتطبيقات كشف حقائق داخلية مفصّلة للوكيل عندما تكون معلومات المتصفح القياسية غير كافية. تدعم تسجيل الأهداف وتحديث اللقطات وتسجيل الأحداث وإعلان الإجراءات وتشغيل دوال `waitFor`. يعتمد Divebell على `agent-browser` كطبقة تنفيذ المتصفح الافتراضية ومرخّص بموجب ترخيص MIT.