عن المشروع

Alek-Core هو نظام شخصي لإدارة المعرفة يوسّع الذاكرة والاستدلال عبر Slack وTelegram. يوصف بأنه مشروع فردي قيد الاستخدام اليومي، ومنشور على GCP (Cloud Run + Firestore). الدورة الأساسية: تُصنَّف رسالة المستخدم بواسطة الموجّه Router حسب التعقيد والنبرة والعدسة الدلالية ونية البحث، ثم تُثرى بنتائج الذاكرة/الويب، ويجيب عنها الوكيل Smart بطبقة نموذج مناسبة للتعقيد، وبعد ذلك يستخرج وكيل توحيد خلفي حقائق جديدة حتى تعرفها المحادثات المستقبلية مسبقًا. البنية: سداسية (Ports & Adapters). لا توجد تبعيات بنية تحتية في منطق المجال ومنطق الأعمال؛ تمر جميع عمليات الإدخال/الإخراج عبر نحو 58 واجهة ABC (منافذ) مع محوّلات ملموسة تُحقن عند الإقلاع عبر ServiceContainer. تغطي المحوّلات Firestore وGemini وClaude وGrok وOpenAI وSlack وTelegram وGmail وMicrosoft To Do. الوكلاء مستقلون عن المزوّد مع إعدادات افتراضية لكل وكيل وتجاوزات لكل مستخدم؛ تُحدَّد طبقة النموذج (ECO/BALANCED/PERFORMANCE) من إعدادات المستخدم وقت التشغيل. شبكة الوكلاء: يجري الموجّه Router فرزًا بالاعتماد على LLM لكل طلب ويوجّه دائمًا إلى Smart، الذي تختار درجة تعقيده طبقة النموذج. يُستدعى المتخصصون عبر أداة واحدة هي delegate_to_specialist. يشمل الوكلاء المدرجون Router وSmart وQuick (احتياطي/منسّق) وMemory وWebSearch وEmailSearch وEmailClassification وFileManagement وTasks وNotes وMapsSearch وCompute وHelp وDocPlanner وDocGenerator وPdfGenerator وHtmlPageGenerator وDeepResearch وDomainResearcher وConsolidation. تتطلب إضافة متخصص إدخالًا في السجل داخل agent_manifest.py. الآليات الرئيسية: توحيد الذاكرة مع تجاوز النافذة المنزلقة إلى Cloud Tasks، وإزالة التكرار الدلالي (عتبة 0.96)، و3 متجهات لكل حقيقة، وإصدارات SCD2، ومسح ساعي للدفعات المتوقفة؛ بحث متعدد المتجهات مع Reciprocal Rank Fusion عبر 6 استعلامات متوازية؛ نظام prompt token/blueprint مدعوم بـFirestore بمستويات أولوية وحد فاصل للذاكرة المؤقتة يفصل البادئة الثابتة عن اللاحقة الديناميكية؛ ثلاث طبقات إعادة محاولة غير متداخلة (داخل العملية، Cloud Tasks، التطبيق)؛ فهرسة Gmail عبر OAuth بمخطط بريد إلكتروني رباعي المتجهات؛ تقرير مراجعة بريد يومي اختياري؛ تذكيرات ذاتية استباقية يطلقها Cloud Scheduler كل 15 دقيقة؛ وخادم MCP بعيد تجريبي يعرض get_user_context لموصلات claude.ai المخصصة مع خادم OAuth 2.1 داخل العملية. يفصل دعم تعدد اللغات لغة الاستجابة عن لغة الواجهة (uk, en, fr, es). الاختبار وCI: تُفرض قواعد البنية كاختبارات، بما في ذلك أكثر من 30 قاعدة عزل طبقات مبنية على AST، وقاعدة منع الطباعة، وفحوصات المنافذ المجردة. تتحقق اختبارات العقود من أشكال الحمولات المرسلة إلى SDK الخاصة بالمزوّد بدلًا من النص المولَّد. يحافظ محاكاة LLMPort على جعل اختبارات تعدد الأدوار واستدعاء الأدوات حتمية. يعمل make check (ruff + نحو 4200 اختبار) عند كل push وPR عبر GitHub Actions؛ والنشر يدوي باختيار المطوّر. صُمم المستودع صراحة للتطوير بمساعدة الذكاء الاصطناعي، مع ملفات سياق CLAUDE.md متعددة الطبقات، وسجلات قرارات وRFCs، ومطالبات مخزنة كبيانات مُنسَّخة بدلًا من كود مضمّن. الحزمة التقنية: Python 3.11 على Cloud Run مع asyncio في كل مكان؛ Firestore وCloud Tasks وCloud Scheduler؛ واجهتا Slack وTelegram؛ تكاملات Gmail وMicrosoft To Do وUnsplash وGoogle Maps؛ تتبع Logfire بالإضافة إلى مخزن محتوى LLM في BigQuery مع TTL لمدة 30 يومًا؛ pytest وpytest-asyncio. لا يوجد وضع محلي — تتطلب عدة قدرات البيئة السحابية. تتبع التوثيق قالب arc42. المستودع مشترك للتقييم فقط بموجب ترخيص يحتفظ بجميع الحقوق.