omniroute 1.6.3 → 1.6.5

package/README.he.md

@@ -3,8 +3,6 @@
   
   # 🚀 OmniRoute — שער הבינה המלאכותית החינמית
 
-🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
-
 ### לעולם אל תפסיק לקוד. ניתוב חכם לדגמי בינה מלאכותית **בחינם ובעלות נמוכה** עם חזרה אוטומטית.
 
 _שרת ה-API האוניברסלי שלך - נקודת קצה אחת, 36+ ספקים, אפס זמן השבתה._
@@ -249,6 +247,30 @@ docker compose --profile cli up -d
 
 ---
 
+---
+
+## 🖥️ Desktop App — Offline & Always-On
+
+> 🆕 **NEW!** OmniRoute is now available as a **native desktop application** for Windows, macOS, and Linux.
+
+- 🖥️ **Native Window** — Dedicated app window with system tray integration
+- 🔄 **Auto-Start** — Launch OmniRoute on system login
+- 🔔 **Native Notifications** — Get alerts for quota exhaustion or provider issues
+- ⚡ **One-Click Install** — NSIS (Windows), DMG (macOS), AppImage (Linux)
+- 🌐 **Offline Mode** — Works fully offline with bundled server
+
+```bash
+npm run electron:dev           # Development mode
+npm run electron:build         # Current platform
+npm run electron:build:win     # Windows (.exe)
+npm run electron:build:mac     # macOS (.dmg)
+npm run electron:build:linux   # Linux (.AppImage)
+```
+
+📖 Full documentation: [`electron/README.md`](electron/README.md)
+
+---
+
 ## 💰 תמחור במבט חטוף
 
 | שכבה            | ספק              | עלות                    | איפוס מכסה               | הטוב ביותר עבור          |
@@ -274,67 +296,6 @@ docker compose --profile cli up -d
 
 ---
 
-## 🎯 מקרי שימוש
-
-### מקרה 1: "יש לי מנוי לקלוד פרו"
-
-**בעיה:** תוקף המכסה פג ללא שימוש, מגבלות תעריף במהלך קידוד כבד
-
-```
-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: "אני רוצה עלות אפס"
-
-**בעיה:** לא יכול להרשות לעצמו מנויים, צריך קידוד AI אמין
-
-```
-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/7, ללא הפרעות"
-
-**בעיה:** מועדים, לא יכול להרשות לעצמו זמן השבתה
-
-```
-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: "אני רוצה AI בחינם ב-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...
-```
-
----
-
 ## 💡 תכונות עיקריות
 
 ### 🧠 ניתוב ליבה ומודיעין
@@ -495,6 +456,67 @@ OmniRoute כולל מגרש משחקי מתרגמים מובנה רב עוצמה
 
 ---
 
+## 🎯 מקרי שימוש
+
+### מקרה 1: "יש לי מנוי לקלוד פרו"
+
+**בעיה:** תוקף המכסה פג ללא שימוש, מגבלות תעריף במהלך קידוד כבד
+
+```
+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: "אני רוצה עלות אפס"
+
+**בעיה:** לא יכול להרשות לעצמו מנויים, צריך קידוד AI אמין
+
+```
+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/7, ללא הפרעות"
+
+**בעיה:** מועדים, לא יכול להרשות לעצמו זמן השבתה
+
+```
+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: "אני רוצה AI בחינם ב-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>
@@ -775,98 +797,81 @@ Settings → API Configuration:
 
 ---
 
-## 📊 דגמים זמינים
-
-<details>
-<summary><b>הצג את כל הדגמים הזמינים</b></summary>
-
-**קוד קלוד (`cc/`)** - פרו/מקסימום:
-
-- `cc/claude-opus-4-6`
-- `cc/claude-sonnet-4-5-20250929`
-- `cc/claude-haiku-4-5-20251001`
-
-**קודקס (`cx/`)** - פלוס/יתרונות:
-
-- `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** בלוח המחוונים.
 
