بدء سريع

المتطلبات الأساسية

• Chrome 124+ (مطلوب لـ WebGPU في service workers)
• Node.js 18+ و npm
• GPU مع دعم WebGPU (معظم وحدات معالجة الرسومات الحديثة تعمل)

التثبيت

1. استنساخ المستودع وتثبيت التبعيات:

   root@kitploit:~

   cd local-browser
   npm install
   

2. بناء الإضافة:

   root@kitploit:~

   npm run build
   

3. التحميل في Chrome:

   • افتح chrome://extensions
   • فعّل "Developer mode" (أعلى اليمين)
   • انقر "Load unpacked"
   • اختر مجلد dist من هذا المشروع

4. التشغيل الأول:

   • انقر على أيقونة الإضافة في شريط الأدوات
   • في التشغيل الأول سيتم تنزيل نموذج الذكاء الاصطناعي (~1 جيجابايت)
   • سيتم تخزينه مؤقتاً للاستخدام المستقبلي

الاستخدام

1. انتقل إلى أي صفحة ويب
2. انقر على أيقونة إضافة Local Browser
3. اكتب مهمة مثل:
   • "ابحث عن 'WebGPU' على ويكيبيديا واستخرج الفقرة الأولى"
   • "اذهب إلى example.com وأخبرني بما يوجد هناك"
   • "اعثر على مربع البحث وابحث عن 'أخبار الذكاء الاصطناعي'"
4. شاهد الذكاء الاصطناعي ينفذ المهمة خطوة بخطوة

التطوير

وضع التطوير

هذا يراقب التغييرات ويعيد البناء تلقائياً.

هيكل المشروع

كيف يعمل

1. يدخل المستخدم مهمة في واجهة النافذة المنبثقة
2. الوكيل المخطط (Planner Agent) يحلل المهمة وينشئ استراتيجية عالية المستوى
3. الوكيل الملاح (Navigator Agent) يفحص DOM الحالي للصفحة ويقرر الإجراء التالي
4. نص المحتوى ينفذ الإجراء (نقر، كتابة، استخراج، إلخ)
5. تستمر الحلقة حتى تكتمل المهمة أو تفشل

نظام الوكلاء

تستخدم الإضافة بنية وكيلين مستوحاة من Nanobrowser:

• PlannerAgent: تخطيط استراتيجي، ينشئ نهجاً خطوة بخطوة
• NavigatorAgent: تنفيذ تكتيكي، يختار إجراءات محددة بناءً على حالة الصفحة

كلا الوكيلين ينتجان JSON منظم يتم تحليله وتنفيذه.

إعدادات النموذج

النموذج الافتراضي: Qwen2.5-1.5B-Instruct-q4f16_1-MLC (~1 جيجابايت)

نماذج بديلة (مكونة في src/shared/constants.ts):

• Phi-3.5-mini-instruct-q4f16_1-MLC (~2 جيجابايت، استدلال أفضل)
• Llama-3.2-1B-Instruct-q4f16_1-MLC (~0.7 جيجابايت، أصغر)

استكشاف الأخطاء وإصلاحها

WebGPU غير مدعوم

• قم بتحديث Chrome إلى الإصدار 124 أو أحدث
• تحقق من chrome://gpu للتأكد من حالة WebGPU
• بعض وحدات معالجة الرسومات قد لا تدعم WebGPU

فشل تحميل النموذج

• تأكد من وجود مساحة كافية على القرص (~2 جيجابايت فارغة)
• تحقق من وحدة تحكم المتصفح بحثاً عن أخطاء
• حاول مسح تخزين الإضافة وإعادة التحميل

الإجراءات لا تنفذ

• بعض الصفحات تمنع نصوص المحتوى (chrome://، صفحات الإضافات)
• جرب على صفحة ويب عادية مثل wikipedia.org

الإضافة لا تعمل بعد تحديث Chrome

• اذهب إلى chrome://extensions
• انقر على زر إعادة التحميل للإضافة

القيود

• نطاق إثبات المفهوم: هذا برهان مفهوم، وليس برنامجاً إنتاجياً
• لا رؤية بصرية: يستخدم تحليل DOM نصي فقط (لا فهم للقطات الشاشة)
• علامة تبويب واحدة: يعمل فقط مع علامة التبويب النشطة حالياً
• إجراءات أساسية: يدعم التنقل، النقر، الكتابة، الاستخراج، التمرير، الانتظار
• حجم النموذج: النماذج الأصغر قد تواجه صعوبة في المهام المعقدة

التقنيات المستخدمة

• WebLLM: استدلال نموذج اللغة الكبير على الجهاز باستخدام WebGPU
• React: واجهة المستخدم المنبثقة
• TypeScript: تطوير آمن من حيث الأنواع
• Vite + CRXJS: تجميع إضافات كروم
• Chrome Extension Manifest V3: بنية إضافات حديثة

الإسناد

هذا المشروع مستوحى من:

• Nanobrowser - أتمتة ويب متعددة الوكلاء (رخصة MIT)
• WebLLM - استدلال نموذج اللغة الكبير في المتصفح (رخصة Apache-2.0)

تراخيص التبعيات

الترخيص

MIT License - انظر ملف LICENSE للتفاصيل.