mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-07-26 09:52:11 +03:00

Files

diegosouzapw d3ace8d611 fix: security hardening, tests, docs for Electron desktop & memory optimization

## Security Fixes
- Sanitize OMNIROUTE_MEMORY_MB with parseInt + range validation (64-16384)
  to prevent command injection via spawn() args
- Validate URL protocol in shell.openExternal (http/https only)
  to prevent RCE in Electron renderer compromise
- Bump default memory from 256MB to 512MB

## Electron package-lock.json
- Added to .gitignore (5278 lines removed from tracking)

## Test Suite (64 tests, 9 suites)
- electron-main.test.mjs: URL validation, IPC channels, window handler
- electron-preload.test.mjs: channel whitelist, API surface, open-external
- cli-memory.test.mjs: injection prevention, boundary values, .env parsing

## Documentation
- Desktop App section added to all 30 READMEs (9 fully translated)
- USER_GUIDE.md updated with 512MB default
- .env.example reflects new defaults

2026-02-28 07:59:38 -03:00

60 KiB

Raw Blame History

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

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

وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 36 موفرًا، بدون أي توقف عن العمل.

إكمالات الدردشة • التضمينات • إنشاء الصور • الصوت • إعادة الترتيب • 100% TypeScript

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

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

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

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

🌐 الموقع • 🚀 البداية السريعة • 💡 الميزات • 📖 التوثيق • 💰 الأسعار • 💬 WhatsApp

🤔 لماذا OmniRoute؟

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

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

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

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

🔄 كيف يعمل

┌─────────────┐
│  Your CLI   │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
│   Tool      │
└──────┬──────┘
       │ http://localhost:20128/v1
       ↓
┌─────────────────────────────────────────┐
│           OmniRoute (Smart Router)        │
│  • Format translation (OpenAI ↔ Claude) │
│  • Quota tracking + Embeddings + Images │
│  • Auto token refresh                   │
└──────┬──────────────────────────────────┘
       │
       ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
       │   ↓ quota exhausted
       ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
       │   ↓ budget limit
       ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
       │   ↓ budget limit
       └─→ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

⚡ بداية سريعة

1. التثبيت عالميًا:

npm install -g omniroute
omniroute

🎉 تفتح لوحة التحكم في http://localhost:20128

الأمر	الوصف
`omniroute`	بدء تشغيل الخادم (المنفذ الافتراضي 20128)
`omniroute --port 3000`	استخدم المنفذ المخصص
`omniroute --no-open`	لا تفتح المتصفح تلقائيًا
`omniroute --help`	عرض المساعدة

**2. الاتصال بمزود مجاني: **

لوحة التحكم → الموفرون → الاتصال Claude Code أو Antigravity → تسجيل الدخول OAuth → تم!

3. استخدم في أداة CLI الخاصة بك:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: if/kimi-k2-thinking

هذا كل شيء! ابدأ البرمجة باستخدام نماذج الذكاء الاصطناعي المجانية.

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

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

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

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

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

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

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

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

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

استخدام Docker Compose:

# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

صورة	العلامة	الحجم	الوصف
`diegosouzapw/omniroute`	`latest`	~250 ميجابايت	أحدث إصدار مستقر
`diegosouzapw/omniroute`	`1.0.3`	~250 ميجابايت	النسخة الحالية

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

🆕 جديد! أصبح OmniRoute متاحًا الآن كـ تطبيق سطح مكتب أصلي لنظام Windows وmacOS وLinux.

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

npm run electron:dev           # وضع التطوير
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg)
npm run electron:build:linux   # Linux (.AppImage)

📖 التوثيق الكامل: electron/README.md

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

الطبقة	مقدم	التكلفة	إعادة ضبط الحصص	الأفضل لـ
💳الإشتراك	كلود كود (برو)	20 دولارًا شهريًا	5 ساعات + أسبوعي	اشتركت بالفعل
	الدستور الغذائي (زائد / برو)	20-200 دولار شهريًا	5 ساعات + أسبوعي	مستخدمي OpenAI
	الجوزاء CLI	مجاني	180 ألف/شهر + 1 ألف/يوم	الجميع!
	جيثب مساعد الطيار	10-19 دولارًا شهريًا	شهري	مستخدمي جيثب
