# 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 — بوابة الذكاء الاصطناعي المجانية

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

## 💰 ~1.62B رمزًا / شهريًا عبر الخطط المجانية التابعة لجهات خارجية

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

بطاقة ميزانية الخطط المجانية في OmniRoute: نحو ~1.62B من الرموز المجانية شهريًا بصورة ثابتة، وما يصل إلى ~2.22B في الشهر الأول مع أرصدة التسجيل، من 34 مفتاحًا موثقًا لمجموعات متكررة تغطي 467 إدخالًا مفهرسًا ضمن الخطط المجانية خلف نقطة نهاية واحدة. حسابات صادقة بعد إزالة تكرار المجموعات — تُحتسب كل مجموعة مشتركة مرة واحدة، بما في ذلك 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 العالمي](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.53+` | | -------------------------------- | :-------------------: | :---------: | :-------------------: | | 🌐 المزوّدون | 352 | **358** | 375 | | 🧠 معرّفات نماذج الدردشة الفريدة | 1320 | **1374** | 1475 | | 🖼️ جسر الوسائط | 🆕 رؤية + صوت + فيديو | ✓ | ✓ | | 📡 كتالوج Radar المجاني | 🆕 تفعيل اختياري | ✓ | ✓ | | ⚖️ الجدولة الواعية بالحصص | 🆕 مشاركة الحصة | ✓ | ✓ | | 📊 تليمترية الحصص | 🆕 مباشر | ✓ | ✓ | | 🧰 الوضع بلا واجهة | — | — | 🆕 `serve --headless` | | 🛤️ بنية مسار LTS | — | — | 🆕 قنوات الإصدار | | 🔎 واجهة API لاكتشاف النماذج | — | — | 🆕 `/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	🏆 ما الذي يميّزه
⚙️ الميزات	🎯 المجموعات	🌐 الموفّرون	🔌 CLI وMCP
	🗜️ الضغط	🖥️ أماكن التشغيل	🔒 خاص
👀 شاهده	🎬 أثناء العمل	✨ ما الجديد	🤖 واجهات CLI المتوافقة
💚 الدعم	💚 الدعم / التبرّع	💬 المجتمع	💖 الرعاة
📦 المشروع	🛠️ الحزمة التقنية	📖 الوثائق	👥 المساهمون

🌐 متاح بـ 67 لغة

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

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

```bash # بعد ربط مزوّد، انسخ مفتاح OmniRoute الخاص بك من Dashboard → Endpoints: 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: يستدعي IDE أو 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.53**. السجل الكامل في [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ توجيه `quota-weighted`** — استراتيجية التجميع العشرون تتجاوز الحسابات المستنفدة، ثم توزّع الطلبات على البقية بنسبة الحصة المتبقية ÷ الحمل الجاري، مع إبقاء المحادثات القائمة مثبّتة. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 الوضع بلا واجهة (Headless)** — يشغّل `omniroute serve --headless` (أو `OMNIROUTE_HEADLESS=1`) محرك البروكسي `/v1/*` فقط، مع إيقاف لوحة التحكم والأنظمة الفرعية الخاصة بها. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 اكتشاف النماذج** — يوفّر `/v1/models` تصفية حسب القدرات وسياق الطلب والنوع والنص، ويعيد `POST /v1/models/query` قائمة مختصرة قصيرة حتمية بنفس نطاق الرؤية لكل مفتاح. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 تحكم بالتوجيه لكل مفتاح** — ثبّت مفتاح API على نموذج أو تجميعة واحدة عبر `forcedModel`، وأضف أو أزل نماذج المفتاح وتجميعاته بشكل ذرّي (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) - **🛡️ تحكم أدق في بيانات PII** — اختيار حسب النوع، وحتى 15 نمطًا مخصصًا موثّقًا، واكتشاف حسب النوع، بينما يبقى التمويه نفسه. → [Guardrails](docs/GUARDRAILS.md) - **🌍 67 لغة في قائمة الانتظار، ومرايا للتوثيق وCLI، مع `npm run i18n:add-locale` لإضافة لغة بأمر واحد.** → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — لوحة تحكم موحّدة لتفويض المهام إلى وكيلك، ومهارات Connector على الوكيل، ولوحة استدعاء human2agent مع محادثة صوتية بنمط اضغط-لتتحدث. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 قبول تكيفي + حماية من الحمل الزائد** — الطلبات الثقيلة في طريقها إلى 503، مع حدود RPM ذرّية لكل اتصال. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ ترتيب `/v1/models` القانوني** — كتلة واحدة متجاورة مجمّعة حسب المزوّد لكل مزوّد (مع تثبيت النماذج)، مستقرة عبر كل مصادر الكتالوج. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ تقوية الضغط** — حماية من التضخّم مفعّلة افتراضيًا، وحزم Caveman للألمانية / الفرنسية / اليابانية + الصينية الكلاسيكية، ومرشّحات RTK لـ Gradle و.NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 تكلفة ثابتة صادقة** — مزوّدو الاشتراكات / خطط البرمجة يظهرون **$0** في تحليلات التكلفة؛ بينما تستمر الميزانية والحصة والتوجيه في التقدير. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ توجيه Quota-Share** — وزّع حصة حساب مشترك بعدالة على المفاتيح المجمّعة، بطريقة محافظة على العمل بحيث تُعار الشرائح الخاملة. → [Resilience Guide](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 Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ الوضع البعيد** — قُد OmniRoute عن بُعد باستخدام رموز محدودة النطاق (`connect` / `contexts` / `tokens`) + مساعد OAuth باسم `antigravity` لتنصيبات VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 توجيه تلقائي أذكى** — تجميعات `auto/:`، و**Fusion** (لوحة نماذج + حَكَم)، وتوجيه واعٍ بالمهمة، وتجاوزات لكل طلب للنموذج / الوضع / ميزانية الدولار. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ ضغط قابل للتوصيل** — 12 محركًا قابلًا للتركيب + Compression Studios: LLMLingua-2، وUltra ثنائي المستوى، وomniglyph، وبوابة دقة لكل خطوة، وGCF v3.2، ومحرّر بالسحب وإعادة الترتيب. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ فك تشفير MITM شفاف (TPROXY)** — التقط واجهات CLI التي تتجاهل متغيرات بيئة البروكسي، مع شهادة CA لكل SNI + مثبّت مخزن الثقة. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 قياس التكلفة في كل مكان** — ترويسات التكلفة/الاستخدام `X-OmniRoute-*` على كل نقطة نهاية، وترويسة التوفير عند إصابة الذاكرة المؤقتة (cache-HIT)، وحصص إنفاق بالدولار لكل مفتاح. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 ذاكرة تحت سيطرتك** — معطّلة افتراضيًا، وتكميم متجهات int8 اختياري + تحليل بالانحدار حسب النوع، و`x-omniroute-no-memory` لكل طلب. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ الأمان** — حارس ضد حقن التعليمات (prompt-injection) على كل مسار LLM (مجموعة اختبارات الفريق الأحمر)، وحماية اختيارية لإخفاء بيانات الاعتماد (تحجب مفاتيح API والأسرار المسرّبة في الاتجاهين)، وبحث ويب مجاني عبر DuckDuckGo كخيار أخير، وبوابة تسجيل دخول OIDC اختيارية للوحة التحكم (يبقى تسجيل الدخول بكلمة المرور متاحًا دائمًا). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ نقاط نهاية جديدة** — تُكمل `/v1/ocr` (Mistral OCR) و`/v1/audio/translations` (بنمط Whisper) واجهة الوسائط. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 توليد الصور / الفيديو / الصوت** — واجهة API واحدة للوسائط: فيديو xAI Grok Imagine وNovita AI، وComfyUI، وMagnific، وAdobe Firefly، وSegmind، ومزوّدو الكلام مثل ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 النشر والتشغيل** — `basePath` في البروكسي العكسي، والكشف التلقائي للغة المتصفح، وتتبّع الأجهزة لكل مفتاح، وثقة MITM بدون جذر، وتعريب zh-TW. → [Environment](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… و**كتالوج محدّث يضم 375 مزوّدًا**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 شفافية التوجيه** — كل استجابة تحمل ترويسة `X-OmniRoute-Decision` تسمّي الاستراتيجية/المزوّد/زمن الاستجابة الذي خدمها، واستراتيجية تجميع جديدة `cache-optimized` + عامل `cacheAffinity` في Auto-Combo يعيدان الطلبات المتكررة إلى الاتصال الذي يحتفظ بالبادئة المخزّنة مؤقتًا، وتكشف نقطة نهاية للقراءة فقط `/v1/auto-combo/{channel}/candidates` عن مجموعة المرشحين الحية لقناة `auto/*`. → [Auto-Combo](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 APIs المتوافقة مع OpenAI، وذاكرة تخزين مؤقت دلالية للاستجابات، والتلعيب مع لوحات الصدارة، واكتشاف وكلاء ACP (15 وكيلًا مدمجًا)، وتصدير السجلات المجدول إلى BigQuery، و`auto/chaos` للتوزيع المتوازي متعدد النماذج، وجسر بوت Telegram، ومدير إصدارات داخل التطبيق، وتصنيفات المزوّدين المجانيين LMArena-ELO. → [المستندات](docs/README.md)

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

_{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

_{📖 إعدادات خاصة بكل أداة لجميع الأدوات الـ 37 (27 من أدوات CLI البرمجية + 10 من وكلاء 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)

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

> **375 مزوّدًا مسجّلًا** ضمن المجموعات المعتمدة للدردشة والوسائط والبحث والتشغيل المحلي ووكلاء السحابة والنظام، من بينها **153 تحمل بيانات الاكتشاف الوصفية `hasFree: true`**. يغطي سجل نماذج الدردشة **239 مزوّدًا / 3,059 زوجًا مميزًا من المزوّد والنموذج / 1,475 معرّف نموذج أوليًا**؛ ويضم كتالوج الميزانية المجانية المنفصل **467 صفًا لكل نموذج**، و**34 مجموعة دورية**، و**51 مزوّدًا مجانيًا دائمًا بدورات متكررة أو دون مفتاح**. صُممت هذه الأعداد الإجمالية وفق أسس مختلفة؛ وترد التعريفات والحسابات التي تزيل تكرار المجموعات في [مرجع المزوّدين](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 نموذجًا 10K عصبون/يوميًا}	NVIDIA NIM _{GLM, MiniMax ~40 RPM مجانًا}	Cerebras _{GLM 4.7, GPT-OSS رصيد $5 لمرة واحدة؛ البطاقة مطلوبة}	OpenRouter _{نماذج :free +$10 ← RPM أعلى}

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

## 🖥️ أين يعمل OmniRoute — في أي مكان

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

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

_{📖 [دليل Docker](docs/guides/DOCKER_GUIDE.md) · [سطح المكتب](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 Chat الأصلي في VS Code

> لا شريط جانبي جديد ولا واجهة دردشة جديدة — يظهر كل نموذج يقدّمه OmniRoute مباشرةً في > **منتقي نماذج Copilot Chat الذي تستخدمه بالفعل**. منذ VS Code 1.122، تعمل نماذج الموفّرين > دون تسجيل الدخول إلى GitHub أو الاشتراك في Copilot — وضع الوكيل، واستدعاء الأدوات، والرؤية، > مجانًا. ثبّت إضافة **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**، ووجّهها إلى خادم OmniRoute لديك (الإعداد الافتراضي هو `localhost:20128`)، ثم افتح Copilot Chat ← منتقي النماذج ← **إدارة النماذج…** ← **OmniRoute**.

المتجر	الرابط	يعمل مع
🧩 VS Code Marketplace	تثبيت ←	VS Code — الإصدار المستقر وInsiders
🔓 Open VSX Registry	تثبيت ←	Cursor، وWindsurf، وVSCodium، وTheia، وcode-server، وGitpod، وAntigravity، وKiro…

من داخل المحرر: افتح عرض **الإضافات**، وابحث عن **"OmniRoute"**، وانقر على **تثبيت** — تعمل بالطريقة نفسها في كلا المتجرين. تتوفر الشيفرة المصدرية والمشكلات ودليل النشر في [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [دليل VS Code Copilot Chat](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 serve`، ويتبنّى نسخة تعمل بالفعل بدلًا من تكرارها
📊 الاستخدام المباشر بلمحة	أشرطة حصص الموفّرين، وحدود جلسات Claude وحدوده الأسبوعية مع العد التنازلي لإعادة التعيين، وتفصيل التكلفة لمدة 30 يومًا
🔄 يُجري تحديثات تلقائية في موضعه	تثبيت مرحلي، واستبدال ذري، وتراجع عند الفشل — دائمًا على أحدث إصدار
🚀 البدء عند تسجيل الدخول	تشغيل اختياري عند تسجيل الدخول؛ في علبة النظام فقط، دون أيقونة في Dock
🩺 التشخيص والسجلات	تشخيص بنقرة واحدة والوصول إلى سجلات الخادم

```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 توكنًا تقريبًا في المثال الم stacking الموثّق. المحتوى المهيكل محميٌّ بحُرّاس الحفاظ وبوّابات الأمانة لكل خطوة؛ وقد تعمل الأوضاع الصريحة الفاقدة للدقة أو التجريبية على تحويل المحتوى المؤهّل.

المزيج المكدّس الافتراضي يشغّل `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) (⭐ 90K+) و[LLMLingua-2](https://github.com/microsoft/LLMLingua) و[Troglodita](https://github.com/leninejunior/troglodita) (البرتغالية البرازيلية). ### 🧱 حزمة المحرّكات الاثني عشر تعمل المحرّكات بترتيب خط المعالجة؛ وكل واحد منها قابل للتفعيل/الإيقاف والتهيئة بشكل مستقل لكل تركيبة:

#	المحرّك	ماذا يفعل
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	تشذيب دلالي عبر تعلّم الآلة باستخدام MobileBERT ONNX — آمن على الشيفرة وغير متزامن
11	Ultra	تشذيب استكشافي للتوكنات مع طبقة اختيارية لنموذج صغير (SLM)
12	OmniGlyph	ترميز تجريبي للسياق كصورة، مُقاس على Claude Fable 5 عبر اتصال Anthropic المباشر؛ أما محوّلات GPT 5.6 فتبقى مغلقة عند الفشل بانتظار إثباتات من المزوّد. أربعة ملفات ضغط (aggressive الافتراضي، balanced، coding-safe، passthrough) (الأكثر عدوانية؛ تفعيل اختياري)

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

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

**مثال حقيقي — وضع Standard:** > **قبل (69 توكنًا):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_ > > **بعد (19 توكنًا):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_ > > **نفس الإجابة. توكنات أقل بنسبة 72%. صفر خسارة في الدقة.** ✅ **مثال بالبرتغالية البرازيلية (PT-BR) — وضع [Troglodita](https://github.com/leninejunior/troglodita):** > **قبل (42 رمزًا):** _"المشكلة هي أن المكوّن يُعاد تصييره لأن مرجع كائن جديد يُنشأ في كل دورة تصيير. أوصي باستخدام `useMemo`."_ > > **بعد (12 رمزًا):** _"إعادة تصيير: مرجع جديد كل دورة (كائن مضمَّن يُعاد إنشاؤه). استخدم `useMemo`."_ > > **الاستجابة نفسها. ~70% رموز أقل. الدقة التقنية سليمة.** ✅
### 🎚️ ما وراء المحرّكات — أنماط المخرجات، القرص التكيّفي والتحكّم لكل طلب المحرّكات الاثنا عشر أعلاه تُقلّص ما **يدخل**. وهناك ثلاث طبقات أخرى تُشكّل **كيف** و**متى** وما **يخرج**: - **🪄 أنماط المخرجات** _(توجيه محور المخرجات)_ — حقن تعليمات حتمية آمنة للتخزين المؤقت تُشكّل الاستجابة؛ قابلة للدمج، كلٌّ منها بكثافة `lite` / `full` / `ultra`. إضافة نمط هي مدخل سطر واحد في السجل: - **نثر موجز** — احذف الحشو / أدوات التعريف / التخفيف؛ أبقِ الجوهر التقني دقيقًا. - **كود أقل** — «مطوّر أول كسول» YAGNI: أصغر تغيير فعّال، بلا سقالات غير مطلوبة. - **Ponytail (مطوّر أول كسول)** — اصعد سلّم YAGNI، أصلح السبب الجذري، أصغر فرق فعّال. - **لديّ ADHD (الإجراء أولًا)** — الإجراء التالي يتصدّر، خطوات مرقّمة، خطوة تالية ملموسة واحدة، بلا مقدّمات. - **نثر CJK موجز (文言)** — أسلوب صيني كلاسيكي فائق الإيجاز (مقيّد باللغة إلى `zh`). - **🎯 ميزانية السياق التكيّفية** _(القرص)_ — بدلًا من عتبة توكِن واحدة تشغيل/إيقاف، صعّد أرخص المحرّكات وأقلّها فقدًا بالقدر اللازم فقط لـ**ملاءمة نافذة سياق النموذج**. السياسة: `reserve-output` (افتراضية، واعية بالنموذج) · `percentage` · `absolute`. الوضع: `floor` (ضمان الملاءمة) · `replace-autotrigger` (خيارك الصريح يفوز) · `off` (العتبة القديمة). - **🎛️ أين يُقرَّر الضغط** _(الأولوية، من الأعلى إلى الأدنى)_ — ترويسة `x-omniroute-compression` لكل طلب › تجاوز تركيبة التوجيه › الملف الشخصي المسمّى النشط › التكيّفي / التشغيل التلقائي › افتراضي اللوحة › إيقاف. تُعاد الخطة المطبّقة في ترويسة الاستجابة `X-OmniRoute-Compression: ; source=`. شغّل تلقائيًا حسب عتبة التوكِنات، أو فعّل القرص التكيّفي، أو ثبّت ملفًا شخصيًا مسمّى، أو اضبط إعدادًا لمرة واحدة لكل طلب، أو خصّص خط أنابيب لكل تركيبة توجيه — أيًّا كان الأنسب لعبء العمل. وهناك **أداة تقييم** offline اختيارية (`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` أو تحذيرات peer-dep؟ [إنها غير ضارّة](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **هل تستخدم npm 11 أو أحدث؟** قد تمنع npm سكربتات دورة حياة الحزم ما لم يُسمح بها. إن `postinstall` الخاص بـ OmniRoute (`node scripts/build/postinstall.mjs`) مطلوب لتحضير ملفات بيئة التشغيل الأصلية. اسمح بالحزم المذكورة في تحذير npm عند التثبيت العام. بالنسبة لمجموعة الحزم التي أبلغ عنها OmniRoute 3.8.53: > > ```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) اربط مزوّدًا مؤهلًا باستخدام حسابك الخاص** لوحة التحكّم ← **Providers** ← اختر مزوّدًا تناسبه شروطه وحصته الحالية مع حالتك ← أضف مفتاح API الخاص به أو أكمل تدفّق حسابه. قد تتطلّب الطبقات المجانية التسجيل أو الموافقة أو وسيلة دفع. راجع [دليل الطبقات المجانية](docs/getting-started/FREE-TIERS-GUIDE.md)؛ توفّر الوصول بدون مفتاح غير مضمون، والمزوّدون المعلَّمون بـ `tos: avoid` مستبعَدون من `auto` افتراضيًا. **3) وجّه أداة البرمجة لديك** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **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 — ‏100% TypeScript عبر `src/` و`open-sse/` (صفر `any` في النواة منذ v2.0)
إطار العمل	Next.js 16 + React 19 + Tailwind CSS 4
قاعدة البيانات	better-sqlite3 (SQLite، تدوين WAL) + LowDB (JSON قديم) — 147 وحدة نطاق، 209 ترحيلات
الذاكرة	SQLite FTS5 بحث نصي كامل + تضمينات متجهية مُكمّمة إلى int8، تلاشٍ مُنمّط
المخططات	Zod 4 — التحقق من إدخال/إخراج أدوات MCP + عقود API
البروتوكولات	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
البث	Server-Sent Events (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 — انتحال بصمة TLS من نوع JA3 / JA4، وكيل من 3 مستويات
المرونة	قاطع الدائرة، التراجع الأسي، مكافحة القطيع الهادر، الشفاء الذاتي للتجميع التلقائي
التسجيل	pino — سجلات JSON منظمة مع سياق الطلب
الاختبار	Node.js test runner + Vitest — أكثر من 56,000 تعريف اختبار ثابت عبر أكثر من 7,800 ملف اختبار متتبع (وحدة، تكامل، 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 run، وملفات تعريف Compose، وCaddy HTTPS، والأنفاق، ووسوم الصور
دليل 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، وخطوط أنابيب مكدّسة، وواجهات لوحة التحكم/API/MCP
صيغة قواعد الضغط	مخططات حزم قواعد JSON لمرشّحات Caveman وRTK
حزم لغات الضغط	كشف اللغة وتأليف حزم قواعد Caveman
دليل المرونة	قواطع الدائرة، وفترات التهدئة، وقائمة الانتظار، ومكافحة التدافع الجماعي، وانتحال TLS
محرّك Auto-Combo	تقييم بـ 16 عاملًا، وحزم الأوضاع، والإصلاح الذاتي
دليل الوكيل	نظام وكلاء من 3 مستويات، وسوق 1proxy، وعمليات CRUD على السجل
الطبقات المجانية	دليل موحّد: 34 مجموعة متكررة موثّقة / 467 إدخالًا مجانيًا مفهرسًا
معرض الميزات	جولة مرئية في لوحة التحكم مع لقطات الشاشة
توثيق قاعدة الشيفرة	شرح لقاعدة الشيفرة ملائم للمبتدئين

### 🤖 البروتوكولات وواجهات 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 لغة، وسير عمل الترجمة، وRTL
قائمة تحقّق الإصدار	خطوات التحقق قبل الإصدار
خطة التغطية	استراتيجية تغطية الاختبارات لأكثر من 56,000 تعريف اختبار ثابت عبر أكثر من 7,800 ملف اختبار متعقَّب

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

الترتيب	المساهم	طلبات السحب المدمجة	الأسطر المتغيّرة تقريبًا
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{أُجري الإحصاء في 2026-10-18 15:09:09 UTC عند رأس release/v3.8.52 الحي 656f01cb43. يتضمّن إحصاء GitHub GraphQL المُصفّح 9,191 طلب سحب مدمجًا: 3,834 من مالك المستودع، و229 من Dependabot، و6 من روبوتات/تطبيقات أخرى، و5,122 طلب سحب خارجيًا من 835 مساهمًا مختلفًا. «الأسطر المتغيّرة» هي إضافات GitHub + الحذف وتشمل الملفات المولّدة وملفات القفل والكتالوجات والترجمات والتوثيق؛ وهي حركة تغيير، وليست أسطر شيفرة مؤلَّفة. تُبلِغ 49 طلب سحب عن فروقات GitHub تتجاوز 500,000 سطر (على سبيل المثال #13399، إضافة مزوّد واحد، يسرد 2,347 ملفًا متغيّرًا)، مما يضخّم عدة إجماليات أعلاه. تُرتّب المراكز المتعادلة معًا.} ### الالتزامات المنسوبة إلى GitHub

Dizzle _{🥇 367 مساهمة منسوبة إلى GitHub}	Bob.Hou _{🥈 269 مساهمة منسوبة إلى GitHub}	Paijo _{🥉 229 مساهمة منسوبة إلى GitHub}	backryun _{🏅 202 مساهمة منسوبة إلى GitHub}	Paco Cartones _{🏅 174 مساهمة منسوبة إلى GitHub}	Ravi Tharuma _{🏅 126 مساهمة منسوبة إلى GitHub}
Markus Hartung _{🏅 114 مساهمة منسوبة إلى GitHub}	Randi _{🏅 108 مساهمات منسوبة إلى GitHub}	Jan Leon _{🏅 87 مساهمة منسوبة إلى GitHub}	Chris _{🏅 70 مساهمة منسوبة إلى GitHub}	Koosha Paridehpour _{🏅 68 مساهمة منسوبة إلى GitHub}

_{أُعيد التحقق في 2026-10-18 14:44:45 UTC: المساهمات المنسوبة إلى GitHub التي أبلغت عنها واجهة Contributors API الخاصة بالمستودع للفرع الافتراضي release/v3.8.52. أعادت الواجهة 849 هوية (429 مستخدمًا، وروبوتين، و418 هوية مجهولة)؛ ويستبعد هذا الجدول المشرف والروبوتات والهويات المجهولة، مع الإبقاء على حالات التعادل في الترتيب. وهو يختلف عن كلٍ من ترتيب طلبات السحب المدمجة أعلاه وإحصاء بيانات 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 مجانيًا ومستقلًا.

## 👥 أكثر من 900 مساهم

[![المساهمون](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{أُجري التدقيق في 2026-10-18 عند أحدث نقطة في release/v3.8.52 المباشر، وهي ad160ab2d1 (6,826 التزامًا): 993 هوية Git بشرية موحّدة — يظهر 707 منهم كمؤلفي التزامات (بمن فيهم المشرف)، بينما يظهر 286 فقط في التذييلات الصريحة Co-authored-by. يطبّق الإحصاء .mailmap، ويقارن عناوين البريد الإلكتروني دون حساسية لحالة الأحرف، ويدمج عناوين GitHub الرقمية والعادية من نوع noreply فقط عندما ترمّز إلى المعرّف نفسه، ويستبعد 26 هوية لبوتات/وكلاء/خدمات/عناصر نائبة، ولا يدمج عناوين البريد الإلكتروني العادية لمجرد تطابق أسماء العرض الخاصة بها. نشر تدقيق 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 في 18 أكتوبر 2026 — فامنحوا هذه المشاريع نجمة. تمثل الأعداد لقطة دقيقة مؤرخة، ومن الطبيعي أن تتغير. ### 🧬 الأصول والبوابة

المشروع	⭐	كيف ألهم OmniRoute
9router	31,004	المشروع الأصلي الذي بُني عليه هذا التفرّع — وقد جرى توسيعه هنا بإضافة واجهات API متعددة الوسائط وإعادة كتابة كاملة باستخدام TypeScript.
CLIProxyAPI	55,591	تنفيذ Go الذي ألهم هذه النسخة المنقولة إلى JavaScript / TypeScript.
LiteLLM	61,482	بوابة الذكاء الاصطناعي التي تغذي مجموعة بيانات التسعير العامة الخاصة بها مزامنة تتبّع التكاليف لدينا، والتي أسهم نموذجها لتوحيد مزوّدي الخدمة في تصميم آلية التوجيه لدينا.
codex-chatgpt-web	14,526	شيفرة مصدرية بترخيص MIT جرى تكييفها ضمن جسر ChatGPT Web → Codex Responses المضمّن، بما في ذلك محوّلات جلسات المتصفح، وتأطير الاستجابات، والاستخدام، والبحث على الويب.
free-claude-code	61,430	أنماط نُقلت إلى استعادة التدفق، والأسماء البديلة من دون تفكير، والبحث الاحتياطي على الويب، وحدود النافذة المنزلقة، وتنقيح السجلات، ومسارات التشغيل المحصّنة.
composer-api	346	أنماط اختيار الأدوات، وقيود المخرجات، وتثبيت الأدوات في Cursor Composer، والتي جرى تكييفها ضمن منفّذ Cursor الأصلي.
codex-multi-auth	553	أنماط تسجيل الدخول الجديد وتدوير رموز التحديث، والتي نُقلت إلى إعادة مصادقة Codex OAuth.
opencode-anthropic-auth	558	إعدادات التحويل الافتراضية المتوافقة مع Claude Code وسلوك ترويسات الفوترة، والتي جرى تعميمها ضمن جسر OmniRoute المعتمد على الإعدادات.
grok2api-merged	2	جرى تكييف تعيينات نماذج Grok الخاصة به، ومولّد Statsig الذي يحاكي TypeError، والإعدادات الافتراضية للطلبات والأجهزة، ومعالج استجابات NDJSON، بصورة جوهرية ضمن منفّذ Grok Web في OmniRoute.
TQZHR/grok2api	706	المصدر البرمجي الانتقالي الرئيسي وراء grok2api-merged؛ وقد حوفظ على تنفيذاته الخاصة بالنماذج، والترويسات، والحمولات، وStatsig، والمعالجات ضمن سلالة Grok Web.
chenyme/grok2api	7,819	المصدر الأساسي المرخّص بموجب MIT للإعدادات الافتراضية لحمولات Grok وأجهزته، ومولّد Statsig، ومعالج `result.response` المنقول عبر TQZHR وgrok2api-merged.
grok2api-pro	27	مصدر انتقالي نسب إليه grok2api-merged الفضل في طبقة مجمّع الوكلاء الخاصة به؛ يحافظ OmniRoute على إشعار النسب هذا، لكنه لا يدّعي نقل مجمّع وكلاء ضمن منفّذ Grok Web محدود النطاق الخاص به.
GrokProxy	51	أسهم وكيل Grok الموثّق بملفات تعريف الارتباط ونمط تدفق `result.response.token` الخاص به في تصميم آلية نقل Grok Web في OmniRoute.
GrokBridge	5	استعان تنفيذ Grok Web الأصلي بتصميم المنبع الخاص به والقائم على HTTP/المتصفح؛ ويُشتق مسار HTTP المباشر فيه من GrokProxy، ولذلك لا يُدّعى نقل أي شيفرة مستقلة منه.

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

المشروع	⭐	كيف ألهم OmniRoute
Caveman	113,396	مشروع «لماذا تستخدم رموزًا كثيرة حين تؤدي رموز قليلة الغرض» واسع الانتشار — تدعم فلسفته القائمة على لغة رجل الكهف وضع الضغط القياسي لدينا وأكثر من 30 قاعدة لإزالة الحشو والتكثيف.
RTK – Rust Token Killer	83,835	ضغط عالي الأداء لمخرجات الأوامر — ألهم محرك RTK لدينا، ولغة JSON DSL للتصفية، واستعادة المخرجات الخام، ومسار RTK → Caveman المتسلسل.
headroom	75,741	ضغط سياق قابل للعكس (SmartCrusher) — ألهم محرك `headroom` لدينا ونمط علامة الاسترداد `ccr`.
LLMLingua	6,757	أبحاث ضغط المطالبات (LLMLingua / LLMLingua-2) — ألهمت محرك `llmlingua` لدينا، غير المتزامن والآمن للتعليمات البرمجية والمصمم لإتاحة المتابعة عند الفشل.
llmlingua-2-js	32	منفذ JS/ONNX ‏(MobileBERT / XLM-RoBERTa) المستخدم كواجهة خلفية قائمة على خيوط العامل لمحرك LLMLingua لدينا.
Troglodita	50	ضغط الرموز للبرتغالية البرازيلية — يشغّل حزمة اللغة pt-BR لدينا: تقليل الحشو البلاغي وإزالة الكلمات الزائدة، بضبط ملائم لقواعد البرتغالية البرازيلية.
ponytail	166,731	مهارة المبرمج «الكبير الكسول» واسعة الانتشار والقائمة على مبدأ YAGNI — ألهمت نمط المخرجات less-code لدينا: توجيه نحو أصغر تغيير صالح للعمل، ما يقلل التعليمات البرمجية _المولّدة_ (النظير على محور المخرجات لنثر Caveman المقتضب).
i-have-adhd	57,628	جرى تكييف أسلوب استجابته الذي يقدّم الإجراءات أولًا ويلائم اضطراب فرط الحركة وتشتت الانتباه ليصبح نمط المخرجات الموجز في OmniRoute عبر خمس لغات.

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

المشروع	⭐	كيف ألهم OmniRoute
TOON	25,509	ترميز الكائنات الموجّه نحو الرموز — شكّل نموذجه العمودي القائم على رأس يليه صفوف مرحلة الضغط الجدولي لدينا.
GCF – Graph Compact Format	59	أسهم تنسيق الرسوم البيانية المدمج وتصميم ملف التعريف العام فيه في صياغة الضغط الجدولي وتنسيق برنامج الترميز Headroom في OmniRoute.
gcf-typescript	4	تطبيق MIT بلغة TypeScript، المضمّن مباشرةً والموسّع ليكون برنامج ترميز ملف التعريف العام في Headroom.
token-optimizer-mcp	551	ذاكرة تخزين مؤقت باستخدام Brotli/SQLite مع فروق سياق لكل جلسة — ألهمت محرك `session-dedup` لدينا.
token-savior	1,182	ضغط مخرجات Bash مع ملفات تعريف MCP — ألهم نهجنا المنضبط للتراجع عن الضغط وتقليل بيان أدوات MCP.
token-saver	154	ضغط مخرجات واعٍ بالمحتوى ولكل نوع ملف، مع تراجع يراعي حالات الفشل — أثبت صحة توجيهنا حسب النوع وتجاوز الضغط عند عدم بلوغ الحد الأدنى للمكاسب.
token-optimizer	2,595	«اعثر على الرموز الشبحية» — أسهم نمطه القائم على التفريغ والمقابض القابلة للاستعادة في تشكيل تصوّرنا للتفريغ عبر CCR.
TokenMizer	33	مخطط لجلسات قائمة على الرسوم البيانية وإزالة تكرار الأسطر عبر الأدوار، أسهم في تصميمنا لإزالة التكرار بين الجلسات.
OmniCompress	3	تنسيق JSON عمودي بلغة Rust، واسترداد معنْون بالمحتوى، وإزالة التكرار عبر الرسائل — أثبت صحة تصميم محركات `headroom`/`ccr`/`session-dedup` لدينا، وثابت استقرار ذاكرة التخزين المؤقت القائل إن «الصيغة المضغوطة مستقلة عن الموضع».
mcp-compressor	133	ضغط مخططات أدوات MCP وأوصافها — أسهم في تشكيل نهجنا لتقليل عدد عناصر بيان أدوات MCP.
RepoMapper	217	ترتيب خرائط المستودعات بأسلوب Aider — أسهم في استكشافنا لخرائط المستودعات وترتيب الاسترداد.
quiet-shell-mcp	4	تقليل تصريحي لمخرجات الصدفة عبر MCP — أثبت صحة نهجنا التصريحي لضغط مخرجات bash.
ts-morph	6,205	مجموعة أدوات لواجهة TypeScript Compiler API — ألهمت إزالة التعليقات القائمة على المحلّل لدينا، والتي تحافظ على القيم الحرفية للسلاسل والقوالب والتعبيرات النمطية.

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

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

### 🛰️ فحص حركة البيانات، واعتراض MITM، والوكيل الشفاف

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

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

المشروع	⭐	كيف ألهم OmniRoute
models.dev	7,286	قاعدة بيانات مفتوحة لمواصفات نماذج الذكاء الاصطناعي وأسعارها وقدراتها — تُزامَن بصورة أصلية مع كتالوج النماذج لدينا.
React Flow / xyflow	38,705	مكتبة الرسوم البيانية القائمة على العُقد التي تشغّل استوديو الضغط واستوديو الدمج/التوجيه في الوقت الفعلي لدينا.
LangGraph	43,443	ألهم التصوير المرئي المباشر للرسم البياني لسير العمل في LangGraph Studio عرض التتابع في الوقت الفعلي داخل الاستوديوهات لدينا.
Langfuse	35,990	شكّل نموذج الرصد الخاص به، من التتبّع ← إلى النطاق ← إلى التوليد، مخطط الشلال في استوديو الضغط لدينا.
Kiali	3,645	قابلية رصد شبكة خدمات Istio — ألهمت شارات قواطع الدارات والتمثيلات المرئية لحواف الأخطاء في استوديو التوجيه/الدمج.
lobe-icons	2,615	شعارات العلامات التجارية للذكاء الاصطناعي/LLM التي تعرض أيقونات المزوّدين في لوحة المعلومات لدينا.
flag-icons	12,473	يوفّر أعلام SVG المرخّصة بموجب MIT والمستخدمة في محدد اللغة بملف README.

### 🛡️ الأمان

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

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

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

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

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