DISOR

NX Edition — بوت إدارة سيرفرات Discord بالذكاء الاصطناعي

اكتب طلبك بالعامية… والبوت ينفذه! 🚀 مش أوامر ثابتة، مش Prefix معقد — مجرد كلام عادي بيتحول لأوامر حقيقية بتنفذ على سيرفرك.

English: A powerful Discord AI bot that understands natural language (Arabic & English) and executes server actions automatically — 126 skills, admin-only security, blazing-fast LLM routing, and zero config hassle. Built with Python + discord.py + Groq LLM.

مطوَّر بالكامل بواسطة: NX (يوزر ديسكورد: e4_1) 💬 تواصل معي على ديسكورد — Discord ID: 1254573563160039495

---

📑 فهرس المحتويات

اضغط للتنقل

• 🏆 الإنجازات
• 🕰️ رحلة التحديثات — 6 إصدارات
• 🛠️ المهارات (126 مهارة)
• ⚡ أوامر سلايش وأوامر نصية
• 🚀 التشغيل السريع
• ⚙️ الإعدادات
• 📂 هيكل المشروع
• 🛡️ الأمان
• ⚡ الأداء
• 🧪 الاختبارات و CI
• 🤝 المساهمة والتطوير
• ❓ أسئلة شائعة
• 📜 الرخصة

---

🏆 الإنجازات

🔐 أمان صارم	⚡ رد أسرع	🧠 فهم أعمق
المشرفين بس + صلاحية لكل أمر + administrator مقموع + حماية ترتيب الرتب	فايبرات LLM + كاش سيرفر + موديل سريع + Retry تلقائي	سياق محادثة + أمثلة few-shot (36 مثال) + محلل كيانات 3 مراحل

🛠️ 126 مهارة	📊 جاهز للنشر	💬 بالعامية المصرية
11 مجموعات كاملة من إدارة السيرفر	CI + اختبارات + متغيرات بيئة + keep-alive	بيتكلم معاك زي صاحبك — مش روبوت جاف

---

🕰️ رحلة التحديثات — 5 إصدارات

الإصدار	العنوان	الإضافة
V2.2	✨ الأساس القوي	فصل الرومات + نسخ + ثريد + سلايش
V2.3	🛠️ فصل وتنظيم	نظام Dispatch + إدارة ثريدز كاملة + 43 مهارة
V2.4	⚡ السيطرة على الأعضاء	سوفت بان + صوتي كامل + 57 مهارة
V2.5	🚀 التوسعة العملاقة	ويبهوكس + إيموجي + إنفيتات + 75 مهارة
V3.0	🔥 الإنجاز الخرافي	102 مهارة + إعدادات سيرفر كاملة
V3.5	👑 القوة القصوى	126 مهارة + صوتيات + رتب جماعية + براند سيرفر + متعة

📖 تفاصيل كل تحديث (اضغط للعرض)

✨ V2.2 — الأساس القوي

• فصل إنشاء الرومات لأنواع (نصي/صوتي) + نسخ روم + ثريد + عرض أعضاء رتبة
• أوامر سلايش بتتزامن تلقائيًا

🛠️ V2.3 — فصل وتنظيم

• إعادة هيكلة بنظام Dispatch جدولي (أساس الـ 100+)
• إدارة ثريدز كاملة: فتح/حذف/أرشفة/قفل/فتح
• فصل السلو مود والـ NSFW والقفل لمهارات مستقلة

⚡ V2.4 — السيطرة على الأعضاء

• سوفت بان + فك كتم + تصفير اسم + فك كتم صوتي + طرشان + فصل من الفويس
• مسح تحذيرات + معلومات عضو + قائمة المتبندين + البوسترز
• فصل مهارات الرتب (لون/ترتيب/صلاحيات/نسخ)

🚀 V2.5 — التوسعة العملاقة

• ويبهوكس (إنشاء/حذف/عرض) + إيموجي مخصص + إدارة إنفيتات
• رسائل متقدمة: إيمبيد منسق + تثبيت + رسالة خاصة + مسح رسائل عضو/بوتات

🔥 V3.0 — الإنجاز الخرافي