🔑 مفتاح واجهة برمجة التطبيقات	نفيديا نيم	مجانًا (1000 نقطة)	لمرة واحدة	اختبار المستوى المجاني
	ديب سيك	الدفع لكل استخدام	لا شيء	أفضل سعر/جودة
	جروك	طبقة مجانية + مدفوعة	معدل محدود	الاستدلال فائق السرعة
	xAI (جروك)	الدفع لكل استخدام	لا شيء	نماذج جروك
	ميسترال	طبقة مجانية + مدفوعة	معدل محدود	الذكاء الاصطناعي الأوروبي
	اوبن راوتر	الدفع لكل استخدام	لا شيء	أكثر من 100 موديل
💰 رخيص	جي إل إم-4.7	0.6 دولار/1 مليون	يوميا 10 صباحا	نسخة احتياطية للميزانية
	ميني ماكس M2.1	0.2 دولار/1 مليون	المتداول لمدة 5 ساعات	الخيار الأرخص
	كيمي ك2	9 دولارات شهريًا مسطحة	10 مليون رمز/شهر	التكلفة المتوقعة
🆓مجانًا	اي فلو	$0	غير محدود	8 نماذج مجانية
	كوين	$0	غير محدود	3 نماذج مجانية
	كيرو	$0	غير محدود	كلود مجاني

💡 نصيحة احترافية: ابدأ مع مجموعة Gemini CLI (180 ألفًا مجانًا شهريًا) + مجموعة iFlow (مجانية غير محدودة) = تكلفة 0 دولار!

🎯 حالات الاستخدام

الحالة 1: "لدي اشتراك Claude Pro"

المشكلة: تنتهي صلاحية الحصة غير المستخدمة، وحدود المعدل أثناء عملية الترميز المكثف

Combo: "maximize-claude"
  1. cc/claude-opus-4-6        (use subscription fully)
  2. glm/glm-4.7               (cheap backup when quota out)
  3. if/kimi-k2-thinking       (free emergency fallback)

Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration

الحالة 2: "أريد تكلفة صفرية"

المشكلة: لا أستطيع تحمل تكلفة الاشتراكات، وتحتاج إلى ترميز يعتمد على الذكاء الاصطناعي

Combo: "free-forever"
  1. gc/gemini-3-flash         (180K free/month)
  2. if/kimi-k2-thinking       (unlimited free)
  3. qw/qwen3-coder-plus       (unlimited free)

Monthly cost: $0
Quality: Production-ready models

الحالة 3: "أحتاج إلى تشفير على مدار 24 ساعة طوال أيام الأسبوع، دون انقطاع"

المشكلة: المواعيد النهائية، لا أستطيع تحمل فترات التوقف عن العمل

Combo: "always-on"
  1. cc/claude-opus-4-6        (best quality)
  2. cx/gpt-5.2-codex          (second subscription)
  3. glm/glm-4.7               (cheap, resets daily)
  4. minimax/MiniMax-M2.1      (cheapest, 5h reset)
  5. if/kimi-k2-thinking       (free unlimited)

Result: 5 layers of fallback = zero downtime

الحالة 4: "أريد ذكاءً اصطناعيًا مجانيًا في OpenClaw"

المشكلة: تحتاج إلى مساعد الذكاء الاصطناعي في تطبيقات المراسلة، مجانًا تمامًا

Combo: "openclaw-free"
  1. if/glm-4.7                (unlimited free)
  2. if/minimax-m2.1           (unlimited free)
  3. if/kimi-k2-thinking       (unlimited free)

Monthly cost: $0
Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

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

🧠 التوجيه الأساسي والذكاء

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

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

