omniroute 1.6.3 → 1.6.5

package/README.th.md

@@ -3,8 +3,6 @@
   
   # 🚀 OmniRoute — เกตเวย์ AI ฟรี
 
-🌐 **[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 ชั่วโมงทุกวัน ไม่มีการหยุดชะงัก"
-
-**ปัญหา:** กำหนดเวลา ไม่สามารถหยุดการทำงานได้
-
-```
-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...
-```
-
----
-
 ## 💡 คุณสมบัติที่สำคัญ
 
 ### 🧠 การกำหนดเส้นทางหลักและความฉลาด
@@ -494,6 +455,67 @@ OmniRoute มี Translator Playground ในตัวอันทรงพล
 
 ---
 
+## 🎯 กรณีการใช้งาน
+
+### กรณีที่ 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 ชั่วโมงทุกวัน ไม่มีการหยุดชะงัก"
+
+**ปัญหา:** กำหนดเวลา ไม่สามารถหยุดการทำงานได้
+
+```
+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>
@@ -768,98 +790,80 @@ 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`
-
-**ราศีเมถุน CLI (`gc/`)** - ฟรี:
-
-- `gc/gemini-3-flash-preview`
-- `gc/gemini-2.5-pro`
+## 🧪 การประเมินผล (Evals)
 
-**โปรแกรมควบคุม GitHub (`gh/`)**:
+OmniRoute มีกรอบการประเมินในตัวเพื่อทดสอบคุณภาพการตอบสนองของ LLM เทียบกับชุดทอง เข้าถึงได้ผ่านทาง **Analytics → Evals** ในแดชบอร์ด
 
-- `gh/gpt-5`
-- `gh/claude-4.5-sonnet`
+### ชุดทองในตัว
 
-**NVIDIA NIM (`nvidia/`)** - เครดิตฟรี:
+"OmniRoute Golden Set" ที่โหลดไว้ล่วงหน้าประกอบด้วยกรณีทดสอบ 10 กรณีที่ครอบคลุม:
 
-- `nvidia/llama-3.3-70b-instruct`
-- `nvidia/mistral-7b-instruct`
-- มากกว่า 50 รุ่นบน [build.nvidia.com](https://build.nvidia.com)
+- คำทักทาย คณิตศาสตร์ ภูมิศาสตร์ การสร้างโค้ด
+- การปฏิบัติตามรูปแบบ JSON, การแปล, มาร์กดาวน์
+- การปฏิเสธอย่างปลอดภัย (เนื้อหาที่เป็นอันตราย) การนับ ตรรกะบูลีน
 
-**GLM (`glm/`)** - $0.6/1M:
+### กลยุทธ์การประเมินผล
 
-- `glm/glm-4.7`
+| กลยุทธ์    | คำอธิบาย                                                           | ตัวอย่าง                         |
+| ---------- | ------------------------------------------------------------------ | -------------------------------- |
+| `exact`    | ผลลัพธ์จะต้องตรงกันทุกประการ                                       | `"4"`                            |
+| `contains` | เอาต์พุตจะต้องมีสตริงย่อย (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) | `"Paris"`                        |
+| `regex`    | เอาต์พุตต้องตรงกับรูปแบบ regex                                     | `"1.*2.*3"`                      |
+| `custom`   | ฟังก์ชัน JS แบบกำหนดเองส่งคืนค่า true/false                        | `(output) => output.length > 10` |
 
-**มินิแม็กซ์ (`minimax/`)** - $0.2/1M:
+---
 
-- `minimax/MiniMax-M2.1`
+## 🐛 การแก้ไขปัญหา
 
-**iFlow (`if/`)** - ฟรี:
+<details>
+<summary><b>คลิกเพื่อขยายคำแนะนำการแก้ปัญหา</b></summary>
+**"โมเดลภาษาไม่ได้ระบุข้อความ"**
 
-- `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`
 
-## 🧪 การประเมินผล (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`    | เอาต์พุตต้องตรงกับรูปแบบ regex                                     | `"1.*2.*3"`                      |
-| `custom`   | ฟังก์ชัน JS แบบกำหนดเองส่งคืนค่า true/false                        | `(output) => output.length > 10` |
+**การทดสอบการเชื่อมต่อแสดงว่า "ไม่ถูกต้อง" สำหรับผู้ให้บริการที่รองรับ OpenAI**
 
----
+- ผู้ให้บริการหลายรายไม่เปิดเผยปลายทาง `/models`
+- OmniRoute v1.0.6+ มีการตรวจสอบทางเลือกผ่านการแชทให้เสร็จสิ้น
+- ตรวจสอบให้แน่ใจว่า URL ฐานมีคำต่อท้าย `/v1`
 
-## 🔐 OAuth ในเซิร์ฟเวอร์ Remoto (การตั้งค่า OAuth ระยะไกล)
+### 🔐 OAuth ในเซิร์ฟเวอร์ Remoto (การตั้งค่า OAuth ระยะไกล)
 
 <a name="oauth-em-servidor-remoto"></a>
 
@@ -950,58 +954,6 @@ Se não quiser criar credenciais próprias agora, ainda é possível usar o flux
 
 > วิธีแก้ปัญหาเบื้องต้นคือทำการเปลี่ยนเส้นทางโดยอัตโนมัติและทำการเปลี่ยนเส้นทางโดยอัตโนมัติ
 
----
-
-## 🐛 การแก้ไขปัญหา
-
-<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>
 
 ---
@@ -1143,85 +1095,6 @@ gh release create v1.0.6 --title "v1.0.6" --generate-notes
 
 ---
 
----
-
-## 🇧🇷 OmniRoute — เกตเวย์ IA ฟรี
-
-<a name="-omniroute--gateway-de-ia-gratuito"></a>
-
-### นันคา พาเร เด โคดาร์. อัจฉริยะสำหรับ **แบบจำลอง IA ฟรีและการปรับแต่ง** com ทางเลือกอัตโนมัติ
-
-_Seu proxy universal de API — อืม endpoint, 36+ พิสูจน์แล้ว, ศูนย์หยุดทำงาน._
-
-### 🌐 อินเตอร์นาซิอองนาลลิซาเซา (i18n)
-
-O แดชบอร์ดรองรับ OmniRoute **múltiplos idiomas** สาเหตุที่แท้จริงคือ:
-
-| ไอดิโอมา             | โคดิโก้ | สถานะ  |
-| -------------------- | ------- | ------ |
-| 🇮🇩 อังกฤษ            | `en`    | ✅ ครบ |
-| 🇧🇷 โปรตุเกส (บราซิล) | `pt-BR` | ✅ ครบ |
-
-**Para trocar o idioma:** Clique no seletor de idioma (USA) no header do Dashboard → selecione o idioma desejado.
-
-**สำหรับการอ้างอิง um novo idioma:**
-
-1. ร้องไห้ `src/i18n/messages/{codigo}.json` ฐาน `en.json`
-2. อ้างอิงถึง `src/i18n/config.ts` → `LOCALES` และ `LANGUAGES`
-3. Reinicie หรือผู้รับใช้
-
-### ⚡ Início Rapido
-
-```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
-
-- ** IA มากกว่า 36 รายการ ** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek และอีเมลอื่น ๆ
-- **Roteamento inteligente** — ทางเลือกสำรองอัตโนมัติ
-- **รูปแบบการจัดรูปแบบ** — OpenAI ↔ Claude ↔ Gemini automaticamente
-- **หลายคอนตา** — Múltiplas contas por provendor com seleção inteligente
-- **ความหมายแคช** — Reduz custos e latência
-- **OAuth automático** — โทเค็นปรับปรุงอัตโนมัติ
-- **คอมโบส่วนบุคคล** — 6 estratégias de roteamento
-- **แดชบอร์ดที่สมบูรณ์** — การตรวจสอบ บันทึก การวิเคราะห์ การกำหนดค่า
-- **เครื่องมือ CLI** — กำหนดค่ารหัส Claude, Codex, เคอร์เซอร์, ไคลน์
-- **TypeScript100%** — รวดเร็วทันใจ
-
-### 📖 เอกสารประกอบ
-
-| เอกสาร                                          | คำอธิบาย                          |
-| ----------------------------------------------- | --------------------------------- |
-| [Guia do Usuário](docs/USER_GUIDE.md)           | Provedores, คอมโบ, CLI, ปรับใช้   |
-| [Referência da API](docs/API_REFERENCE.md)      | Todos os endpoints 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  |
-
-### 📧 สนับสนุน
-
-> 💬 **เริ่มต้นการเดินทาง!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tyre 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/>