• إعدادات سيرفر كاملة: اسم السيرفر + مستوى التحقق + AFK + قناة النظام
• ترحيب + رول تلقائي + معاينة ترحيب + معلومات سيرفر شاملة
• الوصول لـ 102 مهارة

👑 V3.5 — القوة القصوى

• 🎙️ صوتيات: معلومات روم صوتي + نقل الجميع + فصل الجميع
• 🟩 رتب جماعية: إعطاء/سحب رتبة لكل الأعضاء أو البوتات أو البشر
• 🖼️ براند السيرفر: أيقونة + بانر + سبلاش + Vanity URL
• 🟦 قنوات متقدمة: بيتريت + حد أقصى + صلاحيات رتبة/عضو على روم
• 🟪 رسائل: إرسال رسالة + ريأكشن على آخر رسالة
• 🎲 متعة: عملة + نرد + رقم عشوائي + اختيار عشوائي + معلومات البوت
• 🟥 بان بالـ ID + 🎨 تصميم 3D احترافي جديد بأفاتار حقيقي
• الوصول لـ 126 مهارة — أقوى بوت إدارة عربي على جروك 👑

---

🛠️ المهارات (126 مهارة)

🟦 القنوات (28)

المهارة	الوصف
CreateTextChannel CreateVoiceChannel CreateForumChannel CreateStageChannel	إنشاء روم بأي نوع (مع حد أقصى للأعضاء)
DeleteChannel RenameChannel SetChannelTopic	حذف / إعادة تسمية / وصف
MoveChannel SyncChannelPermissions	نقل لكاتجوري / مزامنة الصلاحيات
LockChannel UnlockChannel	قفل / فتح الكتابة أو الكلام
EnableSlowmode DisableSlowmode	سلو مود تفعيل / إيقاف
EnableNsfw DisableNsfw	روم 18+ تفعيل / إيقاف
CloneChannel	نسخ الروم بنفس النوع
SetChannelBitrate	ضبط جودة الصوت (kbps)
SetChannelUserLimit	الحد الأقصى للأعضاء في الروم
ChannelPermissionRole ChannelPermissionMember	صلاحيات رتبة/عضو على روم معين
CreateThread DeleteThread	فتح / حذف ثريد
ArchiveThread UnarchiveThread	أرشفة / فك أرشفة
LockThread UnlockThread	قفل / فتح ثريد
ChannelInfo ListChannels	معلومات / قائمة الرومات

🟨 الكاتجوريز (6)

CreateCategory DeleteCategory RenameCategory ReorderCategory ListCategories CategoryInfo

🟩 الرتب (18)

CreateRole DeleteRole RenameRole SetRoleColor SetRolePosition SetRolePermissions GrantRole RemoveRole RoleMembers CopyRole ToggleRoleHoist ToggleRoleMentionable RoleInfo ListRoles GiveRoleToAll TakeRoleFromAll GiveRoleToBots GiveRoleToHumans

🟥 الأعضاء (22)

KickMember BanMember SoftBanMember UnbanMember BanByID TimeoutMember RemoveTimeout RenameMember ResetNickname VoiceMute VoiceUnmute VoiceDeafen VoiceUndeafen DisconnectMember MoveMember WarnMember UnwarnMember ShowWarnings ClearWarnings MemberInfo BannedList BoostersList

🟪 الرسائل (12)

ClearMessages ClearChannel ClearUserMessages ClearBotMessages Announce CreatePoll SendEmbed PinLastMessage UnpinLastMessage SendDM SendMessage ReactLastMessage

🟫 الإنفيتات (3)

CreateInvite ListInvites RevokeInvites

🟧 الإيموجي (3)

AddEmoji RemoveEmoji ListEmojis

🟦 الويبهوكس (3)

CreateWebhook DeleteWebhook ListWebhooks

🎙️ الصوتيات (3)

VoiceChannelInfo MoveAllToVoice DisconnectAllVoice

🎲 المتعة (5)

FlipCoin RollDice RandomNumber ChooseRandom BotInfo

🟩 السيرفر (23)

ServerInfo MemberCount OnlineCount ServerBoostCount RenameServer SetVerificationLevel SetAfkChannel SetSystemChannel SetWelcome WelcomeOff SetAutoRole AutoRoleOff GreetTest PermsForMember PermsForRole HighestRole RandomMember MemberAvatar ServerIcon ServerBanner ServerSplash CreateVanityURL ServerAvatar