ميزة	ماذا يفعل
🖼️ إنشاء الصور	`/v1/images/generations` — 4 مقدمي خدمات، أكثر من 9 نماذج
📐 المضامين	`/v1/embeddings` — 6 مقدمي خدمات، أكثر من 9 نماذج
🎤 نسخ صوتي	`/v1/audio/transcriptions` — متوافق مع الهمس
🔊 تحويل النص إلى كلام	`/v1/audio/speech` — تركيب صوتي متعدد الموفرين
🛡️ اعتدالات	`/v1/moderations` — فحوصات سلامة المحتوى
🔀 إعادة الترتيب	`/v1/rerank` — إعادة ترتيب مدى صلة الوثيقة

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

ميزة	ماذا يفعل
🔌 قاطع الدائرة	فتح/إغلاق تلقائي لكل مزود مع حدود قابلة للتكوين
🛡️ القطيع المضاد للرعد	الحد الأقصى لمعدل Mutex + الإشارة لموفري مفاتيح API
🧠 ذاكرة التخزين المؤقت الدلالية	ذاكرة التخزين المؤقت ذات المستويين (التوقيع + الدلالي) تقلل التكلفة وزمن الوصول
⚡ طلب العجز	نافذة 5s dedup للطلبات المكررة
🔒 انتحال بصمة الإصبع TLS	تجاوز اكتشاف الروبوتات المستندة إلى TLS عبر wreq-js
🌐 تصفية IP	القائمة المسموح بها/القائمة المحظورة للتحكم في الوصول إلى واجهة برمجة التطبيقات
📊 حدود المعدل القابلة للتحرير	عدد الدورات في الدقيقة القابل للتكوين والفجوة الدنيا والحد الأقصى المتزامن على مستوى النظام
🛡 حماية نقطة نهاية واجهة برمجة التطبيقات	بوابة المصادقة + حظر الموفر لنقطة النهاية `/models`
🔒 رؤية الوكيل	شارات مرمزة بالألوان: 🟢 عالمية، 🟡 مزود، 🔵 لكل اتصال مع عرض IP
🌐 تكوين الوكيل ذو 3 مستويات	قم بتكوين الوكلاء على المستوى العالمي أو لكل مزود أو لكل اتصال

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

ميزة	ماذا يفعل
📝 تسجيل الطلبات	وضع التصحيح مع سجلات الطلب/الاستجابة الكاملة
💾 سجلات وكيل SQLite	تستمر سجلات الوكيل المستمرة في إعادة تشغيل الخادم
📊 لوحة التحكم التحليلية	مدعوم من إعادة التخطيط: بطاقات إحصائيات، مخطط استخدام النموذج، جدول الموفر
📈 تتبع التقدم	الاشتراك في أحداث تقدم SSE للبث
🧪 تقييمات ماجستير إدارة الأعمال	اختبار المجموعة الذهبية مع 4 إستراتيجيات المباراة
🔍 طلب القياس عن بعد	تجميع زمن الوصول p50/p95/p99 + تتبع معرف طلب X
📋 لوحة تحكم السجلات	صفحة موحدة مكونة من 4 علامات تبويب: سجلات الطلب، وسجلات الوكيل، وسجلات التدقيق، ووحدة التحكم
🖥️ عارض سجل وحدة التحكم	عارض على النمط الطرفي في الوقت الفعلي مع مرشح المستوى والبحث والتمرير التلقائي
📑 التسجيل المعتمد على الملفات	يلتقط جهاز اعتراض وحدة التحكم جميع المخرجات إلى ملف سجل JSON بالتدوير
🏥 لوحة المعلومات الصحية	وقت تشغيل النظام، حالات قاطع الدائرة، عمليات الإغلاق، إحصائيات ذاكرة التخزين المؤقت
💰 تتبع التكلفة	إدارة الميزانية + تكوين التسعير لكل نموذج

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

