vrr/OmniRoute
2
0
Fork 0
mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-05-06 02:07:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
OmniRoute/README.ar.md

138 KiB
Raw Blame History

🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية

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

وكيل واجهة برمجة التطبيقات العالمي الخاص بك - نقطة نهاية واحدة، وأكثر من 67 موفرًا، بدون أي توقف عن العمل. الآن مع تنسيق الوكيل MCP & A2A.

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

🌐 متوفر في: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino | 🇨🇿 Čeština

🆕 الجديد في الإصدار 3.0.0

الترقية من الإصدار 2.9.5؟ — راجع full CHANGELOG للتعرف على كافة التغييرات.

المنطقة التغيير
🔒 أمان CodeQL تم إصلاح 10+ تنبيهات CodeQL: متعددات الحدود، العشوائية غير الآمنة، معالجة حقن الصدفة
✅ التحقق من صحة المسار تم الآن التحقق من صحة جميع مسارات واجهة برمجة التطبيقات البالغ عددها 176 باستخدام مخططات Zod + validateBody() — CI check:route-validation:t06 يمر
🐛 ** تسرب علامة omniModel ** لم تعد علامات <omniModel> الداخلية تتسرب إلى العملاء في استجابات تدفق SSE (#585)
🔑 واجهة برمجة التطبيقات للمفاتيح المسجلة توفير مفاتيح واجهة برمجة التطبيقات تلقائيًا عبر POST /api/v1/registered-keys مع فرض الحصص لكل مزود/حساب، والصلاحية، وتخزين SHA-256، والإبلاغ الاختياري عن مشكلات GitHub
🎨 أيقونات الموفر أكثر من 130 شعارًا للموفر عبر @lobehub/icons (SVG) مع PNG → سلسلة احتياطية عامة
🔄 المزامنة التلقائية للنموذج جدولة على مدار 24 ساعة وتبديل واجهة المستخدم اليدوية لمزامنة قوائم النماذج لموفري الخدمات المدمجين والمخصصين المتوافقين مع OpenAI
🌐 OpenCode Zen/Go مقدمان جديدان من @kang-heewon عبر PR #530: طبقة مجانية + طبقة اشتراك عبر OpencodeExecutor
🐛 Gemini CLI OAuth خطأ قابل للتنفيذ عندما يكون GEMINI_OAUTH_CLIENT_SECRET مفقودًا في Docker (كان خطأ Google غامضًا)
🐛 تكوين OpenCode saveOpenCodeConfig() يكتب الآن TOML بشكل صحيح إلى XDG_CONFIG_HOME
🐛 تجاوز النموذج المثبت body.model تم ضبطه بشكل صحيح على pinnedModel في حماية ذاكرة التخزين المؤقت للسياق
🐛 حلقة الدستور الغذائي/كلود تم الآن تحويل كتل tool_result إلى نص لإيقاف الحلقات اللانهائية
🐛 إعادة توجيه تسجيل الدخول لم يعد تسجيل الدخول يتجمد بعد تخطي إعداد كلمة المرور
🐛 مسارات الويندوز تمت تسوية مسارات MSYS2/Git-Bash (/c/...) إلى C:\... تلقائيًا

🖼️ لوحة التحكم الرئيسية

OmniRoute Dashboard

📸 معاينة لوحة التحكم

انقر لرؤية لقطات شاشة لوحة المعلومات
صفحة لقطة شاشة
** مقدمو الخدمة ** Providers
المجموعات Combos
تحليلات Analytics
الصحة Health
مترجم Translator
الإعدادات Settings
أدوات سطر الأوامر CLI Tools
سجلات الاستخدام Usage
نقاط النهاية Endpoints

🤖 موفر الذكاء الاصطناعي المجاني لوكلاء البرمجة المفضلين لديك

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

OpenClaw
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K

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

🤔 لماذا OmniRoute؟

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

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

** OmniRoute يحل هذا: **

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

📧 الدعم

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

🐛 الإبلاغ عن خطأ؟

عند فتح مشكلة، يرجى تشغيل أمر معلومات النظام وإرفاق الملف الذي تم إنشاؤه:

npm run system-info

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

🔄 كيف يعمل

┌─────────────┐
│  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] iFlow, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