---

💬 أمثلة بالعامية

@Disor اعمل روم اسمه chat وحطه في كاتجوري Generals
@Disor ادي محمد رتبة VIP وشيل من أحمد رتبة member
@Disor انقل محمد لروم الفويس واكتمه
@Disor حذر محمد عشان السبام
@Disor اعمل استطلاع في العام: احسن لعبة؟ فورتنايت ولا فري فاير
@Disor عمل ويبهوك في announcements اسمه تنبيهات
@Disor ضيف ايموجي اسمه cool من رابط
@Disor عرفني عن السيرفر
@Disor امسح اخر 20 رسالة وقفل روم chat

---

⚡ أوامر سلايش وأوامر نصية

🎛️ أوامر سلايش (بتظهر تلقائيًا)

الأمر	الوظيفة
/help	كل مهارات البوت
/status	حالة البوت + البنق + الموديل
/settings	إعدادات السيرفر
/warnings [@عضو]	تحذيرات عضو

⌨️ أوامر نصية

الأمر	الوظيفة
!help / !skills	كل المهارات + عداد المهارات
!ping / !status	البنق + حالة مفصلة
!welcome #قناة <نص> / !welcomeoff	ترحيب الأعضاء الجدد
!autorole @رتبة / !autoroleoff	رول تلقائي للأعضاء الجدد
!warnings @عضو / !settings	تحذيرات + إعدادات

---

🚀 التشغيل السريع

المتطلبات

• ✅ Python 3.10+ • ✅ توكن بوت من Discord Developer Portal • ✅ مفتاح Groq مجاني من console.groq.com

1) الإعداد

git clone https://github.com/j4oc/Disor.git
cd Disor

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

cp data.example.json data.json  # ثم عدّل data.json

2) ضبط الـ Intents (مهم جدًا)

من Discord Developer Portal → Bot → فعّل:

• ✅ Message Content Intent
• ✅ Server Members Intent

3) التشغيل

python main.py

بديل أفضل: متغيرات البيئة DISCORD_TOKEN و GROQ_API_KEY — مهم للاستضافة.

---

⚙️ الإعدادات

المفتاح	الوصف	الافتراضي
MODEL	موديل Groq الرئيسي	meta-llama/llama-4-scout-17b-16e-instruct
MODEL_FAST	موديل سريع للراوتر ⚡	"" (نفس الرئيسي)
ALLOWED_CHANNELS	قنوات يشتغل فيها بس ([] = الكل)	[]
REQUIRE_MENTION	يرد بس لما يتعمل له mention	true
ADMIN_ONLY	المشرفين بس — العضو العادي ممنوع	true
ALLOWED_ROLE	رول إضافي يعامل كـ مشرف	""
AUDIT_CHANNEL	قناة سجل العمليات (id)	""
MAX_HISTORY	عدد رسائل الذاكرة لكل مستخدم	12
JSON_MODE	JSON mode للـ Parser (أدق)	true
ACTION_COOLDOWN	ثواني بين كل أمر	3
RATE_LIMIT_PER_MIN	أقصى رسائل/دقيقة لكل مستخدم	8
PREFIX	بريفكس الأوامر النصية	!
WEB_PORT	بورت سيرفر الويب keep-alive	8080

---

📂 هيكل المشروع

Disor/
├── .github/workflows/ci.yml   # GitHub Actions — اختبارات تلقائية
├── tests/                     # 18 اختبار pytest (مفيش إنترنت)
├── assets/                    # بانر + صورة المطوّر
├── main.py                    # نقطة الدخول: الأحداث، الأمان، السلايش، الترحيب
├── ai.py                      # Groq: راوتر/شات/parser/محللو كيانات + retry
├── skills.py                  # 126 مهارة + Dispatch + صلاحيات + تحذيرات
├── memory.py                  # ذاكرة محادثة + سجل طلبات
├── guilddata.py               # إعدادات السيرفرات
├── settings.py                # إعدادات من data.json + متغيرات بيئة
├── web.py                     # سيرفر ويب keep-alive
├── requirements.txt           # المكتبات
├── data.example.json          # نموذج الإعدادات
├── SECURITY.md                # سياسة الثغرات
├── CODE_OF_CONDUCT.md         # قواعد السلوك
├── CONTRIBUTING.md            # دليل المساهمة
├── CHANGELOG.md               # سجل 5 تحديثات
└── LICENSE                    # MIT