ميزة	ماذا يفعل
💾 المزامنة السحابية	مزامنة التكوين عبر الأجهزة عبر Cloudflare Workers
🌐 النشر في أي مكان	المضيف المحلي، VPS، Docker، عمال Cloudflare
🔑 إدارة مفاتيح واجهة برمجة التطبيقات	إنشاء مفاتيح واجهة برمجة التطبيقات وتدويرها ونطاقها لكل مزود
🧙 معالج الإعداد	إعداد إرشادي من 4 خطوات للمستخدمين لأول مرة
🔧 لوحة تحكم أدوات CLI	بنقرة واحدة قم بتكوين Claude، Codex، Cline، OpenClaw، Kilo، Antigravity
🔄 النسخ الاحتياطية لقاعدة البيانات	النسخ الاحتياطي التلقائي والاستعادة والتصدير والاستيراد لجميع الإعدادات
🌐 التدويل	i18n الكامل مع دعم next-intl — الإنجليزية + البرتغالية (البرازيل)
🌍 محدد اللغة	أيقونة الكرة الأرضية في رأس الصفحة للتبديل بين اللغات في الوقت الفعلي (🇺🇸/🇧🇷)
📂 دليل البيانات المخصصة	`DATA_DIR` env var لتجاوز مسار التخزين الافتراضي `~/.omniroute`

📖 تفاصيل الميزة

🎯 نظام احتياطي ذكي مكون من 4 طبقات

إنشاء مجموعات باستخدام خيار الرجوع التلقائي:

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6        (your subscription)
  2. nvidia/llama-3.3-70b      (free NVIDIA API)
  3. glm/glm-4.7               (cheap backup, $0.6/1M)
  4. if/kimi-k2-thinking       (free fallback)

→ Auto switches when quota runs out or errors occur

📊 تتبع الحصص في الوقت الحقيقي

استهلاك الرمز المميز لكل مزود
إعادة ضبط العد التنازلي (5 ساعات، يوميًا، أسبوعيًا)
تقدير التكلفة للمستويات المدفوعة
تقارير الإنفاق الشهرية

🔄 ترجمة التنسيق

ترجمة سلسة بين الصيغ:

OpenAI ↔ Claude ↔ Gemini ↔ استجابات OpenAI
ترسل أداة CLI الخاصة بك تنسيق OpenAI ← يترجم OmniRoute ← يتلقى الموفر التنسيق الأصلي
يعمل مع أي أداة تدعم نقاط نهاية OpenAI المخصصة
تطهير الاستجابة - يزيل الحقول غير القياسية من أجل توافق صارم مع OpenAI SDK
تطبيع الدور — developer → system لغير OpenAI؛ system → user لطرز GLM/ERNIE
استخراج علامة التفكير — كتل <think> → reasoning_content لنماذج التفكير
الإخراج المنظم — json_schema → الجوزاء responseMimeType/responseSchema

👥 دعم الحسابات المتعددة

إضافة حسابات متعددة لكل مزود
التوجيه التلقائي أو التوجيه على أساس الأولوية
الرجوع إلى الحساب التالي عندما يصل أحد إلى الحصة

🔄 التحديث التلقائي للرموز

يتم تحديث رموز OAuth المميزة تلقائيًا قبل انتهاء الصلاحية
لا حاجة لإعادة المصادقة اليدوية
تجربة سلسة عبر جميع مقدمي الخدمة

🎨 مجموعات مخصصة

إنشاء مجموعات نماذج غير محدودة
6 إستراتيجيات: التعبئة أولاً، جولة روبن، قوة الاختيارين، العشوائية، الأقل استخدامًا، الأمثل من حيث التكلفة
مشاركة المجموعات عبر الأجهزة باستخدام Cloud Sync

🏥 لوحة المعلومات الصحية

حالة النظام (وقت التشغيل، الإصدار، استخدام الذاكرة)
حالات قاطع الدائرة لكل مزود (مغلق/مفتوح/نصف مفتوح)
حالة الحد الأقصى للسعر وعمليات الإغلاق النشطة
إحصائيات ذاكرة التخزين المؤقت للتوقيع
قياس الكمون عن بعد (ص50/ص95/ص99) + ذاكرة تخزين مؤقت سريعة
إعادة ضبط الحالة الصحية بنقرة واحدة

🔧 ملعب المترجم

يشتمل OmniRoute على ساحة مترجم قوية مدمجة مع 4 أوضاع لتصحيح الأخطاء واختبار ومراقبة ترجمات واجهة برمجة التطبيقات:

