README (العربية)

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

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

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

💰 ~1.62 مليار رمز مجاني / شهريًا

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

ملخص متحرك لصفحة /dashboard/free-tiers المباشرة. المنهجية الكاملة (إزالة تكرار المجموعات، فئات الأرصدة، شروط المزودين): docs/reference/FREE_TIERS.md.

_{تُعاد مراجعة هذه الأرقام كل أسبوعين بالاستناد إلى الفهرس المباشر، وهي تتحرك في الاتجاهين — إذا أنهى مزود خطة مجانية انخفض الرقم؛ وإذا أُضيفت خطة جديدة ارتفع. ننشر ما يحسبه الفهرس فعليًا، وليس أفضل سيناريو بعد تقريبه إلى الأعلى.}

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

💬 انضم إلى المجتمع

👋 تابع المشرف — وكن أول من يحصل على المزودين الجدد والإصدارات والنصائح:

الأسئلة، ونصائح المزودين، وخريطة الطريق، والدعم ← Discord · Telegram · WhatsApp 🌍 العالمي / 🇧🇷 البرازيل / البوابة

📈 البوابة تواصل النمو

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 المزوّدون	290	357	المزيد قيد الانتظار
🧠 معرّفات نماذج الدردشة الفريدة	1185	1312	—
🖼️ جسر الوسائط المتعددة	—	🆕 رؤية + صوت + فيديو	—
📡 كتالوج Radar المجاني	—	🆕 اشتراك اختياري	—
⚖️ الجدولة المراعية للحصص	—	🆕 Quota-Share	—
📊 قياس الحصص عن بُعد	—	🆕 مباشر	—

← خارطة الطريق — على المسار نحو v3.9.0 LTS

🧩 متاح

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

🌐 متاح بـ 66 لغة

🆓 يعمل بمجرد تثبيته — بلا مفاتيح، بلا إعدادات

# تثبيت جديد، بلا بيانات اعتماد — `auto` يعمل بالفعل:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{هل تفضل واجهة خلفية مجانية محددة؟ استدعِ oc/… (OpenCode Free) مباشرة. ثم انتقل إلى auto ودع OmniRoute يختار.}

_{📦 نصوص بدء سريعة للنسخ واللصق لـ Python و Node.js و PHP و cURL ← examples/quickstart/}

💥 الوعد

🤔 لماذا OmniRoute؟

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

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

هل ترغب في الانضمام بصفتك صديقًا للمصادر المفتوحة؟ هذه هي الشركات التي تدعم المصادر المفتوحة وتساعد على استمرار تطور OmniRoute — ونعلن على الملأ أين يُنفق كل رمز تمنحنا إياه. تواصل معنا: 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؟ افتح مشكلة وسنضيفه هنا.}

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

المجموعة هي سلسلة من النماذج يوجّه OmniRoute الطلبات بينها تلقائيًا. إذا نفدت الحصة، أو تعطّل أحد المزوّدين، أو ارتفعت التكاليف، فيمكن للمجموعة الانتقال إلى النموذج السليم المؤهل التالي. 🛡️

⚡ من دون إعداد — استخدم `auto` فحسب

لا حاجة إلى إنشاء مجموعة. اضبط نموذجك على auto (أو أحد أنواعه)، وسيُنشئ OmniRoute مجموعة افتراضية من المزوّدين المتصلين لديك، مع تقييم مباشر:

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

🔀 أو أنشئ مجموعتك الخاصة — 19 استراتيجية توجيه

جميع الاستراتيجيات الـ19 — امزج وطابق بينها في كل خطوة من خطوات المجموعة:

#	الاستراتيجية	ما الذي تفعله
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	`reset-window`	تفضيل الوجهة التي ستُعاد تهيئة نافذة حصتها في أقرب وقت
12	`reset-aware`	ترتيب الوجهات بحسب وقت إعادة تهيئة الحصة — النوافذ الأقصر أولًا 📊
13	`context-relay`	تمرير السياق بين الوجهات للمحادثات الطويلة 🧠
14	`context-optimized`	اختيار الأنسب لحجم السياق الحالي
15	`cache-optimized`	تثبيت كل بادئة مطالبة قابلة لإعادة الاستخدام على الحساب نفسه — لتعظيم إصابات ذاكرة التخزين المؤقت للمطالبات 🎯
16	`lkgp`	آخر مسار معروف بنجاحه — يثبّت الطلبات على آخر مزوّد ناجح، ثم يعود إلى القواعد عند الحاجة
17	`auto`	تقييم مباشر قائم على 16 عاملًا عبر جميع الاتصالات 🤖
18	`fusion`	إرسال الطلب بالتوازي إلى مجموعة من النماذج + نموذج حَكَم يدمج النتائج في إجابة واحدة 🧬
19	`pipeline`	تسلسل الخطوات — تُمرَّر مخرجات كل وجهة إلى الوجهة التالية 🔗

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

🧱 المرونة مدمجة (3 طبقات مستقلة)

_{📖 محرّك التوليف التلقائي · دليل المرونة}

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

