# README (العربية) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية **من إنشاء [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — لا تتوقف عن البرمجة. كل أدوات الذكاء الاصطناعي → 388 موفرًا — أكثر من 150 موفرًا مجانيًا — عبر نقطة نهاية واحدة. Claude Code وCodex وCursor وCline وCopilot وAntigravity إلى Claude / GPT / Gemini مجانًا مع التحويل التلقائي عند التعذر. يوفر الضغط المتسلسل RTK + Caveman نسبة 15–95% من الرموز (بمتوسط ~89%) — لا تتجاوز الحدود أبدًا. 388 موفرًا للذكاء الاصطناعي · أكثر من 150 مستوى مجانيًا · ~1.62B رمز مجاني شهريًا · 20 استراتيجية توجيه · ابدأ بتكلفة $0.

## 💰 ~1.62B رمز مميز / شهر عبر المستويات المجانية لمزوّدي الجهات الخارجية

> **استخدم حساباتك لدى المزوّدين.** هذا تقدير إجمالي عبر مستويات مجانية لمزوّدين تابعين لجهات خارجية ومؤهلة بشكل منفصل، وليس منحة رموز مميزة من OmniRoute. سجّل، واحصل على بيانات الاعتماد عند الحاجة، واربط المزوّدين الذين يمكنك استخدامهم؛ إذ يتحكم كل مزوّد في حدوده ومدى توفره وشروطه. > > إن تجميع المستويات المجانية يدويًا أمر مرهق — عشرات من حزم SDK، وعشرات من حدود المعدل، ومن دون معرفة مقدار ما لديك فعليًا. يفهرس OmniRoute **465 إدخالًا ضمن المستوى المجاني عبر 34 مفتاحًا متكررًا للتجميع**، ويحسب الرقم الرئيسي للرموز المميزة من **17 مجموعة ذات ميزانية شهرية إيجابية منشورة، بالإضافة إلى خمسة حدود Groq لكل نموذج**، مع إزالة التكرار حسب المجموعة المشتركة. تظهر الحصص التي لا تُفتح إلا بعد التحقق من الهوية الإقليمية (حاليًا: ModelScope) بشكل منفصل، بإضافة ~6M بعد التحقق من الهوية الإقليمية، ولا تُجمع مطلقًا ضمن الرقم الرئيسي. تظل النتيجة ظاهرة في لوحة المعلومات (`/dashboard/free-tiers`).

بطاقة ميزانية المستوى المجاني في OmniRoute: ~1.62B رمز مميز مجاني شهريًا بشكل ثابت، وما يصل إلى ~2.22B في الشهر الأول مع أرصدة التسجيل، من 34 مفتاحًا موثقًا للتجميع المتكرر تغطي 465 إدخالًا مفهرسًا ضمن المستوى المجاني عبر نقطة نهاية واحدة. حساب صادق بعد إزالة التكرار حسب المجموعة — تُحتسب كل مجموعة مشتركة مرة واحدة، بما في ذلك 17 مجموعة متكررة ذات ميزانية شهرية إيجابية منشورة للرموز المميزة، بالإضافة إلى خمسة حدود Groq لكل نموذج؛ تم تصنيف 12 مزوّدًا على أنهم يجب تجنبهم في فهرس مخاطر الشروط، لتقرر أنت. يتضمن شريط الميزانية Mistral 1B وNara 210M وLLM7 150M وxKiro 150M وGroq 30M (خمسة حدود لكل نموذج) ومجموعات أصغر، بالإضافة إلى أرصدة التسجيل للشهر الأول والمزوّدين المجانيين بشكل دائم الذين لا يفرضون حدًا للرموز المميزة، ويظهرون بشكل منفصل حتى لا يضخموا الرقم الرئيسي مطلقًا. الاستخدام/المتبقي المباشر على /dashboard/free-tiers.

> ملخص متحرك لصفحة `/dashboard/free-tiers` المباشرة. المنهجية الكاملة (إزالة التكرار حسب المجموعة، ودرجات الأرصدة، وشروط المزوّدين): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{تُراجع هذه الأرقام كل أسبوعين مقابل الفهرس المباشر، و**تتحرك في كلا الاتجاهين** — ينهي أحد المزوّدين مستوى مجانيًا فينخفض الرقم؛ ويُضاف مزوّد جديد فيرتفع. ننشر ما يحسبه الفهرس فعليًا، وليس أفضل حالة مقربة إلى الأعلى.}

⭐ امنح المستودع نجمة إذا ساعدك OMNIROUTE على توفير المال وتسهيل عملك.