الوضع	الوصف
💻 الملعب	ترجمة التنسيق المباشر - الصق أي نص طلب واجهة برمجة التطبيقات (API) وشاهد على الفور كيف يقوم OmniRoute بترجمته بين تنسيقات الموفر (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). يتضمن أمثلة على القوالب والكشف التلقائي عن التنسيق.
💬 اختبار الدردشة	أرسل طلبات دردشة حقيقية من خلال OmniRoute وشاهد الرحلة الكاملة ذهابًا وإيابًا: مدخلاتك، والطلب المترجم، واستجابة الموفر، والرد المترجم. لا تقدر بثمن للتحقق من صحة توجيه التحرير والسرد.
🧪 مقعد الاختبار	وضع الاختبار المجمع - حدد حالات اختبار متعددة بمدخلات مختلفة ومخرجات متوقعة، وقم بتشغيلها كلها مرة واحدة، وقارن النتائج عبر الموفرين والنماذج.
📱 مراقب مباشر	مراقبة الطلبات في الوقت الفعلي - شاهد الطلبات الواردة أثناء تدفقها عبر OmniRoute، وشاهد ترجمات التنسيق التي تحدث مباشرة، وحدد المشكلات على الفور.

الوصول: لوحة المعلومات ← المترجم (الشريط الجانبي)

💾 المزامنة السحابية

موفري المزامنة والمجموعات والإعدادات عبر الأجهزة
مزامنة الخلفية التلقائية
تخزين مشفر آمن

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

💳 موفري الاشتراك

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

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

نصيحة احترافية: استخدم Opus للمهام المعقدة، وSonnet للسرعة. OmniRoute يتتبع الحصة لكل نموذج!

OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

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

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

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

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

مساعد جيثب

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

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3-pro

🔑 موفري مفاتيح واجهة برمجة التطبيقات

NVIDIA NIM (1000 نقطة مجانية!)

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

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

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

ديب سيك

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

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

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

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

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

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

OpenRouter (+100 موديل)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

iFlow (8 نماذج مجانية)

Dashboard → Connect iFlow
→ iFlow OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

كوين (3 موديلات مجانية)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

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

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

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 إنشاء مجموعات

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

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

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

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

🔧 تكامل واجهة سطر الأوامر

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

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

كلود كود

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

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

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

الخيار 1 — لوحة التحكم (مستحسن):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

الخيار 2 — يدويًا: تحرير ~/.openclaw/openclaw.json:

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

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

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

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

📊 الموديلات المتوفرة

عرض جميع الموديلات المتاحة

كود كلود (cc/) - Pro/Max:

cc/claude-opus-4-6
cc/claude-sonnet-4-5-20250929
cc/claude-haiku-4-5-20251001

المخطوطة (cx/) - Plus/Pro:

cx/gpt-5.2-codex
cx/gpt-5.1-codex-max

Gemini CLI (gc/) - مجانًا:

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

مساعد جيثب (gh/):

gh/gpt-5
gh/claude-4.5-sonnet

NVIDIA NIM (nvidia/) - أرصدة مجانية:

nvidia/llama-3.3-70b-instruct
nvidia/mistral-7b-instruct
أكثر من 50 طرازًا آخر على build.nvidia.com

GLM (glm/) - 0.6 دولار/مليون:

glm/glm-4.7

MiniMax (minimax/) - 0.2 دولار/1 مليون:

minimax/MiniMax-M2.1

iFlow (if/) - مجانًا:

if/kimi-k2-thinking
if/qwen3-coder-plus
if/deepseek-r1
if/glm-4.7
if/minimax-m2

كوين (qw/) - مجانًا:

qw/qwen3-coder-plus
qw/qwen3-coder-flash

كيرو (kr/) - مجانًا:

kr/claude-sonnet-4.5
kr/claude-haiku-4.5

OpenRouter (or/) - أكثر من 100 طراز:

or/anthropic/claude-4-sonnet
or/google/gemini-2.5-pro
أي موديل من openrouter.ai/models

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

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

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

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

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

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

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

🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)

⚠️ هام لمستخدمي OmniRoute على VPS/Docker/servidor عن بعد

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

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

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

Error 400: redirect_uri_mismatch

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

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

باسو باسو

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

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

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

