omniroute 1.4.10 → 1.5.0

package/README.ar.md

@@ -0,0 +1,1153 @@
+<div align="center">
+  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  
+  # 🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية
+
+### لا تتوقف أبدًا عن البرمجة. التوجيه الذكي إلى **نماذج الذكاء الاصطناعي المجانية ومنخفضة التكلفة** مع الرجوع التلقائي.
+
+_وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 36 موفرًا، بدون أي توقف عن العمل._
+
+**إكمالات الدردشة • التضمينات • إنشاء الصور • الصوت • إعادة الترتيب • 100% TypeScript**
+
+---
+
+### 🤖 موفر الذكاء الاصطناعي المجاني لوكلاء البرمجة المفضلين لديك
+
+_قم بتوصيل أي أداة IDE أو CLI مدعومة بالذكاء الاصطناعي من خلال OmniRoute - بوابة واجهة برمجة التطبيقات المجانية للترميز غير المحدود._
+
+  <table>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/cline/cline">
+          <img src="./public/providers/openclaw.png" alt="OpenClaw" width="48"/><br/>
+          <b>OpenClaw</b>
+        </a><br/>
+        <sub>⭐ 205K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/HKUDS/nanobot">
+          <img src="./public/providers/nanobot.png" alt="NanoBot" width="48"/><br/>
+          <b>NanoBot</b>
+        </a><br/>
+        <sub>⭐ 20.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/sipeed/picoclaw">
+          <img src="./public/providers/picoclaw.jpg" alt="PicoClaw" width="48"/><br/>
+          <b>PicoClaw</b>
+        </a><br/>
+        <sub>⭐ 14.6K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/zeroclaw-labs/zeroclaw">
+          <img src="./public/providers/zeroclaw.png" alt="ZeroClaw" width="48"/><br/>
+          <b>ZeroClaw</b>
+        </a><br/>
+        <sub>⭐ 9.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/nearai/ironclaw">
+          <img src="./public/providers/ironclaw.png" alt="IronClaw" width="48"/><br/>
+          <b>IronClaw</b>
+        </a><br/>
+        <sub>⭐ 2.1K</sub>
+      </td>
+    </tr>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/anomalyco/opencode">
+          <img src="./public/providers/opencode.svg" alt="OpenCode" width="48"/><br/>
+          <b>OpenCode</b>
+        </a><br/>
+        <sub>⭐ 106K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/openai/codex">
+          <img src="./public/providers/codex.png" alt="Codex CLI" width="48"/><br/>
+          <b>Codex CLI</b>
+        </a><br/>
+        <sub>⭐ 60.8K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/anthropics/claude-code">
+          <img src="./public/providers/claude.png" alt="Claude Code" width="48"/><br/>
+          <b>Claude Code</b>
+        </a><br/>
+        <sub>⭐ 67.3K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/google-gemini/gemini-cli">
+          <img src="./public/providers/gemini-cli.png" alt="Gemini CLI" width="48"/><br/>
+          <b>Gemini CLI</b>
+        </a><br/>
+        <sub>⭐ 94.7K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/Kilo-Org/kilocode">
+          <img src="./public/providers/kilocode.png" alt="Kilo Code" width="48"/><br/>
+          <b>Kilo Code</b>
+        </a><br/>
+        <sub>⭐ 15.5K</sub>
+      </td>
+    </tr>
+  </table>
+
+<sub>📡 يتصل جميع الوكلاء عبر <code>http://localhost:20128/v1</code> أو <code>http://cloud.omniroute.online/v1</code> - تكوين واحد ونماذج غير محدودة و الحصة</sub>
+
+---
+
+[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
+[![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute)
+[![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
+[![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online)
+[![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+[🌐 الموقع](https://omniroute.online) • [🚀 البداية السريعة](#-بداية-سريعة) • [💡 الميزات](#-الميزات-الرئيسية) • [📖 التوثيق](#-التوثيق) • [💰 الأسعار](#-لمحة-سريعة-عن-الأسعار) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+🌐 **متوفر باللغات:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
+
+</div>
+
+---
+
+## 🤔 لماذا OmniRoute؟
+
+**توقف عن إهدار المال وضرب الحدود:**
+
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> تنتهي صلاحية حصة الاشتراك غير المستخدمة كل شهر
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> حدود الأسعار تمنعك من الترميز المتوسط
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> واجهات برمجة التطبيقات باهظة الثمن (20-50 دولارًا شهريًا لكل مزود)
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> التبديل اليدوي بين مقدمي الخدمة
+
+** 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. التثبيت عالميًا:**
+
+```bash
+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
+```
+
+**هذا كل شيء!** ابدأ البرمجة باستخدام نماذج الذكاء الاصطناعي المجانية.
+
+** البديل - تشغيل من المصدر: **
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 عامل الميناء
+
+OmniRoute متاح كصورة Docker عامة على [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**الجري السريع:**
+
+```bash
+docker run -d \
+  --name omniroute \
+  --restart unless-stopped \
+  -p 20128:20128 \
+  -v omniroute-data:/app/data \
+  diegosouzapw/omniroute:latest
+```
+
+** مع ملف البيئة: **
+
+```bash
+# 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:**
+
+```bash
+# 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 ميجابايت | النسخة الحالية   |
+
+---
+
+## 💰 لمحة سريعة عن الأسعار
+
+| الطبقة                             | مقدم                         | التكلفة                | إعادة ضبط الحصص         | الأفضل لـ                 |
+| ---------------------------------- | ---------------------------- | ---------------------- | ----------------------- | ------------------------- |
+| **💳الإشتراك**                     | كلود كود (برو)               | 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`               |
+
+<details>
+<summary><b>📖 تفاصيل الميزة</b></summary>
+
+### 🎯 نظام احتياطي ذكي مكون من 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، وشاهد ترجمات التنسيق التي تحدث مباشرة، وحدد المشكلات على الفور.                                                                                |
+
+**الوصول:** لوحة المعلومات ← المترجم (الشريط الجانبي)
+
+### 💾 المزامنة السحابية
+
+- موفري المزامنة والمجموعات والإعدادات عبر الأجهزة
+- مزامنة الخلفية التلقائية
+- تخزين مشفر آمن
+
+</details>
+
+---
+
+## 📖 دليل الإعداد
+
+<details>
+<summary><b>💳 موفري الاشتراك</b></summary>
+
+### كلود كود (برو/ماكس)
+
+```bash
+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)
+
+```bash
+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 ألفًا شهريًا مجانًا!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+  gc/gemini-3-flash-preview
+  gc/gemini-2.5-pro
+```
+
+**أفضل قيمة:** طبقة مجانية ضخمة! استخدم هذا قبل المستويات المدفوعة.
+
+### مساعد جيثب
+
+```bash
+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
+```
+
+</details>
+
+<details>
+<summary><b>🔑 موفري مفاتيح واجهة برمجة التطبيقات</b></summary>
+
+### NVIDIA NIM (1000 نقطة مجانية!)
+
+1. قم بالتسجيل: [build.nvidia.com](https://build.nvidia.com)
+2. احصل على مفتاح واجهة برمجة التطبيقات (API) مجانًا (يتضمن 1000 نقطة استدلال)
+3. لوحة المعلومات → إضافة موفر → NVIDIA NIM:
+   - مفتاح واجهة برمجة التطبيقات: `nvapi-your-key`
+
+**النماذج:** `nvidia/llama-3.3-70b-instruct`، `nvidia/mistral-7b-instruct`، وأكثر من 50 طرازًا آخر
+
+**نصيحة احترافية:** واجهة برمجة التطبيقات المتوافقة مع OpenAI — تعمل بسلاسة مع ترجمة تنسيق OmniRoute!
+
+### ديب سيك
+
+1. قم بالتسجيل: [platform.deepseek.com](https://platform.deepseek.com)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة موفر → DeepSeek
+
+**النماذج:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (الطبقة المجانية متاحة!)
+
+1. قم بالتسجيل: [console.groq.com](https://console.groq.com)
+2. احصل على مفتاح API (الطبقة المجانية متضمنة)
+3. لوحة المعلومات → إضافة موفر → Groq
+
+**النماذج:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**نصيحة احترافية:** استنتاج فائق السرعة — الأفضل للبرمجة في الوقت الفعلي!
+
+### OpenRouter (+100 موديل)
+
+1. قم بالتسجيل: [openrouter.ai](https://openrouter.ai)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة موفر → OpenRouter
+
+**النماذج:** يمكنك الوصول إلى أكثر من 100 نموذج من جميع المزودين الرئيسيين من خلال مفتاح واجهة برمجة التطبيقات (API) واحد.
+
+</details>
+
+<details>
+<summary><b>💰 مقدمو الخدمة الرخيصة (النسخ الاحتياطي)</b></summary>
+
+### GLM-4.7 (إعادة التعيين اليومي، 0.6 دولار/1 مليون)
+
+1. قم بالتسجيل: [Zhipu AI](https://open.bigmodel.cn/)
+2. احصل على مفتاح API من خطة الترميز
+3. لوحة المعلومات → إضافة مفتاح واجهة برمجة التطبيقات:
+   - المزود: `glm`
+   - مفتاح واجهة برمجة التطبيقات: `your-key`
+
+**الاستخدام:** `glm/glm-4.7`
+
+**نصيحة احترافية:** توفر خطة البرمجة حصة 3× بتكلفة 1/7! إعادة الضبط يوميًا الساعة 10:00 صباحًا.
+
+### MiniMax M2.1 (إعادة الضبط لمدة 5 ساعات، 0.20 دولار/1 مليون)
+
+1. قم بالتسجيل: [MiniMax](https://www.minimax.io/)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة مفتاح API
+
+**الاستخدام:** `minimax/MiniMax-M2.1`
+
+**نصيحة احترافية:** الخيار الأرخص للسياق الطويل (مليون رمز)!
+
+### كيمي K2 (شقة بقيمة 9 دولارات شهريًا)
+
+1. الاشتراك: [Moonshot AI](https://platform.moonshot.ai/)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة مفتاح API
+
+**الاستخدام:** `kimi/kimi-latest`
+
+**نصيحة احترافية:** سعر ثابت قدره 9 دولارات شهريًا مقابل 10 ملايين رمز مميز = 0.90 دولارًا أمريكيًا/مليون تكلفة فعالة!
+
+</details>
+
+<details>
+<summary><b>🆓 موفرو الخدمة المجانية (النسخ الاحتياطي في حالات الطوارئ)</b></summary>
+
+### iFlow (8 نماذج مجانية)
+
+```bash
+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 موديلات مجانية)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+  qw/qwen3-coder-plus
+  qw/qwen3-coder-flash
+```
+
+### كيرو (كلود فري)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+  kr/claude-sonnet-4.5
+  kr/claude-haiku-4.5
+```
+
+</details>
+
+<details>
+<summary><b>🎨 إنشاء مجموعات</b></summary>
+
+### مثال 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!
+```
+
+</details>
+
+<details>
+<summary><b>🔧 تكامل واجهة سطر الأوامر</b></summary>
+
+### بيئة تطوير متكاملة للمؤشر
+
+```
+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` يدويًا.
+
+### كوديكس سطر الأوامر
+
+```bash
+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`:
+
+```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
+```
+
+</details>
+
+---
+
+## 📊 الموديلات المتوفرة
+
+<details>
+<summary><b>عرض جميع الموديلات المتاحة</b></summary>
+
+**كود كلود (`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](https://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](https://openrouter.ai/models)
+
+</details>
+
+---
+
+## 🧪 التقييمات (التقييمات)
+
+يشتمل 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 عن بعد)
+
+<a name="oauth-em-servidor-remoto"></a>
+
+> **⚠️ هام لمستخدمي 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](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):
+
+```bash
+# 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**
+
+```bash
+# 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**:
+
+1. يفتح OmniRoute عنوان URL لتفويض Google
+2. قم بتفويض Google لإعادة التوجيه إلى `localhost` (لا يوجد خادم عن بعد)
+3. **انسخ عنوان URL كاملاً** من شريط الإدخال في متصفحك (حتى لا يتم نقل الصفحة)
+4. هذا هو عنوان URL الذي يظهر في وضع الاتصال بـ OmniRoute
+5. انقر على **"الاتصال"**
+
+> يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا.
+
+---
+
+## 🐛 استكشاف الأخطاء وإصلاحها
+
+<details>
+<summary><b>انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها</b></summary>
+
+**"نموذج اللغة لم يقدم رسائل"**
+
+- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
+- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص
+
+** الحد من المعدل **
+
+- حصة الاشتراك المحددة → الرجوع إلى 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`
+
+</details>
+
+---
+
+## 🛠️ تيك ستاك
+
+- **وقت التشغيل**: 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](https://omniroute.online)
+- **الحزمة**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **عامل الميناء**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **المرونة**: قاطع الدائرة الكهربائية، والتراجع الأسي، وقطيع مضاد للرعد، وانتحال TLS
+
+---
+
+## 📖 التوثيق
+
+| وثيقة                                        | الوصف                                         |
+| -------------------------------------------- | --------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md)             | مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر |
+| [API Reference](docs/API_REFERENCE.md)       | جميع نقاط النهاية مع الأمثلة                  |
+| [Troubleshooting](docs/TROUBLESHOOTING.md)   | المشاكل والحلول الشائعة                       |
+| [Architecture](docs/ARCHITECTURE.md)         | بنية النظام والداخلية                         |
+| [Contributing](CONTRIBUTING.md)              | إعداد التطوير والمبادئ التوجيهية              |
+| [OpenAPI Spec](docs/openapi.yaml)            | مواصفات OpenAPI 3.0                           |
+| [Security Policy](SECURITY.md)               | الإبلاغ عن الثغرات الأمنية والممارسات الأمنية |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | الدليل الكامل: إعداد VM + nginx + Cloudflare  |
+| [Features Gallery](docs/FEATURES.md)         | جولة لوحة القيادة المرئية مع لقطات الشاشة     |
+
+### 📸 معاينة لوحة التحكم
+
+<details>
+<summary><b>انقر لرؤية لقطات شاشة لوحة المعلومات</b></summary>
+
+| صفحة                  | لقطة شاشة                                         |
+| --------------------- | ------------------------------------------------- |
+| ** مقدمو الخدمة **    | ![Providers](docs/screenshots/01-providers.png)   |
+| **المجموعات**         | ![Combos](docs/screenshots/02-combos.png)         |
+| **تحليلات**           | ![Analytics](docs/screenshots/03-analytics.png)   |
+| **الصحة**             | ![Health](docs/screenshots/04-health.png)         |
+| **مترجم**             | ![Translator](docs/screenshots/05-translator.png) |
+| **الإعدادات**         | ![Settings](docs/screenshots/06-settings.png)     |
+| **أدوات سطر الأوامر** | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
+| **سجلات الاستخدام**   | ![Usage](docs/screenshots/08-usage.png)           |
+| **نقطة النهاية**      | ![Endpoint](docs/screenshots/09-endpoint.png)     |
+
+</details>
+
+---
+
+## 🗺️خريطة الطريق
+
+يحتوي OmniRoute على **210+ ميزات مخطط لها** عبر مراحل تطوير متعددة. فيما يلي المجالات الرئيسية:
+
+| الفئة                       | الميزات المخططة | أبرز الأحداث                                                                                                                                  |
+| --------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| 🧠 **التوجيه والاستخبارات** | 25+             | التوجيه ذو زمن الاستجابة الأقل، والتوجيه القائم على العلامات، والاختبار المبدئي للحصة، واختيار حساب P2C                                       |
+| 🔒 **الأمان والامتثال**     | 20+             | تقوية SSRF، وإخفاء بيانات الاعتماد، والحد الأقصى للمعدل لكل نقطة نهاية، وتحديد نطاق مفتاح الإدارة                                             |
+| 📊 **قابلية الملاحظة**      | 15+             | تكامل OpenTelemetry ومراقبة الحصص في الوقت الفعلي وتتبع التكلفة لكل نموذج                                                                     |
+| 🔄 **تكامل الموفر**         | 20+             | تسجيل النموذج الديناميكي، فترات تهدئة الموفر، الدستور الغذائي متعدد الحسابات، تحليل حصة الطيار المساعد                                        |
+| ⚡ **الأداء**               | 15+             | طبقة ذاكرة التخزين المؤقت المزدوجة، ذاكرة التخزين المؤقت السريعة، ذاكرة التخزين المؤقت للاستجابة، استمرار البث، واجهة برمجة التطبيقات الدفعية |
+| 🌐 **النظام البيئي**        | 10+             | WebSocket API، إعادة تحميل التكوين السريع، مخزن التكوين الموزع، الوضع التجاري                                                                 |
+
+### 🔜قريبا
+
+- 🔗 **تكامل OpenCode** — دعم الموفر الأصلي لـ OpenCode AI IDE للترميز
+- 🔗 **تكامل TRAE** — الدعم الكامل لإطار تطوير TRAE AI
+- 📦 **Batch API** — معالجة الدفعات غير المتزامنة للطلبات المجمعة
+- 🎯 **التوجيه المعتمد على العلامات** — توجيه الطلبات بناءً على العلامات المخصصة والبيانات الوصفية
+- 💰 **إستراتيجية أقل تكلفة** — تحديد أرخص مزود متاح تلقائيًا
+
+> 📝 مواصفات الميزات الكاملة متوفرة في [link](docs/new-features/) (217 مواصفات تفصيلية)
+
+---
+
+## 📧 الدعم
+
+> 💬 **انضم إلى مجتمعنا!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — احصل على المساعدة وشارك النصائح وابق على اطلاع.
+
+- **الموقع الإلكتروني**: [omniroute.online](https://omniroute.online)
+- **جيثب**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **المشاكل**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **واتساب**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **المشروع الأصلي**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 المساهمون
+
+[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### كيفية المساهمة
+
+1. شوكة المستودع
+2. قم بإنشاء فرع الميزات الخاص بك (`git checkout -b feature/amazing-feature`)
+3. تنفيذ التغييرات (`git commit -m 'Add amazing feature'`)
+4. ادفع إلى الفرع (`git push origin feature/amazing-feature`)
+5. افتح طلب السحب
+
+راجع [CONTRIBUTING.md](CONTRIBUTING.md) للحصول على إرشادات مفصلة.
+
+### إطلاق نسخة جديدة
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 تاريخ النجوم
+
+<a href="https://star-history.com/#diegosouzapw/OmniRoute&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+ </picture>
+</a>
+
+---
+
+## 🙏 شكر وتقدير
+
+شكر خاص لـ **[9router](https://github.com/decolua/9router)** بواسطة **[decolua](https://github.com/decolua)** — المشروع الأصلي الذي ألهم هذه الشوكة. يعتمد OmniRoute على هذا الأساس المذهل مع ميزات إضافية وواجهات برمجة التطبيقات متعددة الوسائط وإعادة كتابة TypeScript كاملة.
+
+شكر خاص لـ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — تطبيق Go الأصلي الذي ألهم منفذ JavaScript هذا.
+
+---
+
+## 📄 الترخيص
+
+ترخيص MIT - راجع [LICENSE](LICENSE) للحصول على التفاصيل.
+
+---
+
+---