[![النجوم](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![ترتيب سجل النجوم](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 انضم إلى المجتمع **👋 تابع المشرف — واحصل أولًا على المزوّدين الجدد والإصدارات والنصائح:** [![تابع Diego على LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![تابع @diegosouzapw على GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp البرازيل](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![الموقع الإلكتروني](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **الأسئلة، ونصائح المزوّدين، وخارطة الطريق، والدعم → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 عالمي](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 البرازيل](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [البوابة](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 البوابة تواصل نموّها

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | -------------------------------- | :-------------------------: | :---------: | :-------------------: | | 🌐 المزوّدون | 352 | **358** | 388 | | 🧠 معرّفات نماذج الدردشة الفريدة | 1320 | **1374** | 1491 | | 🖼️ جسر الوسائط | 🆕 الرؤية + الصوت + الفيديو | ✓ | ✓ | | 📡 كتالوج Radar المجاني | 🆕 الاشتراك الاختياري | ✓ | ✓ | | ⚖️ الجدولة المراعية للحصص | 🆕 Quota-Share | ✓ | ✓ | | 📊 بيانات قياس الحصص | 🆕 مباشرة | ✓ | ✓ | | 🧰 الوضع بلا واجهة | — | — | 🆕 `serve --headless` | | 🛤️ البنية التحتية لمسار LTS | — | — | 🆕 قنوات الإصدار | | 🔎 واجهة برمجة اكتشاف النماذج | — | — | 🆕 `/v1/models/query` | **→ [خارطة الطريق](ROADMAP.md) — مواصلة المسار نحو `v3.9.0 LTS`**

## 🧩 متاح [![إصدار npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![شهريًا على NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![الترخيص: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![عمليات سحب Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![تنزيلات Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 البدء	🚀 البدء السريع	📦 التثبيت	🆓 توصيل مزوّد
💡 تعلّم	💥 الوعد	🤔 لماذا OmniRoute	🏆 ما يميّز OmniRoute
⚙️ الميزات	🎯 التركيبات	🌐 المزوّدون	🔌 CLI وMCP
	🗜️ الضغط	🖥️ أين يعمل	🔒 خاص
👀 شاهده	🎬 قيد الاستخدام	✨ ما الجديد	🤖 واجهات CLI المتوافقة
💚 الدعم	💚 دعم / تبرّع	💬 المجتمع	💖 الرعاة
📦 المشروع	🛠️ حزمة التقنيات	📖 التوثيق	👥 المساهمون

🌐 بـ67 لغة

## 🆓 ثبّت موفّرًا، واتصل به، ثم وجّه الطلبات عبر نقطة نهاية واحدة

ثلاث خطوات: ثبّت OmniRoute وشغّله، واتصل بموفّر مؤهل باستخدام حسابك أو مفتاح API الخاص بك، ثم وجّه أداتك إلى localhost:20128/v1 باستخدام مفتاح API لـ OmniRoute والنموذج auto. يعتمد التوجيه على الاتصالات المؤهلة المتاحة وحدود الموفّر.

```bash # بعد الاتصال بموفّر، انسخ مفتاح OmniRoute من لوحة المعلومات → نقاط النهاية: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{يحتاج `auto` إلى مسار مؤهل. قد لا يحتوي التثبيت الجديد على أهداف مؤهلة بلا مفاتيح، وقد يرفض الموفّر الذي لا يتطلب مفتاحًا عملاءً من جهات خارجية. يُستبعد الموفّرون المعلَّمون بالوسم `tos: avoid`، بما في ذلك Kiro، من التوجيه التلقائي افتراضيًا؛ ولا يؤدي الاتصال بحساب إلى تجاوز هذا الإعداد. راجع [دليل المستويات المجانية](docs/getting-started/FREE-TIERS-GUIDE.md) قبل اختيار موفّر.} _{📦 نصوص بدء سريع للنسخ واللصق لـ **Python وNode.js وPHP وcURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 الوعد

# 🤔 لماذا OmniRoute؟

تدفق طلب OmniRoute: تستدعي بيئة التطوير المتكاملة أو CLI الخاصة بك (Claude Code وCursor وCline…) نقطة نهاية محلية واحدة (http://localhost:20128/v1)؛ ويمكن لموجّه OmniRoute الذكي (ضغط RTK + Caveman، و20 استراتيجية توجيه، وقواطع الدارات، وتخفّي TLS، وMCP، وA2A، والضوابط الوقائية) الرجوع عبر 4 مستويات من الموفّرين ما دام هناك هدف مؤهل وسليم — المستوى 1: الاشتراك، والمستوى 2: مفتاح API، والمستوى 3: منخفض التكلفة، والمستوى 4: مجاني.

## 🤝 بدعم من أصدقائنا في المصادر المفتوحة

> **هل ترغب في الانضمام بصفتك صديقًا للمصادر المفتوحة؟** هذه هي الشركات التي تدعم المصادر المفتوحة وتساعد على استمرار تطور OmniRoute — ونعلن على الملأ أين يُنفق كل رمز تمنحنا إياه. تواصل معنا: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} شكرًا لـ Kimi (Moonshot AI)، صديقنا المؤسس للمصادر المفتوحة، على دعم هذا المشروع! Kimi هو مختبر الذكاء الاصطناعي الذي يقف وراء عائلتي النماذج مفتوحة الأوزان K2 وK3 — ويوفر Kimi K3 نافذة سياق بسعة 1M رمز، ورؤية أصلية، وقدرات برمجية بمستوى ريادي مقابل جزء بسيط من أسعار النماذج المغلقة، كما يعمل مباشرةً مع Claude Code وCodex وكل أداة برمجية يدعمها OmniRoute.

ما الذي يتيحه دعم Kimi: تُشغّل أرصدة API المقدمة من Kimi مسار الإصدارات المتحقق منه بالذكاء الاصطناعي في OmniRoute — أي مرحلة التحقق من الدمج بدعم Kimi K3 التي تراجع كل طلب سحب قبل إصداره — بالإضافة إلى تطوير الميزات اليومية. يتوفر دعم Kimi من الدرجة الأولى عبر المسارين: Kimi API المباشر (kimi-k3) وخطة البرمجة Kimi Code (OAuth ومفتاح API). يُعد OmniRoute أيضًا أول مشروع برازيلي مفتوح المصدر ضمن برنامج دعم Kimi. احصل على مفتاح Kimi API مع أرصدة إضافية بنسبة 15% ←

Cheaper Inference
_{cheaperinference.com} شكرًا لـ Cheaper Inference، أحد أصدقاء OmniRoute في المصادر المفتوحة، على دعم هذا المشروع! Cheaper Inference هي بوابة مرتبة حسب التكلفة تعيد بيع 42 نموذجًا رياديًا — Claude وGPT-5.x وGemini وKimi K3 وGLM وDeepSeek وGrok وMiniMax — من خلال نقطة نهاية واحدة متوافقة مع OpenAI، وتوجّه كل طلب إلى أرخص مزود مؤهل من دون فرض تكلفة تتجاوز السعر المعلن من مطور النموذج.

دعم من الدرجة الأولى في OmniRoute: إكمالات المحادثة، ونقطة النهاية الأصلية /v1/responses، والرؤية، واستدعاء الأدوات، و3 نماذج للصور (grok-imagine وnano-banana-pro وnano-banana-2، ويمكن الوصول إليها بصيغة cheaperinference/<model>). احصل على مفتاح API ←

_{الروابط الموسومة بـ aff=omniroute هي روابط شركاء. وهي تموّل المشروع من دون أي تكلفة إضافية عليك.}

_{🎟️ عروض الشركات التابعة — قسائم تسجيل مجانية من مزودين لا يرعوننا (انقر للتوسيع)}

_{هذا القسم مخصص لرموز الإحالة/القسائم فقط. توجد الشراكات المدعومة في قسم 🤝 بدعم من أصدقائنا في المصادر المفتوحة أعلاه. لا توجد أي رعاية أو شراكة بين OmniRoute والمزودين المدرجين هنا — فهذه قسائم عامة يمكن لأي شخص استخدامها.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — تسجيل عبر رابط تابع · أرصدة مجانية بقيمة $100 عند التسجيل (خادم مجاني، لذا توقّع زمن وصول أعلى — وهو الأنسب للاختبار لا لبيئات الإنتاج). دعم من الدرجة الأولى في OmniRoute منذ v3.8.50: إكمالات المحادثة، وتنسيق الاتصال المتوافق مع Anthropic، والمسار المتوافق مع OpenAI. تشمل النماذج المتاحة claude-opus-4-8 وclaude-opus-5 وgpt-5.6-sol والمزيد. احصل على رصيدك البالغ $100 ←}

_{⚠️ رابط تابع — لا توجد أي رعاية أو شراكة بين OmniRoute وهذا المزود.}

_{هل تعرف مزودًا آخر يقدم قسيمة تسجيل مجانية سخية تفيد مستخدمي OmniRoute؟ افتح مشكلة وسنضيفه هنا.}

## 🎯 المجموعات — الميزة الرئيسية

أمثلة متحركة على 18 من استراتيجيات توجيه المجموعات العشرين — لوحة واحدة لكل استراتيجية: priority وfill-first وweighted وround-robin وp2c وleast-used وrandom وstrict-random وcost-optimized وheadroom وreset-window وreset-aware وcontext-relay وcontext-optimized وlkgp وauto وfusion وpipeline. لا تتوفر رسوم متحركة لاستراتيجيتي cache-optimized وquota-weighted؛ ويصف الجدول أدناه الاستراتيجيات العشرين جميعها.

> **المجموعة** هي سلسلة من النماذج يوجّه OmniRoute الطلبات بينها **تلقائيًا**. إذا نفدت الحصة، أو تعطل أحد المزوّدين، أو ارتفعت التكاليف، فيمكن للمجموعة الانتقال إلى النموذج السليم والمؤهل التالي. 🛡️ ### ⚡ بلا إعداد — استخدم `auto` فحسب لا حاجة إلى إنشاء مجموعة. عيّن نموذجك إلى `auto` (أو أحد أشكاله)، وسيُنشئ OmniRoute مجموعة افتراضية من مزوّديك المتصلين، مع تقييم مباشر:

معرّف النموذج	ما الذي يُحسّنه
`auto`	🎯 الإعداد الافتراضي المتوازن (LKGP — يلتزم بآخر مزوّد ناجح لديك)
`auto/coding`	🧑💻 أوزان تعطي الأولوية للجودة عند توليد الشيفرة البرمجية
`auto/fast`	⚡ أقل زمن استجابة أولًا
`auto/cheap`	💰 الأقل تكلفة لكل رمز أولًا
`auto/subscription`	🎟️ حصة الاشتراك التي تدفع مقابلها بالفعل فقط — يفشل بشكل مغلق، ولا يعود مطلقًا إلى خيار مدفوع (الدليل)
`auto/thrifty`	🪜 حصة الخطة أولًا، ثم الانتقال درجةً تلو الأخرى إلى أرخص الخيارات المدفوعة — والعودة إلى الخطة بعد إعادة تعيينها (الدليل)
`auto/offline`	🔋 أكبر هامش متاح من الحصة / حدّ المعدل أولًا
`auto/smart`	🔭 الجودة أولًا + استكشاف بنسبة 10% لاكتشاف نماذج أفضل
`auto/lkgp`	📌 الالتزام الصريح بآخر مزوّد معروف بنجاحه
`auto/chaos`	🧪 توزيع متوازٍ إلى مجموعة من النماذج (واحد لكل مزوّد، و5 افتراضيًا)، مع إرجاع إجابة واحدة؛ استدعاء واحد للجهة العليا لكل نموذج في المجموعة، وليس حقنًا للأعطال

## ### 🔀 أو أنشئ مجموعتك الخاصة — 20 استراتيجية توجيه جميع الاستراتيجيات **العشرين** — امزج وطابق لكل خطوة في المجموعة:

#	الاستراتيجية	وظيفتها
1	`priority`	قائمة مرتبة تبدأ بالهدف الأول — استنفاد كل هدف قبل الانتقال إلى التالي 🥇
2	`fill-first`	استنفاد حصة كل هدف بالكامل قبل الانتقال إلى التالي
3	`weighted`	اختيار عشوائي موزون بحسب وزن كل هدف
4	`round-robin`	التناوب بين الأهداف بالترتيب
5	`p2c`	موازنة حمل عشوائية وفق أسلوب قوة الخيارين
6	`least-used`	اختيار الهدف ذي أقل حمل حالي
7	`random`	اختيار عشوائي منتظم (مع إزالة التكرارات)
8	`strict-random`	اختيار عشوائي من دون إزالة التكرارات 🎲
9	`cost-optimized`	تقليل التكلفة بالدولار لكل طلب استنادًا إلى تسعير الكتالوج المباشر 💸
10	`headroom`	اختيار الهدف ذي أكبر حصة متبقية
11	`quota-weighted`	تجاوز الحسابات المستنفدة، ثم الاختيار بما يتناسب مع الحصة المتبقية ÷ الحمل قيد التنفيذ — تظل المحادثات الحالية مثبتة ⚖️
12	`reset-window`	تفضيل الهدف الذي يُعاد تعيين نافذة حصته في أقرب وقت
13	`reset-aware`	الترتيب حسب وقت إعادة تعيين الحصة — النوافذ الأقصر أولًا 📊
14	`context-relay`	تمرير السياق بين الأهداف للمحادثات الطويلة 🧠
15	`context-optimized`	اختيار الأنسب لحجم السياق الحالي
16	`cache-optimized`	تثبيت كل بادئة مطالبة قابلة لإعادة الاستخدام على الحساب نفسه — لتعظيم إصابات ذاكرة التخزين المؤقت للمطالبات 🎯
17	`lkgp`	المسار الأخير المعروف بنجاحه — يثبّت التوجيه على آخر مزوّد ناجح، ثم يعود إلى القواعد عند الحاجة
18	`auto`	تقييم مباشر يستند إلى 16 عاملًا عبر كل اتصال 🤖
19	`fusion`	التوزيع إلى مجموعة من النماذج + مُحكِّم يركّب إجابة واحدة 🧬
20	`pipeline`	تسلسل الخطوات — تُمرَّر مخرجات كل هدف إلى الهدف التالي 🔗

_{يقيّم محرك Auto-Combo كل مرشح استنادًا إلى **16 عاملًا** (السلامة، الحصة، التكلفة، زمن الاستجابة، ملاءمة المهمة، الجودة، توفر الجلسة…) — راجع [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 المرونة مدمجة في النظام (3 طبقات مستقلة)

مرونة OmniRoute — 3 طبقات مستقلة ذاتية التعافي، بحيث تتولى الطبقة المناسبة معالجة العطل المناسب. الطبقة 1: قاطع دائرة المزوّد (المزوّد بأكمله): لا يُفعّل إلا عند أخطاء 408/5xx، بحدود OAuth ‏8× / مفتاح API ‏12× / محلي ‏2×، ويُعاد ضبطه بعد 60s/30s/15s للدخول في اختبار HALF-OPEN، مع تعافٍ كسول؛ وأثناء حالة OPEN، تعيد المجموعة التوجيه إلى المزوّد التالي. الطبقة 2: فترة تهدئة الاتصال (مفتاح/حساب واحد): مدة أساسية قدرها 5s لـ OAuth / ‏3s لمفتاح API، مع تراجع أُسّي ×2 وحماية من الاندفاع المتزامن، ويحترم الخطأ 429 قيمة Retry-After، بينما يؤدي النجاح إلى مسح حالة الخطأ بالكامل؛ يُتخطى المفتاح الذي يمر بفترة تهدئة، بينما تواصل المفاتيح الأخرى تقديم الخدمة. الطبقة 3: حظر النموذج (نموذج واحد): يؤدي الخطأ 429 الخاص بالنموذج، أو الخطأ المحلي 404، أو رفض الأوضاع إلى حظر ذلك النموذج فقط — وليس الاتصال بأكمله مطلقًا. الحالات النهائية (محظور، منتهي الصلاحية، نفاد الرصيد) مخصصة لتدخل المشغّل وليست فترات تهدئة.

_{📖 [محرك Auto-Combo](docs/routing/AUTO-COMBO.md) · [دليل المرونة](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 ما الذي يميز OmniRoute

_{📊 المنهجية الكاملة والتفاصيل حسب كل ميزة مقارنةً بـ 9router وOpenRouter وCLIProxyAPI وLiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 ادعم OmniRoute يخضع OmniRoute لترخيص MIT وتتم صيانته بشكل علني. إذا كان يوفر عليك الوقت أو المال، فإليك كيفية المساعدة في الحفاظ على استقلاليته — اختر ما يناسبك. لا تؤثر الرعاية مطلقًا في أولوية التوجيه؛ فهي تمنح الظهور، لا ترتيبًا أعلى.

⭐ ضع نجمة للمستودع	مجاني — ويساعد فعلًا في زيادة الظهور	ضع نجمة لـ OmniRoute
🐙 GitHub Sponsors	مرة واحدة أو شهريًا · دون رسوم للمنصة	github.com/sponsors/diegosouzapw
☕ Ko-fi	إكرامية سريعة لمرة واحدة، دون حاجة المتبرع إلى التسجيل	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	لفتة بسيطة وغير رسمية	buymeacoffee.com/diegosouzapw
🖐 Liberapay	متكرر · غير ربحي · مفتوح المصدر	liberapay.com/diegosouzapw
🇧🇷 PIX (البرازيل)	فوري، دون رسوم	المفتاح ورمز QR أدناه
₿ العملات المشفرة	BTC · ETH · USDT-TRC20 · USDC-Solana	العناوين أدناه

**🇧🇷 PIX** — فوري، دون رسوم (البرازيل) رمز QR لخدمة PIX الخاص بـ OmniRoute

المفتاح (عشوائي): `5d865059-bc44-483a-962d-43ceb80126eb` رمز Pix للنسخ واللصق: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ العملات المشفرة — BTC · ETH · USDT-TRC20 · USDC-Solana (انقر للتوسيع)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ أرسل كل عملة عبر الشبكة الموضحة فقط — فقد يؤدي الإرسال عبر شبكة خاطئة إلى خسارة الأموال.}

🐛 هل عثرت على خطأ أو لديك ملاحظات؟ افتح [نقاشًا](https://github.com/diegosouzapw/OmniRoute/discussions).

ملاحظات للمطورين: قد ينشئ المشروع ملف .env محليًا أثناء npm install/postinstall لتسهيل عمل المطورين. يُستبعد هذا الملف عمدًا عبر .gitignore (راجع .gitignore) ويجب عدم إدراجه في أي عملية حفظ تغييرات مطلقًا — وإذا أُدرج عن طريق الخطأ، فاستبدل أي أسرار مكشوفة واحذف الملف من السجل. راجع docs/DEVELOPER-ENVIRONMENT.md للحصول على إرشادات حول إدارة ملفات البيئة المحلية والأسرار.

## 📡 رادار OmniRoute يظل العنوان الرئيسي للطبقة المجانية هو **~1.62 مليار رمز/شهريًا** من الكتالوج الموثّق أعلاه بعد إزالة التكرارات بين المجموعات. ويمكن لأرصدة التسجيل المؤقتة لدى مزوّدي الخدمة أن ترفع إجمالي الشهر الأول بشكل منفصل إلى **~2.22 مليار**. يُعد Radar تراكبًا اختياريًا وموقّعًا للكتالوج، مخصصًا لمن يريدون معلومات أحدث عن توافر النماذج المجانية بين إصدارات OmniRoute؛ ويظل كتالوج المجتمع وجميع الميزات المجانية الحالية مجانيًا. يمكن للداعمين تلقي الكتالوج المباشر وفرص إضافية من مزوّدي الخدمة. ويبلغ حده الأقصى المنفصل والمتغير **نحو 3 مليارات رمز/شهريًا كحد أقصى**، وفقًا لتوافر مزوّدي الخدمة. وهذا الحد الأقصى ليس ضمانًا: إذ يمكن لمزوّدي الخدمة تغيير الحصص أو شروط الأهلية أو النماذج أو المناطق في أي وقت. Radar اختياري ويستخدم طلبات GET فقط. لا يرفع عميل OmniRoute المطالبات أو بيانات حركة الاستخدام أو إعدادات مزوّدي الخدمة أو بيانات قياس الاستخدام عن بُعد أو حالة تجاهل الإعلانات المحلية. تعرّف على شروط الأهلية والكتالوج الحالي عبر **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ ما الجديد

> أبرز المستجدات من **v3.8.20 → v3.8.54**. السجل الكامل في [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ استراتيجية التوجيه `quota-weighted`** — تتخطى استراتيجية الدمج العشرون الحسابات المستنفدة، ثم تختار من بين الحسابات المتبقية بما يتناسب مع الحصة المتبقية ÷ الحمل قيد التنفيذ، مع إبقاء المحادثات الحالية مثبتة. → [الدمج التلقائي](docs/routing/AUTO-COMBO.md) - **🧰 الوضع عديم الواجهة** — يشغّل `omniroute serve --headless` (أو `OMNIROUTE_HEADLESS=1`) محرك الوكيل `/v1/*` فقط، مع تعطيل لوحة المعلومات والأنظمة الفرعية الخاصة بها. → [الوضع عديم الواجهة](docs/guides/HEADLESS.md) - **🔎 اكتشاف النماذج** — يرشّح `/v1/models` حسب القدرة والسياق والنوع والنص، بينما يعيد `POST /v1/models/query` قائمة مختصرة حتمية بالترتيب نفسه وبالرؤية نفسها لكل مفتاح. → [مرجع API](docs/reference/API_REFERENCE.md) - **🔑 التحكم في التوجيه لكل مفتاح** — ثبّت مفتاح API على نموذج أو دمج واحد باستخدام `forcedModel`، وأضف نماذج وعمليات دمج المفتاح أو أزلها بشكل ذري (`/api/keys/{id}/access`). → [مرجع API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ ضوابط أدق لمعلومات التعريف الشخصية** — اختيار حسب النوع، وما يصل إلى 20 نمط إخفاء مخصصًا تم التحقق منه، وعدادات اكتشاف لكل نوع؛ يظل الإخفاء نفسه اختياريًا. → [حواجز الحماية](docs/security/GUARDRAILS.md) - **🌍 67 لغة** — لوحة المعلومات والوثائق المنعكسة وواجهة CLI، مع إضافة `npm run i18n:add-locale` للغة في كل المواضع بأمر واحد. → [دليل i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — تفويض A2A الوارد إلى أسطول وكلائك، ومهارات Conductor في بطاقة الوكيل، ولوحة في لوحة المعلومات مع محادثة صوتية بنمط الضغط للتحدث عبر Faro. → [خادم A2A](docs/frameworks/A2A-SERVER.md) - **🛂 القبول التكيفي والحماية من الحمل الزائد** — تُوضَع طلبات الدردشة الثقيلة في قائمة انتظار بدلًا من إرجاع 503، مع عقود RPM متحركة ذرية لكل اتصال. → [دليل المرونة](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ الترتيب الأساسي لـ `/v1/models`** — كتلة واحدة متصلة مجمعة حسب المزوّد لكل مزوّد (مع تثبيت عمليات الدمج أولًا)، ومستقرة عبر كل مصادر الفهرس. → [مرجع API](docs/reference/API_REFERENCE.md) - **🗜️ تعزيز متانة الضغط** — حارس تضخم مفعّل افتراضيًا، وحزم Caveman للغات DE / FR / JA + الصينية (wényán)، ومرشحات RTK لـ Gradle و.NET. → [الضغط](docs/compression/COMPRESSION_ENGINES.md) - **💸 تكلفة صادقة بسعر ثابت** — تظهر المزوّدات القائمة على الاشتراك / خطط البرمجة بتكلفة **$0** في تحليلات التكلفة؛ بينما تواصل الميزانية والحصة والتوجيه إجراء التقديرات. → [مرجع API](docs/reference/API_REFERENCE.md) - **⚖️ توجيه Quota-Share** — يقسّم حصة الحساب المشترك بعدل بين المفاتيح المجمّعة، مع الحفاظ على استمرارية العمل بحيث تُعار الشرائح الخاملة. → [دليل المرونة](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 إعداد CLI/الوكيل بأمر واحد** — 15 أمرًا مسجلًا من `setup-*`؛ ويشغّل `omniroute run` سبع واجهات CLI (Claude Code وCodex وAider وGoose وOpenCode وQwen Code وGemini CLI)؛ ويدعم `omniroute configure` 11 هدفًا مع منتقي تفاعلي للمزوّد والنموذج ومفضلات حسب السياق. → [تكاملات CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ الوضع البعيد** — تحكّم في OmniRoute بعيد باستخدام رموز مميّزة محددة النطاق (`connect` / `contexts` / `tokens`) + مساعد OAuth باسم `antigravity` لتثبيتات VPS. → [الوضع البعيد](docs/guides/REMOTE-MODE.md) - **🧭 توجيه تلقائي أكثر ذكاءً** — عمليات دمج `auto/:`، و**Fusion** (لوحة نماذج + حَكَم)، وتوجيه واعٍ بالمهمة، وتجاوزات للنموذج / الوضع / ميزانية USD لكل طلب. → [الدمج التلقائي](docs/routing/AUTO-COMBO.md) - **🗜️ ضغط قابل للتوصيل** — 12 محركًا قابلًا للتركيب + استوديوهات الضغط: LLMLingua-2، وUltra ثنائي المستوى، وomniglyph، وبوابة دقة لكل خطوة، وGCF v3.2، ومحرر لإعادة الترتيب بالسحب. → [الضغط](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ فك تشفير MITM شفاف (TPROXY)** — واجهات CLI لالتقاط الاتصالات التي تتجاهل متغيرات بيئة الوكيل، مع مثبّت CA لكل SNI + مخزن ثقة. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 قياس التكلفة في كل مكان** — ترويسات تكلفة/استخدام `X-OmniRoute-*` على كل نقطة نهاية، وترويسة توفير خاصة بإصابة ذاكرة التخزين المؤقت، وحصص إنفاق USD لكل مفتاح. → [مرجع API](docs/reference/API_REFERENCE.md) - **🧠 ذاكرة تحت سيطرتك** — معطّلة افتراضيًا، مع تكميم متجهات int8 اختياري وتلاشي مُصنّف، و`x-omniroute-no-memory` لكل طلب. → [الذاكرة](docs/frameworks/MEMORY.md) - **🛡️ الأمان** — حارس ضد حقن التعليمات على كل مسار LLM (مع مجموعة اختبارات red-team)، وحاجز اختياري لإخفاء بيانات الاعتماد (يحجب مفاتيح API والأسرار المسرّبة في الاتجاهين)، وبحث ويب مجاني عبر DuckDuckGo كحل أخير، وبوابة تسجيل دخول OIDC اختيارية للوحة المعلومات (ويظل تسجيل الدخول بكلمة المرور متاحًا دائمًا). → [حواجز الحماية](docs/security/GUARDRAILS.md) - **🖼️ نقاط نهاية جديدة** — يكمل `/v1/ocr` (Mistral OCR) و`/v1/audio/translations` (بنمط Whisper) نطاق الوسائط. → [مرجع API](docs/reference/API_REFERENCE.md) - **🎨 توليد الصور / الفيديو / الصوت** — واجهة API واحدة للوسائط: xAI Grok Imagine وNovita AI للفيديو، وComfyUI، وMagnific، وAdobe Firefly، وSegmind، ومزوّدو الكلام مثل ElevenLabs. → [مرجع API](docs/reference/API_REFERENCE.md) - **🌍 النشر والعمليات** — `basePath` للوكيل العكسي، والكشف التلقائي عن لغة المتصفح، وتتبع الأجهزة لكل مفتاح، وثقة MITM دون صلاحيات الجذر، وتوطين zh-TW. → [البيئة](docs/reference/ENVIRONMENT.md) - **🤝 مزوّدون ووكلاء إضافيون** — وكلاء سحابيون (Codex Cloud وCursor وDevin وJules)، وGrok Build (xAI) مع تسجيل الدخول عبر المتصفح وOAuth، وبطاقة Ollama من الدرجة الأولى، وClaude Opus 5 وSonnet 5، وشراكة Kimi الرسمية (Code/Web/Moonshot)، وZed وRequesty وSenseNova وYuanbao وAgnes AI… و**فهرس محدّث يضم 388 مزوّدًا**. → [المزوّدون](docs/reference/PROVIDER_REFERENCE.md) - **📡 شفافية التوجيه** — تحمل كل استجابة ترويسة `X-OmniRoute-Decision` التي تسمّي الاستراتيجية/المزوّد/زمن الاستجابة الذي خدمها، وتعيد استراتيجية الدمج الجديدة `cache-optimized` + عامل `cacheAffinity` في Auto-Combo توجيه الطلبات المتكررة إلى الاتصال الذي يحتفظ بالبادئة المخزنة مؤقتًا، كما تكشف نقطة النهاية للقراءة فقط `/v1/auto-combo/{channel}/candidates` عن مجموعة المرشحين الحية لقناة `auto/*`. → [الدمج التلقائي](docs/routing/AUTO-COMBO.md) - **⚡ الأداء المحلي والبنية التحتية** — خدمات Redis محلية بنقرة واحدة، وأدوات نشر مرحّل Cloudflare Workers / Deno Deploy، وBifrost وMux كخدمات مضمّنة خاضعة للإشراف. → [الخدمات المضمّنة](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 متضمّن أيضًا** — إطار عمل الإضافات + سوقها، وإطارا مهارات Omni/Agent/GitHub، وتكامل خزنة Obsidian (22 أداة MCP)، وواجهتا Batch وFiles المتوافقتان مع OpenAI، وذاكرة تخزين مؤقت دلالية للاستجابات، وعناصر تحفيزية مع لوحات المتصدرين، واكتشاف وكلاء ACP (15 وكيلًا مضمّنًا)، وتصدير مجدول للسجلات إلى BigQuery، وتوزيع متوازٍ متعدد النماذج `auto/chaos`، وجسر روبوت Telegram، ومدير إصدارات داخل التطبيق، وتصنيفات مزوّدي LMArena-ELO المجانيين. → [الوثائق](docs/README.md)

## 🤖 واجهات الأوامر والوكلاء البرمجيون المتوافقون > إعداد واحد — `http://localhost:20128/v1` — وكل **أداة تطوير أو واجهة أوامر** تعمل على نماذج مجانية ومنخفضة التكلفة.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ يعمل أيضًا مع · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · أي أداة متوافقة مع OpenAI

_{📖 إعداد لكل أداة من الأدوات الـ 39 (28 أداة CLI Code + 11 وكيل CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 إضافة OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**شغّل أي CLI مدعوم عبر OmniRoute بأمر واحد** — بدون كتابة ملفات إعداد، يتم حقن بيانات الاعتماد لكل عملية، وتحصل Qwen/Gemini على مجلد منزلي معزول مؤقت: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # أو اختر المزود+النموذج بشكل تفاعلي واكتب إعداد الأداة نفسها: omniroute configure codex # أيضًا: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` كل أمر يلتزم بسياق الاتصال البعيد النشط (`omniroute connect `)، و`--dry-run` يعرض معاينة دقيقة للبيئة/المعطيات بدون تنفيذ، و`--api-key-env NAME` يبقي الأسرار خارج سجل أوامر الصدفة لديك. → [تكاملات CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 مزوّدًا للذكاء الاصطناعي — 153 منها معلّمة في الفهرس كخدمات مجانية

> **388 مزوّدًا مسجّلًا** ضمن مجموعات الدردشة والوسائط والبحث والمحلية ووكلاء السحابة والنظام الأساسية، بما في ذلك **153 مزوّدًا يحمل بيانات وصفية للاكتشاف `hasFree: true`**. يغطي سجل نماذج الدردشة **239 مزوّدًا / 3,059 زوجًا مميزًا من المزوّد-النموذج / 1,475 معرّف نموذج خام**؛ بينما يحتوي فهرس الميزانية المجانية المنفصل على **471 صفًا لكل نموذج**، و**34 مجموعة متكررة**، و**52 مزوّدًا مجانيًا إلى الأبد ومتكررًا/دون مفتاح**. هذه مقامات مختلفة عمدًا؛ وتوجد التعريفات والحسابات بعد إزالة تكرار المجموعات في [مرجع المزوّدين](docs/reference/PROVIDER_REFERENCE.md) و[الخطط المجانية](docs/reference/FREE_TIERS.md).

### 🏢 كل المختبرات الكبرى — عبر نقطة نهاية واحدة

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…و350+ مزيدًا — تُحمّل كل أيقونة مباشرةً من فهرس المزوّدين في لوحة المعلومات. 📖 [مرجع المزوّدين](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 مجاني إلى الأبد — $0، دون بطاقة

OpenCode Zen _{DeepSeek V4، Nemotron 3 من دون حدّ للرموز}	Kilo Code _{موجّه تلقائي، Tencent Hy3 مجاني إلى الأبد}	Requesty _{GPT-OSS 120B، Nemotron مجاني إلى الأبد}	SiliconFlow _{DeepSeek V3.2 / R1 خطة مجانية}	Z.AI GLM _{GLM-4.7 / 4.5-Flash مجاني إلى الأبد}	Baidu ERNIE _{ERNIE 4.0 مجاني إلى الأبد}
Qoder AI _{Qwen3-Max، Kimi-K2 مجاني بلا حدود}	Pollinations _{GPT، Llama، Claude لا حاجة إلى مفتاح}	Cloudflare AI _{أكثر من 50 نموذجًا 10 آلاف وحدة عصبية/اليوم}	NVIDIA NIM _{GLM، MiniMax حوالي 40 RPM مجانًا}	Cerebras _{GLM 4.7، GPT-OSS رصيد لمرة واحدة بقيمة $5؛ البطاقة مطلوبة}	OpenRouter _{نماذج مجانية +$10 ← RPM أعلى}

📖 الكتالوج الكامل القابل للقراءة آليًا → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ حيث يعمل OmniRoute - في أي مكان

> نفس التطبيق، جهازك، القواعد الخاصة بك. من تثبيت npm عالمي إلى** هاتفك** عبر ترموكس.

منصة	تثبيت	يسلط الضوء على
📦 npm (عالمي)	`npm تثبيت -g omniroute`	أمر واحد، أي OS
⚡ Bun (عالمي)	`Bun add -g omniroute`	نفس التسجيل tarball، عمليات تثبيت أسرع
🐳 Docker	`docker run … diegosouzapw/omniroute`	متعدد القوس AMD64 + ARM64
🖥️ سطح المكتب (Electron)	`npm تشغيل الإلكترون: بناء`	علبة النظام + النافذة الأصلية — Windows / macOS / Linux
🎩 شريط القوائم (OmniRouteTray)	`Brew install --cask zoispag/tap/omniroute-tray`	يشرف & يقوم بتحديث الخادم تلقائيًا — macOS
💪 ARM	الأصلي	Raspberry Pi، ARM zqm، Apple Silicon
📱 Android (Termux)	`pkg تثبيت عقدة js && npx -y omniroute`	تشغيل على هاتفك ، 24/7، بدون جذر
📲 PWA	"إضافة إلى الشاشة الرئيسية"	ملء الشاشة، غير متصل، قابل للتثبيت من المتصفح
🧩 OpenCode المساعد	`@omniroute/opencode-provider`	التكامل OpenCode الأصلي
🤖 VS Code Copilot Chat	install OmniCopilot ملحق	كل نموذج OmniRoute في منتقي الدردشة Copilot الأصلي - & المطلعون
🛠️ من المصدر	`npm install && npm run dev`	اخترقها، ساهم

[Docker](docs/guides/DOCKER_GUIDE.md)_{📖 zqc · [سطح المكتب](electron/README.md) · [علبة شريط القائمة](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 جديد: OmniRoute داخل دردشة Copilot الأصلية لـ VS Code

> لا يوجد شريط جانبي جديد، ولا توجد دردشة جديدة UI - كل نموذج يقدمه OmniRoute يظهر مباشرة في** منتقي نماذج الدردشة Copilot الذي تستخدمه بالفعل** . منذ كود VS 1.122، تعمل نماذج الموفر بدون تسجيل دخول GitHub أو اشتراك Copilot - وضع الوكيل واستدعاء الأدوات والرؤية مجانًا. تثبيت** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** الامتداد، قم بتوجيهه إلى خادم OmniRoute (الافتراضي هو `localhost:20128`)، ثم افتح Copilot Chat → model Picker →** إدارة النماذج...** →**OmniRoute** . متجر < td align ="left">VS Code — مستقر & Insiders < td محاذاة ="left">Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro...

	Link	يعمل مع
🧩 VS Code Marketplace	تثبيت →
🔓 افتح سجل VSX	تثبيت →

من داخل المحرر: افتح ملف** ملحقات** عرض، بحث** "OmniRoute"** ، انقر** ثَبَّتَ** - يعمل بنفس الطريقة في كلا المتجرين. المصدر والقضايا ودليل النشر مباشر على [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot دليل الدردشة](docs/guides/VSCODE-COPILOT.md) - الإعداد، ما يعرضه المنتقي، لوحة المعلومات في علامة تبويب، استكشاف أخطاء} وإصلاحها

### 🎩 جديد: OmniRouteTray — بوابتك، التي تعيش في شريط القائمة

> `omniroute serve` يكون أسعد عندما يكون قيد التشغيل دائمًا.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** يحول ذلك إلى تطبيق شريط قوائم "ضبط ونسيان" لـ macOS: فهو يبدأ تشغيل الخادم، ويبقيه نشطًا عبر عمليات إعادة التشغيل، ويحدثه في مكانه، ويضع ميزانية الرمز المميز الخاص بك على بعد نقرة واحدة -** لم يتم ترك نافذة طرفية مفتوحة، ولا `npm install -g omniroute` أطفال.** تم تصميمه باستخدام [Tauri v2](https://v2.tauri.app/) (نواة Rust بحجم خطأ تقريبي)، فهو يشحن وقت تشغيل Node 24 الموقع الخاص به ويدير تثبيت OmniRoute المملوك للتطبيق، لذلك فهو لا يحارب `node`/`bun` العالمي أبدًا. هو - هي** يشارك التكوين وقاعدة البيانات `~/.omniroute/` الموجودة لديك** - لذا فهو نفس OmniRoute الذي قمت بتشغيله بالفعل، فقط مع ارتداء القبعة. 🎩

ماذا يفعل	كيف
🟢 يشرف على الخادم	يولد `omniroute يخدم` ، ويتبنى مثيلًا قيد التشغيل بالفعل بدلاً من تكراره
📊 الاستخدام المباشر في لمحة	أشرطة حصص الموفر، حدود Claude session/weekly مع إعادة تعيين العد التنازلي، توزيع التكلفة لمدة 30 يومًا
🔄 التحديثات التلقائية في مكانها	التثبيت المرحلي والمبادلة الذرية والتراجع عند الفشل - دائمًا على الإصدار الأحدث
🚀 ابدأ عند تسجيل الدخول	إطلاق اختياري عند تسجيل الدخول؛ صينية فقط، لا يوجد رمز قفص الاتهام
🩺 سجلات Doctor &	التشخيص بنقرة واحدة والوصول إلى سجل الخادم

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{هل تفضل التنزيل؟ احصل على أحدث إصدار من .dmg من
تطلق . المصدر والقضايا والبناء
المستندات مباشرة في zoispag/omniroute-tray.

💛 مشروع مجتمعي لـ @zoispag - وليس إصدارًا رسميًا OmniRoute.}

## 🔒 خاص ويعمل محليًا أولًا

_{📖 [التخويل](docs/architecture/AUTHZ_GUIDE.md) · [ضوابط الحماية](docs/security/GUARDRAILS.md) · [الامتثال](docs/security/COMPLIANCE.md)}

## 🔌 واجهة CLI كاملة + ‏A2A وMCP

> إلى جانب الخادم، يُعد OmniRoute **مركز تحكم متكاملًا عبر سطر الأوامر** يضم **أكثر من 80 أمرًا**، بالإضافة إلى بروتوكولات وكلاء مفتوحة تتيح لوكيل ذكاء اصطناعي تشغيله **بشكل مستقل**. ### ⌨️ واجهة CLI حقيقية (وليست مجرد `start`) ```bash omniroute # تشغيل البوابة + لوحة المعلومات (المنفذ 20128) omniroute chat # عميل محادثة TUI تفاعلي (اختصارات الشرطة المائلة: /model /combo /skill /memory) omniroute setup # معالج إرشادي للتشغيل الأول omniroute doctor # تشخيص المزوّدين والمنافذ والتبعيات الأصلية ``` ### 🛰️ الوضع البعيد — شغّل واجهة CLI هنا وOmniRoute على خادم VPS هل OmniRoute يعمل على خادم؟ تحكّم فيه من حاسوبك المحمول باستخدام **واجهة CLI نفسها**. سجّل الدخول مرة واحدة باستخدام رمز وصول محدد النطاق؛ وبعد ذلك يستهدف كل أمر الخادم البعيد. ```bash omniroute connect 192.168.0.15 # كلمة المرور ← رمز محدد النطاق، يُحفظ كسياق omniroute models # ← يُنفَّذ على الخادم البعيد omniroute configure codex # ← يختار نموذجًا بعيدًا ويكتب ملف تعريف Codex محليًا omniroute tokens create --name ci --scope read # إصدار رموز أضيق نطاقًا للأجهزة الأخرى omniroute contexts use default # ← العودة إلى الخادم المحلي ``` تُحدَّد نطاقات الرموز إلى `read` / `write` / `admin`؛ وتظل المسارات التي تُنشئ عمليات مقتصرة على واجهة الاسترجاع المحلية. _{📖 [الوضع البعيد](docs/guides/REMOTE-MODE.md)}

عرض طرفية متحرك يستعرض واجهة OmniRoute CLI — الأوامر omniroute providers list وomniroute combo list وomniroute health — مع التنقل عبر واجهة المستوى الأعلى المكوّنة من 89 أمرًا: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 وصّل وكيلًا — وسيتحكم في OmniRoute نفسه أتِح OmniRoute عبر **MCP** أو **A2A** أو **REST API** أو **خطافات الويب** أو **واجهة CLI بعيدة** — وسيحصل أي وكيل قادر (أو شيفرتك الخاصة) على مفاتيح البوابة بأكملها: التوجيه، والمزوّدون، والتركيبات، وذاكرة التخزين المؤقت، والضغط، والذاكرة — بصورة مستقلة. تُقدَّم نقاط نهاية HTTP أدناه ضمن `http://localhost:20128`.

الواجهة	نقطة النهاية / الأمر	استخدمها من أجل
🧰 MCP (stdio)	`omniroute --mcp`	التكامل مع Claude Desktop وCursor وأي عميل MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP بعيد — 110 أداة، و33 نطاقًا (التطبيق اختياري)، وسجل تدقيق كامل
📡 MCP (SSE)	`/api/mcp/sse`	نقل MCP عبر البث
🤝 A2A	`/.well-known/agent.json`	اتصال من وكيل إلى وكيل، JSON-RPC 2.0 + SSE، و6 مهارات
🌐 REST API	`/v1/*`	متوافقة مع OpenAI — المحادثة، والتضمينات، والصور، والصوت، والتعرّف الضوئي على الأحرف
🔔 خطافات الويب	`/api/webhooks`	دفع أحداث الطلبات / الحصص إلى Slack أو Discord أو Telegram أو أي عنوان URL
🛰️ واجهة CLI بعيدة	`omniroute connect`	التحكم في مثيل بعيد باستخدام رموز وصول محددة النطاق

```bash # منح Claude Code مجموعة أدوات OmniRoute الكاملة عبر MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [خادم MCP](docs/frameworks/MCP-SERVER.md) · [خادم A2A](docs/frameworks/A2A-SERVER.md) · [بروتوكولات الوكلاء](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ وفّر 15–95% من الرموز — تلقائيًا

### 📖 كيف يعمل — خط الأنابيب والبنية وحساب التوفير

خط أنابيب الضغط في OmniRoute: يمر طلب عميل توضيحي مكوّن من 10,000 رمز عبر 12 محركًا قابلًا للتركيب — Session-Dedup وCCR وLite وRTK وResponses Tool Output وHeadroom وRelevance وCaveman وAggressive وLLMLingua-2 وUltra وOmniGlyph — ويمكن أن يصل إلى المزوّد بنحو 1,080 رمزًا في المثال التراكمي الموثّق. تتم حماية المحتوى المنظم بواسطة حواجز الحفظ وبوابات دقة لكل خطوة؛ وقد تحوّل الأوضاع الصريحة الفاقدة أو التجريبية المحتوى المؤهل.

يُشغّل المزيج التراكمي الافتراضي `RTK → Caveman`. عندما يعمل كلاهما على حمولة الأداة/السياق نفسها، تتراكم الوفورات: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` تتم **حماية كتل التعليمات البرمجية وعناوين URL وJSON والبيانات المنظمة دائمًا** بواسطة محرك الحفظ. > **لماذا تستخدم رموزًا كثيرة عندما تؤدي رموز قليلة الغرض؟** يمر كل طلب عبر خط أنابيب الضغط في OmniRoute **بشفافية** — من دون أي تغييرات على العميل. وهو الآن **مكدس من 12 محركًا قابلًا للتركيب** تعمل بالترتيب ويمكن مزجها ومطابقتها لكل تركيبة توجيه — مستفيدًا من أفكار [RTK](https://github.com/rtk-ai/rtk) و[Caveman](https://github.com/JuliusBrussee/caveman) (⭐ أكثر من 90 ألفًا) و[LLMLingua-2](https://github.com/microsoft/LLMLingua) و[Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 مكدس المحركات الـ12 تعمل المحركات بترتيب خط الأنابيب؛ ويمكن تبديل كل محرك وتهيئته بشكل مستقل لكل تركيبة:

#	المحرك	وظيفته
1	Session-Dedup	يحذف المحتوى المتكرر عبر الأدوار (مُعنون بالمحتوى، وعبر الأدوار)
2	CCR	يؤرشف الكتل الكبيرة خلف علامات استرجاع، ويجلبها عند الطلب
3	Lite	تشذيب المسافات البيضاء وعناوين URL للصور (خط أساس منخفض التأخير)
4	RTK	تصفية ذكية لنتائج الأدوات وإزالة التكرار والاقتطاع (مدركة للأوامر)
5	Responses Tool Output	ضغط JSON مع إعطاء الأولوية لعدم الفقدان + ضغط تشخيصي محدود لمخرجات shell/patch/search/build (Responses API)
6	Headroom	ضغط جدولي غير فاقد لمصفوفات JSON (نحو 30%) عبر برنامج ترميز GCF مضمّن
7	Relevance	تقييم استخلاصي للجمل مقابل آخر استعلام للمستخدم
8	Caveman	ضغط للنثر قائم على القواعد (نحو 65–75% من المخرجات)
9	Aggressive	تلخيص + تقادم تدريجي للأدوار القديمة
10	LLMLingua-2	تشذيب دلالي باستخدام ML عبر MobileBERT ONNX — آمن للتعليمات البرمجية، وغير متزامن
11	Ultra	تشذيب استدلالي للرموز مع مستوى اختياري لنموذج صغير (SLM)
12	OmniGlyph	ترميز تجريبي للسياق على هيئة صورة من أجل Claude Fable 5 المقاس على سلك Anthropic المباشر؛ تظل محوّلات GPT 5.6 في حالة فشل مغلق بانتظار إيصالات المزوّد. أربعة ملفات للضغط (الافتراضي العدواني، والمتوازن، والآمن للبرمجة، والتمرير) (الأكثر عدوانية؛ يتطلب التفعيل اختياريًا)

تُحفظ كتل التعليمات البرمجية وعناوين URL والبيانات المنظمة **دائمًا بشكل مطابق للبايتات**. تجمع **الإعدادات المسبقة بنقرة واحدة** المحركات:

الوضع	التوفير	الأفضل من أجل
🪶 Lite	~15%	الإعداد الافتراضي الآمن والمفعّل دائمًا
🪨 قياسي (Caveman)	~30%	البرمجة اليومية
⚡ Aggressive	~50%	الجلسات الطويلة كثيفة الأدوات
🔥 Ultra	~75%	أقصى قدر من التوفير
🧰 RTK	60–90%	مخرجات shell/test/build/git
🔗 تراكمي (RTK → Caveman)	78–95%	المطالبات المختلطة + سجلات الأدوات

**مثال واقعي — الوضع القياسي:** > **قبل (69 رمزًا):** _"من المرجح أن سبب إعادة تصيير مكوّن React لديك هو أنك تنشئ مرجعًا جديدًا لكائن في كل دورة تصيير. عندما تمرر كائنًا مضمنًا باعتباره خاصية، ترى المقارنة السطحية في React أنه كائن مختلف في كل مرة، ما يؤدي إلى إعادة التصيير. أوصي باستخدام useMemo لتخزين الكائن مؤقتًا."_ > > **بعد (19 رمزًا):** _"مرجع كائن جديد في كل تصيير. خاصية كائن مضمنة = مرجع جديد = إعادة تصيير. غلّفه بـ useMemo."_ > > **الإجابة نفسها. رموز أقل بنسبة 72%. لا فقدان في الدقة.** ✅ **مثال PT-BR — وضع [Troglodita](https://github.com/leninejunior/troglodita):** > **قبل (42 رمزًا):** _"المشكلة هي أن المكوّن يعيد العرض لأن مرجعًا جديدًا للكائن يُنشأ في كل دورة عرض. أوصي باستخدام useMemo."_ > > **بعد (12 رمزًا):** _"إعادة العرض: مرجع جديد في كل دورة (إعادة إنشاء كائن مضمن). استخدم `useMemo`."_ > > **الإجابة نفسها. رموز أقل بنحو 70%. الدقة التقنية محفوظة.** ✅
### 🎚️ ما وراء المحركات — أنماط الإخراج، والمفتاح التكيفي، والتحكم لكل طلب تقلّص المحركات الاثنا عشر أعلاه ما يدخل **إلى النظام**. وتشكّل ثلاث طبقات إضافية **كيفية** و**وقت** وما يخرج: - **🪄 أنماط الإخراج** _(توجيه محور الإخراج)_ — تحقن تعليمات حتمية وآمنة للتخزين المؤقت لتشكيل الاستجابة؛ ويمكن دمجها، مع توفر كل منها بمستويات شدة `lite` / `full` / `ultra`. إضافة نمط ما لا تتطلب سوى إدخال واحد في السجل: - **النثر الموجز** — احذف الحشو / أدوات التعريف / التحوّط؛ وحافظ على دقة المضمون التقني. - **رمز أقل** — أسلوب YAGNI لـ "المطوّر الخبير الكسول": أصغر تغيير عامل، من دون بنية إضافية غير مطلوبة. - **ذيل الحصان (المطوّر الخبير الكسول)** — ارتقِ في سلّم YAGNI، وأصلح السبب الجذري، وحقّق أصغر فرق عامل. - **لديّ اضطراب فرط الحركة وتشتّت الانتباه (الأفعال أولًا)** — ابدأ بالإجراء التالي، ورقّم الخطوات، وقدّم خطوة تالية ملموسة واحدة، من دون تمهيد. - **CJK موجز (文言)** — أسلوب صيني كلاسيكي بالغ الإيجاز (مقيّد بالإعدادات المحلية إلى `zh`). - **🎯 ميزانية السياق التكيفية** _(المفتاح)_ — بدلًا من حدّ واحد للرموز يعمل أو لا يعمل، صعّد استخدام أرخص المحركات وأقلها فقدًا للمعلومات فقط بالقدر اللازم **لملاءمة نافذة سياق النموذج**. السياسة: `reserve-output` (افتراضي، ومراعٍ للنموذج) · `percentage` · `absolute`. الوضع: `floor` (ضمان الملاءمة) · `replace-autotrigger` (يفوز اختيارك الصريح) · `off` (حدّ قديم). - **🎛️ موضع تحديد الضغط** _(الأولوية، من الأعلى إلى الأدنى)_ — ترويسة `x-omniroute-compression` لكل طلب › تجاوز مجموعة التوجيه › الملف الشخصي النشط المسمّى › التكيّفي / التشغيل التلقائي › الإعداد الافتراضي للوحة › متوقف. تعكس الخطة المطبّقة في ترويسة الاستجابة `X-OmniRoute-Compression: ; source=`. يمكنك التشغيل التلقائي وفق حدّ الرموز، أو تفعيل المفتاح التكيفي، أو تثبيت ملف شخصي مسمّى، أو تعيين إعداد لمرة واحدة لكل طلب، أو إسناد مسار لكل مجموعة توجيه — اختر ما يلائم عبء العمل. كما يقيّم **إطار تقييم** اختياري يعمل دون اتصال (`npm run eval:compression`) مدى الوفاء مقابل التوفير على مجموعة بيانات مثبتة قبل ترقية أي تغيير. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

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

**1) التثبيت والتشغيل** ```bash npm install -g omniroute omniroute ``` > 💡 هل ترى `npm warn ERESOLVE` أو تحذيرات تبعيات الندّ؟ [إنها غير مؤذية](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **هل تستخدم npm 11 أو إصدارًا أحدث؟** قد يحظر npm نصوص دورة حياة الحزم ما لم يُسمح بها. إن `postinstall` الخاص بـ OmniRoute (`node scripts/build/postinstall.mjs`) مطلوب لإعداد ملفات وقت التشغيل الأصلية الخاصة به. اسمح للحزم المذكورة في تحذير npm عند التثبيت العام. بالنسبة إلى مجموعة الحزم التي أبلغ عنها OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > لإعادة استخدام قائمة السماح هذه في عمليات التثبيت العامة المستقبلية، اضبطها مرة واحدة، ثم ثبّت بالطريقة المعتادة: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > قد تتغير قائمة التبعيات بين الإصدارات؛ إذا أبلغ npm عن قائمة مختلفة، فاستخدم أسماء الحزم الواردة في ذلك التحذير. السماح لحزمة ما يتيح تشغيل نصوص التثبيت الخاصة بها. > **هل تستخدم Gemini Web أو مزوّدًا آخر يعتمد على ملفات تعريف ارتباط الويب؟** تتضمن حزمة npm > Playwright، لكنها لا تتضمن ملف Chromium الثنائي الخاص به. راجع > [إعداد Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > قبل إجراء أول طلب إلى مزوّد ويب. لوحة التحكم على `http://localhost:20128` · واجهة API على `http://localhost:20128/v1`. **2) وصّل مزوّدًا مؤهلًا باستخدام حسابك** لوحة التحكم → **المزوّدون** → اختر مزوّدًا تتوافق شروطه الحالية وحصته مع حالة استخدامك → أضف مفتاح API الخاص به أو أكمل إجراءات حسابه. قد تتطلب المستويات المجانية التسجيل أو الموافقة أو وسيلة دفع. راجع [دليل المستويات المجانية](docs/getting-started/FREE-TIERS-GUIDE.md)؛ لا يُضمن التوفر من دون مفتاح، ويُستبعد المزوّدون المعلّمون بـ `tos: avoid` من `auto` افتراضيًا. **3) وجّه أداة البرمجة الخاصة بك** ```txt Base URL: http://localhost:20128/v1 API Key: [انسخ من لوحة التحكم → نقاط النهاية] Model: auto (يوجّه بين الاتصالات المؤهلة — أو اختر المزوّد/النموذج) ``` **4) تحقّق من عمله** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` ينبغي أن ترى نماذجك المتصلة مدرجة. 🎉 هذا كل شيء — ابدأ البرمجة، وسيتولى OmniRoute التوجيه الاحتياطي والتلقائي نيابةً عنك. إذا تعذّر على عميلك إرسال ترويسات مخصصة، يوفّر OmniRoute أيضًا أسماء مستعارة للتوافق تتضمن الرمز المميز: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` استخدم هذه الأسماء فقط مع العملاء الذين لا يستطيعون إرفاق `Authorization: Bearer ...`. تظل مصادقة الترويسة هي الوضع المفضّل.
## 📦 طرق تثبيت إضافية — Docker، والمصدر، وpnpm، وArch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` يتبع الوسم `:latest` أعلى إصدار SemVer مستقر **منشور**. ولا يتتبع فرع git المسمى `main`. ثبّت الوسم على `:X.Y.Z` لاستخدام GitOps. راجع [قنوات إصدارات Docker](docs/guides/DOCKER_GUIDE.md#release-channels).تثبّت الصورة قيمة **`OMNIROUTE_MEMORY_MB=1024`**. وهذا يكفي للوحة التحكم ومحادثة خفيفة. تحتاج **وكلاء البرمجة** (`POST /v1/responses` من Claude Code وCodex وGrok وغيرها) إلى كومة V8 أكبر بكثير، وإلا فستنتهي العملية برسالة `FATAL ERROR` عند نحو 12 GiB في ظل سياقين طويلين متداخلين. خصّص للحاوية حجمًا أكبر من الكومة (إذ توجد المخازن المؤقتة الأصلية خارج V8): | حمل العمل | الكومة (`-e OMNIROUTE_MEMORY_MB`) | الحاوية (`--memory`) | | ----------------------------------------- | --------------------------------- | -------------------- | | لوحة التحكم / محادثة خفيفة | `1024` (القيمة الافتراضية للصورة) | ≥2 g | | وكيل برمجة واحد | `8192` | ≥10 g | | طلبان طويلان متزامنان إلى `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` الجدول الكامل: [دليل Docker — ذاكرة RAM في وقت التشغيل](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **قناة Docker للإصدارات التجريبية:** يتبع `diegosouzapw/omniroute:next` و > `diegosouzapw/omniroute:next-web` فرع `release/v*` الافتراضي الحالي. > هذه الوسوم القابلة للتغيير مخصصة فقط لاختبار الإصلاحات غير المنشورة، > وهي **غير مدعومة للاستخدام في بيئات الإنتاج**. راجع > [قنوات إصدارات Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** يُدعم كل من `bun install` القياسي والتثبيت العام (`bun install -g omniroute`) من خلال اكتشاف بيئة تشغيل Bun: - **`bun:sqlite` المضمّن**: يستخدم OmniRoute مشغّل `bun:sqlite` المضمّن في Bun عند التشغيل ضمن Bun، مع الرجوع إلى `better-sqlite3` على Node.js أو إلى `sql.js`. - **الاختيار التلقائي لأداة Webpack في التطوير**: يكتشف وضع التطوير (`bun run dev`) بيئة Bun تلقائيًا ويعطّل Turbopack لصالح Webpack لمنع حالات عدم التوافق مع روابط V8 الأصلية. تتبع إصدارات الإنتاج (`bun run build`) قيمة `OMNIROUTE_USE_TURBOPACK` تمامًا كما في Node: يُستخدم Turbopack افتراضيًا، ويمكن استخدام `OMNIROUTE_USE_TURBOPACK=0` للبناء باستخدام Webpack (ويتيحه `Dockerfile.bun` كوسيطة `--build-arg`). - **ملف Dockerfile مخصص لـ Bun**: ملف `Dockerfile.bun` متعدد المراحل لعمليات نشر Bun الأصلية في الإنتاج (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # التثبيت والتشغيل باستخدام Bun bun install bun run dev ``` **🛠️ من المصدر** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # باستخدام رقائق Nix nix develop npm run dev # أو باستخدام devbox devbox run npm run dev ``` 📖 [دليل Docker](docs/guides/DOCKER_GUIDE.md) — ملفات تعريف Compose، وCaddy HTTPS، وأنفاق Cloudflare. **🦭 Podman** ```bash # 1. تحضير دليل البيانات المرتبط mkdir -p data # 2. لنظام Linux مع Podman محلي دون صلاحيات الجذر فقط (وليس عميل Podman Machine بعيدًا مطلقًا): podman unshare chown 1000:1000 ./data # 3. تعيين تلميح بيئة التشغيل، وبناء صورة Compose المحلية، ثم بدء التشغيل echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` على macOS أو Windows، يستخدم Podman جهاز Podman Machine بعيدًا: تخطَّ `podman unshare` واتبع [إرشادات دليل البيانات الخاصة بالبنية](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [دليل Podman](contrib/podman/README.md) — عمليات بناء Compose، وPodman Machine، وإعداد Quadlet لنظام Linux/systemd. **⚡ تثبيت أسرع / أقل استهلاكًا للموارد (تخطي البناء الأصلي)** محرك SQLite الأصلي (`better-sqlite3`) هو تبعية **اختيارية**، ولذلك لا يتعطل التثبيت العام مطلقًا بسبب الترجمة من المصدر: إذ يستخدم ملفًا ثنائيًا مبنيًا مسبقًا عند توفر ملف متوافق مع منصتك/Node، وإلا فإنه يرجع بشفافية إلى محرك JavaScript خالص (`node:sqlite` على Node 22+، أو `sql.js` WASM المضمّن بخلاف ذلك) — دون الحاجة إلى أدوات بناء. لتخطي التهيئة الأصلية اللاحقة للتثبيت بالكامل (في CI أو البيئات دون واجهة رسومية أو الأجهزة البطيئة): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # يؤدي CI=1 أيضًا إلى تخطيها ``` لأسرع عمليات تثبيت، يُفضّل استخدام **pnpm** (مخزن معنون بالمحتوى + روابط صلبة — راجع أعلاه). ولاستخدام بيئة تشغيل دون لوحة تحكم أو واجهة رسومية، استخدم ملف تعريف Docker المسمى `base` (أعلاه) أو [دليل Termux](docs/guides/TERMUX_GUIDE.md). تُقدَّم واجهة سطر الأوامر ولوحة تحكم الويب بواسطة العملية نفسها عبر منفذ واحد، ولذلك لا توجد حاليًا حزمة منفصلة لواجهة سطر الأوامر فقط.

# 🎬 OmniRoute قيد التشغيل

## 📹 أدلة الفيديو

_{لقطة للوحة المعلومات بتاريخ 2026-10-18 · الفهرس الخام: YT 1.352 | TT 334 | IG 290 · حداثة البيانات (بالأيام): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 مشاهدة}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 مشاهدة}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 مشاهدة}

🎬 #4 — Instagram
_{theopenstack — 692,419 مشاهدة}

🎬 #5 — TikTok
_{migue.baena — 685,788 مشاهدة}

**الترتيب الكامل (عناوين URL أساسية بعد إزالة التكرارات، `v > 0`، أعلى وصول):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | المقاييس الأساسية بتاريخ 2026-10-18: **1.976 فيديو فريدًا** · **20.220.289 مشاهدة معروفة** (`v > 0`) · **1.210 قناة/ملف شخصي عبر المنصات**. تحتوي لوحة المعلومات الخام على 1.976 صفًا (YouTube 1.352 = 740 فيديو طويلًا + 612 Shorts · TikTok 334 · Instagram 290)؛ ولم تتبقَّ أي تكرارات بعد التسوية حسب عنوان URL الأساسي، الذي يحتفظ بأعلى عدد مشاهدات لكل فيديو. جُمِّدت عملية جمع بيانات YouTube عند 2026-10-13 (نُفدت حصة API من 14 إلى 18/10)، وبيانات TikTok/Instagram منذ 2026-09-02 (لعدم توفر أرصدة لجمع البيانات)؛ ولا يزال 76 فيديو بلا عدد مشاهدات. > 🎬 **هل أنشأت فيديو عن OmniRoute؟** افتح [مشكلة](https://github.com/diegosouzapw/OmniRoute/issues/new) أو [نقاشًا](https://github.com/diegosouzapw/OmniRoute/discussions) وأرفق الرابط — وسنعرضه هنا.

# 📧 المجتمع والمساعدة > كل شيء في مكان واحد — تابع المشرف، أو تحدّث مع المجتمع، أو افتح مشكلة. | القناة | أين / كيف | | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — تابع المشرف على الصيانة | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — تابعنا للإصدارات والنصائح | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 عالمي** | [انضم إلى المجموعة](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 البرازيل** | [انضم إلى المجموعة](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **الموقع الإلكتروني** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍مجتمع StHub OmniRoute (مجاني)** | [بوابة sthub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **الشيفرة المصدرية** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **الإبلاغ عن خلل** | [افتح بلاغًا](https://github.com/diegosouzapw/OmniRoute/issues) — أرفق مخرجات `npm run system-info` | | 🤝 **المساهمة** | [CONTRIBUTING.md](CONTRIBUTING.md) · [نموذج التفريع والإصدار](docs/ops/BRANCHING_MODEL.md) · اختر `good first issue` | | 💚 **دعم المشروع** | [طرق الدعم ↑](#-support-omniroute) · [رعاة GitHub](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ حزمة التقنيات

الطبقة	التقنية
بيئة التشغيل	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
اللغة	TypeScript 6.0 — TypeScript بنسبة 100% ضمن `src/` و`open-sse/` (لا يوجد `any` في النواة منذ v2.0)
إطار العمل	Next.js 16 + React 19 + Tailwind CSS 4
قاعدة البيانات	better-sqlite3 (SQLite، تسجيل WAL) + LowDB (JSON قديم) — 147 وحدة نطاق، و233 عملية ترحيل
الذاكرة	بحث SQLite FTS5 في النص الكامل + تضمينات متجهية مكمّمة إلى int8، مع اضمحلال مُنَمَّط
المخططات	Zod 4 — التحقق من إدخال/إخراج أدوات MCP + عقود API
البروتوكولات	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
البث	الأحداث المرسلة من الخادم (SSE) + جسر WebSocket (`/v1/ws`)
الضغط	خط أنابيب من 12 محركًا — RTK وCaveman وLLMLingua-2 (MobileBERT ONNX) وGCF وOmniGlyph
المصادقة والأمان	OAuth 2.0 (PKCE) + JWT + مفاتيح API + مصادقة MCP محددة النطاق · AES-256-GCM للبيانات الساكنة · DOMPurify
التخفي	wreq-js — انتحال بصمة JA3 / JA4 لـ TLS، ووكيل من 3 مستويات
المرونة	قاطع الدائرة، والتراجع الأسي، ومكافحة تدافع الطلبات، والإصلاح الذاتي التلقائي لـ auto-combo
التسجيل	pino — سجلات JSON مُهيكلة مع سياق الطلب
الاختبار	مشغّل اختبارات Node.js + Vitest — أكثر من 60,000 تصريح اختبار ثابت ضمن أكثر من 8,400 ملف اختبار متتبَّع (وحدات، وتكامل، وE2E، وأمان، ومنظومة بيئية)
المنصات	سطح المكتب (Electron) · Android (Termux) · PWA (أي متصفح)
CI/CD	GitHub Actions — نشر npm تلقائيًا + Docker Hub عند الإصدار
الروابط	الموقع الإلكتروني · npm · Docker Hub

## 📖 التوثيق

### 📘 البدء

المستند	الوصف
دليل المستخدم	المزوّدون، المجموعات، تكامل CLI، والنشر
دليل الإعداد	طرق التثبيت الكاملة، إعدادات أدوات CLI، إعداد البروتوكول، وضبط مهلة الانتظار
دليل أدوات CLI	إعداد كل أداة على حدة لـ Claude Code وCodex وCursor وCline وOpenClaw وKilo وCopilot
الوضع البعيد	التحكم في OmniRoute بعيد (VPS) من CLI على حاسوبك المحمول عبر رموز وصول محددة النطاق
إعداد Claude Code	توجيه Claude Code إلى OmniRoute (محلي/بعيد) باستخدام `launch` وملفات تعريف لكل نموذج
البدء السريع	التثبيت ← الاتصال ← الإعداد في 3 خطوات

### 🔧 العمليات والنشر

المستند	الوصف
دليل Docker	تشغيل Docker، وملفات تعريف Compose، وHTTPS عبر Caddy، والأنفاق، ووسوم الصور
دليل Podman	تكامل Quadlet مع systemd، وpodman-compose، وSELinux
النشر على VM	دليل كامل: إعداد VM وnginx وCloudflare
النشر على Fly.io	النشر على Fly.io مع تخزين دائم
دليل Termux	تشغيل OmniRoute على Android عبر Termux
دليل PWA	تثبيت تطبيق الويب التقدمي، والتخزين المؤقت، والبنية
دليل إلغاء التثبيت	إزالة نظيفة لجميع طرق التثبيت
إعداد البيئة	متغيرات `.env` ومرجعها بالكامل

### 🧠 الميزات والبنية

المستند	الوصف
البنية	بنية النظام، وتدفق البيانات، والأجزاء الداخلية
دليل الضغط	خط أنابيب من 7 خيارات: off / lite / standard / aggressive / ultra / RTK / stacked
ضغط RTK	ضغط مخرجات الأوامر، والمرشحات، والثقة، والتحقق، واستعادة المخرجات الخام
محركات الضغط	خطوط أنابيب Caveman وRTK وstacked، وواجهات لوحة المعلومات وAPI وMCP
تنسيق قواعد الضغط	مخططات حزم القواعد بصيغة JSON لمرشحات Caveman وRTK
حزم لغات الضغط	اكتشاف اللغة وتأليف حزم قواعد Caveman
دليل المرونة	قواطع الدائرة، وفترات التهدئة، وقائمة الانتظار، ومنع تكدس الطلبات، وانتحال TLS
محرك Auto-Combo	تقييم من 16 عاملاً، وحزم الأوضاع، والإصلاح الذاتي
دليل الوكيل	نظام وكلاء من 3 مستويات، وسوق 1proxy، وعمليات CRUD للسجل
الخطط المجانية	دليل موحّد: 34 مجموعة متكررة موثّقة / 465 إدخالاً مفهرساً ضمن الخطط المجانية
معرض الميزات	جولة مرئية في لوحة المعلومات مع لقطات شاشة
توثيق قاعدة الشيفرة	شرح مبسّط لقاعدة الشيفرة للمبتدئين

### 🤖 البروتوكولات وواجهات API

المستند	الوصف
مرجع API	جميع نقاط النهاية مع أمثلة
مواصفات OpenAPI	مواصفات OpenAPI 3.0
خادم MCP	عدد 110 من أدوات MCP، وإعدادات IDE، وعملاء Python/TS/Go
دليل خادم MCP	تثبيت MCP، ووسائل النقل، ومرجع الأدوات
خادم A2A	بروتوكول JSON-RPC 2.0، والمهارات، والبث، وإدارة المهام
دليل خادم A2A	بطاقة وكيل A2A، والمهام، والمهارات، والبث

### 📋 المشروع والجودة

المستند	الوصف
المساهمة	إعداد بيئة التطوير والإرشادات
نموذج التفرّع والإصدار	إلى أين تستهدف طلبات السحب (`release/*`)، وما الذي يعنيه `main` والوسوم
سجل التغييرات	السجل الكامل لإصدارات كل نسخة
سياسة الأمان	الإبلاغ عن الثغرات وممارسات الأمان
دليل i18n	دعم 67 لغة، وسير عمل الترجمة، والكتابة من اليمين إلى اليسار
قائمة التحقق من الإصدار	خطوات التحقق السابقة للإصدار
خطة التغطية	استراتيجية تغطية الاختبارات لأكثر من 60,000 تعريف اختبار ثابت عبر أكثر من 8,400 ملف اختبار متتبع

# ⭐ أبرز المساهمين > يتشكّل OmniRoute بفضل مجتمع شغوف بالمصادر المفتوحة. قدّم هؤلاء الأفراد مساهمات استثنائية تؤثر مباشرةً في جودة المشروع واستقراره وانتشاره. **شكرًا لكم.** ### المساهمون الخارجيون حسب طلبات السحب المدمجة

الترتيب	المساهم	طلبات السحب المدمجة	~الأسطر المتغيرة
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{أُجري الإحصاء في 2026-11-03 03:01:19 UTC باستخدام أحدث نسخة مباشرة من release/v3.8.53، وهي 05bc048d6c. يحتوي إحصاء GitHub GraphQL المُقسّم إلى صفحات على 9,947 طلب سحب مدمجًا: 4,130 منها بواسطة مالك المستودع، و240 بواسطة Dependabot، و6 بواسطة روبوتات/تطبيقات أخرى، و5,571 طلب سحب خارجيًا من 883 مساهمًا مميزًا. تمثل «الأسطر المتغيرة» مجموع الإضافات والحذوفات في GitHub، وتشمل الملفات المُولّدة وملفات القفل والكتالوجات والترجمات والوثائق؛ وهي تمثل حجم التغييرات، لا عدد أسطر التعليمات البرمجية التي ألّفها المساهم. أبلغ 53 طلب سحب عن فروق في GitHub تتجاوز 500,000 سطر (على سبيل المثال #13399، الذي يضيف موفرًا واحدًا ويعرض 2,347 ملفًا متغيرًا)، ما يؤدي إلى تضخيم عدة إجماليات أعلاه. صُنّفت حالات التعادل معًا.} ### الالتزامات المنسوبة إلى GitHub

Dizzle _{🥇 418 مساهمة منسوبة إلى GitHub}	Bob.Hou _{🥈 294 مساهمة منسوبة إلى GitHub}	Paijo _{🥉 229 مساهمة منسوبة إلى GitHub}	Paco Cartones _{🏅 222 مساهمة منسوبة إلى GitHub}	backryun _{🏅 202 مساهمة منسوبة إلى GitHub}	Jan Leon _{🏅 134 مساهمة منسوبة إلى GitHub}
Ravi Tharuma _{🏅 126 مساهمة منسوبة إلى GitHub}	Markus Hartung _{🏅 115 مساهمة منسوبة إلى GitHub}	Randi _{🏅 108 مساهمة منسوبة إلى GitHub}	Chris _{🏅 70 مساهمة منسوبة إلى GitHub}	WebPerson _{🏅 68 مساهمة منسوبة إلى GitHub}	Koosha Paridehpour _{🏅 68 مساهمة منسوبة إلى GitHub}

_{تمت إعادة التحقق في 2026-11-03 02:09:16 UTC: المساهمات المنسوبة إلى GitHub التي أبلغت عنها Contributors API الخاصة بالمستودع للفرع الافتراضي release/v3.8.53. أعادت API‏ 903 هوية (429 مستخدمًا، و2 من الروبوتات، و472 مجهولة الهوية)؛ يستبعد هذا الجدول المشرف والروبوتات والهويات المجهولة، ويُبقي على حالات التعادل في المنافسة. وهو يختلف عن كلٍّ من تصنيف طلبات السحب المدمجة أعلاه وإحصاء بيانات Git الوصفية أدناه.} > 🙏 تُعد ميزات هؤلاء المساهمين وإصلاحاتهم للأخطاء وتحسيناتهم للبنية التحتية **جزءًا أساسيًا** مما يجعل OmniRoute موثوقًا وغنيًا بالميزات. فكل طلب سحب، وكل حالة اختبار، وكل ملف ترجمة i18n مهم. تُبنى البرمجيات مفتوحة المصدر على أيدي أشخاص مثلهم.

---
## 💖 الرعاة

شكرٌ من القلب للأشخاص الذين يموّلون OmniRoute من أموالهم الخاصة — فكل مساهمة تُبقي المشروع مجانيًا ومستقلًا ومتقدمًا إلى الأمام.

Andrew _{💛 راعٍ شهري نشط}	Vlad I _{💛 راعٍ شهري نشط}	小妍儿 _{💛 راعٍ شهري نشط}	Guilherme Costa _{💛 راعٍ نشط لمرة واحدة}	Henrique Iurkiv _{💛 راعٍ نشط لمرة واحدة}	Somesh Ghaturle _{💛 راعٍ نشط لمرة واحدة}
Kolonie AI _{💛 داعم سابق لمرة واحدة}	Prof. Igor Morais _{💛 داعم سابق لمرة واحدة}	Pixma _{💛 داعم سابق لمرة واحدة}	Paco Cartones _{💛 داعم سابق لمرة واحدة}	longtao _{💛 داعم سابق لمرة واحدة}

_{… وآخرون يفضّلون الحفاظ على خصوصيتهم 💛} _{أُعيد التحقق من رعاة GitHub Sponsors المعلنين في 2026-10-18 عبر واجهة GitHub Sponsors GraphQL API: توجد 11 رعاية معلنة (6 نشطة و5 سابقة) من أصل 14 إجمالًا. تحدد حالة isActive في GitHub التصنيفات النشطة أعلاه؛ ويظل الداعمون المعلنون السابقون لمرة واحدة موضع شكر، بينما يظل الرعاة الخاصون مجهولي الهوية. لم تُدرج تبرعات Ko-fi وBuy Me a Coffee وLiberapay وPIX والعملات المشفرة لعدم وجود سجل علني للرعاة فيها.} 💖 كن راعيًا ← — فكل دولار يُبقي OmniRoute مجانيًا ومستقلًا.

## 👥 أكثر من 1,000 مساهم

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{تم التدقيق في 2026-11-02 عند أحدث نسخة مباشرة من release/v3.8.53، وهي 1c7135e0fb (7,972 عملية إيداع): 1,074 هوية بشرية موحّدة في Git — يظهر 759 منها كمؤلفي عمليات إيداع (بما في ذلك المشرف) و315 منها فقط في تذييلات Co-authored-by الصريحة. يطبّق الإحصاء .mailmap، ويقارن عناوين البريد الإلكتروني دون تمييز حالة الأحرف، ويجمع عناوين GitHub الرقمية والعادية بدون رد فقط عندما ترمّز إلى المعرّف نفسه، ويستبعد 29 هوية لروبوتات/وكلاء/خدمات/عناصر نائبة، ولا يدمج عناوين البريد الإلكتروني العادية لمجرد تطابق أسماء العرض الخاصة بها. نشر تدقيق 2026-08-24 العدد 639؛ ويعطي تطبيق هذه الطريقة مجددًا على أساس ذلك التدقيق ac02c5b42f العدد 619، لذا فإن الزيادة ناتجة عن مساهمين جدد، وليست عن استخدام طريقة أقل صرامة.} ### كيفية المساهمة 1. أنشئ نسخة متفرعة من المستودع 2. أنشئ فرعًا انطلاقًا من أحدث نسخة نشطة من `release/vX.Y.Z` (وليس `main`) — راجع [نموذج الفروع والإصدارات](docs/ops/BRANCHING_MODEL.md) 3. أنشئ فرع الميزات الخاص بك (`git checkout -b feat/amazing-feature`) 4. ثبّت تغييراتك (`git commit -m 'feat: add amazing feature'`) 5. ادفع التغييرات إلى الفرع (`git push origin feat/amazing-feature`) 6. افتح طلب سحب مع جعل **الأساس = فرع `release/vX.Y.Z`** هذا راجع [CONTRIBUTING.md](CONTRIBUTING.md) للحصول على إرشادات مفصلة. ### إصدار نسخة جديدة ```bash # إنشاء إصدار — يتم تنفيذ npm publish تلقائيًا VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 النجوم

## 🌍 مخطط النجوم

## 🙏 شكر وتقدير

يقف OmniRoute على أكتاف عمالقة. بدأ كمشتق من **[9router](https://github.com/decolua/9router)** وكمنفذ بلغة TypeScript لمشروع Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — ومن هناك، استُلهم كل نظام فرعي أدناه من مشروع مفتوح المصدر سبقه إلى ذلك. وقد أسهم كل مشروع منها في تشكيل جزء ملموس من OmniRoute. وهذا هو شكرنا وامتناننا لها جميعًا. 🙏 > ⭐ تم التحقق من أعداد النجوم باستخدام واجهة GitHub REST API في 3 نوفمبر 2026 — اذهبوا لمنح هذه المشاريع نجمة. الأعداد لقطة مؤرخة بدقة، ومن الطبيعي أن تتغير بمرور الوقت. ### 🧬 النَسَب والبوابة

المشروع	⭐	كيفية إلهامه لـ OmniRoute
9router	31,861	المشروع الأصلي الذي بُني عليه هذا المشتق — وقد تم توسيعه هنا ليشمل واجهات برمجة تطبيقات متعددة الوسائط وإعادة كتابة كاملة بلغة TypeScript.
CLIProxyAPI	57,329	تطبيق Go الذي ألهم هذا المنفذ بلغة JavaScript / TypeScript.
LiteLLM	62,580	بوابة الذكاء الاصطناعي التي تغذي مجموعة بيانات الأسعار العامة فيها مزامنة تتبع التكلفة لدينا، كما أن نموذج توحيد المزوّدين فيها أسهم في توجيهنا.
codex-chatgpt-web	15,435	تم تكييف مصدر MIT منه ليُستخدم في جسر ChatGPT Web → Codex Responses المضمّن، بما في ذلك محوّلات جلسات المتصفح وتأطير الاستجابات والاستخدام والبحث على الويب.
free-claude-code	65,966	تم نقل أنماطه إلى استعادة التدفق، والأسماء المستعارة no-thinking، والبحث الاحتياطي على الويب، والحدود المعتمدة على النافذة المنزلقة، وتنقيح السجلات، وتدفقات تشغيل محسّنة للأمان.
composer-api	347	تم تكييف أنماط اختيار الأدوات وقيود المخرجات وتثبيت الأدوات في Cursor Composer ضمن المنفّذ الأصلي لـ Cursor.
codex-multi-auth	561	تم نقل أنماط تسجيل الدخول الجديد وتدوير رموز التحديث إلى إعادة المصادقة عبر Codex OAuth.
opencode-anthropic-auth	562	تم تعميم الإعدادات الافتراضية للتحويل المتوافقة مع Claude Code وسلوك ترويسة الفوترة ضمن جسر OmniRoute القائم على الإعدادات.
grok2api-merged	2	تم تكييف تعيينات نماذج Grok فيه، ومولّد Statsig المزيف من نوع TypeError، والإعدادات الافتراضية للطلبات والأجهزة، ومعالج الاستجابات NDJSON، بصورة جوهرية ضمن منفّذ Grok Web في OmniRoute.
TQZHR/grok2api	707	المصدر الرئيسي العابر للكود وراء grok2api-merged؛ وقد حُفظت تطبيقات النماذج والترويسات والحمولة وStatsig والمعالج فيه ضمن نَسَب Grok Web.
chenyme/grok2api	7,874	المصدر الأساسي المرخّص بـ MIT لإعدادات حمولة Grok والأجهزة الافتراضية، ومولّد Statsig، ومعالج `result.response` المنقول عبر TQZHR وgrok2api-merged.
grok2api-pro	27	مصدر عابر ينسب إليه grok2api-merged طبقة تجميع الوكلاء؛ وتحافظ OmniRoute على إشعار النَسَب هذا، لكنها لا تدّعي نقل طبقة تجميع الوكلاء إلى منفّذ Grok Web المحدود الخاص بها.
GrokProxy	52	أثر وكيل Grok الخاص به، والمصادَق عليه عبر ملفات تعريف الارتباط، ونمط تدفق `result.response.token` في نقل Grok Web الخاص بـ OmniRoute.
GrokBridge	5	تمت الاستعانة بتطبيق Grok Web الأصلي فيه لتصميم المنبع عبر HTTP/المتصفح؛ ويستمد مساره المباشر عبر HTTP من GrokProxy، لذلك لا يُدّعى نقل كود مستقل منه.

### 🗜️ ضغط السياق والرموز المميّزة — المحركات

المشروع	⭐	كيف ألهم OmniRoute
Caveman	116,957	مشروع العبارة واسعة الانتشار "لماذا تستخدم كثيرًا من الرموز عندما تؤدي القليل منها الغرض" — فلسفة حديث الكهف فيه تُشغّل وضع الضغط القياسي لدينا وأكثر من 30 قاعدة للحشو/التكثيف.
RTK – Rust Token Killer	85,350	ضغط مخرجات الأوامر عالي الأداء — ألهم محرّك RTK لدينا، وDSL لتصفية JSON، واستعادة المخرجات الخام، وخط الأنابيب المتراكم RTK → Caveman.
headroom	78,672	ضغط السياق القابل للعكس (SmartCrusher) — ألهم محرّك `headroom` لدينا ونمط علامة الاسترجاع `ccr`.
LLMLingua	6,797	أبحاث ضغط المطالبات (LLMLingua / LLMLingua-2) — ألهمت محرّك `llmlingua` غير المتزامن، الآمن مع التعليمات البرمجية، والمفتوح عند الفشل.
llmlingua-2-js	33	منفذ JS/ONNX (MobileBERT / XLM-RoBERTa) المستخدم كواجهة خلفية لخيوط العامل في محرّك LLMLingua لدينا.
Troglodita	50	ضغط الرموز للغة PT-BR — يشغّل حزمة اللغة pt-BR لدينا: تقليل الحشو وإزالة الكلمات الزائدة بما يتلاءم مع قواعد البرتغالية البرازيلية.
ponytail	182,929	مهارة مبرمج YAGNI للعبارة واسعة الانتشار "المطوّر المخضرم الكسول" — ألهمت نمط المخرجات less-code لدينا: توجيه نحو أصغر تغيير عملي يقتطع التعليمات البرمجية _المُولَّدة_ (النظير على محور المخرجات لنثر Caveman المقتضب).
i-have-adhd	59,838	أسلوب الاستجابة الذي يقدّم الإجراء أولًا والمناسب لاضطراب فرط الحركة وتشتت الانتباه فيه جرى تكييفه ليصبح أسلوب المخرجات الموجز في OmniRoute عبر خمس لغات.

### 🧩 التنسيقات المدمجة، وأبحاث الرموز، والأدوات المدركة للتعليمات البرمجية

المشروع	⭐	كيف ألهم OmniRoute
TOON	25,602	ترميز الكائنات الموجّه بالرموز — شكّل نموذج الأعمدة والرأس بالإضافة إلى الصفوف مرحلة التكثيف الجدولي لدينا.
GCF – Graph Compact Format	61	أفاد تنسيق الرسم البياني المدمج وتصميم الملف التعريفي العام فيه عملية التكثيف الجدولي وتنسيق برنامج الترميز Headroom في OmniRoute.
gcf-typescript	4	تنفيذ TypeScript بترخيص MIT، أُدرج مباشرةً وجرى توسيعه ليكون برنامج ترميز الملف التعريفي العام في Headroom.
token-optimizer-mcp	566	ذاكرة تخزين مؤقت Brotli/SQLite + دلتا سياق لكل جلسة — ألهمت محرّك `session-dedup` لدينا.
token-savior	1,203	تكثيف مخرجات Bash + ملفات تعريف MCP — ألهم انضباط التراجع عن الضغط لدينا وتقليل بيان أدوات MCP.
token-saver	162	ضغط مخرجات مدرك للمحتوى ولكل نوع ملف، مع تراجع مدرك للفشل — أكد صحة التوجيه حسب النوع وتخطي العمليات ذات المكسب الأدنى لدينا.
token-optimizer	2,853	"اعثر على الرموز الشبحية" — أفاد نمط التفريغ + المقبض القابل للاستعادة فيه طريقة تفكيرنا في تفريغ CCR.
TokenMizer	34	مخطط أولي لرسم بياني للجلسة + إزالة التكرار بين الأسطر وعبر الأدوار، أفاد تصميم session-dedup لدينا.
OmniCompress	3	JSON عمودي في Rust + استرجاع معنون بالمحتوى + إزالة التكرار بين الرسائل — أكد صحة تصميم محرّكات `headroom`/`ccr`/`session-dedup` لدينا وثابت "التنسيق المضغوط مستقل عن الموضع" المستقر في الذاكرة المؤقتة.
mcp-compressor	140	ضغط مخطط/وصف أدوات MCP — أفاد تقليل عدد بيان أدوات MCP لدينا.
RepoMapper	218	ترتيب خريطة المستودع بأسلوب Aider — أفاد استكشافنا لخريطة المستودع / ترتيب الاسترجاع.
quiet-shell-mcp	4	تقليل تصريحي لمخرجات shell عبر MCP — أكد صحة تكثيف مخرجات bash التصريحي لدينا.
ts-morph	6,222	مجموعة أدوات TypeScript Compiler API — ألهمت إزالة التعليقات المعتمدة على المحلل النحوي لدينا، مع الحفاظ على السلاسل الحرفية وقوالب النصوص والتعابير النمطية.

### 🧠 الذاكرة وRAG

المشروع	⭐	كيف ألهم OmniRoute
Mem0	68,294	طبقة ذاكرة شاملة — شكّل نموذج الوكيل كحدّ للكتابة/القراءة بنية ذاكرتنا.
Letta (MemGPT)	25,321	وكلاء ذوو حالة مع ذاكرة متعددة المستويات — ألهموا نموذجنا متعدد المستويات للتحكم في السياق والاسترداد (CCR).
WFGY	1,804	تصنيف ProblemMap لأنماط فشل RAG/LLM المتكررة وعددها 16 — وهو المفردات المشتركة في دليل استكشاف الأخطاء وإصلاحها لدينا.

### 🛰️ فحص حركة المرور، MITM والوكيل الشفاف

المشروع	⭐	كيف ألهم OmniRoute
llm-interceptor	81	أفاد اعتراض/تحليل MITM لحركة المرور بين مساعد البرمجة وLLM بمتطلبات Traffic Inspector المبكرة. وقد استُبدلت أربع وحدات مشتقة سابقًا — دمج SSE، وتطبيع المحادثات، وإخفاء الأسرار، وتنقية الرؤوس — بتطبيقات مستقلة نُفذت من الصفر وبالاستناد إلى معايير البروتوكولات العامة. ولا تزال واجهتا تمرير المضيف (`passthrough.ts` و`_internal/bypass.cjs`) تطبيقات داخلية خاصة بـ OmniRoute ومصنفة بشكل مستقل؛ ولم يُعَدَت كتابتهما كجزء من ذلك الاستبدال.
ProxyBridge	6,978	توجيه شفاف للوكيل لكل عملية — ألهم إنهاء MITM الآمن عند التعطل، ومهلات خمول المقابس، وإسناد العمليات عبر `/proc`، والتقاط TPROXY.

### 📚 بيانات النماذج، وقابلية المراقبة وواجهة المستخدم

المشروع	⭐	كيف ألهم OmniRoute
models.dev	7,486	قاعدة بيانات مفتوحة لمواصفات نماذج الذكاء الاصطناعي وأسعارها وقدراتها — تُزامَن أصليًا مع كتالوج النماذج لدينا.
React Flow / xyflow	38,874	مكتبة الرسوم البيانية القائمة على العقد التي تشغّل Compression Studio وCombo/Routing Studio الآنيين لدينا.
LangGraph	44,349	ألهم تصور الرسم البياني لسير العمل المباشر في LangGraph Studio عرض التتابع الآني في Studios لدينا.
Langfuse	36,907	شكّل نموذج قابلية المراقبة trace → span → generation الخاص به تصميم الشلال في Compression Studio لدينا.
Kiali	3,647	قابلية مراقبة شبكة خدمات Istio — ألهمت شارات قاطع الدائرة والمرئيات الخاصة بحواف الأخطاء في Routing/Combo Studio.
lobe-icons	2,666	شعارات العلامات التجارية للذكاء الاصطناعي/LLM التي تعرض أيقونات المزوّدين عبر لوحة المعلومات لدينا.
flag-icons	12,499	يوفّر أعلام SVG المرخّصة بموجب MIT المستخدمة في محدد لغة README.

### 🛡️ الأمان

المشروع	⭐	كيف ألهم OmniRoute
awesome-secure-defaults	723	قائمة منتقاة من المكتبات الآمنة افتراضيًا التي توجه اختياراتنا الأمنية (Helmet.js وDOMPurify وssrf-req-filter وsafe-regex وGoogle Tink).

### 🧭 أدوات مكمّلة

المشروع	⭐	كيف ألهم OmniRoute
ClawRouter	6,649	ألهم إزالة تكرار الطلبات، والبديل الطارئ من دون تكلفة، واستراتيجيات Auto-Combo القابلة للتوصيل، وتصنيف النوايا متعدد اللغات.
Antigravity-Manager	32,785	أفادت إعادة تعيين النماذج مع مراعاة الحساب، والتحقق من مسارات الملفات التنفيذية، وسلوك تسميات الخطط في Antigravity runtime الخاص بـ OmniRoute.
vscode-antigravity-cockpit	4,852	ألهم تنسيق العد التنازلي المدمج لإعادة ضبط الحصة عرض حدود المزوّد المناظر في OmniRoute.
AionUi	33,996	ألهمت تكاملات ACP الخاصة به OmniRoute للكشف التلقائي عن وكلاء CLI المثبتين.
CodexBar	22,955	حدّد سطح حصة Grok Build؛ ثم تحقّق OmniRoute بشكل مستقل من تنسيق البيانات الفعلي عبر السلك وصحّحه.

## 📄 الترخيص ترخيص MIT - راجع [LICENSE](LICENSE) لمزيد من التفاصيل. ---

**[⬆ العودة إلى الأعلى](#-omniroute)** · صُمم بحب ❤️ لمجتمع الذكاء الاصطناعي مفتوح المصدر. _{أنشأه Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · ترخيص MIT · omniroute.online}