🎯 ما يحله OmniRoute — 30 مشكلة حقيقية وحالات استخدام

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

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

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

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

  • الاحتياطي الذكي ذو 4 طبقات — في حالة نفاد حصة الاشتراك، تتم إعادة التوجيه تلقائيًا إلى مفتاح واجهة برمجة التطبيقات ← رخيص ← مجاني بدون أي تدخل يدوي
  • تتبع الحصص في الوقت الفعلي — يعرض استهلاك الرمز المميز في الوقت الفعلي مع العد التنازلي لإعادة التعيين (5 ساعات، يوميًا، أسبوعيًا)
  • دعم الحسابات المتعددة — حسابات متعددة لكل مزود مع نظام روبن تلقائي — عند نفاد الحساب، يتم التبديل إلى التالي
  • مجموعات مخصصة — سلاسل احتياطية قابلة للتخصيص مع 6 إستراتيجيات موازنة (الملء أولاً، جولة روبن، P2C، عشوائي، الأقل استخدامًا، الأمثل من حيث التكلفة)
  • حصص الدستور الغذائي — مراقبة حصص مساحة عمل الشركة/الفريق مباشرة في لوحة المعلومات
🔌 2. "أحتاج إلى استخدام موفري خدمات متعددين ولكن لكل منهم واجهة برمجة تطبيقات مختلفة"

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

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

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

