omniroute 1.6.3 → 1.6.5

package/README.uk-UA.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: «У мене є підписка на 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/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: «Я хочу БЕЗКОШТОВНОГО ШІ в 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 містить потужний вбудований Translator Playgr
 
 ---
 
+## 🎯 Випадки використання
+
+### Випадок 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/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: «Я хочу БЕЗКОШТОВНОГО ШІ в 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,83 @@ 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:
+## 🧪 Оцінки (Evals)
 
-- `cx/gpt-5.2-codex`
-- `cx/gpt-5.1-codex-max`
+OmniRoute містить вбудовану систему оцінювання для перевірки якості відповіді LLM на відповідність золотому набору. Доступ до нього через **Аналітика → Оцінки** на інформаційній панелі.
 
-**Gemini CLI (`gc/`)** - БЕЗКОШТОВНО:
+### Вбудований Золотий набір
 
-- `gc/gemini-3-flash-preview`
-- `gc/gemini-2.5-pro`
+Попередньо завантажений "Золотий набір OmniRoute" містить 10 тестів, які охоплюють:
 
-**Копілот GitHub (`gh/`)**:
+- Привітання, математика, географія, генерація коду
+- Відповідність формату JSON, переклад, розмітка
+- Відмова безпеки (шкідливий контент), підрахунок, булева логіка
 
-- `gh/gpt-5`
-- `gh/claude-4.5-sonnet`
+### Стратегії оцінювання
 
-**NVIDIA NIM (`nvidia/`)** - БЕЗКОШТОВНІ кредити:
+| Стратегія  | Опис                                                           | Приклад                          |
+| ---------- | -------------------------------------------------------------- | -------------------------------- |
+| `exact`    | Вихідні дані повинні точно відповідати                         | `"4"`                            |
+| `contains` | Вихідні дані повинні містити підрядок (незалежно від регістру) | `"Paris"`                        |
+| `regex`    | Вихідні дані мають відповідати шаблону регулярного виразу      | `"1.*2.*3"`                      |
+| `custom`   | Спеціальна функція JS повертає true/false                      | `(output) => output.length > 10` |
 
-- `nvidia/llama-3.3-70b-instruct`
-- `nvidia/mistral-7b-instruct`
-- більше 50 моделей на [build.nvidia.com](https://build.nvidia.com)
+---
 
-**GLM (`glm/`)** - 0,6 $/1 млн:
+## 🐛 Усунення несправностей
 
-- `glm/glm-4.7`
+<details>
+<summary><b>Натисніть, щоб розгорнути посібник з усунення несправностей</b></summary>
 
-**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`
+— Вичерпана квота на підписку → Повернення до GLM/MiniMax
 
-**Qwen (`qw/`)** - БЕЗКОШТОВНО:
+- Додати комбо: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
 
-- `qw/qwen3-coder-plus`
-- `qw/qwen3-coder-flash`
+**Термін дії маркера OAuth минув**
 
-**Kiro (`kr/`)** - БЕЗКОШТОВНО:
+— Автоматично оновлено OmniRoute
 
-- `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)
+- Перевірте статистику використання в Інформаційній панелі → Витрати
+- Переключіть основну модель на GLM/MiniMax
+- Використовуйте безкоштовний рівень (Gemini CLI, iFlow) для некритичних завдань
 
-</details>
+**Інформаційна панель відкривається через неправильний порт**
 
----
+- Встановити `PORT=20128` та `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
 
-## 🧪 Оцінки (Evals)
+**Помилки хмарної синхронізації**
 
-OmniRoute містить вбудовану систему оцінювання для перевірки якості відповіді LLM на відповідність золотому набору. Доступ до нього через **Аналітика → Оцінки** на інформаційній панелі.
+- Переконайтеся, що `BASE_URL` вказує на ваш запущений екземпляр
+- Перевірте `CLOUD_URL` вказує на очікувану кінцеву точку хмари
+- Зберігайте значення `NEXT_PUBLIC_*` у відповідності зі значеннями на стороні сервера
 
-### Вбудований Золотий набір
+**Перший вхід не працює**
 
-Попередньо завантажений "Золотий набір OmniRoute" містить 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,61 +964,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
 
 > Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
 
----
-
-## 🐛 Усунення несправностей
-
-<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>
 
 ---
@@ -1154,85 +1106,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 reserve automático.
-
-_Універсальний проксі-сервер API — кінцева точка, 36+ постачальників, нуль простоїв._
-
-### 🌐 Internacionalização (i18n)
-
-Інформаційна панель OmniRoute підтримує **багато ідіом**. Актуально доступні:
-
-| Ідіома                  | Código  | Статус   |
-| ----------------------- | ------- | -------- |
-| 🇺🇸 англійська           | `en`    | ✅ Повне |
-| 🇧🇷 Português (Бразилія) | `pt-BR` | ✅ Повне |
-
-**Параметр троакар або ідіома:** Натисніть без вибору ідіоми (🇺🇸 EN) без заголовка на інформаційній панелі → вибір ідіоми.
-
-**Para adicionar um nova 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** — Зменшити налаштування та затримку
-- **OAuth automático** — автоматичне оновлення токенів
-- **Combos personalizados** — 6 estratégias de roteamento
-- **Помна панель приладів** — Моніторинг, журнали, аналізи, конфігурації
-- **Інструменти CLI** — налаштуйте Claude Code, Codex, Cursor, Cline за допомогою кліка
-- **100% TypeScript** — Código limpo e tipado
-
-### 📖 Documentação
-
-| Documento                                       | Опис                                  |
-| ----------------------------------------------- | ------------------------------------- |
-| [Guia do Usuário](docs/USER_GUIDE.md)           | Провідори, комбо, CLI, розгортання    |
-| [Referência da API](docs/API_REFERENCE.md)      | Усі кінцеві точки з прикладами        |
-| [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)                 | 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) — Тир 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/>