omniroute 1.6.3 → 1.6.5

package/README.bg.md

@@ -3,8 +3,6 @@
   
   # 🚀 OmniRoute — Безплатният AI Gateway
 
-🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
-
 ### Никога не спирайте да кодирате. Интелигентно маршрутизиране към **БЕЗПЛАТНИ и евтини AI модели** с автоматичен резервен вариант.
 
 _Вашият универсален 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: „Имам абонамент за 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: „Искам нулеви разходи“
-
-**Проблем:** Не мога да си позволя абонаменти, имам нужда от надеждно 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“
-
-**Проблем:** Имате нужда от AI асистент в приложенията за съобщения, напълно безплатно
-
-```
-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: „Имам абонамент за 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: „Искам нулеви разходи“
+
+**Проблем:** Не мога да си позволя абонаменти, имам нужда от надеждно 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“
+
+**Проблем:** Имате нужда от AI асистент в приложенията за съобщения, напълно безплатно
+
+```
+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>
-
-**Claude Code (`cc/`)** - Pro/Max:
-
-- `cc/claude-opus-4-6`
-- `cc/claude-sonnet-4-5-20250929`
-- `cc/claude-haiku-4-5-20251001`
-
-**Codex (`cx/`)** - Plus/Pro:
-
-- `cx/gpt-5.2-codex`
-- `cx/gpt-5.1-codex-max`
-
-**Gemini CLI (`gc/`)** - БЕЗПЛАТНО:
+## 🧪 Оценки (Evals)
 
-- `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`
+- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление
+- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво
 
-**Qwen (`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`
 
-## 🧪 Оценки (Evals)
+**Грешки при синхронизиране в облак**
 
-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+ включва резервно валидиране чрез завършвания на чат
+- Уверете се, че основният URL адрес включва суфикс `/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>
-
-**„Езиковият модел не предостави съобщения“**
-
-- Квотата на доставчика е изчерпана → Проверете инструмента за проследяване на квотата на таблото за управление
-- Решение: Използвайте комбо резервен вариант или преминете към по-евтино ниво
-
-**Ограничаване на скоростта**
-
-- Изчерпване на квотата за абонамент → Резервно връщане към 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>
 
 ---
@@ -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 inteligente para **modelos de IA GRATUITOS e de baixo custo** com резервен автоматичен.
-
-_Seu прокси универсален API — um крайна точка, 36+ доставчици, нулев престой._
-
-### 🌐 Internacionalização (i18n)
-
-Таблото за управление на OmniRoute поддържа **múltiplos idiomas**. Актуално налични:
-
-| идиома                    | Código  | Статус       |
-| ------------------------- | ------- | ------------ |
-| 🇺🇸 английски              | `en`    | ✅ Завършено |
-| 🇧🇷 португалски (Бразилия) | `pt-BR` | ✅ Завършено |
-
-**Параметр на трокар или идиома:** Кликнете без избор на идиома (🇺🇸 EN) без заглавка в таблото за управление → избор или избран идиома.
-
-**Para adicionar um new idioma:**
-
-1. Извикайте `src/i18n/messages/{codigo}.json` базирано на `en.json`
-2. Добавете кода към `src/i18n/config.ts` → `LOCALES` и `LANGUAGES`
-3. Reinicie или сървър
-
-### ⚡ 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+ доставчици на IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek и други
-- **Roteamento inteligente** — Резервни автоматични агенти
-- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
-- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
-- **Cache semântico** — Reduz custos e latência
-- **Автоматичен OAuth** — Автоматично обновяване на токени
-- **Combos personalizados** — 6 estratégias de roteamento
-- **Пълно табло** — Мониторинг, регистрационни файлове, анализи, конфигуриране
-- **CLI инструменти** — Конфигуриране на Claude Code, Codex, Cursor, Cline com um clique
-- **100% TypeScript** — Лимпо и тип код
-
-### 📖 Documentação
-
-| Документ                                        | Описание                                |
-| ----------------------------------------------- | --------------------------------------- |
-| [Guia do Usuário](docs/USER_GUIDE.md)           | Доставчици, комбинации, CLI, внедряване |
-| [Referência da API](docs/API_REFERENCE.md)      | Всички крайни точки с примери           |
-| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Общи проблеми и решения                 |
-| [Arquitetura](docs/ARCHITECTURE.md)             | Архитектура и вътрешна система          |
-| [Contribuição](CONTRIBUTING.md)                 | Setup de desenvolvimento e guidelines   |
-| [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) — Двойни гуми, компартилхе дикас и актуализация на фик.
-
-- **Уебсайт**: [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/>