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

💰 نحو 1.62 مليار توكن شهريًا عبر المستويات المجانية التابعة لجهات خارجية

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

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

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

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

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

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

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

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

📈 البوابة تستمر في النمو

	v3.8.50	v3.8.51	`v3.8.53+`
🌐	352	358	380
🧠 نموذج الدردشة الفريد IDs	1320	1374	1475
🖼️ طريقة الجسر	🆕 الرؤية + الصوت + الفيديو	✓	✓
كتالوج 📡 الرادار المجاني	🆕 التقيد في	✓	✓
⚖️ جدولة الحصة النسبية	🆕 حصة الحصص	✓	✓
📊 قياس الحصص عن بعد	🆕 لايف	✓	✓
وضع 🧰 مقطوعة الرأس	—	—	🆕 `serve --headless`
🛤️ LTS السكك الحديدية الأشعة تحت الحمراء	—	—	قنوات الافراج عن 🆕
🔎 اكتشاف النموذج API	—	—	🆕 `/v1/models/query`

خارطة طريق→ - ركوب السكة الحديدية إلى v3.9.0 LTS

🧩 متاح

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

🌐 متاح بـ 67 لغة

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

# بعد ربط مزوّد، انسخ مفتاح 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، مستبعَدون من التوجيه التلقائي افتراضيًا؛ وربط حساب لا يتجاوز هذا الإعداد. راجع دليل المستويات المجانية قبل اختيار مزوّد.}

_{📦 سكربتات بدء سريع جاهزة للنسخ واللصق لـ Python وNode.js وPHP وcURL → 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

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/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.}

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

_{📖 محرك Auto-Combo · دليل المرونة}

🏆 ما الذي يميّز 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.53. السجل الكامل في CHANGELOG.md.