-**GitHub Copilot (`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/1 מיליון:
+| אסטרטגיה   | תיאור                                      | דוגמה                            |
+| ---------- | ------------------------------------------ | -------------------------------- |
+| `exact`    | הפלט חייב להתאים בדיוק                     | `"4"`                            |
+| `contains` | הפלט חייב להכיל תת מחרוזת (לא תלוי רישיות) | `"Paris"`                        |
+| `regex`    | הפלט חייב להתאים לדפוס הרקס                | `"1.*2.*3"`                      |
+| `custom`   | פונקציית JS מותאמת מחזירה true/false       | `(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`
+- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים
+- פתרון: השתמש ב-combo fallback או עבור לשכבה זולה יותר
 
-**Qwen (`qw/`)** - בחינם:
+**הגבלת תעריפים**
 
-- `qw/qwen3-coder-plus`
-- `qw/qwen3-coder-flash`
+- מכסת מנויים נגמרת ← Fallback ל-GLM/MiniMax
+- הוסף שילוב: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
 
-**Kiro (`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`    | הפלט חייב להתאים לדפוס הרקס                | `"1.*2.*3"`                      |
-| `custom`   | פונקציית JS מותאמת מחזירה true/false       | `(output) => output.length > 10` |
+**בדיקת חיבור מראה "לא חוקי" עבור ספקים תואמי OpenAI**
 
----
+- ספקים רבים אינם חושפים נקודת קצה `/models`
+- OmniRoute v1.0.6+ כולל אימות חוזר באמצעות השלמת צ'אט
+- ודא שכתובת האתר הבסיסית כוללת את הסיומת `/v1`
 
-## 🔐 OAuth em Servidor Remoto (הגדרת OAuth מרחוק)
+### 🔐 OAuth em Servidor Remoto (הגדרת OAuth מרחוק)
 
 <a name="oauth-em-servidor-remoto"></a>
 
@@ -957,59 +962,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
 
 > פתרון עקיפת הבעיה או קוד אוטומטי של כתובת ה-URL או עצמאית להפנות את החשבון או לא.
 
----
-
-## 🐛 פתרון בעיות
-
-<details>
-<summary><b>לחץ כדי להרחיב את המדריך לפתרון בעיות</b></summary>
-
-**"מודל השפה לא סיפק הודעות"**
-
-- מיצתה מכסת הספק ← בדוק את עוקב המכסות של לוח המחוונים
-- פתרון: השתמש ב-combo fallback או עבור לשכבה זולה יותר
-
-**הגבלת תעריפים**
-
-- מכסת מנויים נגמרת ← Fallback ל-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+ כולל אימות חוזר באמצעות השלמת צ'אט
-- ודא שכתובת האתר הבסיסית כוללת את הסיומת `/v1`
-
 </details>
 
 ---
@@ -1152,85 +1104,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
 
 ---
 
----
-
-## 🇧🇷 OmniRoute — Gateway de IA Gratuito
-
-<a name="-omniroute--gateway-de-ia-gratuito"></a>
-
-### Nunca pare de codar. Roteamento intelligente עבור **מודלים של IA GRATUITOS e de baixo custo** com fallback automático.
-
-_Seu proxy universal de API - נקודת קצה, 36+ בדיקות, אפס השבתה._
-
-### 🌐 Internacionalização (i18n)
-
-O לוח המחוונים של OmniRoute תומך ב-**רב ביטויים**. ניתנת הספק:
-
-| אידיומה              | קודיגו  | סטטוס      |
-| -------------------- | ------- | ---------- |
-| 🇺🇸 אנגלית            | `en`    | ✅ קומפלטו |
-| 🇧🇷 פורטוגזית (ברזיל) | `pt-BR` | ✅ קומפלטו |
-
-**למקרה של ביטוי:** לחץ על לא בחירה בשפה (🇺🇸 EN) ללא כותרת ללוח המחוונים ← בחירה בצורת ביטוי.
-
-**לפרטים נוספים:**
-
-1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
-2. Adicone o código em `src/i18n/config.ts` → `LOCALES` e `LANGUAGES`
-3. Reinicie o servidor
-
-### ⚡ Início Rápido
-
-```bash
-# Instalar via npm
-npx omniroute@latest
-
-# Ou rodar do código-fonte
-cp .env.example .env
-npm install
-PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
-```
-
-### 🐳 דוקר
-
-```bash
-docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
-```
-
-### 🔑 Funcionalidades Principais
-
-- **36+ provedores de IA** - קלוד, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
-- **Roteamento inteligente** - Fallback automático entre provedores
-- **Tradução de formato** — OpenAI ↔ קלוד ↔ Gemini automaticamente
-- **מולטי-קונטא** - Múltiplas contas por provedor com seleção intelligente
-- **Cache semântico** — Reduz custos e latência
-- **OAuth automático** — אסימונים renovam automaticamente
-- **Combos personalizados** - 6 estratégias de roteamento
-- **לוח המחוונים המלא** - מעקב, יומנים, ניתוחים, הגדרות
-- **כלי CLI** - הגדר את קוד קלוד, Codex, Cursor, Cline com um clique
-- **100% TypeScript** — קוד רגיל
-
-### 📖 תיעוד
-
-| דוקומנטו                                        | תיאור                              |
-| ----------------------------------------------- | ---------------------------------- |
-| [Guia do Usuário](docs/USER_GUIDE.md)           | פרובדורים, שילובים, CLI, פריסה     |
-| [Referência da API](docs/API_REFERENCE.md)      | Todos OS נקודות קצה com exemplos   |
-| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções        |
-| [Arquitetura](docs/ARCHITECTURE.md)             | Arquitetura e internos do sistema  |
-| [Contribuição](CONTRIBUTING.md)                 | התקנה של הנחיות והנחיות            |
-| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md)     | גיאה מלאה: VM + nginx + Cloudflare |
-
-### 📧 תמיכה
-
-> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
-
-- **אתר**: [omniroute.online](https://omniroute.online)
-- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
-- **בעיות**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
-
----
-
 <div align="center">
   <sub>נבנה עם ❤️ למפתחים שמקודדים 24/7</sub>
   <br/>