يقوم مقدمو الخدمة مثل 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 في وقت واحد
🆓 4. "أريد استخدام الذكاء الاصطناعي للبرمجة ولكن ليس لدي المال"

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

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

  • موفرو الطبقة المجانية المضمنون — دعم أصلي لمقدمي الخدمة المجانية بنسبة 100%: iFlow (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 مع فئة "الاستخدام الخفيف" مجانًا؛ استخدم البادئة ollamacloud/<model>
  • المجموعات المجانية فقط — السلسلة gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus = 0 USD/الشهر بدون أي توقف عن العمل
  • NVIDIA NIM Free Access — ~40 دورة في الدقيقة وصول مجاني للأبد إلى أكثر من 70 نموذجًا على build.nvidia.com (الانتقال من الاعتمادات إلى حدود المعدل النقي)
  • استراتيجية التكلفة المحسنة — استراتيجية التوجيه التي تختار تلقائيًا أرخص مزود متاح
🔒 5. "أحتاج إلى حماية بوابة الذكاء الاصطناعي الخاصة بي من الوصول غير المصرح به"

عند تعريض بوابة 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 — بيانات الاعتماد مشفرة في حالة عدم النشاط
🛑 6. "تعطل مزود الخدمة الخاص بي وفقدت تدفق الترميز الخاص بي"

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

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

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

يستخدم المطورون 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 مرة واحدة، والوصول إلى أكثر من 67 موفرًا
🔑 8. "إدارة رموز OAuth المميزة من موفري خدمات متعددين أمر جحيم"

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

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

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

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

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

  • لوحة معلومات تحليلات التكلفة — تتبع التكلفة لكل رمز مميز وإدارة الميزانية لكل مزود
  • حدود الميزانية لكل طبقة — سقف الإنفاق لكل طبقة يؤدي إلى حدوث تراجع تلقائي
  • تكوين التسعير لكل نموذج — أسعار قابلة للتكوين لكل نموذج
  • إحصاءات الاستخدام لكل مفتاح API — عدد الطلبات والطابع الزمني الأخير المستخدم لكل مفتاح
  • لوحة التحكم التحليلية — بطاقات الإحصائيات، ومخطط استخدام النموذج، وجدول الموفر مع معدلات النجاح وزمن الاستجابة
🐛 10. "لا يمكنني تشخيص الأخطاء والمشكلات في مكالمات الذكاء الاصطناعي"

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

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

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

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

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

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

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

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

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

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

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

  • التضمينات — /v1/embeddings مع 6 موفري خدمة وأكثر من 9 نماذج
  • إنشاء الصور — /v1/images/generations مع 10 موفري وأكثر من 20 نموذجًا (OpenAI، وxAI، وTogether، وFireworks، وNebius، وHyperbolic، وNanoBanana، وAntigravity، وSD WebUI، وComfyUI)
  • تحويل النص إلى فيديو — /v1/videos/generations — 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 للمخطوطة
🧪 14. "ليس لدي طريقة لاختبار ومقارنة الجودة عبر النماذج"

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

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

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

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

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

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

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

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

  • الحقن الفوري للنظام — يتم تطبيق المطالبة العامة على جميع الطلبات
  • التحقق من صحة ميزانية التفكير — التحكم في تخصيص الرمز المميز لكل طلب (العبور، التلقائي، المخصص، التكيفي)
  • 6 إستراتيجيات التوجيه — إستراتيجيات عالمية تحدد كيفية توزيع الطلبات
  • Wildcard Router — يتم توجيه أنماط provider/* ديناميكيًا إلى أي مزود
  • تبديل تمكين/تعطيل التحرير والسرد — تبديل المجموعات مباشرة من لوحة المعلومات
  • تبديل الموفر — تمكين/تعطيل جميع اتصالات الموفر بنقرة واحدة
  • موفري الخدمة المحظورون — استبعاد موفري خدمة محددين من قائمة /v1/models
🧰 17. "أحتاج إلى أدوات MCP كإمكانيات منتج من الدرجة الأولى"

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

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

  • يظهر MCP في لوحة التحكم وعلامة تبويب بروتوكول نقطة النهاية
  • صفحة إدارة MCP مخصصة تحتوي على العمليات والأدوات والنطاقات والتدقيق
  • البدء السريع المدمج لـ omniroute --mcp وتأهيل العميل
🧠 18. "أحتاج إلى تنسيق A2A مع المزامنة + مسارات المهام الدفقية"

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

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

  • نقطة نهاية A2A JSON-RPC (POST /a2a) مع message/send وmessage/stream
  • تدفق SSE مع انتشار الحالة الطرفية
  • واجهات برمجة التطبيقات لدورة حياة المهام لـ tasks/get وtasks/cancel
🛰️ 19. "أحتاج إلى صحة عملية MCP حقيقية، وليس حالة تخمينية"

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

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

  • ملف نبضات وقت التشغيل مع PID والطوابع الزمنية والنقل وعدد الأدوات ووضع النطاق
  • واجهة برمجة تطبيقات حالة MCP التي تجمع بين نبضات القلب + النشاط الأخير
  • بطاقات حالة واجهة المستخدم للعملية/وقت التشغيل/نضارة نبضات القلب
📋 20. "أحتاج إلى تنفيذ أداة MCP قابلة للتدقيق"

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

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

  • تسجيل التدقيق المدعوم من SQLite لاستدعاءات أداة MCP
  • عوامل التصفية حسب الأداة، والنجاح/الفشل، ومفتاح API، وترقيم الصفحات
  • جدول تدقيق لوحة المعلومات + إحصائيات نقاط النهاية للأتمتة
🔐 21. "أحتاج إلى أذونات MCP محددة لكل عملية تكامل"

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

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

  • 9 نطاقات MCP محببة للتحكم في الوصول إلى الأدوات
  • إنفاذ النطاق والرؤية في واجهة مستخدم إدارة MCP
  • الوضع الافتراضي الآمن للأدوات التشغيلية
⚙️ 22. "أحتاج إلى عناصر تحكم تشغيلية دون إعادة النشر"

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

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

  • قم بتبديل تنشيط التحرير والسرد مباشرةً من لوحة معلومات MCP
  • تطبيق ملفات تعريف المرونة من حزم السياسات المحددة مسبقًا
  • إعادة ضبط حالة قاطع الدائرة من نفس لوحة العمليات
🔄 23. "أحتاج إلى رؤية وإلغاء دورة حياة مهمة A2A المباشرة"

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

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

  • قائمة المهام/التصفية حسب الحالة/المهارة مع ترقيم الصفحات
  • التعمق في البيانات الوصفية للمهمة، والأحداث، والتحف
  • نقطة نهاية إلغاء المهمة وإجراء واجهة المستخدم مع التأكيد
🌊 24. "أحتاج إلى مقاييس التدفق النشطة لتحميل A2A"

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

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

  • عدادات التدفق النشطة مدمجة في حالة A2A
  • الطابع الزمني للمهمة الأخيرة وعدد كل ولاية
  • بطاقات لوحة القيادة A2A لمراقبة العمليات في الوقت الفعلي
🪪 25. "أحتاج إلى اكتشاف الوكيل القياسي للعملاء"

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

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

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

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

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

  • صفحة نقاط النهاية الموحدة مع علامات تبويب Proxy وMCP وA2A وAPI Endpoints
  • تبديل حالة الخدمة المضمنة (متصل/غير متصل) لـ MCP وA2A
  • روابط من النظرة العامة إلى علامات تبويب الإدارة المخصصة
🧪 27. "أحتاج إلى التحقق من صحة البروتوكول الشامل مع عملاء حقيقيين"

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

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

  • مجموعة E2E التي تعمل على تشغيل التطبيق وتستخدم نقل عميل MCP SDK الحقيقي
  • اختبارات عميل A2A لاكتشاف التدفقات وإرسالها ودفقها والحصول عليها وإلغائها
  • التحقق من التأكيدات ضد تدقيق MCP وواجهات برمجة تطبيقات مهام A2A
📡 28. "أحتاج إلى إمكانية ملاحظة موحدة عبر جميع الواجهات"

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

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

  • لوحات معلومات/سجلات/تحليلات موحدة في منتج واحد
  • الصحة + التدقيق + طلب القياس عن بعد عبر طبقات OpenAI وMCP وA2A
  • واجهات برمجة التطبيقات التشغيلية للحالة والأتمتة
💼 29. "أحتاج إلى وقت تشغيل واحد للوكيل + الأدوات + تنسيق الوكيل"

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

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

  • وكيل متوافق مع OpenAI وخادم MCP وخادم A2A في مكدس واحد
  • المصادقة المشتركة والمرونة وتخزين البيانات وإمكانية الملاحظة
  • نموذج سياسة متسق عبر جميع أسطح التفاعل
🚀 30. "أحتاج إلى شحن عمليات سير عمل الوكيل دون امتداد التعليمات البرمجية اللاصقة"

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

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

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

أمثلة لقواعد اللعبة (حالات الاستخدام المتكاملة)

** قواعد اللعبة أ: زيادة الاشتراك المدفوع إلى الحد الأقصى + نسخة احتياطية رخيصة **

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

دليل التشغيل ب: مكدس البرمجة بدون تكلفة

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 ساعة طوال أيام الأسبوع

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

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

🆓 ابدأ مجانًا — بدون تكلفة تكوين

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

خطوة العمل مقدمي الخدمات مقفلة
1 الاتصال Kiro (معرف AWS Builder OAuth) كلود سونيت 4.5، هايكو 4.5 — غير محدود
2 ربط iFlow (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) التثبيت والتشغيل

npm install -g omniroute
omniroute

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

pnpm install -g omniroute
pnpm approve-builds -g   # Select all packages → approve
omniroute

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

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

وضع المنفذ المقسم الاختياري:

PORT=20128 DASHBOARD_PORT=20129 omniroute
# API:       http://localhost:20128/v1
# Dashboard: http://localhost:20129

2) قم بتوصيل مقدمي الخدمة وإنشاء مفتاح واجهة برمجة التطبيقات (API) الخاص بك

  1. افتح لوحة المعلومات → Providers وقم بتوصيل موفر واحد على الأقل (مفتاح OAuth أو API).
  2. افتح لوحة المعلومات → Endpoints وأنشئ مفتاح API.
  3. (اختياري) افتح لوحة المعلومات → Combos وقم بتعيين السلسلة الاحتياطية.

3) قم بتوجيه أداة الترميز الخاصة بك إلى OmniRoute

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) تمكين البروتوكولات والتحقق من صحتها (الإصدار 2.0)

MCP (للعمليات التي تعتمد على الأدوات):

omniroute --mcp

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

  • omniroute_get_health
  • omniroute_list_combos

A2A (لسير العمل من وكيل إلى وكيل):

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) التحقق من صحة كل شيء من البداية إلى النهاية (مستحسن)

npm run test:protocols:e2e

يتحقق هذا الجناح من تدفقات عميل MCP وA2A الحقيقية مقابل تطبيق قيد التشغيل.

البديل: التشغيل من المصدر

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

🐳 عامل الميناء

OmniRoute متاح كصورة Docker عامة على Docker Hub.

الجري السريع:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

** مع ملف البيئة: **

# Copy and edit .env first
cp .env.example .env

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

استخدام Docker Compose:

# 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
صورة العلامة الحجم الوصف
diegosouzapw/omniroute latest ~250 ميجابايت أحدث إصدار مستقر
diegosouzapw/omniroute 1.0.3 ~250 ميجابايت النسخة الحالية

🖥️ تطبيق سطح المكتب - غير متصل بالإنترنت ومتاح دائمًا

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

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

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

بداية سريعة

# 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)

علبة النظام

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

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

📖 التوثيق الكامل: OMNI_TOKEN_153

💰 لمحة سريعة عن الأسعار

الطبقة مقدم التكلفة إعادة ضبط الحصص الأفضل لـ
💳الإشتراك كلود كود (برو) 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
iFlow (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 وستحدث جميع الإجراءات الاحتياطية تلقائيًا - لا يوجد تبديل يدوي على الإطلاق.

🆓 نماذج مجانية — ما تحصل عليه بالفعل

جميع الموديلات أدناه مجانية بنسبة 100% ولا تتطلب أي بطاقة ائتمان. يقوم OmniRoute بالمسارات التلقائية بينهما عند نفاد حصة واحدة - اجمعها جميعًا للحصول على مجموعة غير قابلة للكسر بقيمة 0 دولار.

🔵 نماذج كلود (عبر Kiro — AWS Builder ID)

نموذج البادئة الحد حد السعر
claude-sonnet-4.5 kr/ غير محدود لم يتم الإبلاغ عن الحد الأقصى اليومي
claude-haiku-4.5 kr/ غير محدود لم يتم الإبلاغ عن الحد الأقصى اليومي
claude-opus-4.6 kr/ غير محدود أحدث أعمال أوبوس عبر كيرو

🟢 نماذج IFLOW (بروتوكول OAuth مجاني — بدون بطاقة ائتمان)

نموذج البادئة الحد حد السعر
kimi-k2-thinking if/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
qwen3-coder-plus if/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
deepseek-r1 if/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
minimax-m2.1 if/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
kimi-k2 if/ غير محدود لم يتم الإبلاغ عن الحد الأقصى

🟡 نماذج QWEN (مصادقة رمز الجهاز)

نموذج البادئة الحد حد السعر
qwen3-coder-plus qw/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
qwen3-coder-flash qw/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
qwen3-coder-next qw/ غير محدود لم يتم الإبلاغ عن الحد الأقصى
vision-model qw/ غير محدود الوسائط المتعددة (صور)

🟣 GEMINI CLI (Google OAuth)

نموذج البادئة الحد حد السعر
gemini-3-flash-preview gc/ 180 ألف توك/شهر + 1 ألف/يوم إعادة الضبط الشهرية
gemini-2.5-pro gc/ 180 ألف/شهر (مسبح مشترك) جودة عالية

⚫ NVIDIA NIM (مفتاح واجهة برمجة التطبيقات المجاني — 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 (مفتاح واجهة برمجة التطبيقات المجاني — inference.cerebras.ai)

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

متاح مجانًا: llama-3.3-70b، llama-3.1-8b، deepseek-r1-distill-llama-70b

🔴 GROQ (مفتاح واجهة برمجة التطبيقات المجاني — console.groq.com)

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

متاح مجانًا: llama-3.3-70b-versatile، gemma2-9b-it، mixtral-8x7b، whisper-large-v3

🔴 LONGCAT AI (مفتاح واجهة برمجة التطبيقات المجاني — longcat.chat) 🆕

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

مجاني 100% أثناء وجودك في النسخة التجريبية العامة. قم بالتسجيل في longcat.chat عبر البريد الإلكتروني أو الهاتف. تتم إعادة الضبط يوميًا في تمام الساعة 00:00 بالتوقيت العالمي المنسق.

🟢 الذكاء الاصطناعي للتلقيح (لا يلزم وجود مفتاح API) 🆕

نموذج البادئة حد السعر مقدم خلف
openai pol/ 1 متطلب/15 ثانية جي بي تي-5
claude pol/ 1 متطلب/15 ثانية أنثروبي كلود
gemini pol/ 1 متطلب/15 ثانية جوجل الجوزاء
deepseek pol/ 1 متطلب/15 ثانية ديب سيك V3
llama pol/ 1 متطلب/15 ثانية ميتا لاما 4 كشاف
mistral pol/ 1 متطلب/15 ثانية ميسترال لمنظمة العفو الدولية

✨ بدون احتكاك: لا يوجد اشتراك، ولا يوجد مفتاح API. أضف موفر التلقيح بحقل مفتاح فارغ وسيعمل على الفور.

🟠 الذكاء الاصطناعي لعمال CLOUDFLARE (مفتاح API مجاني — 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. قم بتخزين معرف الحساب في إعدادات الموفر.

🟣 SCALEWAY AI (مليون عملة مجانية —scaleway.com) 🆕

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

متاح مجانًا: qwen3-235b-a22b-instruct-2507 (Qwen3 235B!)، llama-3.1-70b-instruct، mistral-small-3.2-24b-instruct-2506، deepseek-v3-0324

متوافقة مع الاتحاد الأوروبي/اللائحة العامة لحماية البيانات. احصل على مفتاح API على console.scaleway.com.

💡 المجموعة المجانية المطلقة (11 مقدمًا، 0 دولار للأبد):

Kiro (kr/)             → Claude Sonnet/Haiku UNLIMITED
iFlow (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 models UNLIMITED
Gemini (gemini/)       → Gemini 2.5 Flash — 1,500 req/day free
Cloudflare AI (cf/)    → 50+ models — 10K Neurons/day
Scaleway (scw/)        → Qwen3 235B, Llama 70B — 1M free tokens (EU)
Groq (groq/)           → Llama/Gemma — 14.4K req/day ultra-fast
NVIDIA NIM (nvidia/)   → 70+ open models — 40 RPM forever
Cerebras (cerebras/)   → Llama/Qwen world-fastest — 1M tok/day

🎙️ مجموعة النسخ المجانية

قم بنسخ أي صوت/فيديو مقابل $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: قم بتحميل أي ملف صوت أو فيديو ← حدد نقطة نهاية التحرير والسرد الخاصة بك ← احصل على النسخ بتنسيقات مدعومة.

💡 الميزات الرئيسية

تم تصميم OmniRoute v2.0 كمنصة تشغيلية، وليس مجرد وكيل ترحيل.

🆕 جديد — تحسينات مستوحاة من ClawRouter (مارس 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 القابلة للتوسيع - أضف منطق توجيه مخصص كمكونات إضافية

🚀 الإصدار 2.0.9+ السابق — ساحة اللعب وبصمات أصابع CLI و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 الاتصالات بشكل صحيح عن طريق معرف مساحة العمل
🔄 التحديث التلقائي الإلكتروني يتحقق تطبيق سطح المكتب من التحديثات + التثبيت التلقائي عند إعادة التشغيل

🤖 عمليات الوكيل والبروتوكول (الإصدار 2.0)

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

🧠 التوجيه والاستخبارات

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

🎵 واجهات برمجة التطبيقات متعددة الوسائط

ميزة ماذا يفعل
🖼️ إنشاء الصور /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/generations (سير عمل ComfyUI + SD WebUI)
🎵 جيل الموسيقى /v1/music/generations (ComfyUI workflows)
🛡️ اعتدالات /v1/moderations فحوصات السلامة
🔀 إعادة الترتيب /v1/rerank لتسجيل نقاط الصلة
🔍 بحث الويب 🆕 /v1/search — 5 مقدمي خدمات (Serper، Brave، Perplexity، Exa، Tavily)، أكثر من 6500 مجانًا شهريًا، تجاوز الفشل التلقائي، ذاكرة التخزين المؤقت

🛡️ المرونة والأمن والحوكمة

ميزة ماذا يفعل
🔌 قواطع الدائرة رحلة/استرداد لكل نموذج مع عناصر التحكم في العتبة
🎯 نماذج تدرك نقطة النهاية تعلن النماذج المخصصة عن نقاط النهاية المدعومة + تنسيق API
🛡️ القطيع المضاد للرعد حماية Mutex + الإشارة في أحداث إعادة المحاولة/التقييم
🧠 ** ذاكرة التخزين المؤقت الدلالية + التوقيع ** تقليل التكلفة/زمن الوصول باستخدام طبقتين من ذاكرة التخزين المؤقت
⚡ طلب العجز نافذة الحماية المكررة
🔒 انتحال بصمة الإصبع TLS بصمة TLS الشبيهة بالمتصفح - تقلل من اكتشاف الروبوتات ووضع علامة على الحساب
🔏 مطابقة بصمة CLI يطابق توقيعات طلب واجهة سطر الأوامر (CLI) الأصلية - يقلل من مخاطر الحظر مع الحفاظ على عنوان IP الخاص بالوكيل
🌐 تصفية IP التحكم في القائمة المسموح بها/القائمة المحظورة لعمليات النشر المكشوفة
📊 حدود المعدل القابلة للتحرير حدود عالمية/مستوى مزود قابلة للتكوين مع الثبات
🔑 إدارة مفاتيح واجهة برمجة التطبيقات + تحديد النطاق تأمين إصدار/تدوير المفتاح وضوابط النموذج/المزود
🛡️ محمي /models بوابة مصادقة اختيارية وإخفاء الموفر لكتالوج النماذج

📊 إمكانية الملاحظة والتحليلات

ميزة ماذا يفعل
📝 الطلب + تسجيل الوكيل الطلب/الاستجابة الكاملة وتسجيل الوكيل
📉 Streamed Detailed Logs 🆕 Reconstructs SSE payload streams cleanly into the UI
📋 لوحة تحكم السجلات الموحدة طلب العروض والوكيل والتدقيق ووحدة التحكم في صفحة واحدة
🔍 طلب القياس عن بعد زمن الاستجابة p50/p95/p99 وطلب التتبع
🏥 لوحة المعلومات الصحية وقت التشغيل، حالات الكسارة، عمليات الإغلاق، إحصائيات ذاكرة التخزين المؤقت
💰 تتبع التكلفة ضوابط الميزانية ورؤية التسعير لكل نموذج
📈 تصورات التحليلات رؤى استخدام النموذج/الموفر وطرق عرض الاتجاه
🧪 إطار التقييم اختبار المجموعة الذهبية مع استراتيجيات المطابقة القابلة للتكوين

☁️ النشر والمنصة

ميزة ماذا يفعل
🌐 النشر في أي مكان المضيف المحلي، VPS، Docker، البيئات السحابية
💾 المزامنة السحابية مزامنة التكوين عبر عامل السحابة
🔄 النسخ الاحتياطي/الاستعادة تدفقات التصدير/الاستيراد والتعافي من الكوارث
🧙 معالج الإعداد الإعداد الموجه لأول مرة
🔧 لوحة تحكم أدوات CLI إعداد بنقرة واحدة لأدوات الترميز الشائعة
🎮 ساحة اللعب النموذجية اختبر أي موفر/نموذج/نقطة نهاية من لوحة المعلومات
🔏 تبديل بصمة الإصبع CLI مطابقة بصمات الأصابع لكل موفر في الإعدادات > الأمان
🌐 i18n (30 لغة) لوحة تحكم كاملة + دعم لغة المستندات مع تغطية RTL
🧹 مسح كافة النماذج مسح قائمة النماذج بنقرة واحدة في تفاصيل المزود
👁️ Sidebar Controls 🆕 Hide components and integrations from Appearance Settings
📋 نماذج الإصدارات قوالب GitHub الموحدة للأخطاء والميزات
📂 دليل البيانات المخصصة DATA_DIR تجاوز لموقع التخزين

ميزة الغوص العميق

إجراء احتياطي ذكي مع التحكم العملي في التكلفة

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 تلقائيًا إلى المرشح التالي دون التبديل اليدوي.

إدارة البروتوكول مرئية وقابلة للتشغيل

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

سير عمل المترجم + التحقق من الصحة

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

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

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

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

📖 A2A Server README — المهارات وأساليب JSON-RPC والبث ودورة حياة المهمة

🧪 التقييمات (التقييمات)

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

الطقم الذهبي المدمج

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

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

استراتيجيات التقييم

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

📖 دليل الإعداد

إعداد البروتوكول (MCP + A2A)

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

بدء نقل MCP في وضع stdio:

omniroute --mcp

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

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

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

  • GET /api/mcp/status
  • GET /api/mcp/tools
  • GET /api/mcp/audit
  • GET /api/mcp/audit/stats
🤝 إعداد A2A (Agent2Agent)

اكتشف الوكيل:

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":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'

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

  • GET /api/a2a/status
  • GET /api/a2a/tasks
  • GET /api/a2a/tasks/:id
  • POST /api/a2a/tasks/:id/cancel

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

  • /dashboard/a2a لإمكانية ملاحظة المهمة/الحالة/الدفق وإجراءات الدخان
🧪 التحقق من صحة البروتوكول من طرف إلى طرف

التحقق من صحة كلا البروتوكولين مع عملاء حقيقيين:

npm run test:protocols:e2e

هذا يتحقق:

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

كلود كود (برو/ماكس)

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

إدارة حدود حساب الدستور الغذائي (5 ساعات + أسبوعيًا)

يحتوي كل حساب Codex الآن على تبديل السياسة في Dashboard -> Providers:

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

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

  • 5h ON + Weekly ON: يتم تخطي الحساب عندما تصل إحدى النافذتين إلى الحد الأدنى.
  • 5h OFF + Weekly ON: الاستخدام الأسبوعي فقط يمكنه حظر الحساب.
  • 5h ON + Weekly OFF: الاستخدام لمدة 5 ساعات فقط يمكنه حظر الحساب.
  • تم اجتياز resetAt: يدخل الحساب مرة أخرى في عملية التدوير تلقائيًا (لا توجد إعادة تمكين يدوية).

Gemini CLI (180 ألفًا شهريًا مجانًا!)

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

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

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

مساعد جيثب

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

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3-pro
🔑 موفري مفاتيح واجهة برمجة التطبيقات

NVIDIA NIM (وصول مجاني للمطورين — أكثر من 70 طرازًا)

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

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

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

ديب سيك

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

النماذج: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (الطبقة المجانية متاحة!)

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

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

نصيحة احترافية: استنتاج فائق السرعة — الأفضل للبرمجة في الوقت الفعلي!

OpenRouter (+100 موديل)

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

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

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

GLM-4.7 (إعادة التعيين اليومي، 0.6 دولار/1 مليون)

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

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

نصيحة احترافية: توفر خطة البرمجة حصة 3× بتكلفة 1/7! إعادة الضبط يوميًا الساعة 10:00 صباحًا.

MiniMax M2.1 (إعادة الضبط لمدة 5 ساعات، 0.20 دولار/1 مليون)

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

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

نصيحة احترافية: الخيار الأرخص للسياق الطويل (مليون رمز)!

كيمي K2 (شقة بقيمة 9 دولارات شهريًا)

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

الاستخدام: kimi/kimi-latest

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

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

iFlow (5 نماذج مجانية عبر OAuth)

Dashboard → Connect iFlow
→ iFlow 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 موديلات مجانية عبر رمز الجهاز)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

كيرو (كلود فري)

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

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
🎨 إنشاء مجموعات

مثال 1: زيادة الاشتراك إلى الحد الأقصى → النسخ الاحتياطي الرخيص

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

المثال 2: مجاني فقط (بدون تكلفة)

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!
🔧 تكامل سطر الأوامر

بيئة تطوير متكاملة للمؤشر

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

كلود كود

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

كوديكس سطر الأوامر

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:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

ملاحظة: يعمل OpenClaw فقط مع OmniRoute المحلي. استخدم 127.0.0.1 بدلاً من localhost لتجنب مشكلات دقة IPv6.

كلاين / متابعة / RooCode

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

الكود المفتوح

الخطوة 1: أضف OmniRoute كموفر مخصص:

opencode
/connect
# Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

الخطوة 2: إنشاء/تحرير opencode.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:

/models
# Select any OmniRoute model from the list

نصيحة: أضف أي نموذج متاح في نقطة النهاية OmniRoute /v1/models إلى القسم models. استخدم التنسيق provider/model-id من لوحة تحكم OmniRoute.

🐛 استكشاف الأخطاء وإصلاحها

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

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

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

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

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

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

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

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

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

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

  • 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

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

  • اضبط ENABLE_REQUEST_LOGS=true في .env

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

  • لا يكشف العديد من مقدمي الخدمة عن نقطة نهاية /models
  • يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
  • تأكد من أن عنوان URL الأساسي يتضمن اللاحقة /v1

🔐 OAuth على خادم بعيد

⚠️ مهم للمستخدمين الذين يقومون بتشغيل OmniRoute على VPS أو Docker أو أي خادم بعيد

لماذا يفشل Antigravity / Gemini CLI OAuth على الخوادم البعيدة؟

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

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

Error 400: redirect_uri_mismatch

الحل: قم بتكوين بيانات اعتماد OAuth الخاصة بك

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

خطوة بخطوة

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):

# 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

# npm:
npm run dev

# Docker:
docker restart omniroute

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

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

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

الحل المؤقت (بدون بيانات اعتماد مخصصة)

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

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

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

🇧🇷 النسخة البرتغالية

لماذا يستخدم OAuth Antigravity / Gemini CLI في الخوادم البعيدة؟

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

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

Error 400: redirect_uri_mismatch

الحل: تكوين OAuth الخاص بك

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

باسو باسو

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

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

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

  • انقر على "+ إنشاء بيانات الاعتماد" → "معرف عميل OAuth"
  • نوع التطبيق: "تطبيق ويب"
  • الاسم: اسم escolha qualquer (على سبيل المثال: 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):

# 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

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

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

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

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

الحل المؤقت (لم يتم تكوين الاعتمادات الخاصة)

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

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

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

🛠️ تيك ستاك

انقر لتوسيع تفاصيل المجموعة التقنية
  • وقت التشغيل: 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
  • الحزمة: npmjs.com/package/omniroute
  • عامل الميناء: hub.docker.com/r/diegosouzapw/omniroute
  • المرونة: قاطع الدائرة، والتراجع الأسي، وقطيع مكافحة الرعد، وانتحال TLS، والإصلاح الذاتي للتحرير والسرد التلقائي

📖 التوثيق

وثيقة الوصف
User Guide مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر
API Reference جميع نقاط النهاية مع الأمثلة
MCP Server 16 أدوات MCP وتكوينات IDE وعملاء Python/TS/Go
A2A Server بروتوكول JSON-RPC 2.0، المهارات، التدفق، إدارة المهام
Auto-Combo Engine تسجيل 6 عوامل، حزم الوضع، الشفاء الذاتي
Troubleshooting المشاكل والحلول الشائعة
Architecture بنية النظام والداخلية
Contributing إعداد التطوير والمبادئ التوجيهية
OpenAPI Spec مواصفات OpenAPI 3.0
Security Policy الإبلاغ عن الثغرات الأمنية والممارسات الأمنية
VM Deployment الدليل الكامل: إعداد VM + nginx + Cloudflare
Features Gallery جولة لوحة القيادة المرئية مع لقطات الشاشة
Release Checklist خطوات التحقق من صحة الإصدار المسبق

🗺️خريطة الطريق

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

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

🔜قريبا

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

📝 مواصفات الميزات الكاملة متوفرة في OMNI_TOKEN_342 (217 مواصفات تفصيلية)

👥 المساهمون

Contributors

كيفية المساهمة

  1. شوكة المستودع
  2. قم بإنشاء فرع الميزات الخاص بك (git checkout -b feature/amazing-feature)
  3. تنفيذ التغييرات (git commit -m 'Add amazing feature')
  4. ادفع إلى الفرع (git push origin feature/amazing-feature)
  5. افتح طلب السحب

راجع CONTRIBUTING.md للحصول على إرشادات مفصلة.

إطلاق نسخة جديدة

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

📊 تاريخ النجوم

مراقبو النجوم مع مرور الوقت

Stargazers over time

🙏 شكر وتقدير

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

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

📄 الترخيص

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

تم تصميمه باستخدام ❤️ للمطورين الذين يبرمجون 24/7
omniroute.online