⚖️ توجيه quota-weighted — استراتيجية التجميع العشرون تتجاوز الحسابات المستنفدة، ثم توزّع الطلبات على البقية بنسبة الحصة المتبقية ÷ الحمل الجاري، مع إبقاء المحادثات القائمة مثبّتة. → Auto-Combo
🧰 الوضع بلا واجهة (Headless) — يشغّل omniroute serve --headless (أو OMNIROUTE_HEADLESS=1) محرك البروكسي /v1/* فقط، مع إيقاف لوحة التحكم والأنظمة الفرعية الخاصة بها. → Headless Mode
🔎 اكتشاف النماذج — يوفّر /v1/models تصفية حسب القدرات وسياق الطلب والنوع والنص، ويعيد POST /v1/models/query قائمة مختصرة قصيرة حتمية بنفس نطاق الرؤية لكل مفتاح. → API Reference
🔑 تحكم بالتوجيه لكل مفتاح — ثبّت مفتاح API على نموذج أو تجميعة واحدة عبر forcedModel، وأضف أو أزل نماذج المفتاح وتجميعاته بشكل ذرّي (/api/keys/{id}/access). → API Reference
🛡️ تحكم أدق في بيانات PII — اختيار حسب النوع، وحتى 15 نمطًا مخصصًا موثّقًا، واكتشاف حسب النوع، بينما يبقى التمويه نفسه. → Guardrails
🌍 67 لغة في قائمة الانتظار، ومرايا للتوثيق وCLI، مع npm run i18n:add-locale لإضافة لغة بأمر واحد. → i18n Guide
🎛️ OmniConductor — لوحة تحكم موحّدة لتفويض المهام إلى وكيلك، ومهارات Connector على الوكيل، ولوحة استدعاء human2agent مع محادثة صوتية بنمط اضغط-لتتحدث. → A2A Server
🛂 قبول تكيفي + حماية من الحمل الزائد — الطلبات الثقيلة في طريقها إلى 503، مع حدود RPM ذرّية لكل اتصال. → Resilience Guide
🗂️ ترتيب /v1/models القانوني — كتلة واحدة متجاورة مجمّعة حسب المزوّد لكل مزوّد (مع تثبيت النماذج)، مستقرة عبر كل مصادر الكتالوج. → API Reference
🗜️ تقوية الضغط — حماية من التضخّم مفعّلة افتراضيًا، وحزم Caveman للألمانية / الفرنسية / اليابانية + الصينية الكلاسيكية، ومرشّحات RTK لـ Gradle و.NET. → Compression
💸 تكلفة ثابتة صادقة — مزوّدو الاشتراكات / خطط البرمجة يظهرون $0 في تحليلات التكلفة؛ بينما تستمر الميزانية والحصة والتوجيه في التقدير. → API Reference
⚖️ توجيه Quota-Share — وزّع حصة حساب مشترك بعدالة على المفاتيح المجمّعة، بطريقة محافظة على العمل بحيث تُعار الشرائح الخاملة. → Resilience Guide
🤖 إعداد CLI/الوكيل بأمر واحد — 15 أمر setup-* مسجّلًا؛ ويشغّل omniroute run سبع واجهات CLI (Claude Code، Codex، Aider، Goose، OpenCode، Qwen Code، Gemini CLI)؛ ويدعم omniroute configure 11 هدفًا مع منتقي مزوّد+نموذج تفاعلي ومفضّلات لكل سياق. → CLI Integrations
🛰️ الوضع البعيد — قُد OmniRoute عن بُعد باستخدام رموز محدودة النطاق (connect / contexts / tokens) + مساعد OAuth باسم antigravity لتنصيبات VPS. → Remote Mode
🧭 توجيه تلقائي أذكى — تجميعات auto/<category>:<tier>، وFusion (لوحة نماذج + حَكَم)، وتوجيه واعٍ بالمهمة، وتجاوزات لكل طلب للنموذج / الوضع / ميزانية الدولار. → Auto-Combo
🗜️ ضغط قابل للتوصيل — 12 محركًا قابلًا للتركيب + Compression Studios: LLMLingua-2، وUltra ثنائي المستوى، وomniglyph، وبوابة دقة لكل خطوة، وGCF v3.2، ومحرّر بالسحب وإعادة الترتيب. → Compression
🕵️ فك تشفير MITM شفاف (TPROXY) — التقط واجهات CLI التي تتجاهل متغيرات بيئة البروكسي، مع شهادة CA لكل SNI + مثبّت مخزن الثقة. → MITM/TPROXY
💸 قياس التكلفة في كل مكان — ترويسات التكلفة/الاستخدام X-OmniRoute-* على كل نقطة نهاية، وترويسة التوفير عند إصابة الذاكرة المؤقتة (cache-HIT)، وحصص إنفاق بالدولار لكل مفتاح. → API Reference
🧠 ذاكرة تحت سيطرتك — معطّلة افتراضيًا، وتكميم متجهات int8 اختياري + تحليل بالانحدار حسب النوع، وx-omniroute-no-memory لكل طلب. → Memory
🛡️ الأمان — حارس ضد حقن التعليمات (prompt-injection) على كل مسار LLM (مجموعة اختبارات الفريق الأحمر)، وحماية اختيارية لإخفاء بيانات الاعتماد (تحجب مفاتيح API والأسرار المسرّبة في الاتجاهين)، وبحث ويب مجاني عبر DuckDuckGo كخيار أخير، وبوابة تسجيل دخول OIDC اختيارية للوحة التحكم (يبقى تسجيل الدخول بكلمة المرور متاحًا دائمًا). → Guardrails
🖼️ نقاط نهاية جديدة — تُكمل /v1/ocr (Mistral OCR) و/v1/audio/translations (بنمط Whisper) واجهة الوسائط. → API Reference
🎨 توليد الصور / الفيديو / الصوت — واجهة API واحدة للوسائط: فيديو xAI Grok Imagine وNovita AI، وComfyUI، وMagnific، وAdobe Firefly، وSegmind، ومزوّدو الكلام مثل ElevenLabs. → API Reference
🌍 النشر والتشغيل — basePath في البروكسي العكسي، والكشف التلقائي للغة المتصفح، وتتبّع الأجهزة لكل مفتاح، وثقة MITM بدون جذر، وتعريب zh-TW. → Environment
🤝 المزيد من المزوّدين والوكلاء — وكلاء سحابيون (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… وكتالوج محدّث يضم 380 مزوّدًا. → Providers
📡 شفافية التوجيه — كل استجابة تحمل ترويسة 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 APIs المتوافقة مع OpenAI، وذاكرة تخزين مؤقت دلالية للاستجابات، والتلعيب مع لوحات الصدارة، واكتشاف وكلاء ACP (15 وكيلًا مدمجًا)، وتصدير السجلات المجدول إلى BigQuery، وauto/chaos للتوزيع المتوازي متعدد النماذج، وجسر بوت Telegram، ومدير إصدارات داخل التطبيق، وتصنيفات المزوّدين المجانيين LMArena-ELO. → المستندات

🤖 متوافق مع CLIs ووكلاء الترميز

تكوين واحد - http://localhost:20128/v1 - و** كل** يعمل AI IDE أو CLI على نماذج مجانية ومنخفضة التكلفة.

_{Claude كود}	_{Codex CLI}	_Cline	_{رمز الكيلو}	_{رمز حديقة الحيوان}	_متابعة
_ايدر	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{مصنع الروبوت}	_{Copilot CLI}	_{Cursor CLI}	_صهر		_{Grok بناء}
_{وكيل هيرميس}	_OpenClaw	_أوزة	_{مترجم مفتوح}	_{Warp AI}	_deyin.ai

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

إعداد _{📖 لكل أداة لجميع الأدوات الـ 38 (27 CLI Code's + 11 CLI Agents) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode plugin → @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 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"

# Or pick provider+model interactively and write the tool's own config:
omniroute configure codex          # also: claude opencode qwen aider goose gemini cline continue kilo 5dive

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

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

380 مزوّدًا مسجّلًا عبر مجموعات الدردشة والوسائط والبحث والمزوّدين المحليين ووكلاء السحابة والنظام الأساسية، منها 153 تحمل بيانات تعريف الاكتشاف hasFree: true. يغطي سجل نماذج الدردشة 239 مزوّدًا / 3,059 زوجًا مميزًا من المزوّد والنموذج / 1,475 معرّف نموذج خامًا؛ ويضم كتالوج الميزانية المجانية المنفصل 471 صفًا خاصًا بالنماذج، و34 مجموعة موارد متجددة، و52 مزوّدًا مجانيًا إلى الأبد بموارد متجددة/من دون مفتاح. صُممت هذه المقامات لتكون مختلفة؛ وتوجد التعريفات والحسابات بعد إزالة التكرار بين مجموعات الموارد في مرجع المزوّدين والباقات المجانية.

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

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

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

🆓 مجاني إلى الأبد — $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

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

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

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

Docker_{📖 zqc · سطح المكتب · علبة شريط القائمة · Termux · PWA · OpenCode}

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

لا يوجد شريط جانبي جديد، ولا توجد دردشة جديدة UI - كل نموذج يقدمه OmniRoute يظهر مباشرة في** منتقي نماذج الدردشة Copilot الذي تستخدمه بالفعل** . منذ كود VS 1.122، تعمل نماذج الموفر بدون تسجيل دخول GitHub أو اشتراك Copilot - وضع الوكيل واستدعاء الأدوات والرؤية مجانًا.

تثبيت** OmniCopilot** الامتداد، قم بتوجيهه إلى خادم OmniRoute (الافتراضي هو localhost:20128)، ثم افتح Copilot Chat → model Picker →** إدارة النماذج...** →OmniRoute .

متجر < td align ="left">VS Code — مستقر & Insiders < td محاذاة ="left">Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro...

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

من داخل المحرر: افتح ملف** ملحقات** عرض، بحث** "OmniRoute"** ، انقر** ثَبَّتَ** - يعمل بنفس الطريقة في كلا المتجرين. المصدر والقضايا ودليل النشر مباشر على diegosouzapw/OmniCopilot.

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

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

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

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

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

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                         # ← يُنفَّذ على الخادم البعيد
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 — مع التنقل عبر واجهة المستوى الأعلى المكوّنة من 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`	التحكم في مثيل بعيد باستخدام رموز وصول محددة النطاق

# منح 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 (⭐ 90K+) وLLMLingua-2 و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:

قبل (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: <mode>; source=<source>.

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

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

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

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

npm install -g omniroute
omniroute

💡 هل ترى npm warn ERESOLVE أو تحذيرات peer-dep؟ إنها غير ضارّة. هل تستخدم npm 11 أو أحدث؟ قد تمنع npm سكربتات دورة حياة الحزم ما لم يُسمح بها. إن postinstall الخاص بـ OmniRoute (node scripts/build/postinstall.mjs) مطلوب لتحضير ملفات بيئة التشغيل الأصلية. اسمح بالحزم المذكورة في تحذير npm عند التثبيت العام. بالنسبة لمجموعة الحزم التي أبلغ عنها OmniRoute 3.8.53:
npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
لإعادة استخدام قائمة السماح هذه في عمليات التثبيت العام المستقبلية، اضبطها مرة واحدة ثم ثبّت بشكل عادي:
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 قبل إجراء أول طلب لمزوّد ويب.

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

2) اربط مزوّدًا مؤهلًا باستخدام حسابك الخاص

لوحة التحكّم ← Providers ← اختر مزوّدًا تناسبه شروطه وحصته الحالية مع حالتك ← أضف مفتاح API الخاص به أو أكمل تدفّق حسابه. قد تتطلّب الطبقات المجانية التسجيل أو الموافقة أو وسيلة دفع. راجع دليل الطبقات المجانية؛ توفّر الوصول بدون مفتاح غير مضمون، والمزوّدون المعلَّمون بـ tos: avoid مستبعَدون من auto افتراضيًا.

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

Base URL: http://localhost:20128/v1
API Key:  [copy from Dashboard → Endpoints]
Model:    auto            (routes among eligible connections — or choose provider/model)

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

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

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

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

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

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-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 — 3,042,474	nnapier7 — Instagram — 1,454,535	Amidia AI & Tech — YouTube — 794,974	theopenstack — Instagram — 692,419	migue.baena — TikTok — 685,788

#6	#7	#8	#9	#10
milesreevesai — TikTok — 620,400	nikothetech — TikTok — 610,803	Vaibhav Sisinty — YouTube — 509,281	buildwithai.club — Instagram — 347,652	nivedan.ai — Instagram — 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؟ افتح مشكلة أو نقاشًا وأرفق الرابط — وسنعرضه هنا.

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

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

القناة	أين / كيف
💼 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 — ‏100% TypeScript عبر `src/` و`open-sse/` (صفر `any` في النواة منذ v2.0)
إطار العمل	Next.js 16 + React 19 + Tailwind CSS 4
قاعدة البيانات	better-sqlite3 (SQLite، تدوين WAL) + LowDB (JSON قديم) — 147 وحدة نطاق، 219 ترحيلات
الذاكرة	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

📖 التوثيق

📘 البدء

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

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

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

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

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

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

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

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

المستند	الوصف
المساهمة	إعداد بيئة التطوير وإرشاداتها
نموذج التفريع والإصدار	الفروع التي تستهدفها طلبات السحب (`release/*`)، وما الذي يعنيه `main` والوسوم
سجل التغييرات	السجل الكامل للإصدارات بحسب كل إصدار
سياسة الأمان	الإبلاغ عن الثغرات والممارسات الأمنية
دليل التدويل	دعم 67 لغة، وسير عمل الترجمة، والكتابة من اليمين إلى اليسار
قائمة التحقق الخاصة بالإصدار	خطوات التحقق قبل الإصدار
خطة التغطية	استراتيجية تغطية الاختبارات لأكثر من 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، ويشمل الملفات المُنشأة، وملفات القفل، والكتالوجات، والترجمات، والوثائق؛ وهو مقياس لحجم التغييرات، وليس لأسطر الشيفرة التي ألّفها المساهم. تُظهر فروقات GitHub في 49 طلب سحب أكثر من 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. أعادت API عدد 849 هوية (429 مستخدمًا، وروبوتان، و418 هوية مجهولة)؛ يستبعد هذا الجدول المشرف والروبوتات والهويات المجهولة، ويُبقي على حالات التعادل في الترتيب. وهو يختلف عن كلٍ من ترتيب طلبات PR المدمجة أعلاه وإحصاء بيانات 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 مساهم

_{أُجري التدقيق في 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، لذا ترجع الزيادة إلى مساهمين جدد، وليس إلى منهجية أكثر تساهلًا.}

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

أنشئ نسخة متفرعة من المستودع
أنشئ فرعًا انطلاقًا من أحدث نقطة نشطة في 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 في 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 للتفاصيل.

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

_{OmniRoute v3.8.53 · Node ≥22.22.2 · رخصة MIT · omniroute.online}

FilesExpand file tree

README.md

Latest commit

History