OmniRoute/docs/i18n/ar

🚀 OmniRoute — The Free AI Gateway (العربية)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

---

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 60 موفرًا، بدون أي توقف عن العمل. الآن معخادم MCP (25 أداة)وبروتوكول A2Aوأنظمة الذاكرة/المهاراتوتطبيق Electron Desktop.

إكمالات الدردشة • التضمينات • إنشاء الصور • الفيديو • الموسيقى • الصوت • إعادة الترتيب •بحث الويب• خادم MCP • بروتوكول A2A • 100% TypeScript---

🌐 موقع الويب • [🚀 البداية السريعة](#-بدء سريع) • 💡 الميزات • 📖 المستندات • [💰 التسعير](#-تسعير في لمحة) • 💬 واتساب

🌐متوفر باللغة:🇺🇸 الإنجليزية | 🇧🇷 البرتغالية (البرازيل) | 🇪🇸 الإسبانية | 🇫🇷 Français | 🇮🇹 الإيطالية | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 الألمانية | 🇮🇳 خبر | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 بلغارسكي | 🇩🇰 الدانسك | 🇫🇮 سومي | 🇮🇱 العربية | 🇭🇺 المجرية | 🇮🇩 البهاسا الإندونيسية | 🇰🇷 한국어 | 🇲🇾 البهاسا ملايو | 🇳🇱 هولندا | 🇳🇴 نورسك | 🇵🇹 البرتغالية (البرتغال) | 🇷🇴 روماني | 🇵🇱 بولسكي | 🇸🇰 سلوفينسينا | 🇸🇪 السفينسكا | 🇵🇭 الفلبينية | 🇨🇿 تشيستينا---

🖼️ Main Dashboard

---

📸 Dashboard Preview

<التفاصيل>

انقر لرؤية لقطات شاشة لوحة التحكم

صفحة	لقطة شاشة
مقدمو الخدمة
المجموعات
تحليلات
الصحة
مترجم
الإعدادات
أدوات سطر الأوامر
سجلات الاستخدام
نقاط النهاية

---

🤖 Free AI Provider for your favorite coding agents

قم بتوصيل أي أداة IDE أو CLI مدعومة بالذكاء الاصطناعي من خلال OmniRoute - بوابة واجهة برمجة التطبيقات المجانية للترميز غير المحدود.

<الجدول> <تر>

أوبنكلاو
_{⭐ 205 ألف}
نانوبوت
_{⭐ 20.9 ألف}
بيكوكلاو
_{⭐ 14.6 ألف}
المخلب الصفري
_{⭐ 9.9 ألف}
المخلب الحديدي
_{⭐ 2.1 كيلو} <تر>
الرمز المفتوح
_{⭐ 106 كيلو}
Codex CLI
_{⭐ 60.8 ألف}
كلود كود
_{⭐ 67.3 ألف}
CLI الجوزاء
_{⭐ 94.7 ألف}
كود الكيلو
_{⭐ 15.5 ألف}

_{📡 يتصل جميع الوكلاء عبر http://localhost:20128/v1 أو http://cloud.omniroute.online/v1 - تكوين واحد ونماذج وحصة غير محدودة}---

🤔 Why OmniRoute?

توقف عن إهدار المال وضرب الحدود:

• تنتهي صلاحية حصة الاشتراك غير المستخدمة كل شهر
• حدود المعدل تمنعك من الترميز المتوسط
• واجهات برمجة التطبيقات باهظة الثمن (20-50 دولارًا شهريًا لكل مزود)
• التبديل اليدوي بين مقدمي الخدمة

OmniRoute يحل هذا:

• ✅تعظيم الاشتراكات- تتبع الحصة، استخدم كل جزء منها قبل إعادة التعيين
• ✅الرجوع التلقائي- الاشتراك → مفتاح واجهة برمجة التطبيقات → رخيص → مجاني، بدون توقف
• ✅حسابات متعددة- جولة روبن بين الحسابات لكل مزود
• ✅عالمي- يعمل مع Claude Code وCodex وGemini CLI وCursor وCline وOpenClaw وأي أداة CLI---

📧 Support

💬انضم إلى مجتمعنا!مجموعة WhatsApp — احصل على المساعدة وشارك النصائح وابق على اطلاع.

-الموقع الإلكتروني: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -المشاكل: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: مجموعة المجتمع -المساهمة: راجع CONTRIBUTING.md، أو افتح علاقة عامة، أو اختر العدد الأول الجيد -المشروع الأصلي: 9router بواسطة decolua### 🐛 Reporting a Bug?

عند فتح مشكلة، يرجى تشغيل أمر معلومات النظام وإرفاق الملف الذي تم إنشاؤه:```bash npm run system-info

يؤدي هذا إلى إنشاء ملف "system-info.txt" مع إصدار Node.js، وإصدار OmniRoute، وتفاصيل نظام التشغيل، وأدوات CLI المثبتة (qoder، وgemini، و claude، وcodex، وantigravity، وdroid، وما إلى ذلك)، وحالة Docker/PM2، وحزم النظام - كل ما نحتاجه لإعادة إنتاج مشكلتك بسرعة. قم بإرفاق الملف مباشرة بمشكلة GitHub الخاصة بك.---

## 🔄 How It Works

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────┐ │ OmniRoute (Smart Router) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking + Embeddings + Images │ │ • Auto token refresh │ └──────┬──────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI │ ↓ quota exhausted ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. │ ↓ budget limit ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 4: FREE] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**يواجه كل مطور يستخدم أدوات الذكاء الاصطناعي هذه المشكلات يوميًا.**تم تصميم OmniRoute لحلها جميعًا — بدءًا من تجاوز التكاليف وحتى الكتل الإقليمية، ومن تدفقات OAuth المعطلة إلى عمليات البروتوكول وإمكانية مراقبة المؤسسة.

<التفاصيل>
<summary><b>💸 1. "أدفع مقابل اشتراك باهظ الثمن ولكن لا يزال يتم مقاطعتي بسبب الحدود"</b></summary>

يدفع المطورون ما بين 20 إلى 200 دولار شهريًا مقابل Claude Pro أو Codex Pro أو GitHub Copilot. حتى عند الدفع، فإن الحصة لها حد أقصى — 5 ساعات من الاستخدام، أو حدود أسبوعية، أو حدود لسعر الدقيقة. في منتصف جلسة الترميز، يتوقف الموفر عن الاستجابة ويفقد المطور التدفق والإنتاجية.

**كيف يحل OmniRoute المشكلة:**

-**الاحتياطي الذكي ذو 4 طبقات**— في حالة نفاد حصة الاشتراك، تتم إعادة التوجيه تلقائيًا إلى مفتاح واجهة برمجة التطبيقات ← رخيص ← مجاني بدون أي تدخل يدوي
-**تتبع حدود الموفر**— يتم تحديث لقطات الحصص المخزنة مؤقتًا وفقًا لجدول من جانب الخادم (الافتراضي `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`) مع توفر التحديث اليدوي في واجهة المستخدم
-**دعم الحسابات المتعددة**— حسابات متعددة لكل مزود مع نظام روبن تلقائي — عند نفاد الحساب، يتم التبديل إلى التالي
-**مجموعات مخصصة**— سلاسل احتياطية قابلة للتخصيص مع 9 إستراتيجيات موازنة (الأولوية، الموزونة، التعبئة أولاً، جولة روبن، P2C، عشوائي، الأقل استخدامًا، محسنة التكلفة، عشوائية صارمة)
-**حصص الدستور الغذائي**— مراقبة حصص مساحة عمل الشركة/الفريق مباشرة في لوحة المعلومات</details>

<التفاصيل>
<summary><b>🔌 2. "أحتاج إلى استخدام عدة موفري خدمات ولكن لكل منهم واجهة برمجة تطبيقات مختلفة"</b></summary>

يستخدم OpenAI تنسيقًا واحدًا، ويستخدم Claude (Anthropic) تنسيقًا آخر، ويستخدم Gemini تنسيقًا آخر. إذا أراد أحد المطورين اختبار النماذج من موفري خدمات مختلفين أو إجراء بديل فيما بينهم، فسيحتاج إلى إعادة تكوين مجموعات تطوير البرامج (SDK)، وتغيير نقاط النهاية، والتعامل مع التنسيقات غير المتوافقة. لدى موفري الخدمة المخصصين (FriendLI، NIM) نقاط نهاية نموذجية غير قياسية.

**كيف يحل OmniRoute المشكلة:**

-**نقطة النهاية الموحدة**— يعمل `http://localhost:20128/v1` كوكيل لجميع مقدمي الخدمة الذين يزيد عددهم عن 60
-**تنسيق الترجمة**— تلقائي وشفاف: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**تطهير الاستجابة**— إزالة الحقول غير القياسية (`x_groq`، `usage_breakdown`، `service_tier`) التي تكسر OpenAI SDK v1.83+
-**تطبيع الدور**— تحويل "المطور" → "النظام" لمقدمي الخدمات غير التابعين لـ OpenAI؛ "النظام" → "المستخدم" لـ GLM/ERNIE
-**Think Tag Extraction**— يستخرج كتل `<think>` من نماذج مثل DeepSeek R1 إلى ``reasoning_content'' القياسي
-**الإخراج المنظم لـ Gemini**— التحويل التلقائي `json_schema` ← `responseMimeType`/`responseSchema`
-**`stream` الافتراضي هو `false`**- يتماشى مع مواصفات OpenAI، ويتجنب SSE غير المتوقع في Python/Rust/Go SDKs</details>

<التفاصيل>
<summary><b>🌐 3. "يحظر مزود الذكاء الاصطناعي الخاص بي منطقتي/بلدي"</b></summary>

يقوم مقدمو الخدمة مثل OpenAI/Codex بحظر الوصول من مناطق جغرافية معينة. يحصل المستخدمون على أخطاء مثل `unsupported_country_region_territory` أثناء اتصالات OAuth وAPI. وهذا أمر محبط بشكل خاص للمطورين من البلدان النامية.

**كيف يحل OmniRoute المشكلة:**

-**تكوين الوكيل ثلاثي المستوى**— وكيل قابل للتكوين على 3 مستويات: عالمي (كل حركة المرور)، لكل مزود (موفر واحد فقط)، ولكل اتصال/مفتاح
-**شارات الوكيل المرمزة بالألوان**— المؤشرات المرئية: 🟢 الوكيل العالمي، 🟡 وكيل الموفر، 🔵 وكيل الاتصال، يظهر دائمًا عنوان IP
-**تبادل رمز OAuth عبر الوكيل**— يمر تدفق OAuth أيضًا عبر الوكيل، مما يؤدي إلى حل مشكلة `unsupported_country_region_territory`
-**اختبارات الاتصال عبر الوكيل**— تستخدم اختبارات الاتصال الوكيل الذي تم تكوينه (لا مزيد من التجاوز المباشر)
-**دعم SOCKS5**— دعم وكيل SOCKS5 الكامل للتوجيه الخارجي
-**انتحال بصمة إصبع TLS**— بصمة TLS تشبه المتصفح عبر `wreq-js` لتجاوز اكتشاف الروبوتات
-**🔏 مطابقة بصمة CLI**— إعادة ترتيب الرؤوس وحقول النص لمطابقة التوقيعات الثنائية لـ CLI الأصلية، مما يقلل بشكل كبير من مخاطر الإبلاغ عن الحساب. يتم الحفاظ على عنوان IP الخاص بالوكيل — حيث يمكنك الحصول على إخفاء**و**IP في وقت واحد</details>

<التفاصيل>
<summary><b>🆓 4. "أريد استخدام الذكاء الاصطناعي في البرمجة ولكن ليس لدي المال"</b></summary>

لا يستطيع الجميع دفع ما بين 20 إلى 200 دولار شهريًا مقابل اشتراكات الذكاء الاصطناعي. يحتاج الطلاب والمطورون من البلدان الناشئة والهواة والمستقلون إلى الوصول إلى نماذج عالية الجودة بدون تكلفة.

**كيف يحل OmniRoute المشكلة:**

-**موفرو الطبقة المجانية المضمنون**— دعم أصلي لمقدمي الخدمة المجانية بنسبة 100%: Qoder (5 نماذج غير محدودة عبر OAuth: kimi-k2-thinking، qwen3-coder-plus، Deepseek-r1، minimax-m2، kimi-k2)، Qwen (4 نماذج غير محدودة: qwen3-coder-plus، qwen3-coder-flash، qwen3-coder-next، Vision-model)، Kiro (Claude + AWS Builder ID مجانًا)، Gemini CLI (180 ألف رمز مميز شهريًا مجانًا)
-**Ollama Cloud**— نماذج Ollama المستضافة على السحابة على `api.ollama.com` مع فئة "الاستخدام الخفيف" مجانًا؛ استخدم البادئة `olmacloud/<model>`
-**المجموعات المجانية فقط**— السلسلة `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = 0 USD/الشهر بدون أي توقف عن العمل
-**NVIDIA NIM Free Access**— ~40 دورة في الدقيقة وصول مجاني للأبد إلى أكثر من 70 نموذجًا على build.nvidia.com (الانتقال من الاعتمادات إلى حدود المعدل النقي)
-**استراتيجية التكلفة المحسنة**— استراتيجية التوجيه التي تختار تلقائيًا أرخص مزود متاح</details>

<التفاصيل>
<summary><b>🔒 5. "أحتاج إلى حماية بوابة الذكاء الاصطناعي الخاصة بي من الوصول غير المصرح به"</b></summary>

عند تعريض بوابة AI للشبكة (LAN، VPS، Docker)، يمكن لأي شخص لديه العنوان استهلاك الرموز المميزة/الحصة النسبية للمطور. بدون الحماية، تكون واجهات برمجة التطبيقات (API) عرضة لإساءة الاستخدام والحقن الفوري وإساءة الاستخدام.

**كيف يحل OmniRoute المشكلة:**

-**إدارة مفاتيح واجهة برمجة التطبيقات**— الإنشاء والتدوير وتحديد النطاق لكل مزود من خلال صفحة `/dashboard/api-manager` المخصصة
-**أذونات على مستوى النموذج**— تقييد مفاتيح واجهة برمجة التطبيقات (API) على نماذج محددة (`openai/*`، أنماط أحرف البدل)، مع تبديل السماح للكل/تقييد
-**API Endpoint Protection**— اطلب مفتاحًا لـ `/v1/models` واحظر موفري خدمة محددين من القائمة
-**Auth Guard + CSRF Protection**— جميع مسارات لوحة المعلومات محمية بالبرمجيات الوسيطة `withAuth` + رموز CSRF المميزة
-**محدد المعدل**— تحديد معدل لكل IP مع نوافذ قابلة للتكوين
-**تصفية IP**— القائمة المسموح بها/القائمة المحظورة للتحكم في الوصول
-**حماية الحقن الفوري**— التعقيم ضد أنماط المطالبة الضارة
-**تشفير AES-256-GCM**— بيانات الاعتماد مشفرة في حالة عدم النشاط</details>

<التفاصيل>
<summary><b>🛑 6. "تعطل مزود الخدمة الخاص بي وفقدت تدفق الترميز الخاص بي"</b></summary>

يمكن أن يصبح موفرو الذكاء الاصطناعي غير مستقرين، أو يعرضون أخطاء 5xx، أو يصلون إلى حدود المعدلات المؤقتة. إذا كان أحد المطورين يعتمد على موفر واحد، فسيتم مقاطعته. بدون قواطع الدائرة، يمكن أن تؤدي عمليات إعادة المحاولة المتكررة إلى تعطل التطبيق.

**كيف يحل OmniRoute المشكلة:**

-**قاطع الدائرة لكل نموذج**— فتح/إغلاق تلقائي مع حدود قابلة للتكوين وفترة تهدئة (مغلق/مفتوح/نصف مفتوح)، محدد النطاق لكل نموذج لتجنب الكتل المتتالية
-**التراجع الأسي**— تأخير إعادة المحاولة التدريجي
-**مكافحة الرعد القطيع**— Mutex + حماية الإشارة ضد عواصف إعادة المحاولة المتزامنة
-**السلاسل الاحتياطية المجمعة**— إذا فشل الموفر الأساسي، فسيتم دخوله تلقائيًا عبر السلسلة دون أي تدخل
-**Combo Circuit Breaker**— التعطيل التلقائي لمقدمي الخدمات الفاشلين ضمن سلسلة التحرير والسرد
-**لوحة معلومات الصحة**— مراقبة وقت التشغيل، وحالات قاطع الدائرة، وعمليات التأمين، وإحصائيات ذاكرة التخزين المؤقت، ووقت الاستجابة p50/p95/p99</details>

<التفاصيل>
<summary><b>🔧 7. "تكوين كل أداة من أدوات الذكاء الاصطناعي أمر ممل ومتكرر"</b></summary>

يستخدم المطورون Cursor وClaude Code وCodex CLI وOpenClaw وGemini CLI وKilo Code... تحتاج كل أداة إلى تكوين مختلف (نقطة نهاية واجهة برمجة التطبيقات، المفتاح، النموذج). تعد إعادة التكوين عند تبديل مقدمي الخدمات أو النماذج مضيعة للوقت.

**كيف يحل OmniRoute المشكلة:**

-**لوحة تحكم أدوات CLI**— صفحة مخصصة مع إعداد بنقرة واحدة لـ Claude Code، وCodex CLI، وOpenClaw، وKilo Code، وAntigravity، وCline
-**GitHub Copilot Config Generator**— يُنشئ `chatLanguageModels.json` لرمز VS مع تحديد نموذج مجمع
-**معالج الإعداد**— إعداد إرشادي من 4 خطوات للمستخدمين لأول مرة
-**نقطة نهاية واحدة، جميع النماذج**— قم بتكوين `http://localhost:20128/v1` مرة واحدة، والوصول إلى أكثر من 60 موفرًا</details>

<التفاصيل>
<summary><b>🔑 8. "إدارة رموز OAuth المميزة من موفري خدمات متعددين أمر جحيم"</b></summary>

Claude Code، وCodex، وGemini CLI، وCopilot — جميعهم يستخدمون OAuth 2.0 مع الرموز المميزة التي تنتهي صلاحيتها. يحتاج المطورون إلى إعادة المصادقة باستمرار، والتعامل مع "سر_العميل مفقود"، و"إعادة توجيه_uri_mismatch"، وحالات الفشل على الخوادم البعيدة. يمثل OAuth على LAN/VPS مشكلة بشكل خاص.

**كيف يحل OmniRoute المشكلة:**

-**التحديث التلقائي للرمز المميز**— يتم تحديث رموز OAuth المميزة في الخلفية قبل انتهاء الصلاحية
-**OAuth 2.0 (PKCE) مدمج**— التدفق التلقائي لـ Claude Code وCodex وGemini CLI وCopilot وKiro وQwen وQoder
-**OAuth متعدد الحسابات**— حسابات متعددة لكل مزود عبر استخراج الرمز المميز JWT/ID
-**OAuth LAN/Remote Fix**— اكتشاف IP الخاص لـ `redirect_uri` + وضع URL اليدوي للخوادم البعيدة
-**OAuth Behind Nginx**— يستخدم window.location.origin للتوافق العكسي مع الوكيل
-**دليل OAuth عن بعد**— دليل خطوة بخطوة لبيانات اعتماد Google Cloud على VPS/Docker</details>

<التفاصيل>
<summary><b>📊 9. "لا أعرف كم أنفق أو أين"</b></summary>

يستخدم المطورون العديد من مقدمي الخدمات المدفوعة ولكن ليس لديهم رؤية موحدة للإنفاق. يمتلك كل مزود خدمة لوحة تحكم الفوترة الخاصة به، ولكن لا يوجد عرض موحد. التكاليف غير المتوقعة يمكن أن تتراكم.

**كيف يحل OmniRoute المشكلة:**

-**لوحة معلومات تحليلات التكلفة**— تتبع التكلفة لكل رمز مميز وإدارة الميزانية لكل مزود
-**حدود الميزانية لكل طبقة**— سقف الإنفاق لكل طبقة يؤدي إلى حدوث تراجع تلقائي
-**تكوين التسعير لكل نموذج**— أسعار قابلة للتكوين لكل نموذج
-**إحصاءات الاستخدام لكل مفتاح API**— عدد الطلبات والطابع الزمني الأخير المستخدم لكل مفتاح
-**لوحة التحكم التحليلية**— بطاقات الإحصائيات، ومخطط استخدام النموذج، وجدول الموفر مع معدلات النجاح وزمن الوصول</details>

<التفاصيل>
<summary><b>🐛 10. "لا أستطيع تشخيص الأخطاء والمشكلات في مكالمات الذكاء الاصطناعي"</b></summary>

عندما تفشل المكالمة، لا يعرف المطور ما إذا كان هناك حد للسعر، أو رمز مميز منتهي الصلاحية، أو تنسيق خاطئ، أو خطأ في الموفر. سجلات مجزأة عبر محطات مختلفة. وبدون إمكانية الملاحظة، يكون تصحيح الأخطاء عبارة عن تجربة وخطأ.

**كيف يحل OmniRoute المشكلة:**

-**لوحة تحكم السجلات الموحدة**— 4 علامات تبويب: سجلات الطلبات، وسجلات الوكيل، وسجلات التدقيق، ووحدة التحكم
-**عارض سجل وحدة التحكم**— عارض بنمط المحطة الطرفية في الوقت الفعلي مع مستويات مرمزة بالألوان، والتمرير التلقائي، والبحث، والتصفية
-**سجلات وكيل SQLite**— السجلات المستمرة التي تستمر حتى بعد إعادة تشغيل الخادم
-**ساحة المترجم**— 4 أوضاع لتصحيح الأخطاء: ساحة اللعب (ترجمة التنسيق)، اختبار الدردشة (ذهابًا وإيابًا)، منصة الاختبار (دفعة)، المراقبة المباشرة (في الوقت الفعلي)
-**قياس الطلب عن بعد**— زمن الاستجابة p50/p95/p99 + تتبع معرف طلب X
-**التسجيل المستند إلى الملف مع التدوير**— يتم تدوير سجلات التطبيق حسب الحجم وأيام الاحتفاظ وعدد الأرشيف؛ يتم تدوير عناصر سجل المكالمات حسب أيام الاحتفاظ وعدد الملفات
-**تقرير معلومات النظام**— يُنشئ `npm run system-info` ملف `system-info.txt` مع بيئتك الكاملة (إصدار Node، إصدار OmniRoute، نظام التشغيل، أدوات CLI، حالة Docker/PM2). قم بإرفاقه عند الإبلاغ عن مشكلات للفرز الفوري.</details>

<التفاصيل>
<summary><b>🏗️ 11. "إن نشر البوابة وصيانتها أمر معقد"</b></summary>

يعد تثبيت وكيل AI وتكوينه وصيانته عبر بيئات مختلفة (محلية، VPS، Docker، سحابية) عملية كثيفة العمالة. مشاكل مثل المسارات المضمنة، EACCES في الدلائل، وتعارضات المنافذ، والبنيات عبر الأنظمة الأساسية تزيد من الاحتكاك.

**كيف يحل OmniRoute المشكلة:**

-**تثبيت npm الشامل**— `npm install -g omniroute && omniroute` - تم
-**منصة Docker المتعددة**— AMD64 + ARM64 الأصلي (Apple Silicon، AWS Graviton، Raspberry Pi)
-**Docker Compose Profiles**— `base` (بدون أدوات CLI) و`cli` (مع Claude Code، وCodex، وOpenClaw)
-**Electron Desktop App**— تطبيق أصلي لنظام التشغيل Windows/macOS/Linux مع علبة النظام، والتشغيل التلقائي، ووضع عدم الاتصال
-**وضع المنفذ المقسم**— واجهة برمجة التطبيقات ولوحة المعلومات على منافذ منفصلة للسيناريوهات المتقدمة (الوكيل العكسي، وشبكات الحاويات)
-**Cloud Sync**— مزامنة التكوين عبر الأجهزة عبر Cloudflare Workers
-**النسخ الاحتياطية لقاعدة البيانات**— النسخ الاحتياطي التلقائي لجميع الإعدادات واستعادتها وتصديرها واستيرادها، باستخدام `DISABLE_SQLITE_AUTO_BACKUP` للنسخ الاحتياطية المُدارة خارجيًا</details>

<التفاصيل>
<summary><b>🌍 12. "الواجهة باللغة الإنجليزية فقط وفريقي لا يتحدث الإنجليزية"</b></summary>

تواجه الفرق في البلدان غير الناطقة باللغة الإنجليزية، وخاصة في أمريكا اللاتينية وآسيا وأوروبا، صعوبة في التعامل مع الواجهات التي تستخدم اللغة الإنجليزية فقط. تعمل حواجز اللغة على تقليل الاعتماد وزيادة أخطاء التكوين.

**كيف يحل OmniRoute المشكلة:**

-**لوحة المعلومات i18n — 30 لغة**— أكثر من 500 مفتاح مترجم بما في ذلك العربية والبلغارية والدنماركية والألمانية والإسبانية والفنلندية والفرنسية والعبرية والهندية والمجرية والإندونيسية والإيطالية واليابانية والكورية والماليزية والهولندية والنرويجية والبولندية والبرتغالية (PT/BR) والرومانية والروسية والسلوفاكية والسويدية والتايلاندية والأوكرانية والفيتنامية والصينية والفلبينية والإنجليزية
-**دعم RTL**— دعم من اليمين إلى اليسار للغتين العربية والعبرية
-**الملفات التمهيدية متعددة اللغات**— 30 ترجمة كاملة للوثائق
-**محدد اللغة**— رمز الكرة الأرضية في رأس الصفحة للتبديل في الوقت الفعلي</details>

<التفاصيل>
<summary><b>🔄 13. "أحتاج إلى أكثر من مجرد الدردشة - أحتاج إلى التضمين والصور والصوت"</b></summary>

الذكاء الاصطناعي ليس مجرد استكمال للدردشة. يحتاج المطورون إلى إنشاء صور، ونسخ الصوت، وإنشاء تضمينات لـ RAG، وإعادة ترتيب المستندات، والإشراف على المحتوى. تحتوي كل واجهة برمجة تطبيقات على نقطة نهاية وتنسيق مختلفين.

**كيف يحل OmniRoute المشكلة:**

-**Embeddings**— `/v1/embeddings` مع 6 موفري خدمات وأكثر من 9 نماذج
-**إنشاء الصور**— `/v1/images/ Generations` مع 10 موفرين وأكثر من 20 نموذجًا (OpenAI، وxAI، وTogether، وFireworks، وNebius، وHyperbolic، وNanoBanana، وAntigravity، وSD WebUI، وComfyUI)
-**تحويل النص إلى فيديو**— `/v1/videos/أجيال` — ComfyUI (AnimateDiff، SVD) وSD WebUI
-**تحويل النص إلى موسيقى**— `/v1/music/generations` — ComfyUI (صوت ثابت مفتوح، MusicGen)
-**نسخ الصوت**— `/v1/audio/transcriptions` — Whisper + Nvidia NIM، HuggingFace، Qwen3
-**تحويل النص إلى كلام**— `/v1/audio/speech` — ElevenLabs، Nvidia NIM، HuggingFace، Coqui، Tortoise، Qwen3،**Inworld**،**Cartesia**،**PlayHT**، + مقدمي الخدمة الحاليين
-**الإشراف**— `/v1/moderations` — التحقق من سلامة المحتوى
-**إعادة الترتيب**— `/v1/rerank` — إعادة ترتيب مدى ملاءمة الوثيقة
-**Responses API**— الدعم الكامل `/v1/responses` لـ Codex</details>

<التفاصيل>
<summary><b>🧪 14. "ليس لدي طريقة لاختبار ومقارنة الجودة عبر النماذج"</b></summary>

يرغب المطورون في معرفة النموذج الأفضل لحالة الاستخدام الخاصة بهم - التعليمات البرمجية، والترجمة، والتفكير - ولكن المقارنة يدويًا بطيئة. لا توجد أدوات تقييم متكاملة.

**كيف يحل OmniRoute المشكلة:**

-**تقييمات LLM**— اختبار المجموعة الذهبية مع 10 حالات محملة مسبقًا تغطي التحيات، والرياضيات، والجغرافيا، وإنشاء التعليمات البرمجية، والامتثال لـ JSON، والترجمة، وتخفيض السعر، والرفض الآمن
-**4 إستراتيجيات المطابقة**— `exact`، `contains`، `regex`، `custom` (وظيفة JS)
-**منصة اختبار ساحة المترجم**— اختبار الدفعات بمدخلات متعددة ومخرجات متوقعة، ومقارنة بين الموفرين
-**أداة اختبار الدردشة**— رحلة ذهابًا وإيابًا كاملة مع عرض الاستجابة المرئية
-**المراقبة المباشرة**— البث المباشر لجميع الطلبات المتدفقة عبر الوكيل</details>

<التفاصيل>
<summary><b>📈 15. "أحتاج إلى التوسع دون فقدان الأداء"</b></summary>

مع نمو حجم الطلب، يؤدي عدم التخزين المؤقت لنفس الأسئلة إلى توليد تكاليف مكررة. دون العجز، طلبات مكررة معالجة النفايات. يجب احترام حدود الأسعار لكل مزود.

**كيف يحل OmniRoute المشكلة:**

-**ذاكرة التخزين المؤقت الدلالية**— تعمل ذاكرة التخزين المؤقت ذات المستويين (التوقيع + الدلالي) على تقليل التكلفة ووقت الاستجابة
-**صلاحية الطلب**— نافذة إلغاء البيانات المكررة لمدة 5 ثوانٍ للطلبات المتماثلة
-**الكشف عن حدود المعدل**— عدد الدورات في الدقيقة لكل مزود، والفجوة الدنيا، والحد الأقصى للتتبع المتزامن
-**حدود المعدل القابلة للتحرير**— الإعدادات الافتراضية القابلة للتكوين في الإعدادات → المرونة مع الثبات
-**ذاكرة التخزين المؤقت للتحقق من صحة مفتاح واجهة برمجة التطبيقات**— ذاكرة تخزين مؤقت ثلاثية الطبقات لأداء الإنتاج
-**لوحة معلومات الصحة مع القياس عن بعد**— زمن الاستجابة p50/p95/p99، وإحصائيات ذاكرة التخزين المؤقت، ووقت التشغيل</details>

<التفاصيل>
<summary><b>🤖 16. "أريد التحكم في سلوك النموذج عالميًا"</b></summary>

المطورون الذين يريدون جميع الاستجابات بلغة معينة، بنبرة معينة، أو يريدون الحد من الرموز المميزة للاستدلال. يعد تكوين هذا في كل أداة/طلب أمرًا غير عملي.

**كيف يحل OmniRoute المشكلة:**

-**الحقن الفوري للنظام**— يتم تطبيق المطالبة العامة على جميع الطلبات
-**التحقق من صحة ميزانية التفكير**— التحكم في تخصيص الرمز المميز لكل طلب (العبور، التلقائي، المخصص، التكيفي)
-**9 استراتيجيات التوجيه**— استراتيجيات عالمية تحدد كيفية توزيع الطلبات
-**Wildcard Router**— يتم توجيه أنماط `المزود/*` ديناميكيًا إلى أي مزود
-**تبديل تمكين/تعطيل التحرير والسرد**— تبديل المجموعات مباشرة من لوحة المعلومات
-**تبديل الموفر**— تمكين/تعطيل جميع اتصالات الموفر بنقرة واحدة
-**موفري الخدمة المحظورون**— استبعاد موفري خدمة محددين من قائمة `/v1/models`</details>

<التفاصيل>
<summary><b>🧰 17. "أحتاج إلى أدوات MCP كقدرات منتج من الدرجة الأولى"</b></summary>

تعرض العديد من بوابات الذكاء الاصطناعي MCP فقط كتفاصيل تنفيذ مخفية. تحتاج الفرق إلى طبقة تشغيل مرئية ويمكن التحكم فيها.

**كيف يحل OmniRoute المشكلة:**

- يظهر MCP في لوحة التحكم وعلامة تبويب بروتوكول نقطة النهاية
- صفحة إدارة MCP مخصصة تحتوي على العمليات والأدوات والنطاقات والتدقيق
- بداية سريعة مدمجة لـ `omniroute --mcp` وتأهيل العميل</details>

<التفاصيل>
<summary><b>🧠 18. "أحتاج إلى تنسيق A2A مع مسارات المهام المتزامنة والدفقية"</b></summary>

تحتاج مسارات عمل الوكيل إلى ردود مباشرة وتنفيذ متدفق طويل الأمد مع التحكم في دورة الحياة.

**كيف يحل OmniRoute المشكلة:**

- نقطة نهاية A2A JSON-RPC (`POST /a2a`) مع `message/send` و`message/stream`
- تدفق SSE مع انتشار الحالة الطرفية
- واجهات برمجة التطبيقات الخاصة بدورة حياة المهام لـ "المهام/الحصول" و"المهام/الإلغاء".</details>

<التفاصيل>
<summary><b>🛰️ 19. "أحتاج إلى صحة عملية MCP حقيقية، وليس حالة تخمينية"</b></summary>

تحتاج الفرق التشغيلية إلى معرفة ما إذا كان MCP حيًا بالفعل، وليس فقط ما إذا كان يمكن الوصول إلى واجهة برمجة التطبيقات (API).

**كيف يحل OmniRoute المشكلة:**

- ملف نبضات وقت التشغيل مع PID والطوابع الزمنية والنقل وعدد الأدوات ووضع النطاق
- واجهة برمجة تطبيقات حالة MCP التي تجمع بين نبضات القلب + النشاط الأخير
- بطاقات حالة واجهة المستخدم للعملية/وقت التشغيل/نضارة نبضات القلب</details>

<التفاصيل>
<summary><b>📋 20. "أحتاج إلى تنفيذ أداة MCP قابلة للتدقيق"</b></summary>

عندما تقوم الأدوات بتغيير التكوين أو تشغيل إجراءات العمليات، تحتاج الفرق إلى إمكانية التتبع الجنائي.

**كيف يحل OmniRoute المشكلة:**

- تسجيل التدقيق المدعوم من SQLite لاستدعاءات أداة MCP
- عوامل التصفية حسب الأداة، والنجاح/الفشل، ومفتاح API، وترقيم الصفحات
- جدول تدقيق لوحة المعلومات + إحصائيات نقاط النهاية للأتمتة</details>

<التفاصيل>
<summary><b>🔐 21. "أحتاج إلى أذونات MCP محددة لكل عملية تكامل"</b></summary>

يجب أن يتمتع العملاء المختلفون بإمكانية الوصول الأقل امتيازًا إلى فئات الأدوات.

**كيف يحل OmniRoute المشكلة:**

- 10 نطاقات MCP محببة للتحكم في الوصول إلى الأدوات
- إنفاذ النطاق والرؤية في واجهة مستخدم إدارة MCP
- الوضع الافتراضي الآمن للأدوات التشغيلية</details>

<التفاصيل>
<summary><b>⚙️ 22. "أحتاج إلى ضوابط تشغيلية دون إعادة الانتشار"</b></summary>

تحتاج الفرق إلى تغييرات سريعة في وقت التشغيل أثناء الحوادث أو أحداث التكلفة.

**كيف يحل OmniRoute المشكلة:**

- قم بتبديل تنشيط التحرير والسرد مباشرةً من لوحة معلومات MCP
- تطبيق ملفات تعريف المرونة من حزم السياسات المحددة مسبقًا
- إعادة ضبط حالة قاطع الدائرة من نفس لوحة العمليات</details>

<التفاصيل>
<summary><b>🔄 23. "أحتاج إلى رؤية وإلغاء مباشر لدورة حياة مهمة A2A"</b></summary>

وبدون رؤية دورة الحياة، يصبح من الصعب فرز حوادث المهام.

**كيف يحل OmniRoute المشكلة:**

- قائمة المهام/التصفية حسب الحالة/المهارة مع ترقيم الصفحات
- التعمق في البيانات الوصفية للمهمة، والأحداث، والتحف
- نقطة نهاية إلغاء المهمة وإجراء واجهة المستخدم مع التأكيد</details>

<التفاصيل>
<summary><b>🌊 24. "أحتاج إلى مقاييس تيار نشطة لتحميل A2A"</b></summary>

يتطلب تدفق سير العمل رؤية تشغيلية للتزامن والاتصالات المباشرة.

**كيف يحل OmniRoute المشكلة:**

- عدادات التدفق النشطة مدمجة في حالة A2A
- الطابع الزمني للمهمة الأخيرة وعدد كل ولاية
- بطاقات لوحة القيادة A2A لمراقبة العمليات في الوقت الفعلي</details>

<التفاصيل>
<summary><b>🪪 25. "أحتاج إلى اكتشاف وكيل قياسي للعملاء"</b></summary>

يحتاج العملاء والمنسقون الخارجيون إلى بيانات تعريف يمكن قراءتها آليًا من أجل الإعداد.

**كيف يحل OmniRoute المشكلة:**

- بطاقة الوكيل معروضة على `/.well-known/agent.json`
- القدرات والمهارات الموضحة في واجهة المستخدم الإدارية
- تتضمن واجهة برمجة التطبيقات لحالة A2A بيانات تعريف الاكتشاف للأتمتة</details>

<التفاصيل>
<summary><b>🧭 26. "أحتاج إلى إمكانية اكتشاف البروتوكول في تجربة المستخدم للمنتج"</b></summary>

إذا لم يتمكن المستخدمون من اكتشاف أسطح البروتوكول، فسوف ينخفض جودة الاعتماد والدعم.

**كيف يحل OmniRoute المشكلة:**

- صفحة**نقاط النهاية**الموحدة مع علامات تبويب Proxy وMCP وA2A وAPI Endpoints
- تبديل حالة الخدمة المضمنة (متصل/غير متصل) لـ MCP وA2A
- روابط من النظرة العامة إلى علامات تبويب الإدارة المخصصة</details>

<التفاصيل>
<summary><b>🧪 27. "أحتاج إلى التحقق من صحة البروتوكول الشامل مع عملاء حقيقيين"</b></summary>

الاختبارات الوهمية ليست كافية للتحقق من توافق البروتوكول قبل الإصدار.

**كيف يحل OmniRoute المشكلة:**

- مجموعة E2E التي تعمل على تشغيل التطبيق وتستخدم نقل عميل MCP SDK الحقيقي
- اختبارات عميل A2A لاكتشاف التدفقات وإرسالها ودفقها والحصول عليها وإلغائها
- التحقق من التأكيدات ضد تدقيق MCP وواجهات برمجة تطبيقات مهام A2A</details>

<التفاصيل>
<summary><b>📡 28. "أحتاج إلى إمكانية ملاحظة موحدة عبر جميع الواجهات"</b></summary>

يؤدي تقسيم إمكانية المراقبة حسب البروتوكول إلى إنشاء نقاط عمياء وMTTR أطول.

**كيف يحل OmniRoute المشكلة:**

- لوحات معلومات/سجلات/تحليلات موحدة في منتج واحد
- الصحة + التدقيق + طلب القياس عن بعد عبر طبقات OpenAI وMCP وA2A
- واجهات برمجة التطبيقات التشغيلية للحالة والأتمتة</details>

<التفاصيل>
<summary><b>💼 29. "أحتاج إلى وقت تشغيل واحد للوكيل + الأدوات + تنسيق الوكيل"</b></summary>

يؤدي تشغيل العديد من الخدمات المنفصلة إلى زيادة تكلفة التشغيل وأوضاع الفشل.

**كيف يحل OmniRoute المشكلة:**

- وكيل متوافق مع OpenAI وخادم MCP وخادم A2A في مكدس واحد
- المصادقة المشتركة والمرونة وتخزين البيانات وإمكانية الملاحظة
- نموذج سياسة متسق عبر جميع أسطح التفاعل</details>

<التفاصيل>
<summary><b>🚀 30. "أحتاج إلى إرسال مهام سير عمل الوكيل دون امتداد التعليمات البرمجية اللاصقة"</b></summary>

تفقد الفرق سرعتها عند دمج العديد من الخدمات والبرامج النصية المخصصة.

**كيف يحل OmniRoute المشكلة:**

- استراتيجية نقطة النهاية الموحدة للعملاء والوكلاء
- واجهات مستخدم لإدارة البروتوكول مدمجة ومسارات التحقق من صحة الدخان
- أسس جاهزة للإنتاج (الأمان، التسجيل، المرونة، النسخ الاحتياطي)</details>

### Example Playbooks (Integrated Use Cases)

**قواعد اللعبة أ: زيادة الاشتراك المدفوع إلى الحد الأقصى + نسخة احتياطية رخيصة**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

دليل التشغيل ب: مكدس البرمجة بدون تكلفة```txt Combo: "free-forever"

1. gc/gemini-3-flash
2. if/kimi-k2-thinking
3. qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow

**Playbook C: سلسلة احتياطية متاحة دائمًا على مدار 24 ساعة طوال أيام الأسبوع**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

قواعد اللعبة د: عمليات العميل مع MCP + A2A```txt

1. Start MCP transport (omniroute --mcp) for tool-driven operations
2. Run A2A tasks via message/send and message/stream
3. Observe via /dashboard/endpoint (MCP and A2A tabs)
4. Toggle services via inline status controls

---

## 🆓 Start Free — Zero Configuration Cost

> قم بإعداد ترميز الذكاء الاصطناعي في دقائق بسعر**$0/الشهر**. قم بتوصيل هذه الحسابات المجانية واستخدم المجموعة المدمجة**Free Stack**.

| خطوة | العمل | مقدمي الخدمات مقفلة |
| ---- | -------------------------------------------------- | ------------------------------------------------------------------ |
| 1 | الاتصال**Kiro**(معرف AWS Builder OAuth) | كلود سونيت 4.5، هايكو 4.5 —**غير محدود**|
| 2 | ربط**Qoder**(Google OAuth) | kimi-k2-thinking, qwen3-coder-plus, Deepseek-r1... —**غير محدود**|
| 3 | ربط**كوين**(رمز الجهاز) | qwen3-coder-plus، qwen3-coder-flash... —**غير محدود**|
| 4 | الاتصال**Gemini CLI**(Google OAuth) | gemini-3-flash,gemini-2.5-pro —**180 ألف/الشهر مجانًا**|
| 5 | `/dashboard/combos` →**قالب مكدس مجاني ($0)**| جولة روبن لجميع مقدمي الخدمات المجانية تلقائيًا |

**قم بتوجيه أي IDE/CLI إلى:**`http://localhost:20128/v1` · مفتاح API: `any-string` · تم.

>**تغطية إضافية اختيارية (مجانية أيضًا):**مفتاح Groq API (30 دورة في الدقيقة مجانًا)، NVIDIA NIM (40 دورة في الدقيقة مجانًا، أكثر من 70 طرازًا)، Cerebras (1 مليون tok/يوم)، مفتاح LongCat API (50 مليون رمز مميز/يوم!)، Cloudflare Workers AI (10 آلاف خلية عصبية/يوم، أكثر من 50 نموذجًا).## بداية سريعة

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**مستخدمي pnpm:**قم بتشغيل pnpmوافق-builds -g بعد التثبيت لتمكين البرامج النصية للبناء الأصلي المطلوبة من قبل better-sqlite3 و@swc/core:

تثبيت pnpm -g في كل الاتجاهات
pnpm Approved-builds -g # حدد جميع الحزم → الموافقة
الطريق الشامل

تفتح لوحة المعلومات على http://localhost:20128 ويكون عنوان URL الأساسي لواجهة برمجة التطبيقات هو http://localhost:20128/v1.

الأمر	الوصف
"الطريق الشامل"	بدء تشغيل الخادم (PORT=20128 وواجهة برمجة التطبيقات ولوحة المعلومات على نفس المنفذ)
الطريق الشامل --المنفذ 3000	اضبط منفذ Canonical/API على 3000
الطريق الشامل --mcp	بدء تشغيل خادم MCP (نقل stdio)
الطريق الشامل --no-open	لا تفتح المتصفح تلقائيًا
الطريق الشامل --مساعدة	عرض المساعدة

وضع المنفذ المقسم الاختياري:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

### Long-Running Streaming Timeouts

بالنسبة لمعظم عمليات النشر، تحتاج فقط إلى:

| متغير | الافتراضي | الغرض |
| ------------------------ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | `600000` | خط أساسي مشترك للجلب الأولي، ومهلات Undici المخفية، وطلبات بصمة TLS، ومهلة طلب/وكيل جسر واجهة برمجة التطبيقات |
| `STREAM_IDLE_TIMEOUT_MS` | يرث `REQUEST_TIMEOUT_MS` | الحد الأقصى للفجوة بين قطع الدفق قبل أن يقوم OmniRoute بإحباط دفق SSE |

يتم الحفاظ على التوافق مع الإصدارات السابقة: لا تزال متغيرات مهلة `FETCH_TIMEOUT_MS` وAPI_BRIDGE_PROXY_TIMEOUT_MS الموجودة ومتغيرات المهلة الأخرى لكل طبقة تعمل وتتجاوز الخط الأساسي المشترك.

تتوفر التجاوزات المتقدمة إذا كنت بحاجة إلى تحكم أفضل:| متغير | الافتراضي | الغرض |
| ---------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | يرث `REQUEST_TIMEOUT_MS` | إجمالي مهلة طلب المنبع المستخدمة بواسطة إشارة إحباط الجلب الرئيسية |
| `FETCH_HEADERS_TIMEOUT_MS` | يرث `FETCH_TIMEOUT_MS` | الحد الزمني لـ Undici لتلقي رؤوس الاستجابة الأولية |
| `FETCH_BODY_TIMEOUT_MS` | يرث `FETCH_TIMEOUT_MS` | الحد الزمني Undici بين قطع النص الأساسي (`0` يعطله) |
| `FETCH_CONNECT_TIMEOUT_MS` | `30000` | Undici TCP مهلة الاتصال |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Undici مهلة مأخذ التوصيل الخامل |
| `TLS_CLIENT_TIMEOUT_MS` | يرث `FETCH_TIMEOUT_MS` | انتهت المهلة لطلبات بصمة TLS التي تم إجراؤها من خلال `wreq-js` |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | يرث `REQUEST_TIMEOUT_MS` أو `30000` | انتهت المهلة لإعادة توجيه الوكيل `/v1` من منفذ API إلى منفذ لوحة المعلومات |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `الحد الأقصى (API_BRIDGE_PROXY_TIMEOUT_MS، 300000)` | انتهت مهلة الطلب الوارد على خادم جسر API |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | انتهت مهلة الرأس الوارد على خادم جسر API |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | مهلة البقاء على قيد الحياة على خادم جسر API |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | انتهت مهلة عدم نشاط مأخذ التوصيل على خادم جسر واجهة برمجة التطبيقات (`0` يعطله) |

إذا قمت بتشغيل OmniRoute خلف Nginx أو Caddy أو Cloudflare أو وكيل عكسي آخر، فتأكد من الوكيل
تعد المهلات أيضًا أعلى من مهلات البث/الجلب في OmniRoute.### 2) Connect providers and create your API key

1. افتح لوحة المعلومات → "الموفرون" وقم بتوصيل موفر واحد على الأقل (مفتاح OAuth أو API).
2. افتح لوحة المعلومات ← "نقاط النهاية" وأنشئ مفتاح واجهة برمجة التطبيقات.
3. (اختياري) افتح لوحة المعلومات → `المجموعات` وقم بتعيين السلسلة الاحتياطية.### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

يعمل مع Claude Code، وCodex CLI، وGemini CLI، وCursor، وCline، وOpenClaw، وOpenCode، وحزم SDK المتوافقة مع OpenAI.### 4) Enable and validate protocols (v2.0)

MCP (للعمليات التي تعتمد على الأدوات):```bash omniroute --mcp

ثم قم بتوصيل عميل MCP الخاص بك عبر أدوات "stdio" واختبار مثل:

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (لسير العمل من وكيل إلى وكيل):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

يتحقق هذا الجناح من تدفقات عميل MCP وA2A الحقيقية مقابل تطبيق قيد التشغيل.### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

<التفاصيل>

إبطال Linux (قالب `xbps-src`)

بالنسبة لمستخدمي Void Linux، يمكنك إنشاء حزمة أصلية باستخدام xbps-src. احفظ هذه الكتلة باسم srcpkgs/omniroute/template:```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }

</details>

---

## 🐳 Docker

OmniRoute متاح كصورة Docker عامة على [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).

**الجري السريع:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

مع ملف البيئة:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest

**استخدام Docker Compose:**```bash
# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

يتضمن دعم لوحة المعلومات لعمليات نشر Docker الآن نقرة واحدةCloudflare Quick Tunnelعلى Dashboard → Endpoints. يقوم الأول بتمكين التنزيلات cloudflared فقط عند الحاجة، ويبدأ نفقًا مؤقتًا إلى نقطة النهاية /v1 الحالية، ويعرض عنوان URL الذي تم إنشاؤه https://*.trycloudflare.com/v1 مباشرةً أسفل عنوان URL العام العادي.

ملاحظات:

• عناوين URL للنفق السريع مؤقتة وتتغير بعد كل إعادة تشغيل.
• لا تتم استعادة الأنفاق السريعة تلقائيًا بعد إعادة تشغيل OmniRoute أو الحاوية. أعد تمكينها من لوحة التحكم عند الحاجة.
• التثبيت المُدار يدعم حاليًا Linux وmacOS وWindows على x64 / arm64.
• الأنفاق السريعة المُدارة هي النقل الافتراضي عبر HTTP/2 لتجنب تحذيرات المخزن المؤقت QUIC UDP المزعجة في بيئات الحاويات المقيدة. قم بتعيين CLOUDFLARED_PROTOCOL=quic أو auto إذا كنت تريد وسيلة نقل مختلفة.
• تقوم صور Docker بتجميع جذور CA للنظام وتمريرها إلى cloudflared المُدارة، مما يتجنب فشل ثقة TLS عندما يبدأ النفق داخل الحاوية.
• يعمل SQLite في وضع WAL. يجب السماح لـ "docker stop" بالانتهاء حتى يتمكن OmniRoute من التحقق من أحدث التغييرات مرة أخرى في "storage.sqlite".
• قامت ملفات الإنشاء المجمعة بالفعل بتعيين فترة سماح للتوقف مدتها 40 ثانية. إذا قمت بتشغيل الصورة مباشرة، فاحتفظ بـ --stop-timeout 40 (أو ما شابه) حتى لا تؤدي عمليات الإيقاف اليدوية إلى قطع عملية تنظيف إيقاف التشغيل.
• قم بتعيين CLOUDFLARED_BIN=/absolute/path/to/cloudflared إذا كنت تريد أن يستخدم OmniRoute ملفًا ثنائيًا موجودًا بدلاً من تنزيله.

استخدام Docker Compose مع Caddy (HTTPS Auto-TLS):

يمكن كشف OmniRoute بشكل آمن باستخدام توفير SSL التلقائي من Caddy. تأكد من أن سجل DNS A الخاص بنطاقك يشير إلى عنوان IP الخاص بخادمك.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:

| صورة | العلامة | الحجم | الوصف |
| ------------------------ | -------- | ------ | --------------------- |
| `diegosouzapw/omniroute` | `الأحدث` | ~250 ميجابايت | أحدث إصدار مستقر |
| `diegosouzapw/omniroute` | `1.0.3` | ~250 ميجابايت | النسخة الحالية |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**جديد!**OmniRoute متوفر الآن كتطبيق سطح مكتب أصلي**لأنظمة التشغيل Windows وmacOS وLinux.

قم بتشغيل OmniRoute كتطبيق مستقل لسطح المكتب - لا توجد محطة طرفية أو متصفح أو إنترنت مطلوب للطرز المحلية. يتضمن التطبيق المعتمد على Electron ما يلي:

- 🖥️**النافذة الأصلية**— نافذة تطبيق مخصصة مع تكامل علبة النظام
- 🔄**البدء التلقائي**— قم بتشغيل OmniRoute عند تسجيل الدخول إلى النظام
- 🔔**الإشعارات الأصلية**— احصل على تنبيهات بشأن استنفاد الحصص أو مشكلات المزود
- ⚡**التثبيت بنقرة واحدة**— NSIS (Windows)، DMG (macOS)، AppImage (Linux)
- 🌐**وضع عدم الاتصال بالإنترنت**— يعمل بشكل كامل دون اتصال بالإنترنت مع الخادم المُجمَّع### بداية سريعة

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

عند تصغيره، يظل OmniRoute موجودًا في علبة النظام لديك من خلال الإجراءات السريعة:

• فتح لوحة القيادة
• تغيير منفذ الخادم
• قم بإنهاء التطبيق

📖 التوثيق الكامل: electron/README.md---

💰 Pricing at a Glance

الطبقة	مقدم	التكلفة	إعادة ضبط الحصص	الأفضل لـ
💳الإشتراك	كلود كود (برو)	20 دولارًا شهريًا	5 ساعات + أسبوعي	اشتركت بالفعل
	الدستور الغذائي (زائد / برو)	20-200 دولار شهريًا	5 ساعات + أسبوعي	مستخدمي OpenAI
	الجوزاء CLI	مجاني	180 ألف/شهر + 1 ألف/يوم	الجميع!
	جيثب مساعد الطيار	10-19 دولارًا شهريًا	شهري	مستخدمي جيثب
🔑 مفتاح واجهة برمجة التطبيقات	نفيديا نيم	مجانًا(مطور للأبد)	~40 دورة في الدقيقة	70+ نماذج مفتوحة
	المخيخ	مجانًا(1 مليون توك/يوم)	60 ألف دورة في الدقيقة / 30 دورة في الدقيقة	الأسرع في العالم
	جروك	مجانًا(30 دورة في الدقيقة)	14.4K دورة في الدقيقة	لاما/جيما فائقة السرعة
	ديب سيك V3.2	0.27 دولار/1.10 دولار لكل مليون	لا شيء	أفضل منطق السعر/الجودة
	xAI Grok-4 سريع	0.20 دولار/0.50 دولار لكل مليون🆕	لا شيء	أسرع + أداة استدعاء، منخفضة للغاية
	xAI Grok-4 (قياسي)	0.20 دولار/1.50 دولار لكل مليون 🆕	لا شيء	المنطق الرائد من xAI
	ميسترال	تجربة مجانية + مدفوعة	معدل محدود	الذكاء الاصطناعي الأوروبي
	اوبن راوتر	الدفع لكل استخدام	لا شيء	100+ نماذج مجمعة.
💰 رخيص	GLM-5 (عبر Z.AI) 🆕	0.5 دولار/1 مليون	يوميا 10 صباحا	إخراج 128 كيلو، أحدث الرائد
	جي إل إم-4.7	0.6 دولار/1 مليون	يوميا 10 صباحا	نسخة احتياطية للميزانية
	ميني ماكس M2.5 🆕	إدخال 0.3 دولار/1 مليون	المتداول لمدة 5 ساعات	الاستدلال + المهام الوكيلة
	ميني ماكس M2.1	0.2 دولار/1 مليون	المتداول لمدة 5 ساعات	الخيار الأرخص
	كيمي K2.5 (Moonshot API) 🆕	الدفع لكل استخدام	لا شيء	الوصول المباشر إلى Moonshot API
	كيمي ك2	9 دولارات شهريًا مسطحة	10 مليون رمز/شهر	التكلفة المتوقعة
🆓مجانًا	قدير	$0	غير محدود	5 نماذج غير محدودة
	كوين	$0	غير محدود	4 نماذج غير محدودة
	كيرو	$0	غير محدود	كلود سونيت/هايكو (AWS Builder)
	LongCat Flash-Lite 🆕	$0(50 مليون توك/يوم 🔥)	1 دورة في الثانية	أكبر حصة مجانية على وجه الأرض
	التلقيحات AI 🆕	$0(لا حاجة لمفتاح)	1 متطلب/15 ثانية	جي بي تي-5، كلود، ديب سيك، لاما 4
	Cloudflare Workers AI 🆕	$0(10 آلاف خلية عصبية/اليوم)	~150 راحة/يوم	أكثر من 50 نموذجًا، حافة عالمية
	سكيليواي AI 🆕	$0(إجمالي 1 مليون رمز)	معدل محدود	الاتحاد الأوروبي/اللائحة العامة لحماية البيانات، Qwen3 235B، Llama 70B	> 🆕**تمت إضافة نماذج جديدة (مارس 2026):**عائلة Grok-4 Fast بسعر 0.20 دولار أمريكي/0.50 دولار أمريكي/م (تم قياسها عند 1143 مللي ثانية - أسرع بنسبة 30% من Gemini 2.5 Flash)، GLM-5 عبر Z.AI بإخراج 128 ألف، واستدلال MiniMax M2.5، وتسعير DeepSeek V3.2 المحدث، وKimi K2.5 عبر Moonshot direct API.

💡 $0 Combo Stack — الإعداد المجاني الكامل:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day

**تكلفة صفر. لا تتوقف أبدًا عن البرمجة.**قم بتكوين هذا كمجموعة واحدة من OmniRoute وستحدث جميع الإجراءات الاحتياطية تلقائيًا - لا يوجد تبديل يدوي على الإطلاق.---

---

## 🆓 Free Models — What You Actually Get

> جميع الموديلات أدناه**مجانية بنسبة 100% ولا تتطلب أي بطاقة ائتمان**. يقوم OmniRoute بالمسارات التلقائية بينهما عند نفاد حصة واحدة - اجمعها جميعًا للحصول على مجموعة غير قابلة للكسر بقيمة 0 دولار.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| نموذج | البادئة | الحد | حد السعر |
| ------------------- | ------ | ------------- | --------------------- |
| `كلود-السوناتة-4.5` | `كر/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى اليومي |
| `كلود-هايكو-4.5` | `كر/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى اليومي |
| `كلود-أوبوس-4.6` | `كر/` |**غير محدود**| أحدث أعمال أوبوس عبر كيرو |### 🟢 QODER MODELS (Free PAT via qodercli)

| نموذج | البادئة | الحد | حد السعر |
| ------------------ | ------ | ------------- | --------------- |
| `تفكير كيمي-ك2` | `إذا/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `qwen3-coder-plus` | `إذا/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `ديبسيك-R1` | `إذا/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `مينيماكس-m2.1` | `إذا/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `كيمي-k2` | `إذا/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |

> طريقة الاتصال الموصى بها:**رمز الوصول الشخصي + `qodercli`**. متصفح OAuth هو
> تجريبي ومعطل افتراضيًا ما لم يتم تكوين متغيرات البيئة `QODER_OAUTH_*`.### 🟡 QWEN MODELS (Device Code Auth)

| نموذج | البادئة | الحد | حد السعر |
| ------------------- | ------ | ------------- | ------------------- |
| `qwen3-coder-plus` | `س/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `qwen3-coder-flash` | `س/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `qwen3-coder-next` | `س/` |**غير محدود**| لم يتم الإبلاغ عن الحد الأقصى |
| `نموذج الرؤية` | `س/` |**غير محدود**| الوسائط المتعددة (صور) |### 🟣 GEMINI CLI (Google OAuth)

| نموذج | البادئة | الحد | حد السعر |
| ------------------------ | ------ | --------------------------- | ------------- |
| `الجوزاء-3-معاينة فلاش` | `جي سي/` |**180 ألف توك/شهر**+ 1 ألف/يوم | إعادة الضبط الشهرية |
| `الجوزاء-2.5-برو` | `جي سي/` | 180 ألف/شهر (مسبح مشترك) | جودة عالية |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| الطبقة | الحد اليومي | حد السعر | ملاحظات |
| ---------- | ------------ | ----------- | ------------------------------------------------------ |
| مجاني (ديف) | لا يوجد غطاء رمزي |**~40 دورة في الدقيقة**| أكثر من 70 نموذجًا؛ الانتقال إلى حدود المعدل النقي منتصف عام 2025 |

النماذج المجانية المشهورة: `moonshotai/kimi-k2.5` (Kimi K2.5)، `z-ai/glm4.7` (GLM 4.7)، `deepseek-ai/deepseek-v3.2` (DeepSeek V3.2)، `nvidia/llama-3.3-70b-instruct`، `deepseek/deepseek-r1`### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| الطبقة | الحد اليومي | حد السعر | ملاحظات |
| ---- | ----------------- | ---------------- | ------------------------------------------- |
| مجاني |**1 مليون قطعة/يوم**| 60 ألف دورة في الدقيقة / 30 دورة في الدقيقة | أسرع استنتاج LLM في العالم؛ يعيد يوميا |

متاح مجانًا: `llama-3.3-70b`، `llama-3.1-8b`، `deepseek-r1-distill-llama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

| الطبقة | الحد اليومي | حد السعر | ملاحظات |
| ---- | ------------- | ---------------- | ----------------------------------------- |
| مجاني |**14.4 كيلو دورة في الدقيقة**| 30 دورة في الدقيقة لكل موديل | لا توجد بطاقة ائتمان؛ 429 على الحد، غير مشحونة |

متاحة مجانًا: `llama-3.3-70b-versatile`، `gemma2-9b-it`، `mixtral-8x7b`، `whisper-large-v3`### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| نموذج | البادئة | الحصة اليومية المجانية | ملاحظات |
| ----------------------------- | ------ | ----------------- | ----------------------- |
| `لونجكات-فلاش-لايت` | `لك/` |**50 مليون رمز**💥 | أكبر حصة مجانية على الإطلاق |
| `LongCat-Flash-Chat` | `لك/` | 500 ألف رمز | دردشة متعددة المنعطفات |
| ``التفكير الخاطف الطويل`` | `لك/` | 500 ألف رمز | الاستدلال / CoT |
| `لونجكات-فلاش-التفكير-2601` | `لك/` | 500 ألف رمز | نسخة يناير 2026 |
| `لونج كات-فلاش-أومني-2603` | `لك/` | 500 ألف رمز | الوسائط المتعددة |

> مجاني 100% أثناء وجودك في النسخة التجريبية العامة. قم بالتسجيل في [longcat.chat](https://longcat.chat) باستخدام البريد الإلكتروني أو الهاتف. تتم إعادة الضبط يوميًا في تمام الساعة 00:00 بالتوقيت العالمي المنسق.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| نموذج | البادئة | حد السعر | مقدم خلف |
| ---------- | ------ | ---------- | ------------------ |
| `أوبيني` | `بول/` | 1 متطلب/15 ثانية | جي بي تي-5 |
| "كلود" | `بول/` | 1 متطلب/15 ثانية | أنثروبي كلود |
| `الجوزاء` | `بول/` | 1 متطلب/15 ثانية | جوجل الجوزاء |
| `البحث العميق` | `بول/` | 1 متطلب/15 ثانية | ديب سيك V3 |
| اللاما | `بول/` | 1 متطلب/15 ثانية | ميتا لاما 4 كشاف |
| `ميسترال` | `بول/` | 1 متطلب/15 ثانية | ميسترال لمنظمة العفو الدولية |

> ✨**بدون احتكاك:**لا يوجد اشتراك، ولا يوجد مفتاح API. أضف موفر التلقيح بحقل مفتاح فارغ وسيعمل على الفور.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| الطبقة | الخلايا العصبية اليومية | الاستخدام المعادل | ملاحظات |
| ---- | ------------- | --------------------------------------- | ----------------------- |
| مجاني |**10,000**| ~150 LLM resp / 500 ثانية صوت / 15 ألف تضمين | الحافة العالمية، أكثر من 50 نموذجًا |

النماذج المجانية الشهيرة: `@cf/meta/llama-3.3-70b-instruct`، `@cf/google/gemma-3-12b-it`، `@cf/openai/whisper-large-v3-turbo` (صوت مجاني!)، `@cf/qwen/qwen2.5-coder-15b-instruct`

> يتطلب رمز API المميز + معرف الحساب من [dash.cloudflare.com](https://dash.cloudflare.com). قم بتخزين معرف الحساب في إعدادات الموفر.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| الطبقة | حصة مجانية | الموقع | ملاحظات |
| ---- | ------------- | ------------ | ----------------------------------- |
| مجاني |**مليون قطعة**| 🇫🇷 باريس، الاتحاد الأوروبي | لا حاجة لبطاقة الائتمان ضمن الحدود |

متاح مجانًا: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!)

> متوافقة مع الاتحاد الأوروبي/اللائحة العامة لحماية البيانات. احصل على مفتاح واجهة برمجة التطبيقات على [console.scaleway.com](https://console.scaleway.com).

>**💡 المجموعة المجانية المطلقة (11 مقدمًا، 0 دولار للأبد):**
>
> ```
> كيرو (kr/) → كلود سونيت/هايكو غير محدود
> Qoder (if/) → kimi-k2-thinking، qwen3-coder-plus، Deepseek-r1 غير محدود
> LongCat Lite (lc/) → LongCat-Flash-Lite — 50 مليون رمز/يوم 🔥
> التلقيح (pol/) → GPT-5، Claude، DeepSeek، Llama 4 - لا حاجة إلى مفتاح
> Qwen (qw/) → نماذج qwen3-coder غير محدودة
> Gemini (gemini/) → Gemini 2.5 Flash — 1500 طلب/يوم مجانًا
> Cloudflare AI (cf/) → أكثر من 50 نموذجًا - 10 آلاف خلية عصبية/اليوم
> Scaleway (scw/) → Qwen3 235B، Llama 70B — مليون رمز مجاني (الاتحاد الأوروبي)
> Groq (groq/) → Llama/Gemma — 14.4 ألف طلب/يوم بسرعة فائقة
> NVIDIA NIM (nvidia/) → أكثر من 70 طرازًا مفتوحًا - 40 دورة في الدقيقة إلى الأبد
> المخيخ (cerebras/) → اللاما/كوين الأسرع في العالم — مليون توك/اليوم
> ```## 🎙️ Free Transcription Combo

> قم بنسخ أي صوت/فيديو مقابل**$0**— تقدم Deepgram مبلغًا مجانيًا بقيمة 200 دولار أمريكي، ونسخة احتياطية من AssemblyAI بقيمة 50 دولارًا أمريكيًا، وGroq Whisper كنسخة احتياطية غير محدودة للطوارئ.

| مقدم | اعتمادات مجانية | أفضل موديل | حد السعر |
| ----------------- | ---------------------- | -------------------------------------------- | ---------------------------- |
| 🟢**ديبجرام**|**200 دولار مجانًا**(اشتراك) | `nova-3` — أفضل دقة، أكثر من 30 لغة | لا يوجد حد لعدد RPM على الاعتمادات المجانية |
| 🔵**AssemblyAI**|**50 دولارًا مجانًا**(اشتراك) | `universal-3-pro` - الفصول، المشاعر، معلومات تحديد الهوية الشخصية | لا يوجد حد لعدد RPM على الاعتمادات المجانية |
| 🔴**جروق**|**مجاني للأبد**| `whisper-large-v3` — OpenAI Whisper | 30 دورة في الدقيقة (معدل محدود) |

**التحرير والسرد المقترح في `/dashboard/combos`:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

ثم في /dashboard/media → علامة التبويبTranscription: قم بتحميل أي ملف صوت أو فيديو ← حدد نقطة نهاية التحرير والسرد الخاصة بك ← احصل على النسخ بتنسيقات مدعومة.## 💡 Key Features

تم تصميم OmniRoute v2.0 كمنصة تشغيلية، وليس مجرد وكيل ترحيل.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

ميزة	ماذا يفعل
⚡Grok-4 Fast Family	طرازات xAI بسعر 0.20 دولارًا أمريكيًا/0.50 دولارًا أمريكيًا للمتر المربع - تم قياسها بـ 1143 مللي ثانية (أسرع بنسبة 30% من Gemini 2.5 Flash)
🧠GLM-5 عبر Z.AI	سياق إخراج 128 ألفًا، 0.5 دولار أمريكي/1 مليون — أحدث منتج رئيسي من عائلة GLM
🔮ميني ماكس M2.5	الاستدلال + المهام الوكيلة بسعر 0.30 دولارًا أمريكيًا/مليون واحد — ترقية كبيرة من M2.1
🎯أداة استدعاء العلم لكل نموذج	لكل نموذج toolCalling: true/false في التسجيل - يتخطى AutoCombo النماذج التي لا تحتوي على أدوات
🌍كشف النوايا المتعددة اللغات	الكلمات الأساسية PT/ZH/ES/AR في تسجيل AutoCombo — اختيار نموذج أفضل للمحتوى غير الإنجليزي
📊الإجراءات الاحتياطية المستندة إلى المعايير	زمن استجابة حقيقي p95 من الطلبات المباشرة يغذي تسجيل التحرير والسرد - يتعلم AutoCombo من البيانات الفعلية
🔁طلب إلغاء البيانات المكررة	نافذة إلغاء البيانات المستندة إلى تجزئة المحتوى — آمنة متعددة الوكلاء، وتمنع الرسوم المكررة
🔌استراتيجية جهاز التوجيه القابل للتوصيل	واجهة "RouterStrategy" القابلة للتوسيع - أضف منطق توجيه مخصص كمكونات إضافية	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

ميزة	ماذا يفعل
🎮ساحة اللعب النموذجية	صفحة لوحة التحكم لاختبار أي نموذج مباشرة - محددات الموفر/النموذج/نقطة النهاية، محرر موناكو، البث، الإجهاض، التوقيت
🔏مطابقة بصمة CLI	ترتيب الرأس/النص لكل موفر لمطابقة توقيعات CLI الأصلية - قم بالتبديل لكل موفر في الإعدادات > الأمان.يتم الاحتفاظ بـ IP الوكيل الخاص بك
🤝دعم ACP (بروتوكول العميل الوكيل)	اكتشاف وكيل CLI (Codex، Claude، Goose، Gemini CLI، OpenClaw + 9 آخرين)، مولد العمليات، /api/acp/agents نقطة النهاية
🤖لوحة تحكم وكلاء ACP	التصحيح › صفحة الوكلاء - شبكة مكونة من 14 وكيلًا مع حالة التثبيت والإصدار ونموذج الوكيل المخصص لأي أداة CLI. يحصل مستخدموOpenCodeعلى زر "تنزيل opencode.json" الذي يقوم تلقائيًا بإنشاء تكوين جاهز للاستخدام مع جميع الطرز المتاحة.
🔧توجيه نموذج مخصص apiFormat	النماذج المخصصة ذات apiFormat: "responses" توجه الآن بشكل صحيح إلى مترجم Responses API
🏢عزل مساحة عمل الدستور الغذائي	مساحات عمل Codex متعددة لكل بريد إلكتروني - يفصل OAuth الاتصالات بشكل صحيح عن طريق معرف مساحة العمل
🔄التحديث التلقائي الإلكتروني	يتحقق تطبيق سطح المكتب من التحديثات + التثبيت التلقائي عند إعادة التشغيل	### 🤖 Agent & Protocol Operations (v2.0)

ميزة	ماذا يفعل
🔧خادم MCP (25 أداة)	أدوات IDE/agent عبر 3 وسائل نقل: stdio، وSSE (/api/mcp/sse)، وHTTP القابل للتدفق (/api/mcp/stream). 18 نواة + 3 ذاكرة + 4 أدوات مهارات
🤝خادم A2A (JSON-RPC + SSE)	تنفيذ المهام من وكيل إلى وكيل مع تدفقات المزامنة والتدفق
🧭صفحة نقاط النهاية الموحدة	صفحة إدارة مبوبة مع علامات تبويب Endpoint Proxy وMCP وA2A وAPI Endpoints
🎚️تبديل تمكين / تعطيل الخدمة	مفاتيح التشغيل/الإيقاف لـ MCP وA2A مع ثبات الإعدادات (الافتراضي: OFF)
🛰️نبضات وقت تشغيل MCP	حالة العملية الحقيقية (معرف المنتج، وقت التشغيل، عمر نبضات القلب، النقل، وضع النطاق)
📋مسار تدقيق MCP	سجلات التدقيق القابلة للتصفية مع النجاح/الفشل والإسناد الرئيسي
🔐تنفيذ نطاق MCP	10 أذونات نطاق تفصيلية للوصول إلى الأدوات الخاضعة للرقابة
📡إدارة دورة حياة المهام A2A	قائمة/تصفية المهام، فحص الأحداث/التحف، إلغاء المهام قيد التشغيل
📋اكتشاف بطاقة الوكيل	/.well-known/agent.json للاكتشاف التلقائي للعميل
🧪أداة اختبار البروتوكول E2E	يتدفق عميل MCP SDK + A2A الحقيقي في "اختبار: البروتوكولات: e2e"
⚙️ضوابط التشغيل	مجموعة التبديل، وتطبيق ملفات تعريف المرونة، وإعادة ضبط القواطع من سطح تحكم واحد	### 🧠 Routing & Intelligence

ميزة	ماذا يفعل
🎯احتياطي ذكي من 4 طبقات	المسار التلقائي: الاشتراك → مفتاح API → رخيص → مجاني
📊تتبع الحصص في الوقت الفعلي	عدد الرموز الحية + إعادة تعيين العد التنازلي لكل مزود
🔄تنسيق الترجمة	OpenAI ↔ Claude ↔ Gemini ↔ الردود مع التحويلات الآمنة للمخطط
👥دعم الحسابات المتعددة	حسابات متعددة لكل مزود مع اختيار ذكي
🔄تحديث تلقائي للرمز	يتم تحديث رموز OAuth المميزة تلقائيًا من خلال إعادة المحاولة
🎨مجموعات مخصصة	9 استراتيجيات موازنة + التحكم في السلسلة الاحتياطية
🌐جهاز توجيه Wildcard	المزود/* التوجيه الديناميكي
🧠التفكير في ضوابط الميزانية	حدود التفكير المنطقي والتلقائي والمخصص والتكيفي
🔀الأسماء المستعارة للنماذج	مدمج + اسم مستعار للنموذج المخصص وأمان الترحيل
⚡تدهور الخلفية	قم بتوجيه مهام الخلفية ذات الأولوية المنخفضة إلى نماذج أرخص
🧪التوجيه الذكي المدرك للمهام	تحديد النموذج تلقائيًا حسب نوع المحتوى (الترميز/الرؤية/التحليل/التلخيص)
🔄سير عمل وكيل A2A	منسق ولايات ميكرونيزيا الموحدة الحتمية لعمليات إعدام الوكيل متعددة الخطوات
🔀التوجيه التكيفي	تجاوز الإستراتيجية الديناميكية بناءً على حجم الرمز المميز والتعقيد الفوري
🎲تنوع مقدمي الخدمة	شانون الإنتروبيا التهديف موازنة توزيع حركة المرور والسرد التلقائي
💬الحقن الفوري للنظام	يتم تطبيق ضوابط السلوك العالمية بشكل متسق
📄توافق واجهة برمجة التطبيقات للردود	الدعم الكامل /v1/responses لـ Codex وسير العمل الوكيل المتقدم	### 🎵 Multi-Modal APIs

ميزة	ماذا يفعل
🖼️إنشاء الصور	/v1/images/ Generations مع الواجهات الخلفية السحابية والمحلية
📐المضامين	/v1/embeddings لخطوط أنابيب البحث وRAG
🎤نسخ صوتي	/v1/audio/transcriptions - 7 مقدمي خدمات (Deepgram Nova 3، AssemblyAI، Groq Whisper، HuggingFace، ElevenLabs، OpenAI، Azure)، الكشف التلقائي عن اللغة، دعم MP4/MP3/WAV
🔊تحويل النص إلى كلام	/v1/audio/speech - 10 مقدمي خدمات (ElevenLabs، OpenAI، Deepgram، Cartesia، PlayHT، HuggingFace، Nvidia NIM، Inworld، Coqui، Tortoise) مع رسائل الخطأ الصحيحة
🎬توليد الفيديو	/v1/videos/أجيال (سير عمل ComfyUI + SD WebUI)
🎵جيل الموسيقى	/v1/music/generations (سير عمل ComfyUI)
🛡️اعتدالات	/v1/moderations فحوصات السلامة
🔀إعادة الترتيب	/v1/rerank لدرجات الملاءمة
🔍بحث الويب🆕	/v1/search - 5 مقدمي خدمات (Serper، Brave، Perplexity، Exa، Tavily)، أكثر من 6500 خدمة مجانية شهريًا، تجاوز الفشل التلقائي، ذاكرة التخزين المؤقت	### 🛡️ Resilience, Security & Governance

ميزة	ماذا يفعل
🔌قواطع الدائرة	رحلة/استرداد لكل نموذج مع عناصر التحكم في العتبة
🎯نماذج تدرك نقطة النهاية	تعلن النماذج المخصصة عن نقاط النهاية المدعومة + تنسيق API
🛡️القطيع المضاد للرعد	حماية Mutex + الإشارة في أحداث إعادة المحاولة/التقييم
🧠ذاكرة التخزين المؤقت الدلالية + التوقيع	تقليل التكلفة/زمن الوصول باستخدام طبقتين من ذاكرة التخزين المؤقت
⚡طلب العجز	نافذة الحماية المكررة
🔒انتحال بصمة الإصبع TLS	بصمة TLS الشبيهة بالمتصفح -تقلل من اكتشاف الروبوتات ووضع علامة على الحساب
🔏مطابقة بصمة CLI	يطابق توقيعات طلب واجهة سطر الأوامر (CLI) الأصلية -يقلل من مخاطر الحظر مع الحفاظ على عنوان IP الخاص بالوكيل
🌐تصفية IP	التحكم في القائمة المسموح بها/القائمة المحظورة لعمليات النشر المكشوفة
📊حدود المعدل القابلة للتحرير	حدود عالمية/مستوى مزود قابلة للتكوين مع الثبات
📉التحلل الرشيق	قدرات احتياطية متعددة الطبقات تحمي عمليات البوابة الأساسية
📜مسار تدقيق التكوين	تتبع التغيير القائم على الاختلاف يمنع الانحراف التشغيلي من خلال عمليات التراجع البسيطة
⏳مزامنة صحة الموفر	مراقبة استباقية لانتهاء صلاحية الرمز المميز، مما يؤدي إلى تنبيهات قبل فشل التفويض
🚪تعطيل الحسابات المحظورة تلقائيًا	يقوم قاطع الدائرة التشغيلية بإغلاق حسابات الرموز المميزة المحظورة بشكل دائم تلقائيًا
🔑إدارة مفاتيح واجهة برمجة التطبيقات + تحديد النطاق	تأمين إصدار/تدوير المفتاح وضوابط النموذج/المزود
👁️الكشف عن مفتاح واجهة برمجة التطبيقات (Scoped API)🆕	الاشتراك في استرداد مفاتيح واجهة برمجة التطبيقات عبر ALLOW_API_KEY_REVEAL
🛡️محميه /موديلات	بوابة مصادقة اختيارية وإخفاء الموفر لكتالوج النماذج	### 📊 Observability & Analytics

ميزة	ماذا يفعل
📝الطلب + تسجيل الوكيل	الطلب/الاستجابة الكاملة وتسجيل الوكيل
📉السجلات التفصيلية المتدفقة🆕	يعيد بناء تدفقات حمولة SSE بشكل واضح في واجهة المستخدم
📋لوحة تحكم السجلات الموحدة	طلب العروض والوكيل والتدقيق ووحدة التحكم في صفحة واحدة
🔍طلب القياس عن بعد	زمن الاستجابة p50/p95/p99 وطلب التتبع
🏥لوحة المعلومات الصحية	وقت التشغيل، حالات الكسارة، عمليات الإغلاق، إحصائيات ذاكرة التخزين المؤقت
💰تتبع التكلفة	ضوابط الميزانية ورؤية التسعير لكل نموذج
📈تصورات التحليلات	رؤى استخدام النموذج/الموفر وطرق عرض الاتجاه
🧪إطار التقييم	اختبار المجموعة الذهبية مع استراتيجيات المطابقة القابلة للتكوين
📡تشخيص مباشر🆕	تجاوز ذاكرة التخزين المؤقت الدلالية لإجراء اختبار مباشر دقيق للسرد	### ☁️ Deployment & Platform

ميزة	ماذا يفعل
🌐النشر في أي مكان	المضيف المحلي، VPS، Docker، البيئات السحابية
🚇نفق كلاود فلير🆕	تكامل النفق السريع بنقرة واحدة من لوحة المعلومات
🔑تصفية نموذج مفتاح واجهة برمجة التطبيقات	تمت تصفية الاستجابة الأصلية /v1/models عبر أدوار سياق الحامل المعينة
⚡تجاوز ذاكرة التخزين المؤقت الذكية	استدلالات TTL قابلة للتكوين وضوابط إعادة الجلب القسري
🔄النسخ الاحتياطي/الاستعادة	تدفقات التصدير/الاستيراد والتعافي من الكوارث
🧙معالج الإعداد	الإعداد الموجه لأول مرة
🔧لوحة تحكم أدوات CLI	إعداد بنقرة واحدة لأدوات الترميز الشائعة
🎮ساحة اللعب النموذجية	اختبر أي موفر/نموذج/نقطة نهاية من لوحة المعلومات
🔏تبديل بصمة الإصبع CLI	مطابقة بصمات الأصابع لكل موفر في الإعدادات > الأمان
🌐i18n (30 لغة)	لوحة تحكم كاملة + دعم لغة المستندات مع تغطية RTL
🧹مسح كافة النماذج	مسح قائمة النماذج بنقرة واحدة في تفاصيل المزود
👁️عناصر التحكم في الشريط الجانبي🆕	إخفاء المكونات وعمليات التكامل من إعدادات المظهر
📋نماذج الإصدارات	قوالب GitHub الموحدة للأخطاء والميزات
📂دليل البيانات المخصصة	تجاوز DATA_DIR لموقع التخزين	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

عند فشل الحصة أو المعدل أو الصحة، ينتقل OmniRoute تلقائيًا إلى المرشح التالي دون التبديل اليدوي.#### Protocol management that is visible and operable

• يمكن اكتشاف MCP + A2A في واجهة المستخدم والمستندات (غير مخفية)
• تعرض واجهات برمجة التطبيقات لحالة البروتوكول البيانات التشغيلية المباشرة (/api/mcp/*، /api/a2a/*)
• تتضمن لوحات المعلومات إجراءات لعمليات اليوم الثاني (تبديل التحرير والسرد، وإعادة ضبط الكسارة، وإلغاء المهام)#### Translator + validation workflow

منطقة المترجم تشمل:

-الملعب: طلب عمليات التحقق من التحويل -أداة اختبار الدردشة: الطلب/الإجابة الكاملة ذهابًا وإيابًا -منصة الاختبار: حالات متعددة في جولة واحدة -المراقبة المباشرة: عرض حركة المرور في الوقت الحقيقي

بالإضافة إلى التحقق من صحة البروتوكول مع عملاء حقيقيين عبر اختبار تشغيل npm:البروتوكولات:e2e.

📖MCP Server README— مرجع الأداة، وتكوينات IDE، وأمثلة العميل

📖A2A Server README— المهارات، وأساليب JSON-RPC، والبث، ودورة حياة المهمة## 🧪 Evaluations (Evals)

يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبرAnalytics → Evalsفي لوحة التحكم.### Built-in Golden Set

تحتوي "OmniRoute Golden Set" المحملة مسبقًا على حالات اختبار لما يلي:

• تحياتي، الرياضيات، الجغرافيا، توليد التعليمات البرمجية
• الامتثال لتنسيق JSON والترجمة وإنشاء تخفيض السعر
• رفض السلامة (المحتوى الضار)، العد، المنطق المنطقي### Evaluation Strategies

استراتيجية	الوصف	مثال
بالضبط	يجب أن يتطابق الإخراج تمامًا مع	"4"
يحتوي على	يجب أن يحتوي الإخراج على سلسلة فرعية (غير حساسة لحالة الأحرف)	"باريس"
"التعبير العادي"	يجب أن يتطابق الإخراج مع نمط regex	"1.*2.*3"
"مخصص"	ترجع دالة JS المخصصة صواب/خطأ	(الإخراج) => الإخراج.الطول > 10	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

<التفاصيل>

🧩 إعداد MCP (بروتوكول السياق النموذجي)

بدء نقل MCP في وضع stdio:```bash omniroute --mcp

تدفق التحقق الموصى به:

1. قم بتوصيل عميل MCP الخاص بك عبر stdio.
2. قم بتشغيل "omniroute_get_health".
3. قم بتشغيل "omniroute_list_combos".
4. افتح `/dashboard/mcp` لتأكيد نبضات القلب والنشاط والتدقيق.

واجهات برمجة التطبيقات المفيدة للأتمتة:

- `الحصول على /api/mcp/status`
- `الحصول على /api/mcp/tools`
- `الحصول على /api/mcp/audit`
- `الحصول على /api/mcp/audit/stats`</details>

<التفاصيل>
<summary><b>🤝 إعداد A2A (Agent2Agent)</b></summary>

اكتشف الوكيل:```bash
curl http://localhost:20128/.well-known/agent.json

إرسال مهمة:```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'

إدارة دورة الحياة:

- `الحصول على /api/a2a/status`
- `الحصول على /api/a2a/tasks`
- `الحصول على /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/cancel`

واجهة المستخدم التشغيلية:

- `/dashboard/a2a` لإمكانية ملاحظة المهمة/الحالة/الدفق وإجراءات الدخان</details>

<التفاصيل>
<summary><b>🧪 التحقق من صحة البروتوكول الشامل</b></summary>

التحقق من صحة كلا البروتوكولين مع عملاء حقيقيين:```bash
npm run test:protocols:e2e

هذا يتحقق:

• اتصال/قائمة/اتصال عميل MCP SDK
• اكتشاف A2A/إرسال/دفق/حصول على/إلغاء
• التحقق من البيانات في تدقيق MCP وواجهات برمجة التطبيقات لإدارة المهام A2A

<التفاصيل>

💳 مقدمو الاشتراكات

### Claude Code (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

**نصيحة احترافية:**استخدم Opus للمهام المعقدة، وSonnet للسرعة. OmniRoute يتتبع الحصة لكل نموذج!### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

يحتوي كل حساب Codex الآن على تبديل السياسة في "لوحة المعلومات -> مقدمي الخدمة":

• 5h (تشغيل/إيقاف): فرض سياسة عتبة النافذة البالغة 5 ساعات.
• أسبوعيًا (تشغيل/إيقاف): فرض سياسة حد النافذة الأسبوعية.
• سلوك العتبة: عندما تصل النافذة الممكّنة إلى >=90% من الاستخدام، يتم تخطي هذا الحساب.
• سلوك التناوب: يقوم OmniRoute بتوجيه حساب Codex المؤهل التالي تلقائيًا.
• إعادة تعيين السلوك: عندما يمر وقت الموفر resetAt، يصبح الحساب مؤهلاً مرة أخرى تلقائيًا.

السيناريوهات:

• 5h ON' + Weekly ON`: يتم تخطي الحساب عندما تصل أي من النافذتين إلى الحد الأدنى.
• إيقاف لمدة 5 ساعات + تشغيل أسبوعي: الاستخدام الأسبوعي فقط يمكنه حظر الحساب.
• 5 ساعات تشغيل' + إيقاف أسبوعي`: الاستخدام لمدة 5 ساعات فقط يمكنه حظر الحساب.
• تم resetAt: يعود الحساب إلى التدوير تلقائيًا (لا توجد إعادة تمكين يدوية).### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**أفضل قيمة:**طبقة مجانية ضخمة! استخدم هذا قبل المستويات المدفوعة.### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

<التفاصيل>

🔑 موفري مفاتيح واجهة برمجة التطبيقات

### NVIDIA NIM (FREE developer access — 70+ models)

1. قم بالتسجيل: build.nvidia.com
2. احصل على مفتاح واجهة برمجة التطبيقات (API) مجانًا (يتضمن 1000 نقطة استدلال)
3. لوحة المعلومات → إضافة موفر → NVIDIA NIM:
   • مفتاح API: nvapi-your-key

النماذج:nvidia/llama-3.3-70b-instruct، nvidia/mistral-7b-instruct، وأكثر من 50 طرازًا آخر

**نصيحة احترافية:**واجهة برمجة التطبيقات المتوافقة مع OpenAI — تعمل بسلاسة مع ترجمة تنسيق OmniRoute!### DeepSeek

1. قم بالتسجيل: platform.deepseek.com
2. احصل على مفتاح API
3. لوحة المعلومات → إضافة موفر → DeepSeek

النماذج:deepseek/deepseek-chat، deepseek/deepseek-coder### Groq (Free Tier Available!)

1. قم بالتسجيل: console.groq.com
2. احصل على مفتاح API (الطبقة المجانية متضمنة)
3. لوحة المعلومات → إضافة موفر → Groq

النماذج:groq/llama-3.3-70b، groq/mixtral-8x7b

**نصيحة احترافية:**استنتاج فائق السرعة — الأفضل للبرمجة في الوقت الفعلي!### OpenRouter (100+ Models)

1. قم بالتسجيل: openrouter.ai
2. احصل على مفتاح API
3. لوحة المعلومات → إضافة موفر → OpenRouter

**النماذج:**يمكنك الوصول إلى أكثر من 100 نموذج من جميع المزودين الرئيسيين من خلال مفتاح واجهة برمجة التطبيقات (API) واحد.

سلوك لوحة المعلومات:تتم إدارة نماذج OpenRouter منالنماذج المتوفرة. تعمل عمليات الإضافة والاستيراد والمزامنة التلقائية يدويًا على تحديث نفس القائمة.

<التفاصيل>

💰 مقدمو الخدمة الرخيصة (النسخ الاحتياطي)

### GLM-4.7 (Daily reset, $0.6/1M)

1. قم بالتسجيل: Zhipu AI
2. احصل على مفتاح API من خطة الترميز
3. لوحة المعلومات → إضافة مفتاح واجهة برمجة التطبيقات:
   • المزود: glm
   • مفتاح واجهة برمجة التطبيقات: "مفتاحك".

الاستخدام:glm/glm-4.7

**نصيحة احترافية:**توفر خطة البرمجة حصة 3× بتكلفة 1/7! إعادة الضبط يوميًا الساعة 10:00 صباحًا.### MiniMax M2.1 (5h reset, $0.20/1M)

1. قم بالتسجيل: MiniMax
2. احصل على مفتاح API
3. لوحة المعلومات → إضافة مفتاح API

الاستخدام:minimax/MiniMax-M2.1

**نصيحة احترافية:**الخيار الأرخص للسياق الطويل (مليون رمز)!### Kimi K2 ($9/month flat)

1. اشترك: Moonshot AI
2. احصل على مفتاح API
3. لوحة المعلومات → إضافة مفتاح API

الاستخدام:كيمي/كيمي-أحدث

**نصيحة احترافية:**سعر ثابت قدره 9 دولارات شهريًا مقابل 10 ملايين رمز مميز = 0.90 دولارًا أمريكيًا/مليون تكلفة فعالة!

<التفاصيل>

🆓 مقدمو الخدمة مجانًا (النسخ الاحتياطي في حالات الطوارئ)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

<التفاصيل>

🎨 أنشئ مجموعات

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

<التفاصيل>

🔧 تكامل CLI

### Cursor IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Claude Code

استخدم صفحةأدوات CLIفي لوحة المعلومات للتكوين بنقرة واحدة، أو قم بتحرير ~/.claude/settings.json يدويًا.### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

الخيار 1 — لوحة التحكم (مستحسن):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply

**الخيار 2 - يدويًا:**تحرير `~/.openclaw/openclaw.json`:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**ملاحظة:**يعمل OpenClaw فقط مع OmniRoute المحلي. استخدم "127.0.0.1" بدلاً من "المضيف المحلي" لتجنب مشكلات دقة IPv6.### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**الخطوة 1:**أضف OmniRoute كموفر مخصص:```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

**الخطوة 2:**إنشاء/تحرير `opencode.json` في جذر مشروعك:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**الخطوة 3:**حدد النموذج في OpenCode:```bash /models

Select any OmniRoute model from the list

>**نصيحة:**أضف أي نموذج متوفر في نقطة نهاية OmniRoute `/v1/models` إلى قسم `models`. استخدم التنسيق "provider/model-id" من لوحة معلومات OmniRoute.</details>

---

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

<التفاصيل>
<summary><b>انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها</b></summary>

**"نموذج اللغة لم يقدم رسائل"**

- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص

**الحد من المعدل**

- حصة الاشتراك المحددة → الرجوع إلى GLM/MiniMax
- إضافة التحرير والسرد: `cc/clude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**انتهت صلاحية رمز OAuth**

- يتم التحديث تلقائيًا بواسطة OmniRoute
- إذا استمرت المشكلات: لوحة المعلومات → الموفر → إعادة الاتصال

**تكاليف مرتفعة**

- التحقق من إحصائيات الاستخدام في لوحة المعلومات → التكاليف
- تبديل النموذج الأساسي إلى GLM/MiniMax
- استخدم الطبقة المجانية (Gemini CLI، Qoder) للمهام غير الحرجة

**منافذ لوحة المعلومات/واجهة برمجة التطبيقات غير صحيحة**

- `PORT` هو المنفذ الأساسي الأساسي (ومنفذ API افتراضيًا)
- `API_PORT` يتخطى فقط مستمع واجهة برمجة التطبيقات المتوافق مع OpenAI
- `DASHBOARD_PORT` يتجاوز مستمع لوحة المعلومات/Next.js فقط
- قم بتعيين `NEXT_PUBLIC_BASE_URL` على لوحة التحكم/عنوان URL العام (لردود اتصال OAuth)

**أخطاء المزامنة السحابية**

- تحقق من نقاط `BASE_URL` لمثيلك قيد التشغيل
- تحقق من نقاط `CLOUD_URL` إلى نقطة النهاية السحابية المتوقعة
- حافظ على محاذاة قيم `NEXT_PUBLIC_*` مع القيم الموجودة على جانب الخادم

**تسجيل الدخول الأول لا يعمل**

- حدد "INITIAL_PASSWORD" في ".env".
- في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي `123456`

**لا توجد سجلات الطلب**

- تتم كتابة عناصر الطلب إلى `DATA_DIR/call_logs/` كملف JSON واحد لكل طلب
- تمكين التقاط خط الأنابيب من لوحة المعلومات → السجلات → طلب السجلات إذا كنت بحاجة إلى حمولات مفصلة لكل مرحلة
- اضبط `APP_LOG_TO_FILE=true` إذا كنت تريد أيضًا وجود سجلات لوحدة تحكم التطبيق في `logs/application/app.log`
- اضبط `APP_LOG_MAX_FILE_SIZE`، و`APP_LOG_RETENTION_DAYS`، و`APP_LOG_MAX_FILES`، و`CALL_LOG_MAX_ENTRIES` حسب الحاجة

**يظهر اختبار الاتصال "غير صالح" لمقدمي الخدمات المتوافقين مع OpenAI**

- لا يكشف العديد من مقدمي الخدمة عن نقطة نهاية `/models`
- يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
- تأكد من أن عنوان URL الأساسي يتضمن لاحقة `/v1`### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servidor-remoto"></a>

>**⚠️ مهم للمستخدمين الذين يقومون بتشغيل OmniRoute على VPS أو Docker أو أي خادم بعيد**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

يستخدم موفرو**Antigravity**و**Gemini CLI****Google OAuth 2.0**. تتطلب Google أن يكون `redirect_uri` في تدفق OAuth مطابقًا تمامًا لأحد معرفات URI المسجلة مسبقًا في Google Cloud Console للتطبيق.

يتم تسجيل بيانات اعتماد OAuth المجمعة في OmniRoute**لـ `المضيف المحلي` فقط**. عند الوصول إلى OmniRoute على خادم بعيد (على سبيل المثال، `https://omniroute.myserver.com`)، يرفض Google المصادقة باستخدام:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

يلزمك إنشاءOAuth 2.0 Client IDفي Google Cloud Console باستخدام معرف URI الخاص بخادمك.#### Step-by-step

1. افتح Google Cloud Console

انتقل إلى: https://console.cloud.google.com/apis/credentials

2. قم بإنشاء معرف عميل OAuth 2.0 جديد

• انقر على**"+ إنشاء بيانات اعتماد"→"معرف عميل OAuth"**
• نوع التطبيق:"تطبيق ويب"
• الاسم: أي شيء تريده (على سبيل المثال، "OmniRoute Remote")

3. أضف عناوين URI لإعادة التوجيه المعتمدة

في الحقل**"عناوين URI لإعادة التوجيه المعتمدة"**، أضف:``` https://your-server.com/callback

> استبدل "your-server.com" بنطاق الخادم الخاص بك أو عنوان IP (قم بتضمين المنفذ إذا لزم الأمر، على سبيل المثال "http://45.33.32.156:20128/callback").

**4. حفظ ونسخ بيانات الاعتماد**

بعد الإنشاء، ستعرض Google**معرف العميل**و**سر العميل**.

**5. تعيين متغيرات البيئة**

في `.env` (أو متغيرات بيئة Docker):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. أعد تشغيل OmniRoute```bash

npm:

npm run dev

Docker:

docker restart omniroute

**7. حاول الاتصال مرة أخرى**

لوحة المعلومات → الموفرون → Antigravity (أو Gemini CLI) → OAuth

سيقوم Google الآن بإعادة التوجيه بشكل صحيح إلى `https://your-server.com/callback`.---

#### Temporary workaround (without custom credentials)

إذا كنت لا ترغب في إعداد بيانات الاعتماد الخاصة بك الآن، فلا يزال بإمكانك استخدام**تدفق عنوان URL اليدوي**:

1. يفتح OmniRoute عنوان URL لتفويض Google
2. بعد التفويض، يحاول Google إعادة التوجيه إلى "المضيف المحلي" (والذي يفشل على الخادم البعيد)
3.**انسخ عنوان URL الكامل**من شريط عنوان المتصفح (حتى لو لم يتم تحميل الصفحة)
4. الصق عنوان URL هذا في الحقل الموضح في نموذج اتصال OmniRoute
5. انقر**"اتصال"**

> يعمل هذا لأن رمز التفويض الموجود في عنوان URL صالح بغض النظر عما إذا تم تحميل صفحة إعادة التوجيه أم لا.---

<التفاصيل>
<summary><b>🇧🇷 النسخة البرتغالية</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

تم إثبات**Antigravity**و**Gemini CLI**باستخدام**Google OAuth 2.0**للمصادقة. تطلب Google أن يتم استخدام `redirect_uri` دون تدفق OAuth**بالتأكيد**إلى عناوين URI المسبقة لتطبيق Google Cloud Console.

نظرًا لأن اعتمادات OAuth المُدخلة ليست في OmniRoute، فهي عبارة عن سجلات**apenas لـ `المضيف المحلي`**. عند الوصول إلى OmniRoute من خادم بعيد (على سبيل المثال: `https://omniroute.meuservidor.com`)، أو تحصل Google على مصادقة عبر:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

يجب عليك إنشاءOAuth 2.0 Client IDعلى Google Cloud Console باستخدام URI لخادمك.#### Passo a passo

1. الوصول إلى Google Cloud Console

العبرة: https://console.cloud.google.com/apis/credentials

2. طلب معرف عميل OAuth 2.0

• انقر على**"+ إنشاء بيانات الاعتماد"→"معرف عميل OAuth"**
• نوع التطبيق:"تطبيق ويب"
• الاسم: escolha qualquer nome (على سبيل المثال: OmniRoute Remote)

3. Adicione كمحددات URI لإعادة التوجيه المعتمدة

ليس هناك مجال**"عناوين URI لإعادة التوجيه المعتمدة"**، أضف:``` https://seu-servidor.com/callback

> استبدل `seu-servidor.com` بمنطقتك أو IP بخادمك (بما في ذلك البوابة إذا لزم الأمر، على سبيل المثال: `http://45.33.32.156:20128/callback`).

**4. حفظ ونسخ كموثقات**

وبعد ذلك، قم بإنشاء أو عرض Google o**معرف العميل**أو**سر العميل**.

**5. تكوين كمتغيرات البيئة**

ليس لديك `.env` (أو في بيئة Docker المتنوعة):```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. Reinicie أو OmniRoute```bash

Se usando npm:

npm run dev

Se usando Docker:

docker restart omniroute

**7. خيمة تواصل جديدة**

لوحة المعلومات → الموفرون → Antigravity (ou Gemini CLI) → OAuth

قم بإعادة توجيه Google بشكل صحيح إلى `https://seu-servidor.com/callback` ووظيفة المصادقة.---

#### Workaround temporário (sem configurar credenciais próprias)

إذا لم ترغب في إنشاء بيانات اعتماد خاصة بك منذ الآن، فمن الممكن استخدام التدفق**دليل URL**:

1. يفتح OmniRoute عنوان URL لتفويض Google
2. نسمح لك بأن تقوم Google بإعادة التوجيه إلى "المضيف المحلي" (الذي لا يوجد خادم عن بعد)
3.**انسخ عنوان URL كاملاً**من شريط الإدخال في متصفحك (حتى لا يتم نقل الصفحة)
4. هذا هو عنوان URL الذي يظهر في وضع الاتصال بـ OmniRoute
5. انقر على**"الاتصال"**

> يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا.</details>

---

</details>

## 🛠️ Tech Stack

<التفاصيل>
<summary><b>انقر لتوسيع تفاصيل المجموعة التقنية</b></summary>

-**وقت التشغيل**: Node.js 18–22 LTS (⚠️ Node.js 24+**غير مدعومة**— الثنائيات الأصلية `better-sqlite3` غير متوافقة)
-**اللغة**: TypeScript 5.9 —**TypeScript بنسبة 100%**عبر `src/` و`open-sse/` (لا يوجد `any` في الوحدات الأساسية منذ الإصدار 2.0)
-**الإطار**: Next.js 16 + React 19 + Tailwind CSS 4
-**قاعدة البيانات**: LowDB (JSON) + SQLite (حالة المجال + سجلات الوكيل + تدقيق MCP + قرارات التوجيه)
-**المخططات**: Zod (التحقق من صحة الإدخال/الإخراج لأداة MCP، وعقود API)
-**البروتوكولات**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**البث**: الأحداث المرسلة من الخادم (SSE)
-**المصادقة**: OAuth 2.0 (PKCE) + JWT + مفاتيح API + ترخيص نطاق MCP
-**الاختبار**: مشغل اختبار Node.js + Vitest (أكثر من 900 اختبار بما في ذلك الوحدة والتكامل وE2E)
-**CI/CD**: إجراءات GitHub (نشر npm التلقائي + Docker Hub عند الإصدار)
-**الموقع الإلكتروني**: [omniroute.online](https://omniroute.online)
-**الحزمة**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**دوكر**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**المرونة**: قاطع الدائرة، والتراجع الأسي، وقطيع مكافحة الرعد، وانتحال TLS، والإصلاح الذاتي للتحرير والسرد التلقائي</details>

---

## التوثيق

| وثيقة | الوصف |
| ---------------------------------------------- | --------------------------------------------------- |
| [دليل المستخدم](docs/USER_GUIDE.md) | مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر |
| [مرجع واجهة برمجة التطبيقات](docs/API_REFERENCE.md) | جميع نقاط النهاية مع الأمثلة |
| [خادم MCP](open-sse/mcp-server/README.md) | 16 أدوات MCP وتكوينات IDE وعملاء Python/TS/Go |
| [خادم A2A](src/lib/a2a/README.md) | بروتوكول JSON-RPC 2.0، المهارات، التدفق، إدارة المهام |
| [محرك التحرير والسرد التلقائي](docs/auto-combo.md) | تسجيل 6 عوامل، حزم الوضع، الشفاء الذاتي |
| [استكشاف الأخطاء وإصلاحها](docs/TROUBLESHOOTING.md) | المشاكل والحلول الشائعة |
| [هندسة معمارية](docs/ARCHITECTURE.md) | بنية النظام والداخلية |
| [مساهمة](CONTRIBUTING.md) | إعداد التطوير والمبادئ التوجيهية |
| [مواصفات OpenAPI](docs/openapi.yaml) | مواصفات OpenAPI 3.0 |
| [سياسة الأمان](SECURITY.md) | الإبلاغ عن الثغرات الأمنية والممارسات الأمنية |
| [نشر الجهاز الافتراضي](docs/VM_DEPLOYMENT_GUIDE.md) | الدليل الكامل: إعداد VM + nginx + Cloudflare |
| [معرض الميزات](docs/FEATURES.md) | جولة لوحة القيادة المرئية مع لقطات الشاشة |
| [قائمة مراجعة الإصدار](docs/RELEASE_CHECKLIST.md) | خطوات التحقق من صحة الإصدار المسبق |---

## 🗺️ Roadmap

يحتوي OmniRoute على**210+ ميزات مخطط لها**عبر مراحل تطوير متعددة. فيما يلي المجالات الرئيسية:

| الفئة | الميزات المخططة | أبرز الأحداث |
| ----------------------------- | ---------------- | -------------------------------------------------------------------------------------- |
| 🧠**التوجيه والاستخبارات**| 25+ | التوجيه ذو زمن الاستجابة الأقل، والتوجيه القائم على العلامات، والاختبار المبدئي للحصة، واختيار حساب P2C |
| 🔒**الأمان والامتثال**| 20+ | تقوية SSRF، وإخفاء بيانات الاعتماد، والحد الأقصى للمعدل لكل نقطة نهاية، وتحديد نطاق مفتاح الإدارة |
| 📊**قابلية الملاحظة**| 15+ | تكامل OpenTelemetry ومراقبة الحصص في الوقت الفعلي وتتبع التكلفة لكل نموذج |
| 🔄**تكامل الموفر**| 20+ | تسجيل النموذج الديناميكي، فترات تهدئة الموفر، الدستور الغذائي متعدد الحسابات، تحليل حصة الطيار المساعد |
| ⚡**الأداء**| 15+ | طبقة ذاكرة التخزين المؤقت المزدوجة، ذاكرة التخزين المؤقت السريعة، ذاكرة التخزين المؤقت للاستجابة، استمرار البث، واجهة برمجة التطبيقات الدفعية |
| 🌐**النظام البيئي**| 10+ | WebSocket API، إعادة تحميل التكوين السريع، مخزن التكوين الموزع، الوضع التجاري |### 🔜 Coming Soon

- 🔗**تكامل OpenCode**— دعم الموفر الأصلي لـ OpenCode AI IDE للترميز
- 🔗**تكامل TRAE**— الدعم الكامل لإطار تطوير TRAE AI
- 📦**Batch API**— معالجة الدفعات غير المتزامنة للطلبات المجمعة
- 🎯**التوجيه المعتمد على العلامات**— توجيه الطلبات بناءً على العلامات المخصصة والبيانات الوصفية
- 💰**إستراتيجية أقل تكلفة**— تحديد أرخص مزود متاح تلقائيًا

> 📝 مواصفات الميزات الكاملة متوفرة في [`docs/new-features/`](docs/new-features/) (217 مواصفات تفصيلية)---

## 👥 Contributors

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)

### How to Contribute

1. شوكة المستودع
2. قم بإنشاء فرع الميزات الخاص بك (`git checkout -b feature/amazing-feature`)
3. تنفيذ التغييرات ("git الالتزام -m "إضافة ميزة مذهلة")
4. ادفع إلى الفرع ("ميزة git Push Origin/ميزة مذهلة")
5. افتح طلب السحب

راجع [CONTRIBUTING.md](CONTRIBUTING.md) للحصول على إرشادات مفصلة.### Releasing a New Version

```bash
# Create a release — npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes

---

📊 Star History

Stargazers over time

🙏 Acknowledgments

شكر خاص لـ**9routerبواسطةdecolua**— المشروع الأصلي الذي ألهم هذه الشوكة. يعتمد OmniRoute على هذا الأساس المذهل مع ميزات إضافية وواجهات برمجة التطبيقات متعددة الوسائط وإعادة كتابة TypeScript كاملة.

شكر خاص لـ**CLIProxyAPI**— تطبيق Go الأصلي الذي ألهم منفذ JavaScript هذا.---

الرخصة

ترخيص MIT - راجع الترخيص للحصول على التفاصيل.---

_{Built with ❤️ for developers who code 24/7
omniroute.online}