عن المشروع

Egg Shen Bot هو بوت ديسكورد غني بالميزات وقابل للاستضافة الذاتية، يركّز على اكتشاف الترفيه وأنشطة المجتمع. يبحث عبر سبعة أنواع من الوسائط — الأفلام والمسلسلات والحلقات وألعاب الفيديو وألعاب الطاولة والكتب — ويعيد تضمينات غنية تتضمن ملخصات وتقييمات مجمّعة من مصادر متعددة، وروابط لصفحة كل خدمة خاصة بالوسائط. تشمل مصادر التقييمات والروابط المذكورة IMDb وLetterboxd وTrakt وRotten Tomatoes وJustWatch، مع التعامل مع توفّر البث عبر تكامل TMDB وWatchmode. إلى جانب البحث، يوفّر البوت نظام أقواس بطولات يدعم مراحل مجموعات من 4 إلى 12 مجموعة، وبطاقات wildcards وجولات خروج المغلوب من نوع single-elimination. تشمل أدوات جلسات المشاهدة مؤقتات وتتبّع سجل المشاهدة وإحصاءات السيرفر، إضافة إلى أمر announce. تشمل الميزات الاجتماعية استطلاعات تفاعلية والبحث عن الموسيقى التصويرية وأمر "magic potion" وتوليد الصور بالذكاء الاصطناعي بشكل اختياري. تتيح ميزة Event Requests الاختيارية لأعضاء المجتمع إرسال طلبات جلسات مشاهدة عبر نموذج ويب باستخدام Discord OAuth؛ يوافق المشرفون عليها أو يرفضونها، وتُنشأ الأحداث الموافق عليها كـ Discord Scheduled Events. تغطي إدارة السيرفر أذونات قابلة للتهيئة، وتشغيل/إيقاف خدمات التقييم، وتفضيلات المنطقة، والإيموجي المخصص عبر أمر configuration، إلى جانب أوامر إشراف لإعادة التشغيل والإحصاءات. يوثّق المشروع تحديد المعدل المدمج كحماية للتكلفة، والإشعارات/التذكيرات، وإحصاءات الاستخدام. النشر يتم بالاستضافة الذاتية: كل نسخة مستقلة، وتستخدم تطبيق Discord خاصًا بها وسيرفرها الخاص وملفات بيانات محلية خاصة بها للإعدادات والمؤقتات والبطولات، دون خادم خلفي مشترك أو حساب مركزي. المتطلبات هي Node.js 20 أو أعلى، ورمز بوت Discord، ومفتاح TMDB API، مع مفاتيح اختيارية لـ Watchmode وOMDb وTrakt وRAWG وGoogle Books وOpenAI. تتضمن عملية الإعداد استنساخ المستودع، وتثبيت الاعتماديات، وتهيئة ملف .env، ونشر أوامر slash، وتشغيل البوت. الكود منظّم للتوسعة ضمن src/commands وsrc/services وsrc/utils وpublic (نموذج ويب لطلبات الأحداث) وdocs (توثيق VitePress)، وهو منشور تحت رخصة MIT.