_{📊 المنهجية الكاملة والتفاصيل لكل ميزة مقارنة بـ 9router و OpenRouter و CLIProxyAPI و LiteLLM ← 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 — فوري، دون رسوم (البرازيل)

المفتاح (عشوائي): 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`

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

🐛 هل عثرت على خطأ أو لديك ملاحظات؟ افتح نقاشًا.

ملاحظات للمطورين: قد ينشئ المشروع ملف .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.

✨ ما الجديد

أبرز المستجدات الأخيرة من v3.8.20 → v3.8.50. السجل الكامل متوفر في CHANGELOG.md.

🎛️ OmniConductor — تفويض A2A الوارد إلى أسطول وكلائك، ومهارات Conductor على بطاقة الوكيل، ولوحة معلومات تتضمن دردشة صوتية بنظام الضغط للتحدث عبر Faro. → خادم A2A
🛂 القبول التكيفي والحماية من الحمل الزائد — تُوضَع طلبات الدردشة الثقيلة في قائمة انتظار بدلًا من إرجاع الخطأ 503، مع عقود إيجار ذرّية متجددة لـ RPM لكل اتصال. → دليل المرونة
🗂️ الترتيب القياسي لـ /v1/models — كتلة واحدة متصلة ومجمّعة حسب المزوّد لكل مزوّد (مع تثبيت التركيبات أولًا)، وثابتة عبر جميع مصادر الكتالوج. → مرجع API
🗜️ تعزيز الضغط — حارس افتراضي مفعّل للحماية من التضخيم، وحزم Caveman للألمانية / الفرنسية / اليابانية + الصينية (wényán)، ومرشحات RTK لـ Gradle و.NET. → الضغط
💸 تكلفة ثابتة صادقة — تظهر تكلفة مزوّدي الاشتراكات / خطط البرمجة بقيمة $0 في تحليلات التكلفة؛ بينما تستمر تقديرات الميزانية والحصة والتوجيه. → مرجع API
⚖️ توجيه Quota-Share — تقسيم حصة حساب مشترك بإنصاف بين المفاتيح المجمّعة، مع الحفاظ على كفاءة العمل بحيث تُعار الشرائح الخاملة للآخرين. → دليل المرونة
🤖 إعداد CLI/الوكيل بأمر واحد — 13 أمرًا مسجلًا من نوع setup-*؛ يشغّل omniroute run سبع أدوات CLI‏ (Claude Code وCodex وAider وGoose وOpenCode وQwen Code وGemini CLI)؛ ويدعم omniroute configure عشرة أهداف مع أداة تفاعلية لاختيار المزوّد والنموذج، ومفضلات لكل سياق. → تكاملات CLI
🛰️ الوضع البعيد — تحكّم في OmniRoute بعيد باستخدام رموز مميزة محددة النطاق (connect / contexts / tokens) + مساعد OAuth باسم antigravity لعمليات التثبيت على VPS. → الوضع البعيد
🧭 توجيه تلقائي أكثر ذكاءً — تركيبات auto/<category>:<tier>، وFusion (لوحة نماذج + حَكَم)، وتوجيه مدرك للمهمة، وتجاوزات لكل طلب للنموذج / الوضع / الميزانية بالدولار الأمريكي. → Auto-Combo
🗜️ ضغط قابل للتوسعة — 12 محركًا قابلًا للتركيب + استوديوهات الضغط: LLMLingua-2، وUltra ثنائي المستوى، وomniglyph، وبوابة دقة لكل خطوة، وGCF v3.2، ومحرر لإعادة الترتيب بالسحب. → الضغط
🕵️ فك تشفير MITM شفاف (TPROXY) — التقاط أدوات CLI التي تتجاهل متغيرات بيئة الوكيل، باستخدام سلطة شهادات لكل SNI + مثبّت لمخزن الثقة. → MITM/TPROXY
💸 قياس التكلفة في كل مكان — ترويسات التكلفة/الاستخدام X-OmniRoute-* على كل نقطة نهاية، وترويسة توفير عند إصابة ذاكرة التخزين المؤقت، وحصص إنفاق بالدولار الأمريكي لكل مفتاح. → مرجع API
🧠 ذاكرة تحت سيطرتك — معطّلة افتراضيًا، مع تكميم متجهات int8 اختياري واضمحلال محدد النوع، وx-omniroute-no-memory لكل طلب. → الذاكرة
🛡️ الأمان — حارس ضد حقن المطالبات على كل مسار LLM (مع حزمة اختبارات هجومية)، وحاجز حماية اختياري لإخفاء بيانات الاعتماد (ينقّح مفاتيح API/الأسرار المسرّبة في كلا الاتجاهين)، وبحث ويب مجاني عبر DuckDuckGo كملاذ أخير، وبوابة تسجيل دخول OIDC اختيارية للوحة المعلومات (يظل تسجيل الدخول بكلمة المرور متاحًا دائمًا). → حواجز الحماية
🖼️ نقاط نهاية جديدة — تُكمل /v1/ocr ‏(Mistral OCR) و/v1/audio/translations ‏(بنمط Whisper) واجهة الوسائط. → مرجع API
🎨 توليد الصور / الفيديو / الصوت — واجهة API واحدة للوسائط: xAI Grok Imagine وNovita AI للفيديو، وComfyUI، وMagnific، وAdobe Firefly، وSegmind، ومزوّدو الكلام مثل ElevenLabs. → مرجع API
🌍 النشر والعمليات — basePath للوكيل العكسي، واكتشاف تلقائي للغة المتصفح، وتتبع الأجهزة لكل مفتاح، وثقة MITM بلا صلاحيات جذر، وتعريب zh-TW. → البيئة
🤝 مزيد من المزوّدين والوكلاء — وكلاء سحابيون (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… بالإضافة إلى كتالوج محدّث يضم 352 مزوّدًا. → المزوّدون
📡 شفافية التوجيه — يحمل كل رد ترويسة X-OmniRoute-Decision التي تسمّي الاستراتيجية/المزوّد/زمن الاستجابة الذي خدمه، وتعيد استراتيجية التركيبات الجديدة cache-optimized + عامل cacheAffinity في Auto-Combo توجيه الطلبات المتكررة إلى الاتصال الذي يحتفظ بالبادئة المخزنة مؤقتًا، كما تكشف نقطة النهاية للقراءة فقط /v1/auto-combo/{channel}/candidates عن مجموعة المرشحين الحية لقناة auto/*. → Auto-Combo
⚡ الأداء والبنية التحتية محليًا — Redis محلي بنقرة واحدة، وأدوات نشر مرحّلات Cloudflare Workers / Deno Deploy، وBifrost وMux كخدمات مضمنة خاضعة للإشراف. → الخدمات المضمّنة
🧩 ومضمّن أيضًا — إطار عمل للإضافات + سوق، وأطر عمل مهارات Omni/Agent/GitHub، وتكامل خزنة Obsidian ‏(22 أداة MCP)، وواجهات Batch وFiles المتوافقة مع OpenAI، وذاكرة تخزين مؤقت دلالية للاستجابات، وتحفيز قائم على اللعب مع لوحات صدارة، واكتشاف وكلاء ACP ‏(15 وكيلًا مضمّنًا)، وتصدير مجدول للسجلات إلى BigQuery، وحقن الأعطال عبر auto/chaos، وجسر لبوت Telegram، ومدير إصدارات داخل التطبيق، وتصنيفات LMArena-ELO للمزوّدين المجانيين. → التوثيق

🤖 واجهات سطر الأوامر ووكلاء البرمجة المتوافقون

إعداد واحد — 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

_{📖 إعداد مخصص لكل أداة لجميع الأدوات الـ 36 (26 أداة CLI للبرمجة + 10 وكلاء CLI) ← docs/reference/CLI-TOOLS.md · 🧩 إضافة OpenCode ← @omniroute/opencode-provider}

شغّل أي CLI مدعوم عبر OmniRoute بأمر واحد — من دون كتابة ملفات إعداد، مع حقن بيانات الاعتماد لكل عملية، وحصول Qwen/Gemini على مجلد رئيسي مؤقت ومعزول:

omniroute run claude   --model openai/gpt-5.4          # Claude Code
omniroute run codex    --model glm/glm-5.2             # واجهة OpenAI Codex لسطر الأوامر
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

يحترم كل أمر السياق البعيد النشط (omniroute connect <host>)، ويعرض --dry-run معاينة دقيقة لمتغيرات البيئة/الوسائط من دون تنفيذ، بينما يُبقي --api-key-env NAME الأسرار خارج سجل أوامر الصدفة. ← تكاملات CLI

🌐 357 مزودًا للذكاء الاصطناعي — 152 منها مُصنَّفة في الدليل على أنها مجانية

357 مزودًا مسجلًا عبر المجموعات القياسية للدردشة والوسائط والبحث والتشغيل المحلي ووكلاء السحابة والنظام، منها 152 تحمل بيانات الاكتشاف الوصفية hasFree: true. يشمل سجل نماذج الدردشة 229 مزودًا / 2,554 زوجًا مميزًا من المزود والنموذج / 1,283 معرّف نموذج أوليًا؛ بينما يحتوي دليل الميزانية المجانية المنفصل على 491 صفًا لكل نموذج، و35 حصة مشتركة متكررة، و54 مزودًا مجانيًا دائمًا بحصص متكررة أو من دون مفاتيح. صُممت هذه المقامات لتكون مختلفة؛ وتتوفر التعريفات والحسابات التي أزيل منها تكرار الحصص المشتركة في مرجع المزودين والخطط المجانية.

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

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

_{…وأكثر من 330 مزودًا آخر — يُحمَّل كل رمز مباشرةً من دليل المزودين في لوحة المعلومات. 📖 مرجع المزودين}

🆓 مجاني إلى الأبد — $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 طلبًا في الدقيقة مجانًا}	Cerebras _{GLM 4.7, GPT-OSS 1M رمز/يوم}	OpenRouter _{نماذج :free +$10 ← معدل طلبات أعلى في الدقيقة}

📖 الكتالوج الكامل القابل للقراءة آليًا ← 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 · سطح المكتب · علبة شريط القوائم · Termux · PWA · OpenCode}

🧩 جديد: OmniRoute داخل Copilot Chat الأصلي في VS Code

لا شريط جانبي جديد ولا واجهة دردشة جديدة — يظهر كل نموذج يقدّمه OmniRoute مباشرةً في منتقي نماذج Copilot Chat الذي تستخدمه بالفعل. منذ VS Code 1.122، تعمل نماذج الموفّرين دون تسجيل الدخول إلى GitHub أو الاشتراك في Copilot — وضع الوكيل، واستدعاء الأدوات، والرؤية، مجانًا.

ثبّت إضافة 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.

_{📖 دليل VS Code Copilot Chat — الإعداد، وما يعرضه المنتقي، ولوحة المعلومات داخل علامة تبويب، واستكشاف الأخطاء وإصلاحها}

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

يكون omniroute serve في أفضل حالاته عندما يعمل دائمًا. يحوّل OmniRouteTray ذلك إلى تطبيق لشريط القوائم في macOS يمكنك إعداده ونسيانه: فهو يشغّل الخادم، ويبقيه قيد التشغيل عبر عمليات إعادة التشغيل، ويحدّثه في موضعه، ويضع ميزانية الرموز المباشرة على بُعد نقرة واحدة — دون ترك نافذة طرفية مفتوحة، ودون الحاجة إلى متابعة npm install -g omniroute.

بُني باستخدام Tauri v2 (نواة Rust بحجم يكاد لا يُذكر)، ويأتي مع بيئة تشغيل Node 24 موقّعة خاصة به، ويدير تثبيت OmniRoute مملوكًا للتطبيق، لذا لا يتعارض مطلقًا مع node/bun العام لديك. وهو يشارك إعداداتك وقاعدة بياناتك الحالية في ~/.omniroute/ — لذا فهو OmniRoute نفسه الذي تشغّله بالفعل، ولكن مع قبعة. 🎩

ما يفعله	كيف
🟢 يراقب الخادم	يشغّل `omniroute serve`، ويتبنّى نسخة تعمل بالفعل بدلًا من تكرارها
📊 الاستخدام المباشر بلمحة	أشرطة حصص الموفّرين، وحدود جلسات Claude وحدوده الأسبوعية مع العد التنازلي لإعادة التعيين، وتفصيل التكلفة لمدة 30 يومًا
🔄 يُجري تحديثات تلقائية في موضعه	تثبيت مرحلي، واستبدال ذري، وتراجع عند الفشل — دائمًا على أحدث إصدار
🚀 البدء عند تسجيل الدخول	تشغيل اختياري عند تسجيل الدخول؛ في علبة النظام فقط، دون أيقونة في Dock
🩺 التشخيص والسجلات	تشخيص بنقرة واحدة والوصول إلى سجلات الخادم

brew install --cask zoispag/tap/omniroute-tray

_{تفضّل التنزيل؟ احصل على أحدث ملف .dmg من
الإصدارات. تتوفر الشيفرة المصدرية والمشكلات ووثائق
البناء في zoispag/omniroute-tray.

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

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

_{📖 التخويل · ضوابط الحماية · الامتثال}

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

إلى جانب الخادم، تُعد OmniRoute مقصورة تحكم متكاملة عبر سطر الأوامر تضم أكثر من 80 أمرًا، بالإضافة إلى بروتوكولات وكلاء مفتوحة تتيح لوكيل ذكاء اصطناعي تشغيلها بنفسه.

⌨️ واجهة CLI حقيقية (وليست مجرد `start`)

omniroute               # تشغيل البوابة + لوحة المعلومات (المنفذ 20128)
omniroute chat          # عميل دردشة TUI تفاعلي (الاختصارات: /model /combo /skill /memory)
omniroute setup         # معالج إرشادي للتشغيل الأول
omniroute doctor        # تشخيص المزوّدين والمنافذ والتبعيات الأصلية

🛰️ الوضع البعيد — شغّل واجهة CLI هنا وOmniRoute على خادم VPS

هل تعمل OmniRoute على خادم؟ تحكّم بها من حاسوبك المحمول باستخدام واجهة CLI نفسها. سجّل الدخول مرة واحدة باستخدام رمز وصول محدود النطاق؛ وبعد ذلك سيستهدف كل أمر الخادم البعيد.

omniroute connect 192.168.0.15            # كلمة المرور ← رمز محدود النطاق، يُحفظ كسياق
omniroute models list                     # ← يُنفّذ على الخادم البعيد
omniroute configure codex                 # ← يختار نموذجًا بعيدًا ويكتب ملف تعريف Codex محليًا
omniroute tokens create --name ci --scope read   # إصدار رموز أضيق نطاقًا للأجهزة الأخرى
omniroute contexts use default            # ← العودة إلى الخادم المحلي

تقتصر نطاقات الرموز على read / write / admin؛ وتظل المسارات التي تُنشئ عمليات مقصورة على واجهة الاسترجاع المحلية. _{📖 الوضع البعيد}

عرض طرفية متحرك يوضّح واجهة OmniRoute CLI — الأوامر omniroute providers list وomniroute combo list وomniroute health — مع التنقل عبر واجهة المستوى الأعلى المكوّنة من 86 أمرًا: 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 أو webhooks أو واجهة 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 — الدردشة، والتضمينات، والصور، والصوت، والتعرّف الضوئي على الحروف
🔔 Webhooks	`/api/webhooks`	إرسال أحداث الطلبات / الحصص إلى Slack أو Discord أو Telegram أو أي عنوان URL
🛰️ واجهة CLI البعيدة	`omniroute connect`	التحكم في نسخة بعيدة باستخدام رموز وصول محدودة النطاق

# امنح Claude Code مجموعة أدوات OmniRoute الكاملة عبر MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 خادم MCP · خادم A2A · بروتوكولات الوكلاء}

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

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

تشغّل التوليفة المكدّسة الافتراضية RTK → Caveman. عندما يعمل كلاهما على حمولة الأداة/السياق نفسها، يتراكم التوفير:

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 وCaveman (⭐ أكثر من 90 ألفًا) وLLMLingua-2 وTroglodita (PT-BR).

🧱 المكدّس المكوّن من 12 محركًا

تعمل المحركات وفق ترتيب خط المعالجة؛ ويمكن تبديل كل منها وتهيئته بصورة مستقلة لكل توليفة:

#	المحرك	ما الذي يفعله
1	Session-Dedup	يحذف المحتوى المتكرر عبر الأدوار (معنون بالمحتوى وعابر للأدوار)
2	CCR	يؤرشف الكتل الكبيرة خلف علامات استرجاع، لتُجلب عند الطلب
3	Lite	تشذيب المسافات البيضاء وعناوين URL للصور (خط أساس خفيف زمن الاستجابة)
4	RTK	تصفية ذكية لنتائج الأدوات وإزالة التكرار والاقتطاع (مدركة للأوامر)
5	Responses Tool Output	ضغط JSON بلا فقد أولًا مع ضغط تشخيصي محدود لمخرجات الصدفة/الترقيع/البحث/البناء (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 مغلقة عند الفشل بانتظار إيصالات المزوّد. أربعة ملفات تعريف للضغط (عدواني افتراضي، متوازن، آمن للبرمجة، وتمرير مباشر) (الأكثر عدوانية؛ يتطلب الاشتراك الصريح)

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

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

مثال واقعي — وضع Standard:

قبل (69 توكنًا): "من المرجح أن سبب إعادة تصيير مكوّن React لديك هو أنك تنشئ مرجع كائن جديدًا في كل دورة تصيير. عندما تمرر كائنًا مضمنًا كخاصية، ترى المقارنة السطحية في React أنه كائن مختلف في كل مرة، ما يؤدي إلى إعادة التصيير. أوصي باستخدام useMemo لتخزين الكائن مؤقتًا."

بعد (19 توكنًا): "مرجع كائن جديد مع كل تصيير. خاصية كائن مضمنة = مرجع جديد = إعادة تصيير. استخدم useMemo."

الإجابة نفسها. توكنات أقل بنسبة 72%. بلا أي خسارة في الدقة. ✅

مثال PT-BR — وضع Troglodita:

قبل (42 رمزًا): "المشكلة هي أن المكوّن يُعاد تصييره لأن مرجع كائن جديدًا يُنشأ في كل دورة تصيير. أوصي باستخدام useMemo."

بعد (12 رمزًا): "إعادة التصيير: مرجع جديد كل دورة (إعادة إنشاء كائن مضمّن). استخدم useMemo."

الإجابة نفسها. رموز أقل بنحو 70%. الدقة التقنية سليمة. ✅

🎚️ ما وراء المحركات — أنماط المخرجات، والقرص التكيّفي، والتحكم لكل طلب

تقلّص المحركات الـ12 المذكورة أعلاه ما يدخل. وتشكّل ثلاث طبقات إضافية كيفية وتوقيت وما يخرج:

🪄 أنماط المخرجات (توجيه محور المخرجات) — تحقن تعليمات حتمية وآمنة للتخزين المؤقت لتشكيل الاستجابة؛ ويمكن دمجها، وكل منها بشدة lite / full / ultra. لا تتطلب إضافة نمط سوى إدخال من سطر واحد في السجل:
- نثر مقتضب — احذف الحشو / أدوات التعريف / عبارات التحوّط؛ وأبقِ المضمون التقني دقيقًا.
- كود أقل — نهج "المطور الخبير الكسول" وفق YAGNI: أصغر تغيير فعّال، من دون هيكلة لم تُطلب.
- ذيل الحصان (المطور الخبير الكسول) — اصعد سُلّم YAGNI، وأصلح السبب الجذري، وبأصغر فرق فعّال.
- لديّ ADHD (الإجراء أولًا) — ابدأ بالإجراء التالي، ورقّم الخطوات، وقدّم خطوة تالية ملموسة واحدة، بلا مقدمة.
- الصينية الكلاسيكية المقتضبة (文言) — أسلوب صيني كلاسيكي فائق الإيجاز (مقيّد باللغة zh).
🎯 ميزانية سياق تكيّفية (القرص) — بدلًا من عتبة رموز واحدة للتشغيل/الإيقاف، صعّد استخدام المحركات الأقل تكلفة والأقل فقدًا فقط بالقدر اللازم لملاءمة نافذة سياق النموذج. السياسة: reserve-output (الافتراضية، والمراعية للنموذج) · percentage · absolute. الوضع: floor (ضمان الملاءمة) · replace-autotrigger (خيارك الصريح يتغلب) · off (العتبة القديمة).
🎛️ موضع اتخاذ قرار الضغط (الأسبقية، من الأعلى ← إلى الأدنى) — ترويسة x-omniroute-compression لكل طلب › تجاوز مجموعة التوجيه › الملف الشخصي المسمّى النشط › التكيّف / التشغيل التلقائي › الإعداد الافتراضي للوحة › إيقاف. تُعاد الخطة المطبقة في ترويسة الاستجابة X-OmniRoute-Compression: <mode>; source=<source>.

شغّل تلقائيًا وفق عتبة الرموز، أو فعّل القرص التكيّفي، أو ثبّت ملفًا شخصيًا مسمّى، أو اضبط إعدادًا لمرة واحدة لكل طلب، أو عيّن خط أنابيب لكل مجموعة توجيه — أيًّا كان الأنسب لعبء العمل. تقيس حزمة تقييم اختيارية وغير متصلة بالإنترنت (npm run eval:compression) مدى الحفاظ على الدقة مقابل التوفير باستخدام مجموعة بيانات مثبّتة قبل اعتماد أي تغيير.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

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

1) التثبيت والتشغيل

npm install -g omniroute
omniroute

💡 هل ترى تحذيرات npm warn ERESOLVE أو تبعيات النظراء؟ إنها غير ضارة.

لوحة التحكم على http://localhost:20128 · وواجهة API على http://localhost:20128/v1.

2) وصّل مزوّدًا مجانيًا (بلا تسجيل)

لوحة التحكم ← المزوّدون ← وصّل Kiro AI (Claude مجاني، نحو 50 رصيدًا شهريًا لكل حساب) أو OpenCode Free (بلا مصادقة) ← تم.

3) وجّه أداة البرمجة لديك

عنوان URL الأساسي: http://localhost:20128/v1
مفتاح API:  [انسخه من لوحة التحكم ← نقاط النهاية]
النموذج:    auto            (توجيه ذكي بلا إعداد — أو أي مزوّد/نموذج)

4) تحقّق من أنه يعمل

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

ينبغي أن ترى قائمة بالنماذج المتصلة لديك. 🎉 هذا كل شيء — ابدأ البرمجة، وسيتولى OmniRoute التوجيه التلقائي والانتقال الاحتياطي نيابةً عنك.

إذا تعذّر على عميلك إرسال ترويسات مخصصة، فإن OmniRoute يوفّر أيضًا أسماء توافق بديلة مضمّنًا فيها الرمز:

كتالوج OpenAI:     http://localhost:20128/vscode/YOUR_KEY/
نماذج OpenAI:      http://localhost:20128/vscode/YOUR_KEY/models
دردشة OpenAI:      http://localhost:20128/vscode/YOUR_KEY/chat/completions
استجابات OpenAI:   http://localhost:20128/vscode/YOUR_KEY/responses
دردشة Ollama:      http://localhost:20128/vscode/YOUR_KEY/api/chat
وسوم Ollama:       http://localhost:20128/vscode/YOUR_KEY/api/tags

استخدم هذه فقط للعملاء الذين لا يمكنهم إرفاق Authorization: Bearer .... وتظل المصادقة عبر الترويسة هي الوضع المفضّل.

📦 طرق تثبيت إضافية — Docker، والمصدر، وpnpm، وArch

🐳 Docker

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.تثبّت الصورة قيمة 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

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 في وقت التشغيل.

قناة Docker للإصدارات التجريبية: يتبع diegosouzapw/omniroute:next و diegosouzapw/omniroute:next-web فرع release/v* الافتراضي الحالي. هذه الوسوم القابلة للتغيير مخصصة فقط لاختبار الإصلاحات غير المنشورة، وهي غير مدعومة للاستخدام في بيئات الإنتاج. راجع قنوات إصدارات Docker.

🥟 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 .).

# التثبيت والتشغيل باستخدام Bun
bun install
bun run dev

🛠️ من المصدر

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# باستخدام رقائق Nix
nix develop
npm run dev

# أو باستخدام devbox
devbox run npm run dev

📖 دليل Docker — ملفات تعريف Compose، وCaddy HTTPS، وأنفاق Cloudflare.

🦭 Podman

# 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 واتبع إرشادات دليل البيانات الخاصة بالبنية.

📖 دليل Podman — عمليات بناء Compose، وPodman Machine، وإعداد Quadlet لنظام Linux/systemd.

⚡ تثبيت أسرع / أقل استهلاكًا للموارد (تخطي البناء الأصلي)

محرك SQLite الأصلي (better-sqlite3) هو تبعية اختيارية، ولذلك لا يتعطل التثبيت العام مطلقًا بسبب الترجمة من المصدر: إذ يستخدم ملفًا ثنائيًا مبنيًا مسبقًا عند توفر ملف متوافق مع منصتك/Node، وإلا فإنه يرجع بشفافية إلى محرك JavaScript خالص (node:sqlite على Node 22+، أو sql.js WASM المضمّن بخلاف ذلك) — دون الحاجة إلى أدوات بناء.

لتخطي التهيئة الأصلية اللاحقة للتثبيت بالكامل (في CI أو البيئات دون واجهة رسومية أو الأجهزة البطيئة):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # يؤدي CI=1 أيضًا إلى تخطيها

لأسرع عمليات تثبيت، يُفضّل استخدام pnpm (مخزن معنون بالمحتوى + روابط صلبة — راجع أعلاه). ولاستخدام بيئة تشغيل دون لوحة تحكم أو واجهة رسومية، استخدم ملف تعريف Docker المسمى base (أعلاه) أو دليل Termux. تُقدَّم واجهة سطر الأوامر ولوحة تحكم الويب بواسطة العملية نفسها عبر منفذ واحد، ولذلك لا توجد حاليًا حزمة منفصلة لواجهة سطر الأوامر فقط.

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

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

_{لقطة من لوحة المعلومات بتاريخ 2026-08-24 · الكتالوج الأولي: YT 809 | TT 137 | IG 124 · الحداثة (بالأيام): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 مشاهدة}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 مشاهدة}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 مشاهدة}

الترتيب الكامل (عناوين URL أساسية منزوعة التكرار، v > 0، أعلى وصول):

#1	#2	#3	#4	#5
nick_saraev — Instagram — 3,042,474	theopenstack — Instagram — 692,419	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 391,109	buildwithai.club — Instagram — 347,652

#6	#7	#8	#9	#10
nivedan.ai — Instagram — 331,973	vaibhavsisinty — Instagram — 263,744	Nick Automates — مقاطع YouTube القصيرة — 218,174	theroshankrishna — Instagram — 186,786	midudev — TikTok — 177,800

المقاييس الأساسية بتاريخ 2026-08-24: 1.029 فيديو فريد · 11.132.922 مشاهدة معروفة (v > 0) · 639 قناة/ملفًا شخصيًا عبر المنصات. تحتوي لوحة المعلومات الأولية على 1.070 صفًا؛ جرت تسوية 41 نسخة مكررة من Instagram باستخدام عنوان URL الأساسي، مع الاحتفاظ بأعلى عدد مشاهدات لكل فيديو.

🎬 هل أنشأت فيديو عن OmniRoute؟ افتح مشكلة أو نقاشًا وأرفق الرابط — وسنعرضه هنا.

📧 المجتمع والمساعدة

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

القناة	أين / كيف
💼 LinkedIn — تابع المشرف على الصيانة	linkedin.com/in/diegosouzapw
🐙 GitHub — تابعنا للإصدارات والنصائح	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 عالمي	انضم إلى المجموعة
🟢 WhatsApp — 🇧🇷 البرازيل	انضم إلى المجموعة
🌍 الموقع الإلكتروني	omniroute.online
🌍 🌍مجتمع StHub OmniRoute (مجاني)	بوابة StHub
📦 الشيفرة المصدرية	github.com/diegosouzapw/OmniRoute
🐛 الإبلاغ عن خطأ	افتح مشكلة — أرفق مخرجات `npm run system-info`
🤝 المساهمة	CONTRIBUTING.md · نموذج التفريع والإصدار · اختر `good first issue`
💚 دعم المشروع	طرق الدعم ↑ · رعاة GitHub

🛠️ المكدس التقني

الطبقة	التقنية
بيئة التشغيل	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 قديم) — 122 وحدة نطاق، و190 عملية ترحيل
الذاكرة	بحث نصي كامل باستخدام 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 — انتحال بصمة TLS من نوع JA3 / JA4، ووكيل بثلاثة مستويات
المرونة	قاطع دائرة، وتراجع أُسّي، ومنع التدافع الجماعي، وإصلاح ذاتي تلقائي للتركيبات
التسجيل	pino — سجلات JSON مهيكلة مع سياق الطلب
الاختبار	مشغّل اختبارات Node.js + Vitest — أكثر من 39,000 تعريف اختبار ثابت عبر أكثر من 5,100 ملف اختبار متتبَّع (اختبارات الوحدة، والتكامل، والشاملة 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، وCaddy HTTPS، والأنفاق، ووسوم الصور
دليل Podman	تكامل Quadlet مع systemd، وpodman-compose، وSELinux
نشر الآلات الافتراضية	دليل كامل: إعداد VM + nginx + Cloudflare
النشر على Fly.io	النشر على Fly.io باستخدام تخزين دائم
دليل Termux	تشغيل OmniRoute على Android عبر Termux
دليل PWA	تثبيت تطبيق الويب التقدمي، والتخزين المؤقت، والبنية
دليل إلغاء التثبيت	إزالة نظيفة لجميع طرق التثبيت
إعداد البيئة	متغيرات `.env` الكاملة ومراجعها

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

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

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

⭐ أبرز المساهمين

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

المساهمون الخارجيون حسب طلبات السحب المدمجة

الترتيب	المساهم	طلبات السحب المدمجة	~الأسطر المتغيرة
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{جُمِّدت البيانات عند أحدث نقطة من release/v3.8.50 وهي dafb4ae808، مع عمليات دمج حتى 2026-08-24 05:26:03 UTC. يتضمن إحصاء GitHub GraphQL المقسّم إلى صفحات 5,911 طلب سحب مدمجًا: 2,707 بواسطة مالك المستودع، و179 بواسطة Dependabot، و3,025 طلب سحب خارجيًا من 535 مساهمًا مختلفًا. تشير «الأسطر المتغيرة» إلى إضافات GitHub وعمليات الحذف فيه، وتشمل الملفات المُنشأة، وملفات القفل، والكتالوجات، والترجمات، والوثائق؛ وهي مقياس لحجم التغييرات وليست عدد أسطر الشفرة المؤلَّفة. تُحتفَظ بالمراتب المتعادلة عند حد الإدراج.}

الإيداعات المنسوبة عبر GitHub

backryun _{🥇 220 إيداعًا منسوبًا إلى GitHub}	Paijo _{🥈 219 إيداعًا منسوبًا إلى GitHub}	Randi _{🥉 108 إيداعات منسوبة إلى GitHub}	Ravi Tharuma _{🏅 81 إيداعًا منسوبًا إلى GitHub}	Chris _{🏅 70 إيداعًا منسوبًا إلى GitHub}	Markus Hartung _{🏅 69 إيداعًا منسوبًا إلى GitHub · متعادل في المركز السادس}
Dizzle _{🏅 69 إيداعًا منسوبًا إلى GitHub · متعادل في المركز السادس}	Jan Leon _{🏅 64 إيداعًا منسوبًا إلى GitHub}	zenobit _{🏅 62 إيداعًا منسوبًا إلى GitHub}	Bob.Hou _{🏅 51 إيداعًا منسوبًا إلى GitHub · متعادل في المركز العاشر}	Xiangzhe _{🏅 51 إيداعًا منسوبًا إلى GitHub · متعادل في المركز العاشر}

_{أُعيد التحقق في 2026-08-24 06:14:31 UTC: الإيداعات المنسوبة إلى GitHub كما أبلغت عنها واجهة Contributors API الخاصة بالمستودع للفرع الافتراضي release/v3.8.50. أعادت واجهة API عدد 525 هوية (415 مستخدمًا، وبوتين، و108 هويات مجهولة)؛ يستبعد هذا الجدول المشرف والبوتات والهويات المجهولة، ويحتفظ بحالات التعادل في الترتيب. وهو يختلف عن كل من ترتيب طلبات السحب المدمجة أعلاه وإحصاء بيانات Git الوصفية الذي يشمل 639 شخصًا أدناه.}

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

💖 الرعاة

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

Andrew
_{💛 راعٍ شهري نشط}

Vlad I
_{💛 راعٍ شهري نشط}

Paco Cartones
_{💛 راعٍ نشط لمرة واحدة}

Prof. Igor Morais
_{💛 داعم سابق لمرة واحدة}

longtao
_{💛 داعم سابق لمرة واحدة}

_{… وآخرون يفضّلون الحفاظ على خصوصيتهم 💛}

_{أُعيد التحقق من رعاة GitHub العلنيين في 2026-08-24. تحدد حالة activeOnly في GitHub التسميات النشطة أعلاه؛ ويظل الداعمون العلنيون لمرة واحدة الذين أُعلن عنهم سابقًا موضع شكر، بينما يظل الرعاة الخاصون مجهولي الهوية.}

💖 كن راعيًا ← — كل دولار يُبقي OmniRoute مجانيًا ومستقلًا.

👥 أكثر من 600 مساهم

_{أُجري التدقيق في 2026-08-24 عند الأساس المجمّد ac02c5b42f، ثم أُعيد التحقق عند رأس release/v3.8.50 المباشر dafb4ae808: 639 هوية Git بشرية بعد التطبيع — يظهر 407 منهم كمؤلفي التزامات (بمن فيهم المشرف على الصيانة)، بينما يظهر 232 منهم فقط في تذييلات Co-authored-by الصريحة. يطبّع الإحصاء معرّفات GitHub من نوع noreply، ويستبعد 26 هوية لروبوتات/وكلاء/خدمات/عناصر نائبة، ولا يدمج عناوين البريد الإلكتروني العادية لمجرد تطابق أسماء العرض الخاصة بها.}

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

أنشئ نسخة متفرعة من المستودع
أنشئ فرعًا من رأس release/vX.Y.Z النشط (وليس main) — راجع نموذج التفريع والإصدار
أنشئ فرع ميزتك (git checkout -b feat/amazing-feature)
ثبّت تغييراتك (git commit -m 'feat: add amazing feature')
ادفع التغييرات إلى الفرع (git push origin feat/amazing-feature)
افتح طلب سحب مع تعيين الأساس = فرع release/vX.Y.Z ذاك

راجع CONTRIBUTING.md للاطلاع على الإرشادات التفصيلية.

إصدار نسخة جديدة

# أنشئ إصدارًا — تتم عملية npm publish تلقائيًا
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 النجوم

🌍 مخطط النجوم

🙏 شكر وتقدير

يقف OmniRoute على أكتاف عمالقة. بدأ كتفرع من 9router وكنسخة منقولة إلى TypeScript من مشروع Go المسمى CLIProxyAPI — ومنذ ذلك الحين، استُلهم كل نظام فرعي أدناه من مشروع مفتوح المصدر سبقه إلى ذلك. وقد أسهم كل واحد منها في تشكيل جزء ملموس من OmniRoute. وهذه طريقتنا لشكرهم جميعًا. 🙏

⭐ تم التحقق من أعداد النجوم عبر واجهة GitHub REST API في 24 أغسطس 2026 — فامنحوا هذه المشاريع نجمة. تمثل الأعداد لقطة مؤرخة ودقيقة، ومن الطبيعي أن تتغير.

🧬 الأصل والبوابة

المشروع	⭐	كيف ألهم OmniRoute
9router	26,161	المشروع الأصلي الذي بُنيت عليه هذه النسخة المتفرعة — وقد وُسّع هنا ليشمل واجهات API متعددة الوسائط، مع إعادة كتابة كاملة باستخدام TypeScript.
CLIProxyAPI	48,497	تنفيذ Go الذي ألهم هذا النقل إلى JavaScript / TypeScript.
LiteLLM	57,100	بوابة الذكاء الاصطناعي التي تغذي مجموعة بيانات التسعير العامة الخاصة بها مزامنة تتبّع التكلفة لدينا، والتي ساعد نموذجها لتوحيد مزوّدي الخدمة في تشكيل آلية التوجيه لدينا.
codex-chatgpt-web	1,410	مصدر مرخّص بموجب MIT جرى تكييفه ضمن جسر ChatGPT Web → Codex Responses المضمّن، بما في ذلك محوّلات جلسة المتصفح، وتأطير الاستجابات، والاستخدام، والبحث على الويب.
free-claude-code	48,112	أنماط نُقلت إلى استعادة التدفق، والأسماء البديلة دون تفكير، والبحث الاحتياطي على الويب، وحدود النافذة المنزلقة، وتنقيح السجلات، ومسارات التشغيل المحصّنة.
composer-api	322	أنماط اختيار الأدوات وقيود المخرجات واعتماد الأدوات في Cursor Composer، وقد جرى تكييفها ضمن منفّذ Cursor الأصلي.
codex-multi-auth	457	أنماط تسجيل الدخول الجديد وتدوير رموز التحديث، وقد نُقلت إلى إعادة مصادقة Codex OAuth.
opencode-anthropic-auth	510	إعدادات التحويل الافتراضية المتوافقة مع Claude Code وسلوك ترويسة الفوترة، وقد جرى تعميمهما ضمن جسر OmniRoute المعتمد على الإعدادات.
grok2api-merged	2	جرى تكييف تعيينات نماذج Grok، ومولّد Statsig ذي TypeError الزائف، والإعدادات الافتراضية للطلبات والأجهزة، ومعالج استجابات NDJSON الخاص به تكييفًا جوهريًا ضمن منفّذ Grok Web في OmniRoute.
TQZHR/grok2api	705	مصدر الشفرة غير المباشر الرئيسي وراء grok2api-merged؛ إذ جرى الحفاظ على تطبيقاته الخاصة بالنماذج والترويسات والحمولات وStatsig والمعالج ضمن سلسلة نسب Grok Web.
chenyme/grok2api	7,520	المصدر الأساسي المرخّص بموجب MIT للإعدادات الافتراضية لحمولة Grok والجهاز، ومولّد Statsig، ومعالج `result.response` المنقول عبر TQZHR وgrok2api-merged.
grok2api-pro	27	مصدر غير مباشر ينسب إليه grok2api-merged الفضل في طبقة مجمّع الوكلاء الخاصة به؛ ويحافظ OmniRoute على إشعار النسب هذا، لكنه لا يدّعي نقل مجمّع وكلاء إلى منفّذ Grok Web محدود النطاق الخاص به.
GrokProxy	50	أسهم وكيل Grok الموثّق بملفات تعريف الارتباط ونمط تدفق `result.response.token`
GrokBridge	5	استند تنفيذ Grok Web الأصلي إلى تصميمه للجهة العليا عبر HTTP/المتصفح؛ ونظرًا إلى أن مسار HTTP المباشر الخاص به مشتق من GrokProxy، فلا يُدّعى إجراء نقل مستقل للشفرة.
grok-web-api	14	أسهمت مخططات Rust الخاصة بـ `ChatOptions` وأغلفة الاستجابة في تشكيل أنواع طلبات Grok واستجابات التدفق في TypeScript لدى OmniRoute.

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

المشروع	⭐	كيف ألهم OmniRoute
Caveman	100,538	المشروع واسع الانتشار القائم على فكرة «لماذا تستخدم رموزًا كثيرة حين تفي رموز قليلة بالغرض» — تُشغّل فلسفته القائمة على كلام رجل الكهف وضع الضغط القياسي لدينا وأكثر من 30 قاعدة لإزالة الحشو والتكثيف.
RTK – Rust Token Killer	77,185	ضغط عالي الأداء لمخرجات الأوامر — ألهم محرك RTK لدينا، ولغة JSON filter DSL، واستعادة المخرجات الخام، وخط المعالجة المتراكم RTK → Caveman.
headroom	67,310	ضغط سياق قابل للعكس (SmartCrusher) — ألهم محرك `headroom` لدينا ونمط علامة الاسترجاع `ccr`.
LLMLingua	6,598	أبحاث ضغط المطالبات (LLMLingua / LLMLingua-2) — ألهمت محرك `llmlingua` غير المتزامن لدينا، والآمن للتعليمات البرمجية، والذي يواصل العمل دون ضغط عند الفشل.
llmlingua-2-js	31	منفذ JS/ONNX ‏(MobileBERT / XLM-RoBERTa) المستخدم بوصفه الواجهة الخلفية لخيط العامل في محرك LLMLingua لدينا.
Troglodita	40	ضغط الرموز للبرتغالية البرازيلية — يشغّل حزمة اللغة pt-BR لدينا: تقليل الحشو البلاغي وإزالة الكلمات الزائدة، مع ضبطهما ليناسبا قواعد البرتغالية البرازيلية.
ponytail	108,957	مهارة البرمجة واسعة الانتشار القائمة على مبدأ YAGNI لـ«المطوّر الخبير الكسول» — ألهمت نمط المخرجات less-code لدينا: توجيه نحو أصغر تغيير ناجح يقلّص التعليمات البرمجية _المولَّدة_ (النظير على محور المخرجات لنثر Caveman المقتضب).
i-have-adhd	23,526	عُدّل أسلوب استجابته الذي يقدّم الإجراءات أولًا ويراعي المصابين باضطراب فرط الحركة وتشتت الانتباه ليصبح نمط المخرجات الموجز في OmniRoute عبر خمس لغات.

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

المشروع	⭐	كيف ألهم OmniRoute
TOON	25,233	ترميز الكائنات الموجّه نحو الرموز — شكّل نموذجه الجدولي القائم على ترويسة تتبعها صفوف مرحلة الضغط الجدولي لدينا.
GCF – Graph Compact Format	41	أسهم تنسيق الرسوم البيانية المدمج وتصميم الملف التعريفي العام لديه في صياغة الضغط الجدولي وتنسيق برنامج ترميز Headroom في OmniRoute.
gcf-typescript	4	تنفيذ TypeScript بترخيص MIT، دُمج مباشرةً في المشروع ووُسّع ليصبح برنامج ترميز الملف التعريفي العام لـHeadroom.
token-optimizer-mcp	494	ذاكرة تخزين مؤقت باستخدام Brotli/SQLite مع فروق السياق لكل جلسة — ألهمت محرك `session-dedup` لدينا.
token-savior	1,122	ضغط مخرجات Bash مع ملفات MCP التعريفية — ألهم منهجنا المنضبط للعدول عن الضغط وتقليص بيان أدوات MCP.
token-saver	138	ضغط للمخرجات حسب نوع الملف، يراعي المحتوى ويعدِل عن الضغط عند الفشل — أثبت صحة التوجيه حسب النوع لدينا وتخطّي الضغط عند عدم بلوغ الحد الأدنى للمكسب.
token-optimizer	1,951	«اعثر على الرموز الشبحية» — أسهم نمطه القائم على نقل المحتوى خارج السياق واستخدام مقابض قابلة للاسترجاع في صياغة نهجنا تجاه نقل CCR للمحتوى خارج السياق.
TokenMizer	28	مخطط قائم على رسم بياني للجلسة مع إزالة تكرار الأسطر عبر الأدوار، أسهم في صياغة تصميم session-dedup لدينا.
OmniCompress	3	JSON عمودي بلغة Rust، مع استرجاع معنْوَن بالمحتوى وإزالة للتكرار عبر الرسائل — أثبت صحة تصميم محركات `headroom`/`ccr`/`session-dedup` لدينا، وثابت استقرار ذاكرة التخزين المؤقت «الصيغة المضغوطة مستقلة عن الموضع».
mcp-compressor	113	ضغط مخططات أدوات MCP وأوصافها — أسهم في صياغة تقليل عدد عناصر بيان أدوات MCP لدينا.
RepoMapper	197	ترتيب خرائط المستودعات بأسلوب Aider — أسهم في صياغة استكشافنا لخرائط المستودعات وترتيب الاسترجاع.
quiet-shell-mcp	4	تقليل تصريحي لمخرجات shell عبر MCP — أثبت صحة الضغط التصريحي لمخرجات bash لدينا.
ts-morph	6,162	مجموعة أدوات TypeScript Compiler API — ألهمت إزالة التعليقات المعتمدة على المحلّل لدينا، والتي تحافظ على القيم الحرفية للسلاسل والقوالب والتعبيرات النمطية.

🧠 الذاكرة وRAG

المشروع	⭐	كيف ألهم OmniRoute
Mem0	63,902	طبقة ذاكرة عامة — شكّل نموذجها الذي يستخدم الوكيل كحدٍّ لعمليات الكتابة/القراءة بنية الذاكرة لدينا.
Letta (MemGPT)	24,382	وكلاء ذوو حالة مع ذاكرة متعددة المستويات — ألهمت نموذجنا متعدد المستويات للتحكم في السياق واستعادته (CCR).
WFGY	1,781	تصنيف ProblemMap المكوّن من 16 نمطًا متكررًا لفشل RAG/LLM — وهو المفردات المشتركة في دليل استكشاف الأخطاء وإصلاحها لدينا.

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

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

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

المشروع	⭐	كيف ألهم OmniRoute
models.dev	6,555	قاعدة بيانات مفتوحة لمواصفات نماذج الذكاء الاصطناعي وأسعارها وإمكاناتها — تُزامَن أصليًا مع كتالوج النماذج لدينا.
React Flow / xyflow	38,108	مكتبة الرسوم البيانية القائمة على العُقد التي تشغّل Compression Studio وCombo/Routing Studio في الوقت الفعلي.
LangGraph	40,314	ألهم التصور المرئي المباشر للرسم البياني لسير العمل في LangGraph Studio عرض التسلسل المتتابع في الوقت الفعلي ضمن Studios لدينا.
Langfuse	33,592	شكّل نموذج الرصد الخاص به، التتبّع → النطاق → التوليد، العرض المتدرج في Compression Studio لدينا.
Kiali	3,631	قابلية رصد شبكة خدمات Istio — ألهمت شارات قواطع الدائرة والعناصر المرئية لحواف الأخطاء في Routing/Combo Studio.
lobe-icons	2,428	شعارات العلامات التجارية للذكاء الاصطناعي/LLM التي تعرض أيقونات المزوّدين عبر لوحة المعلومات لدينا.
flag-icons	12,354	يوفّر أعلام SVG المرخّصة بموجب MIT والمستخدمة في محدد اللغة بملف README.

🛡️ الأمان

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

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

المشروع	⭐	كيف ألهم OmniRoute
ClawRouter	6,564	ألهم إزالة تكرار الطلبات، والرجوع الاحتياطي الطارئ من دون تكلفة، واستراتيجيات Auto-Combo القابلة للتوصيل، وتصنيف النيات متعدد اللغات.
Antigravity-Manager	30,652	أسهمت إعادة تعيين النماذج مع مراعاة الحساب، والتحقق من مسار الملف التنفيذي، وسلوك تسميات الخطط لديه في تشكيل بيئة تشغيل Antigravity في OmniRoute.
vscode-antigravity-cockpit	4,817	ألهم تنسيق العد التنازلي الموجز لإعادة تعيين الحصة لديه عرض حدود المزوّد المقابل في OmniRoute.
AionUi	32,230	ألهمت تكاملات ACP الخاصة به الاكتشاف التلقائي لوكلاء CLI المثبّتين في OmniRoute.
CodexBar	20,507	حدّد واجهة حصة Grok Build؛ ثم تحقّق OmniRoute بصورة مستقلة من تنسيق البيانات الفعلي وصحّحه.

📄 الترخيص

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

⬆ العودة إلى الأعلى · صُنع بكل ❤️ لمجتمع الذكاء الاصطناعي مفتوح المصدر.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · ترخيص MIT · omniroute.online}

FilesExpand file tree

README.md

Latest commit

History