Forkybot AI: Bytebot محسّن ومؤمّن

هذا فرع (fork) محسّن ومؤمّن من Bytebot، وهو وكيل ذكاء اصطناعي مفتوح المصدر يتحكم في سطح مكتب افتراضي لأتمتة المهام المعقدة.

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

🎯 ماذا يفعل هذا المشروع؟

تخيّل موظفًا افتراضيًا يمتلك حاسوبه الخاص. يمكنك إعطاؤه تعليمات بلغة طبيعية مثل "نزّل فواتير هذا الشهر من بوابات الموردين الثلاث الخاصة بي ونظّمها في مجلد"، وسيقوم الوكيل بفتح المتصفح والتنقل عبر البوابات وتنزيل الملفات وتنظيمها. كل ذلك بشكل مستقل، مع إمكانية تولّيك التحكم في أي لحظة (Human-in-the-loop).

✨ التحسينات الرئيسية (مراحل الهندسة)

هذا الفرع ليس مجرد نسخة. أُجريت ثلاث مراحل هندسية للارتقاء به إلى المستوى التالي:

المرحلة أ: الأمان (ترقيع CVE-2026-78250)

• التخفيف من الحلقة اللانهائية: طُبّقت حدود أمان قابلة للتهيئة (MAX_TASK_ITERATIONS وTASK_TIMEOUT_MS) لمنع حجب الخدمة (DoS) والنفقات غير المنضبطة على واجهات API.
• Human-in-the-loop: إذا تجاوزت مهمة ما الحدود، فإنها لا تفشل. بل تنتقل إلى NEEDS_HELP ليتدخل إنسان ويستأنفها.

المرحلة ب: التحسين (تقليص الحجم بنسبة 85%)

• الانتقال إلى Debian Bookworm-slim: يحافظ على التوافق الكامل مع glibc وVS Code و1Password، لكنه يزيل البرمجيات وأدوات البناء غير الضرورية.
• بناء متعدد المراحل (Multi-Stage Build): تقلّص الصورة النهائية حجمها من ~7 GB إلى ~1.09 GB، مما يحسّن الكفاءة ويقلّل سطح الهجوم.
• تنظيف عميق: أُزيلت Thunderbird وxfce4-goodies والمحررات الزائدة.

المرحلة ج: التحقق من التكامل (Smoke Test)

• تم التحقق من التشغيل المتزامن لسطح المكتب والوكيل وواجهة المستخدم وقاعدة البيانات.
• تم فحص الاتصال الداخلي (VNC على المنفذ 9990) والخارجي (واجهة المستخدم على المنفذ 9992).

📚 توثيق حيّ (Obsidian)

من أكبر إسهامات هذا الفرع دماغ المشروع، وهو خزنة Obsidian (vault/) تعمل كسياق يتيح للذكاء الاصطناعي (وللبشر) التنقل عبر البنية دون ضياع. وتشمل:

• ADRs (سجلات القرارات المعمارية) التي تشرح سبب كل تغيير.
• خرائط الملفات المفصّلة للوكيل وواجهة المستخدم وسطح المكتب الافتراضي.
• بروتوكولات العمل (PROTOCOLO_TRABAJO.md وPROTOCOLO_OBSIDIAN.md) التي تحدد كيفية عمل وكيل الذكاء الاصطناعي في هذا المشروع.

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

• الوكيل: NestJS (Node.js 20 Alpine)
• سطح المكتب الافتراضي: Debian Bookworm-slim، XFCE، Xvfb، TigerVNC
• الواجهة الأمامية: Next.js 15، Tailwind CSS، noVNC
• قاعدة البيانات: PostgreSQL 16
• البنية التحتية: Docker، Docker Compose، عمليات بناء متعددة المراحل

🚀 كيفية البدء

# Clonar el repositorio
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# Configurar las variables de entorno (ej. Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# Levantar el stack
docker-compose -f docker/docker-compose.yml up -d

# Acceder a la interfaz
# Abre http://localhost:9992 en tu navegador