لنجهّز بوتك، خطوة بخطوة.
دليل إعداد ونشر Iraq Bot Studio لمشرفي المجتمعات، دون برمجة الواجهة.
أنشئ تطبيق Discord
من Discord Developer Portal افتح Applications ثم New Application. في OAuth2 أضف عنوان العودة: رابط تطبيقك المنشور نفسه دون أي جزء يبدأ بـ #؛ تُكتشف العودة تلقائيًا. لا تستخدم رابط معاينة المحرر.
الأسرار والاستضافة المطلوبة
| المكوّن | المتطلب | حدود الاستخدام |
|---|---|---|
| لوحة التحكم | استضافة الواجهة والوظائف المرفقة | التخزين المدمج: 600 قراءة و180 كتابة/دقيقة، 100 KB للقيمة |
| عامل Discord | Node 24، اتصال دائم، وحدة تخزين، FFmpeg | لا يعمل كوظيفة قصيرة؛ قد يتطلب استضافة مدفوعة |
| الذكاء الاصطناعي | OPENAI_API_KEY ونموذج متاح | الفوترة والتوفر لدى المزوّد |
| الأفلام والمسلسلات | TMDB_API_KEY | شروط TMDB وJustWatch، توفر بحسب البلد |
| تحميل وصوت مرخّص | DOWNLOAD_ALLOWED_HOSTS، AUDIO_ALLOWED_HOSTS | لا مواقع محظورة أو تجاوز قيود |
تفاصيل النشر والأمان
يحتوي المشروع على DEPLOYMENT.md ودليل تشغيل العامل وملف إعداد الحاوية واختبارات للتشفير والروابط. لا تحتاج كتابة الكود، لكن تسجيل تطبيق Discord وإضافة أسرارك وتوصيل خدمة استضافة خطوات يجب أن تنفّذها بصفتك مالك الحساب. الأسرار لا تُضمّن في المستودع.
تشغيل نسخة واحدة من العامل لكل بوت وسيرفر يمنع معالجة الطلب مرتين. القناة الخاصة تنقل أوامر مشفّرة، والسجل محفوظ على وحدة التخزين. النسخ الاحتياطي في الواجهة لا يتضمن الأرشيف؛ انسخ مجلد data المشفّر من خدمة الاستضافة.
أسئلة الإعداد
هل الاستضافة مجانية مدى الحياة؟
لا. نوفّر ملفات النشر ولا نضمن خطة مجانية أو تشغيلًا دائمًا. راجع حدود وتكلفة مزوّد الاستضافة قبل ربط البوت.
هل بياناتي في قاعدة بيانات PostgreSQL؟
لا. الخطة الحالية تتضمن التخزين المدمج ذي المفتاح والقيمة. قاعدة البيانات المُدارة ميزة Pro، أو يمكنك ربط Supabase من لوحة Database؛ لم نبدّل مزوّدك تلقائيًا.
لماذا لا أستطيع لصق رمز البوت هنا؟
لمنع وجود الرمز في المتصفح أو سجلاته. أضفه من لوحة أسرار الخادم، أو استخدم أداة connect:bot على خادم العامل لتخزينه مشفّرًا.
متى تظهر الميزة متصلة؟
بعد وجود نبض حديث من العامل. يجب أيضًا اختبار نشر اللوحة وتفاعلها داخل سيرفرك؛ الفحص المحلي لا يختبر صلاحيات Discord الحقيقية.