---

🛡️ الأمان

الحماية	الوصف
⛔ المشرفين بس	ADMIN_ONLY مفعل — العضو العادي ممنوع نهائيًا
🔑 صلاحية لكل أمر	كل مهارة من الـ 126 ليها صلاحية مطلوبة
🚫 administrator مقموع	بيتشال من أي صلاحيات تطلع من الموديل
🛡️ حماية ترتيب الرتب	ممنوع لمس اللي فوق رتبة البوت أو المالك أو البوت
📋 سجل عمليات	Audit log اختياري
🚦 Rate limit	حماية من السبام
🔒 مفاتيحك معزولة	data.json في .gitignore

---

⚡ الأداء

• فايبرات: استدعاءات LLM في asyncio.to_thread — مفيش تجميد
• كاش ذكي: بيانات السيرفر بتتحسب مرة وبتتجدد تلقائيًا
• MODEL_FAST: موديل سريع للقرارات اللحظية
• Dispatch جدولي: بحث فوري عن المهارة + دالة مباشرة
• Retry تلقائي: مع backoff عند مشاكل الشبكة

---

🧪 الاختبارات و CI

pip install -r requirements-dev.txt
python -m pytest tests/ -v

• 18 اختبار بتشتغل بدون توكن أو إنترنت
• CI على Python 3.10 → 3.13 في كل Push/PR

---

🤝 المساهمة والتطوير

عايز تساهم أو تطور من المشروع؟ إزاي تعمل Fork وتشتغل:

# 1) اعمل Fork من صفحة الريبو (زر Fork فوق يمين)
# 2) انسخ نسختك على جهازك:
git clone https://github.com/j4oc/Disor.git
cd Disor

# 3) اعمل فرع جديد لميزتك:
git checkout -b feature/اسم-الميزة

# 4) عدّل واختبر:
python -m pytest tests/ -v

# 5) ارفع الفرع واعمل Pull Request:
git add .
git commit -m "✨ ميزة جديدة"
git push origin feature/اسم-الميزة

⚠️ مهم: data.json (فيه التوكن) في .gitignore — مستحيل يتسرب للريبو. وشوف CONTRIBUTING.md قبل ما تعمل Pull Request.

---

❓ أسئلة شائعة

ليه العضو العادي مش بيرد عليه البوت؟ ده المطلوب — ADMIN_ONLY مفعل افتراضيًا. غيّره لـ false لو عايز الكل.

إزاي أعطي رول معين صلاحية استخدام البوت؟ حط id/اسم الرول في ALLOWED_ROLE.

البوت بيقول "رتبة البوت لازم تكون فوق"؟ من Server Settings → Roles سحب رتبة البوت فوق كل الرتب اللي هيديرها.

ممكن يدي administrator لحد؟ مستحيل — الكود بيمسحها من أي صلاحيات تطلع من الموديل.

أوامر السلايش مش ظاهرة؟ بتتزامن تلقائيًا عند أول تشغيل — لو مش ظاهرة أعد تشغيل البوت.

عايز تستضيفه 24/7؟ البوت بيشغّل سيرفر ويب keep-alive على WEB_PORT — اربطه بـ UptimeRobot:

https://your-host:8080/health

---

📜 الرخصة

مشروع MIT — استخدمه وعدّله ووزّعه بحرية. شوف LICENSE

---

⭐ لو عجبك المشروع، سيب ستار — ده بيساعدنا جدًا!

تم تطويره بالكامل بواسطة NX (e4_1) — Discord ID: 1254573563160039495

_{الفكرة مستوحاة من مشروع Disor الأصلي — أعيد بناؤه بالكامل من الصفر بواسطة NX}

Disor NX Edition — مصنوع بـ ❤️ و Python + Groq LLM

💡 ساعدنا: لو المشروع عجبك، اضغط ⭐ Star في أعلى الصفحة — كل نجمة بتدعم المشروع!