omniroute 1.6.3 → 1.6.5

package/README.ar.md

@@ -247,6 +247,29 @@ docker compose --profile cli up -d
 
 ---
 
+---
+
+## 🖥️ تطبيق سطح المكتب — غير متصل ومتاح دائمًا
+
+> 🆕 **جديد!** أصبح OmniRoute متاحًا الآن كـ **تطبيق سطح مكتب أصلي** لنظام Windows وmacOS وLinux.
+
+- 🖥️ **نافذة أصلية** — نافذة مخصصة مع تكامل شريط النظام
+- 🔄 **بدء تلقائي** — تشغيل OmniRoute عند تسجيل الدخول
+- 🔔 **إشعارات أصلية** — تنبيهات عند نفاد الحصة
+- ⚡ **تثبيت بنقرة واحدة** — NSIS (Windows)، DMG (macOS)، AppImage (Linux)
+- 🌐 **وضع غير متصل** — يعمل بالكامل بدون إنترنت
+
+```bash
+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`](electron/README.md)
+
+---
+
 ## 💰 لمحة سريعة عن الأسعار
 
 | الطبقة                             | مقدم                         | التكلفة                | إعادة ضبط الحصص         | الأفضل لـ                 |
@@ -272,67 +295,6 @@ docker compose --profile cli up -d
 
 ---
 
-## 🎯 حالات الاستخدام
-
-### الحالة 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...
-```
-
----
-
 ## 💡 الميزات الرئيسية
 
 ### 🧠 التوجيه الأساسي والذكاء
@@ -493,6 +455,67 @@ Combo: "my-coding-stack"
 
 ---
 
+## 🎯 حالات الاستخدام
+
+### الحالة 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...
+```
+
+---
+
 ## 📖 دليل الإعداد
 
 <details>
@@ -773,98 +796,81 @@ Settings → API Configuration:
 
 ---
 
-## 📊 الموديلات المتوفرة
-
-<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`
+يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر **Analytics → Evals** في لوحة التحكم.
 
-**مساعد جيثب (`gh/`)**:
+### الطقم الذهبي المدمج
 
-- `gh/gpt-5`
-- `gh/claude-4.5-sonnet`
+تحتوي "OmniRoute Golden Set" المحملة مسبقًا على 10 حالات اختبار تغطي:
 
-**NVIDIA NIM (`nvidia/`)** - أرصدة مجانية:
+- تحياتي، الرياضيات، الجغرافيا، توليد التعليمات البرمجية
+- الامتثال لتنسيق JSON والترجمة وتخفيض السعر
+- رفض السلامة (المحتوى الضار)، العد، المنطق المنطقي
 
-- `nvidia/llama-3.3-70b-instruct`
-- `nvidia/mistral-7b-instruct`
-- أكثر من 50 طرازًا آخر على [build.nvidia.com](https://build.nvidia.com)
+### استراتيجيات التقييم
 
-**GLM (`glm/`)** - 0.6 دولار/مليون:
+| استراتيجية | الوصف                                                         | مثال                             |
+| ---------- | ------------------------------------------------------------- | -------------------------------- |
+| `exact`    | يجب أن يتطابق الإخراج تمامًا مع                               | `"4"`                            |
+| `contains` | يجب أن يحتوي الإخراج على سلسلة فرعية (غير حساسة لحالة الأحرف) | `"Paris"`                        |
+| `regex`    | يجب أن يتطابق الإخراج مع نمط regex                            | `"1.*2.*3"`                      |
+| `custom`   | ترجع دالة JS المخصصة صواب/خطأ                                 | `(output) => output.length > 10` |
 
-- `glm/glm-4.7`
+---
 
-**MiniMax (`minimax/`)** - 0.2 دولار/1 مليون:
+## 🐛 استكشاف الأخطاء وإصلاحها
 
-- `minimax/MiniMax-M2.1`
+<details>
+<summary><b>انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها</b></summary>
 
-**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`
+- حصة الاشتراك المحددة → الرجوع إلى GLM/MiniMax
+- إضافة التحرير والسرد: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
 
-**كيرو (`kr/`)** - مجانًا:
+** انتهت صلاحية رمز OAuth **
 
-- `kr/claude-sonnet-4.5`
-- `kr/claude-haiku-4.5`
+- يتم التحديث تلقائيًا بواسطة OmniRoute
+- إذا استمرت المشكلات: لوحة المعلومات → الموفر → إعادة الاتصال
 
-**OpenRouter (`or/`)** - أكثر من 100 طراز:
+**تكاليف مرتفعة**
 
-- `or/anthropic/claude-4-sonnet`
-- `or/google/gemini-2.5-pro`
-- أي موديل من [openrouter.ai/models](https://openrouter.ai/models)
+- التحقق من إحصائيات الاستخدام في لوحة المعلومات → التكاليف
+- تبديل النموذج الأساسي إلى GLM/MiniMax
+- استخدم الطبقة المجانية (Gemini CLI، iFlow) للمهام غير الحرجة
 
-</details>
+** لوحة المعلومات تفتح على منفذ خاطئ **
 
----
+- اضبط `PORT=20128` و`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
 
-## 🧪 التقييمات (التقييمات)
+**أخطاء المزامنة السحابية**
 
-يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر **Analytics → Evals** في لوحة التحكم.
+- تحقق من نقاط `BASE_URL` لمثيلك قيد التشغيل
+- تحقق من نقاط `CLOUD_URL` إلى نقطة نهاية السحابة المتوقعة
+- احتفظ بقيم `NEXT_PUBLIC_*` متوافقة مع القيم من جانب الخادم
 
-### الطقم الذهبي المدمج
+**تسجيل الدخول الأول لا يعمل**
 
-تحتوي "OmniRoute Golden Set" المحملة مسبقًا على 10 حالات اختبار تغطي:
+- تحقق من `INITIAL_PASSWORD` في `.env`
+- في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي `123456`
 
-- تحياتي، الرياضيات، الجغرافيا، توليد التعليمات البرمجية
-- الامتثال لتنسيق JSON والترجمة وتخفيض السعر
-- رفض السلامة (المحتوى الضار)، العد، المنطق المنطقي
+** لا توجد سجلات الطلب **
 
-### استراتيجيات التقييم
+- اضبط `ENABLE_REQUEST_LOGS=true` في `.env`
 
-| استراتيجية | الوصف                                                         | مثال                             |
-| ---------- | ------------------------------------------------------------- | -------------------------------- |
-| `exact`    | يجب أن يتطابق الإخراج تمامًا مع                               | `"4"`                            |
-| `contains` | يجب أن يحتوي الإخراج على سلسلة فرعية (غير حساسة لحالة الأحرف) | `"Paris"`                        |
-| `regex`    | يجب أن يتطابق الإخراج مع نمط regex                            | `"1.*2.*3"`                      |
-| `custom`   | ترجع دالة JS المخصصة صواب/خطأ                                 | `(output) => output.length > 10` |
+**يظهر اختبار الاتصال "غير صالح" لمقدمي الخدمات المتوافقين مع OpenAI**
 
----
+- لا يكشف العديد من مقدمي الخدمة عن نقطة النهاية `/models`
+- يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
+- تأكد من أن عنوان URL الأساسي يتضمن اللاحقة `/v1`
 
-## 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)
+### 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)
 
 <a name="oauth-em-servidor-remoto"></a>
 
@@ -955,59 +961,6 @@ Agora o Google redirecionará corretamente para `https://seu-servidor.com/callba
 
 > يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان 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>
 
 ---