انقر على "+ إنشاء بيانات الاعتماد" → "معرف عميل OAuth"
نوع التطبيق: "تطبيق ويب"
الاسم: اسم escolha qualquer (على سبيل المثال: OmniRoute Remote)

3. Adicione كمحددات URI لإعادة التوجيه المعتمدة

ليس هناك مجال "عناوين URI لإعادة التوجيه المعتمدة"، أضف:

https://seu-servidor.com/callback

استبدال seu-servidor.com بنطاقك أو IP الخاص بخادمك (بما في ذلك البوابة الضرورية، على سبيل المثال: http://45.33.32.156:20128/callback).

4. حفظ ونسخ كمعتمدة

وبعد ذلك، قم بإنشاء أو عرض Google o معرف العميل أو سر العميل.

**5. تكوين كمتغيرات البيئة **

لا يوجد .env (أو متغيرات بيئة Docker):

# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. Reinicie أو OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

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

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

Agora o Google redirecionará corretamente para https://seu-servidor.com/callback e a autenticação funcionará.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

** لوحة المعلومات تفتح على منفذ خاطئ **

اضبط PORT=20128 وNEXT_PUBLIC_BASE_URL=http://localhost:20128

أخطاء المزامنة السحابية

تحقق من نقاط BASE_URL لمثيلك قيد التشغيل
تحقق من نقاط CLOUD_URL إلى نقطة نهاية السحابة المتوقعة
احتفظ بقيم NEXT_PUBLIC_* متوافقة مع القيم من جانب الخادم

تسجيل الدخول الأول لا يعمل

تحقق من INITIAL_PASSWORD في .env
في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي 123456

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

اضبط ENABLE_REQUEST_LOGS=true في .env

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

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

🛠️ تيك ستاك

وقت التشغيل: Node.js 18–22 LTS (⚠️ Node.js 24+ غير مدعومة — better-sqlite3 الثنائيات الأصلية غير متوافقة)
اللغة: TypeScript 5.9 — TypeScript بنسبة 100% عبر src/ وopen-sse/ (الإصدار 1.0.6)
الإطار: Next.js 16 + React 19 + Tailwind CSS 4
قاعدة البيانات: LowDB (JSON) + SQLite (حالة المجال + سجلات الوكيل)
البث: الأحداث المرسلة من الخادم (SSE)
المصادقة: OAuth 2.0 (PKCE) + JWT + مفاتيح API
الاختبار: مشغل اختبار Node.js (أكثر من 368 اختبارًا للوحدة)
CI/CD: إجراءات GitHub (نشر npm التلقائي + Docker Hub عند الإصدار)
الموقع الإلكتروني: omniroute.online
الحزمة: npmjs.com/package/omniroute
عامل الميناء: hub.docker.com/r/diegosouzapw/omniroute
المرونة: قاطع الدائرة الكهربائية، والتراجع الأسي، وقطيع مضاد للرعد، وانتحال TLS

📖 التوثيق

وثيقة	الوصف
User Guide	مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر
API Reference	جميع نقاط النهاية مع الأمثلة
Troubleshooting	المشاكل والحلول الشائعة
Architecture	بنية النظام والداخلية
Contributing	إعداد التطوير والمبادئ التوجيهية
OpenAPI Spec	مواصفات OpenAPI 3.0
Security Policy	الإبلاغ عن الثغرات الأمنية والممارسات الأمنية
VM Deployment	الدليل الكامل: إعداد VM + nginx + Cloudflare
Features Gallery	جولة لوحة القيادة المرئية مع لقطات الشاشة

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

انقر لرؤية لقطات شاشة لوحة المعلومات

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

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

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

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

🔜قريبا

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

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

📧 الدعم

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

الموقع الإلكتروني: omniroute.online
جيثب: github.com/diegosouzapw/OmniRoute
المشاكل: github.com/diegosouzapw/OmniRoute/issues
واتساب: Community Group
المشروع الأصلي: 9router by decolua

👥 المساهمون

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

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

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

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

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

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

🙏 شكر وتقدير

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

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

📄 الترخيص

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

60 KiB Raw Blame History Unescape Escape