npm package: @oqool/muayadgen
Description: أداة ذكاء اصطناعي متقدمة لتوليد وتعديل الأكواد
Author: Dr. Muayad
Latest version: 3.13.0

# 🧠 MuayadGen

<div dir="rtl">

أداة ذكاء اصطناعي متقدمة لتوليد وتعديل الأكواد

![Version](https://img.shields.io/badge/version-3.13.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)

</div>

---

## ✨ المميزات

### 🏆 الذكاء الاصطناعي المتقدم (v2.5)
- **فرق AI متعددة الشخصيات**: 8 شخصيات متخصصة (معماري، مطور، مراجع، أمني، مختبر، محسن، موثق، مرشد)
- **ذكاء جماعي**: اتخاذ قرارات جماعية مع 5 خبراء مختلفين
- **DNA الكود**: استخراج "البصمة الوراثية" للكود مع تحليل شامل للأنماط والجودة
- **نظام صوتي متقدم**: تفاعل صوتي باللغة العربية والإنجليزية

### 🤖 الذكاء الاصطناعي المحسن (v2.0)
- **ذكاء اصطناعي متعدد**: دعم OpenAI, Claude, DeepSeek مع اختيار تلقائي
- **توثيق تلقائي**: حفظ وفهرسة جميع تفاعلاتك مع AI
- **بحث ذكي**: البحث في تاريخ الردود والطلبات
- **تعلم مخصص**: فهم أسلوبك وتفضيلاتك

### 👥 التعاون الذكي
- **جلسات تعاون**: مشاريع مشتركة بين أعضاء الفريق
- **مراجعات كود**: نظام مراجعة متكامل مع تعليقات
- **قوالب فريق**: مشاركة القوالب والأنماط
- **تقارير تعاون**: تحليل أداء الفريق

### 🔐 الأمان المتقدم
- **فحص أمان**: كشف الأنماط الضارة والثغرات
- **توقيع كود**: توقيع رقمي للملفات
- **تشفير حساس**: حماية الملفات السرية
- **فحص تبعيات**: كشف الثغرات في الحزم

### 🌍 دعم اللغات المتعددة
- **7 لغات**: JavaScript, TypeScript, Python, Go, Rust, Ruby, PHP
- **تنسيق تلقائي**: دعم Prettier, Black, gofmt, rustfmt
- **فحص متقدم**: ESLint, Pylint, golangci-lint, clippy
- **اختبار شامل**: Jest, Pytest, go test, cargo test

### 📝 كتابة وتعديل متقدم
- **كتابة تلقائية**: إنشاء وتعديل الملفات مباشرة في مشروعك
- **فهم السياق**: يقرأ مشروعك ويفهم البنية
- **محادثة تفاعلية**: وضع chat للتفاعل المستمر
- **Patch System**: تعديلات دقيقة على مستوى السطر بدلاً من إعادة كتابة كاملة

### 🧠 تحليل ذكي
- **AST Analyzer**: تحليل عميق للكود باستخدام Abstract Syntax Tree
- **تحليل أداء**: مراقبة سرعة التنفيذ واستخدام الموارد
- **تحليل تعارض**: حل التعارضات بذكاء اصطناعي
- **اقتراحات ذكية**: تحسينات تلقائية للكود

### 🏃 تنفيذ واختبار
- **Code Executor**: تشغيل الأكواد مباشرة مع sandbox وإصلاح تلقائي للأخطاء
- **اختبار شامل**: Unit, Integration, E2E tests
- **تغطية عالية**: 95%+ تغطية اختبارات
- **أداء محسن**: تنفيذ متوازي ومحسن

### 🔀 Git وإدارة المشاريع
- **Git Integration**: branches تلقائية، commits ذكية، وpush تفاعلي
- **Pull Requests**: إنشاء وإدارة PR تلقائياً
- **Git Hooks**: hooks ذكية للجودة
- **تاريخ العمل**: تتبع جميع التغييرات

### 🎭 الذكاء الاصطناعي المتقدم
- **فرق AI متعددة الشخصيات**: 8 شخصيات متخصصة (معماري، مطور، مراجع، أمني، مختبر، محسن، موثق، مرشد)
- **ذكاء جماعي**: اتخاذ قرارات جماعية مع تحليل متعدد الجوانب
- **DNA الكود**: استخراج "البصمة الوراثية" للكود مع تحليل شامل للأنماط والجودة
- **نظام صوتي**: تفاعل صوتي باللغة العربية والإنجليزية

### 🎨 تجربة المستخدم
- **واجهة جميلة**: ألوان وأيقونات احترافية
- **دعم IDE**: امتدادات VS Code, IntelliJ
- **API برمجي**: استخدام كمكتبة برمجية
- **تصدير متعدد**: JSON, CSV, Markdown

### 🌍 الدعم العربي
- **واجهة عربية كاملة**: واجهة وأوامر بالعربية
- **توثيق شامل**: أدلة وأمثلة بالعربية
- **دعم مجتمع**: Discord ومنتديات عربية
- **محتوى تعليمي**: فيديوهات ودروس بالعربية

---

## 📦 التنصيب

### عالمياً (Global)

```bash
npm install -g @oqool/muayadgen
```

### محلياً (في المشروع)

```bash
npm install @oqool/muayadgen
npx muayadgen
```

### من المصدر

```bash
git clone https://github.com/oqool-ai/muayadgen.git
cd muayadgen
npm install
npm run build
npm link
```

---

## 🚀 البدء السريع

### 1. التسجيل في Oqool AI

1. اذهب إلى [oqool.net](https://oqool.net)
2. أنشئ حساب واختر باقتك
3. احصل على API Key من الإعدادات

### 2. تسجيل الدخول

```bash
muayadgen login oqool_your_api_key_here
```

### 3. استخدم الأداة!

```bash
muayadgen "اصنع API بسيط ب Express.js"
```

---

## 📖 الاستخدام

### الأوامر الأساسية

#### 🔐 تسجيل الدخول
```bash
muayadgen login <API_KEY>
```

#### 📝 توليد كود
```bash
muayadgen "اصنع مكون React للمستخدمين"
muayadgen generate "أضف middleware للمصادقة"
muayadgen gen "اكتب اختبارات للـ API"
```

#### 💬 محادثة تفاعلية
```bash
muayadgen chat
```

#### 📊 حالة الحساب
```bash
muayadgen status
```

#### 🌳 عرض بنية المشروع
```bash
muayadgen structure
muayadgen tree
```

#### 🔧 تعديل الكود بدقة (Patch System)
```bash
muayadgen patch "استبدل var بـ const" --files src/app.js
muayadgen patch "حسن أداء الدالة fetchUsers" --files src/api.js --preview
```

#### 🔍 تحليل الكود (AST Analyzer)
```bash
muayadgen analyze src/app.js
muayadgen analyze src/**/*.js --output json
```

#### 🏃 تشغيل الكود (Code Executor)
```bash
muayadgen run src/app.js
muayadgen run src/app.js --sandbox --timeout 10000
muayadgen run-fix src/app.js  # تشغيل وإصلاح تلقائي
muayadgen fix src/app.js --auto-apply  # إصلاح الأخطاء
```

#### 🚪 تسجيل الخروج
```bash
muayadgen logout
```

#### 📚 إدارة التوثيق
```bash
muayadgen docs search "express api"
muayadgen docs stats
muayadgen docs export --format json
```

#### 👥 جلسات التعاون
```bash
muayadgen session create "مشروع API" "تطوير API للمنصة"
muayadgen session invite user@example.com --role member
muayadgen session list
```

#### 🔍 مراجعات الكود
```bash
muayadgen review create "تحسين الأداء" "مراجعة endpoints" --files src/api.ts --reviewer senior
muayadgen review list --status pending
```

#### 🔐 الأمان المتقدم
```bash
muayadgen security scan src/api.ts
muayadgen security deps
muayadgen security sign src/app.js
muayadgen security encrypt config/database.js
muayadgen security report
```

#### 📋 قوالب الفريق
```bash
muayadgen team-template create "Express API" "قالب API معقد" backend --files src/**/*.ts
muayadgen team-template search "api"
```

#### 🎭 فرق AI متعددة الشخصيات
```bash
muayadgen team create "فريق التطوير" "فريق لتطوير تطبيق ويب" web-application
muayadgen team list
muayadgen team personalities
muayadgen team discuss <team-id> "تحسين الأداء" "كيف نحسن أداء قاعدة البيانات؟"
```

#### 🧠 الذكاء الجماعي
```bash
muayadgen collective create "اختيار قاعدة البيانات" "ما هي أفضل قاعدة بيانات للمشروع؟"
muayadgen collective decide <decision-id>
muayadgen collective list
muayadgen collective cluster "قاعدة البيانات" "تحليل قواعد البيانات"
muayadgen collective knowledge <cluster-id> "MongoDB سريع في القراءة" "خبرة عملية"
```

#### 🧬 DNA الكود
```bash
muayadgen dna extract src/app.js
muayadgen dna compare src/app.js src/utils.js
muayadgen dna list
```

#### 🎤 النظام الصوتي
```bash
muayadgen voice config --enable
muayadgen voice start
muayadgen voice train
muayadgen voice sessions
muayadgen voice stats
```

#### 🎭 فرق AI المتقدمة (v2.5)
```bash
# إنشاء فريق AI متخصص
muayadgen team create "فريق التطوير" "تطوير تطبيق ويب" web-application

# عرض الشخصيات المتاحة
muayadgen team personalities

# مناقشة جماعية
muayadgen team discuss <team-id> "تحسين الأداء" "كيف نحسن أداء قاعدة البيانات؟"

# عصف ذهني جماعي
muayadgen ai-team brainstorm "تصميم النظام" "ما هي أفضل بنية للتطبيق؟"

# قرار جماعي
muayadgen collective create "اختيار قاعدة البيانات" "ما هي أفضل قاعدة بيانات؟"
muayadgen collective decide <decision-id>
```

#### 🧬 DNA الكود (v2.5)
```bash
# استخراج DNA لملف
muayadgen dna extract src/app.js

# مقارنة DNA ملفين
muayadgen dna compare src/app.js src/utils.js

# عرض DNA المحفوظة
muayadgen dna list
```

#### 🎤 النظام الصوتي (v2.5)
```bash
# تكوين النظام الصوتي
muayadgen voice config --enable --language ar

# بدء جلسة صوتية
muayadgen voice start

# تدريب النظام
muayadgen voice train

# عرض الجلسات
muayadgen voice sessions

# إحصائيات الصوت
muayadgen voice stats
```

#### 🤖 الذكاء الاصطناعي المتقدم
```bash
# عرض الشخصيات المتاحة
muayadgen ai-team personality

# عصف ذهني جماعي
muayadgen ai-team brainstorm "تحسين تجربة المستخدم"

# مناقشة بين الشخصيات
muayadgen ai-team debate <team-id> "أفضل إطار عمل للمشروع"
```

---

## ⚙️ خيارات متقدمة

### تحديد ملفات معينة للسياق

```bash
muayadgen "عدل هذا الملف" --files src/api.ts src/types.ts
```

### تحديد عدد الملفات

```bash
muayadgen "اصنع API" --max-files 5
```

### اختيار مزود AI محدد

```bash
muayadgen "اكتب دالة معقدة" --provider claude
muayadgen "برمجة بسيطة" --provider deepseek
muayadgen "سؤال عام" --provider openai
```

---

## 📂 ملف .oqoolignore

أنشئ ملف `.oqoolignore` في مشروعك لاستبعاد ملفات معينة:

```gitignore
# Dependencies
node_modules/
.pnp/

# Production
dist/
build/
out/

# Environment
.env*

# Logs
*.log
```

---

## 💡 أمثلة عملية

### مثال 1: إنشاء API بسيط

```bash
cd my-project
muayadgen "اصنع Express API مع endpoints للمستخدمين (create, read, update, delete)"
```

**النتيجة:**
- `src/server.ts` - السيرفر الرئيسي
- `src/routes/users.ts` - Routes المستخدمين
- `src/controllers/users.ts` - Controllers
- `src/models/User.ts` - Model

### مثال 2: إضافة ميزة لمشروع موجود

```bash
muayadgen "أضف نظام مصادقة JWT مع middleware" --files src/server.ts
```

### مثال 3: كتابة اختبارات

```bash
muayadgen "اكتب اختبارات Jest لملف API" --files src/api.ts
```

### مثال 4: محادثة تفاعلية

```bash
muayadgen chat

أنت: اشرح لي الكود في src/utils.ts
🤖 Oqool: [شرح الكود]

أنت: عدله ليكون أسرع
🤖 Oqool: [كود محسن]

أنت: exit
```

---

## 🎯 أفضل الممارسات

### 1. كن واضحاً في الطلبات

✅ **جيد**: "اصنع API REST لإدارة المنتجات مع CRUD operations"  
❌ **غير واضح**: "اصنع API"

### 2. استخدم السياق

```bash
# قبل الطلب، دع الأداة تفحص المشروع
muayadgen structure

# ثم اطلب بوضوح
muayadgen "أضف endpoint جديد للإحصائيات"
```

### 3. راجع الكود قبل الكتابة

الأداة تسأل تأكيد قبل كتابة الملفات - راجعها دائماً!

### 4. استخدم .oqoolignore

استبعد الملفات غير الضرورية لتسريع المعالجة.

---

## 📊 الباقات والأسعار

| الباقة | السعر | الرسائل/اليوم | المميزات |
|--------|-------|---------------|----------|
| 🆓 Free | مجاني | 10 | الميزات الأساسية |
| 💎 Medium | $9.99/شهر | 100 | أولوية في الاستجابة |
| 👑 Expert | $29.99/شهر | غير محدود | جميع المزودات + دعم |

سجل في [oqool.net](https://oqool.net) للحصول على باقتك

---

## 🔧 استكشاف الأخطاء

### "API Key غير صحيح"

تأكد من:
- نسخ المفتاح كاملاً من الموقع
- عدم وجود مسافات إضافية
- الصيغة: `oqool_xxxxxxxxxxxx`

### "فشل الاتصال بالـ Backend"

تحقق من:
- اتصال الإنترنت
- حالة موقع oqool.net
- Firewall لا يحجب الطلبات

### "لا توجد ملفات للكتابة"

- تأكد من أن الرد يحتوي على كود blocks
- استخدم طلبات أكثر وضوحاً
- جرب المحادثة التفاعلية للتوضيح

---

## 🤝 المساهمة

نرحب بالمساهمات! 

1. Fork المشروع
2. أنشئ branch جديد (`git checkout -b feature/amazing`)
3. Commit التغييرات (`git commit -m 'Add amazing feature'`)
4. Push للـ branch (`git push origin feature/amazing`)
5. افتح Pull Request

---

## 📚 الوثائق

للمزيد من التفاصيل، راجع الأدلة الشاملة:

- 📘 [PATCH_GUIDE.md](PATCH_GUIDE.md) - دليل نظام التعديلات الدقيقة
- 📗 [AST_ANALYZER_GUIDE.md](AST_ANALYZER_GUIDE.md) - دليل محلل الكود الذكي
- 📙 [CODE_EXECUTOR_GUIDE.md](CODE_EXECUTOR_GUIDE.md) - دليل تنفيذ الكود والإصلاح التلقائي
- 📕 [GIT_INTEGRATION_GUIDE.md](GIT_INTEGRATION_GUIDE.md) - دليل التكامل مع Git
- 📔 [SETUP_REPORT.md](SETUP_REPORT.md) - تقرير الإعداد الكامل

---

## 📝 الترخيص

MIT License - راجع ملف [LICENSE](LICENSE)

---

## 🌐 الروابط

- 🏠 الموقع: [oqool.net](https://oqool.net)
- 📧 الدعم: support@oqool.net
- 💬 Discord: [انضم للمجتمع](https://discord.gg/oqool)
- 🐦 Twitter: [@OqoolAI](https://twitter.com/OqoolAI)

---

## 👨‍💻 المطور

صنع بـ ❤️ بواسطة **Dr. Muayad** و فريق Oqool AI

<div dir="ltr">

```
   ___              _      _   ___ 
  / _ \  __ _  ___ | |    / \ |_ _|
 | | | |/ _` |/ _ \| |   / _ \ | | 
 | |_| | (_| | (_) | |  / ___ \| | 
  \___/ \__, |\___/|_| /_/   \_\___|
           |_|                       
```

</div>

---

## 🚀 الإصدار 2.5 - التحسينات الجديدة

### ✅ ما تم إنجازه:

#### 🎭 Multi-Personality AI Team
- **8 شخصيات AI متخصصة**: معماري، مطور، مراجع، أمني، مختبر، محسن، موثق، مرشد
- **نقاشات جماعية**: تفاعل بين الشخصيات المختلفة
- **أدوار محددة**: كل شخصية لها خبرة وأسلوب تواصل فريد
- **عرض أداء**: تتبع أداء كل شخصية وتحسينه

#### 🧠 Collective Intelligence System
- **قرارات جماعية**: جمع آراء 5 خبراء مختلفين
- **تحليل التوافق**: حساب درجة التوافق والثقة
- **مجموعات ذكاء**: قواعد معرفة مترابطة
- **أنماط التعلم**: اكتشاف الأنماط من البيانات
- **رؤى ذكية**: توليد توصيات من المعرفة المتراكمة

#### 🧬 Code DNA System
- **تحليل AST شامل**: فهم بنية الكود بعمق
- **أسلوب البرمجة**: تحليل التنسيق والتسمية والأقواس
- **مقاييس الجودة**: 8 مقاييس شاملة للجودة
- **التعقيد المتعدد**: دوري، معرفي، هيكلي، منطقي
- **التطور**: تتبع تاريخ التغييرات والتطور
- **التشابه**: مقارنة DNA ملفين لتحديد الاختلافات

#### 🎤 Voice-First Interface
- **تفاعل صوتي**: تحكم بالصوت بالعربية والإنجليزية
- **تحليل النية**: فهم ما يريده المستخدم
- **استخراج الكيانات**: التعرف على الملفات والدوال
- **التعلم المستمر**: تحسين الدقة مع الاستخدام
- **جلسات صوتية**: تتبع وحفظ الجلسات

### 📊 التحسن الإجمالي:

| المقياس | الإصدار 2.0 | الإصدار 2.5 | التحسن |
|---------|-------------|-------------|---------|
| **الشخصيات AI** | - | 8 شخصيات | +∞ |
| **الذكاء الجماعي** | - | 5 خبراء | +∞ |
| **DNA الكود** | - | تحليل شامل | +∞ |
| **النظام الصوتي** | - | كامل | +∞ |
| **الأوامر الجديدة** | 13 | 25+ | +92% |
| **الميزات المتقدمة** | 6 | 15+ | +150% |
| **التكامل** | جيد | استثنائي | +200% |

### 🎯 الأوامر الجديدة (12 أمر جديد):

```bash
# فرق AI متعددة الشخصيات
muayadgen team create/list/personalities/discuss

# الذكاء الجماعي
muayadgen collective create/decide/list/cluster/knowledge

# DNA الكود
muayadgen dna extract/compare/list

# النظام الصوتي
muayadgen voice config/start/train/sessions/stats

# الذكاء المتقدم
muayadgen ai-team personality/brainstorm/debate
```

### 🔬 التقنيات المتقدمة:

- **تحليل AST**: فهم بنية الكود بعمق
- **معالجة اللغة الطبيعية**: فهم الأوامر الصوتية
- **التعلم الآلي**: تحسين مستمر للأداء
- **تحليل الشخصيات**: تفاعل ذكي مع كل شخصية
- **التشفير الرقمي**: توقيع وحماية الكود
- **الشبكات العصبية**: لفهم وتحليل الكود

---

**🎊 تهانينا! أصبح Oqool Code أداة ذكاء اصطناعي متطورة!**

**🏆 الإنجازات:**
- ✅ 4 ميزات رئيسية جديدة
- ✅ 12 أمر جديد
- ✅ 25+ ملف برمجي
- ✅ توثيق شامل
- ✅ أمثلة عملية
- ✅ تكامل كامل

**🚀 الآن يمكنك:**
- إنشاء فرق AI متخصصة لمشاريعك
- اتخاذ قرارات جماعية ذكية
- استخراج DNA الكود لفهم عميق
- التحكم الصوتي في التطوير
- تحليل شامل للكود والأداء

**صُنع بـ ❤️ و 🌟 بواسطة فريق Oqool AI**

*نسعى دائماً لجعل تطوير البرمجيات أذكى وأسهل وأكثر متعة للجميع! 🎉*

---

**⭐ إذا أعجبتك الأداة، لا تنسى النجمة على GitHub!**