OmniRoute Dashboard # ๐Ÿš€ OmniRoute โ€” Gerbang AI Percuma ### Jangan sekali-kali berhenti mengekod. Penghalaan pintar ke **model AI PERCUMA & kos rendah** dengan sandaran automatik. _Proksi API universal anda โ€” satu titik akhir, 36+ pembekal, masa henti sifar._ **Penyelesaian Sembang โ€ข Pembenaman โ€ข Penjanaan Imej โ€ข Audio โ€ข Kedudukan Semula โ€ข 100% TypeScript** --- ### ๐Ÿค– Pembekal AI percuma untuk ejen pengekodan kegemaran anda _Sambungkan mana-mana alat IDE atau CLI berkuasa AI melalui OmniRoute โ€” get laluan API percuma untuk pengekodan tanpa had._
OpenClaw
OpenClaw
โญ 205K 		NanoBot
NanoBot
โญ 20.9K 		PicoClaw
PicoClaw
โญ 14.6K 		ZeroClaw
ZeroClaw
โญ 9.9K 		IronClaw
IronClaw
โญ 2.1K
OpenCode
OpenCode
โญ 106K 		Codex CLI
Codex CLI
โญ 60.8K 		Claude Code
Claude Code
โญ 67.3K 		Gemini CLI
Gemini CLI
โญ 94.7K 		Kilo Code
Kilo Code
โญ 15.5K
๐Ÿ“ก Semua ejen menyambung melalui http://localhost:20128/v1 atau http://cloud.omniroute.online/v1 atau model http://cloud.omniroute.online/v1 โ€”i_24_TOKEN dan satu โ€”i_konfigurasi kuota --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [๐ŸŒ Website](https://omniroute.online) โ€ข [๐Ÿš€ Quick Start](#-quick-start) โ€ข [๐Ÿ’ก Features](#-key-features) โ€ข [๐Ÿ“– Docs](#-documentation) โ€ข [๐Ÿ’ฐ Pricing](#-pricing-at-a-glance) โ€ข [๐Ÿ’ฌ WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) ๐ŸŒ **Available in:** ๐Ÿ‡บ๐Ÿ‡ธ [English](README.md) | ๐Ÿ‡ง๐Ÿ‡ท [Portuguรชs (Brasil)](README.pt-BR.md) | ๐Ÿ‡ช๐Ÿ‡ธ [Espaรฑol](README.es.md) | ๐Ÿ‡ซ๐Ÿ‡ท [Franรงais](README.fr.md) | ๐Ÿ‡ฎ๐Ÿ‡น [Italiano](README.it.md) | ๐Ÿ‡ท๐Ÿ‡บ [ะ ัƒััะบะธะน](README.ru.md) | ๐Ÿ‡จ๐Ÿ‡ณ [ไธญๆ–‡ (็ฎ€ไฝ“)](README.zh-CN.md) | ๐Ÿ‡ฉ๐Ÿ‡ช [Deutsch](README.de.md) | ๐Ÿ‡ฎ๐Ÿ‡ณ [เคนเคฟเคจเฅเคฆเฅ€](README.in.md) | ๐Ÿ‡น๐Ÿ‡ญ [เน„เธ—เธข](README.th.md) | ๐Ÿ‡บ๐Ÿ‡ฆ [ะฃะบั€ะฐั—ะฝััŒะบะฐ](README.uk-UA.md) | ๐Ÿ‡ธ๐Ÿ‡ฆ [ุงู„ุนุฑุจูŠุฉ](README.ar.md) | ๐Ÿ‡ฏ๐Ÿ‡ต [ๆ—ฅๆœฌ่ชž](README.ja.md) | ๐Ÿ‡ป๐Ÿ‡ณ [Tiแบฟng Viแป‡t](README.vi.md) | ๐Ÿ‡ง๐Ÿ‡ฌ [ะ‘ัŠะปะณะฐั€ัะบะธ](README.bg.md) | ๐Ÿ‡ฉ๐Ÿ‡ฐ [Dansk](README.da.md) | ๐Ÿ‡ซ๐Ÿ‡ฎ [Suomi](README.fi.md) | ๐Ÿ‡ฎ๐Ÿ‡ฑ [ืขื‘ืจื™ืช](README.he.md) | ๐Ÿ‡ญ๐Ÿ‡บ [Magyar](README.hu.md) | ๐Ÿ‡ฎ๐Ÿ‡ฉ [Bahasa Indonesia](README.id.md) | ๐Ÿ‡ฐ๐Ÿ‡ท [ํ•œ๊ตญ์–ด](README.ko.md) | ๐Ÿ‡ฒ๐Ÿ‡พ [Bahasa Melayu](README.ms.md) | ๐Ÿ‡ณ๐Ÿ‡ฑ [Nederlands](README.nl.md) | ๐Ÿ‡ณ๐Ÿ‡ด [Norsk](README.no.md) | ๐Ÿ‡ต๐Ÿ‡น [Portuguรชs (Portugal)](README.pt.md) | ๐Ÿ‡ท๐Ÿ‡ด [Romรขnฤƒ](README.ro.md) | ๐Ÿ‡ต๐Ÿ‡ฑ [Polski](README.pl.md) | ๐Ÿ‡ธ๐Ÿ‡ฐ [Slovenฤina](README.sk.md) | ๐Ÿ‡ธ๐Ÿ‡ช [Svenska](README.sv.md) | ๐Ÿ‡ต๐Ÿ‡ญ [Filipino](README.phi.md)
--- ## ๐Ÿ–ผ๏ธ
OmniRoute
--- ## ๐Ÿ“ธ
... | # | # | | ----- | ---------------------------------------- | | **1** | ![1](docs/screenshots/01-providers.png) | | **2** | ![2](docs/screenshots/02-combos.png) | | **3** | ![3](docs/screenshots/03-analytics.png) | | **4** | ![4](docs/screenshots/04-health.png) | | **5** | ![5](docs/screenshots/05-translator.png) | | **6** | ![6](docs/screenshots/06-settings.png) | | **7** | ![7](docs/screenshots/07-cli-tools.png) | | **8** | ![8](docs/screenshots/08-usage.png) | | **9** | ![9](docs/screenshots/09-endpoint.png) |
--- ## ๐Ÿค” Mengapa OmniRoute? **Berhenti membazir wang dan mencapai had:** - Kuota langganan tamat tempoh tidak digunakan setiap bulan - Had kadar menghalang anda pertengahan pengekodan - API Mahal ($20-50/bulan bagi setiap pembekal) - Pertukaran manual antara pembekal **OmniRoute menyelesaikan ini:** - โœ… **Maksimumkan langganan** - Jejaki kuota, gunakan setiap bit sebelum ditetapkan semula - โœ… **Auto sandaran** - Langganan โ†’ Kunci API โ†’ Murah โ†’ Percuma, masa henti sifar - โœ… **Berbilang akaun** - Round-robin antara akaun bagi setiap pembekal - โœ… **Universal** - Berfungsi dengan Kod Claude, Codex, Gemini CLI, Kursor, Cline, OpenClaw, sebarang alat CLI --- ## ๐Ÿ“ง Sokongan > ๐Ÿ’ฌ **Sertai komuniti kami!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) โ€” Dapatkan bantuan, kongsi petua dan kekal kemas kini. - **Laman web**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **Isu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **Projek Asal**: [9router by decolua](https://github.com/decolua/9router) --- ## ๐Ÿ”„ Cara Ia Berfungsi ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Your CLI โ”‚ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) โ”‚ Tool โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ http://localhost:20128/v1 โ†“ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ OmniRoute (Smart Router) โ”‚ โ”‚ โ€ข Format translation (OpenAI โ†” Claude) โ”‚ โ”‚ โ€ข Quota tracking + Embeddings + Images โ”‚ โ”‚ โ€ข Auto token refresh โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”œโ”€โ†’ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI โ”‚ โ†“ quota exhausted โ”œโ”€โ†’ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. โ”‚ โ†“ budget limit โ”œโ”€โ†’ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) โ”‚ โ†“ budget limit โ””โ”€โ†’ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited) Result: Never stop coding, minimal cost ``` --- ## ๐ŸŽฏ Perkara yang Selesaikan OmniRoute โ€” 30 Titik Sakit Nyata & Kes Penggunaan > **Setiap pembangun yang menggunakan alatan AI menghadapi masalah ini setiap hari.** OmniRoute dibina untuk menyelesaikan kesemuanya โ€” daripada lebihan kos kepada blok serantau, daripada aliran OAuth yang rosak kepada operasi protokol dan kebolehmerhatian perusahaan.
๐Ÿ’ธ 1. "Saya membayar untuk langganan yang mahal tetapi masih terganggu oleh had" Pembangun membayar $20โ€“200/bulan untuk Claude Pro, Codex Pro atau GitHub Copilot. Walaupun membayar, kuota mempunyai siling โ€” 5j penggunaan, had mingguan atau had kadar seminit. Sesi pertengahan pengekodan, pembekal berhenti bertindak balas dan pembangun kehilangan aliran dan produktiviti. **Cara OmniRoute menyelesaikannya:** - **Smart 4-Tier Fallback** โ€” Jika kuota langganan habis, diubah hala secara automatik ke API Key โ†’ Murah โ†’ Percuma tanpa campur tangan manual - **Penjejakan Kuota Masa Nyata** โ€” Menunjukkan penggunaan token dalam masa nyata dengan kira detik tetapan semula (5j, harian, mingguan) - **Sokongan Berbilang Akaun** โ€” Berbilang akaun bagi setiap pembekal dengan auto round-robin โ€” apabila satu kehabisan, beralih kepada yang seterusnya - **Kombo Tersuai** โ€” Rantaian sandaran yang boleh disesuaikan dengan 6 strategi pengimbangan (isi dahulu, round-robin, P2C, rawak, paling kurang digunakan, dioptimumkan kos) - **Kuota Perniagaan Codex** โ€” Pemantauan kuota ruang kerja Perniagaan/Pasukan terus dalam papan pemuka
๐Ÿ”Œ 2. "Saya perlu menggunakan berbilang penyedia tetapi setiap satu mempunyai API yang berbeza" OpenAI menggunakan satu format, Claude (Anthropic) menggunakan satu lagi, Gemini satu lagi. Jika pembangun ingin menguji model daripada pembekal yang berbeza atau sandaran antara mereka, mereka perlu mengkonfigurasi semula SDK, menukar titik akhir, menangani format yang tidak serasi. Pembekal tersuai (FriendLI, NIM) mempunyai titik akhir model bukan standard. **Cara OmniRoute menyelesaikannya:** - **Titik Akhir Disatukan** โ€” Satu `http://localhost:20128/v1` berfungsi sebagai proksi untuk kesemua 36+ pembekal - **Format Terjemahan** โ€” Automatik dan telus: OpenAI โ†” Claude โ†” Gemini โ†” Responses API - **Pembersihan Tindak Balas** โ€” Mengosongkan medan bukan standard (`x_groq`, `usage_breakdown`, `service_tier`) yang memecahkan OpenAI SDK v1.83+ - **Penormalan Peranan** โ€” Menukar `developer` โ†’ `system` untuk penyedia bukan OpenAI; `system` โ†’ `user` untuk GLM/ERNIE - **Think Tag Extraction** โ€” Mengekstrak blok `` daripada model seperti DeepSeek R1 ke dalam `reasoning_content` standard - **Output Berstruktur untuk Gemini** โ€” `json_schema` โ†’ `responseMimeType`/`responseSchema` penukaran automatik - **`stream` lalai kepada `false`** โ€” Menjajarkan dengan spesifikasi OpenAI, mengelakkan SSE yang tidak dijangka dalam Python/Rust/Go SDK
๐ŸŒ 3. "Pembekal AI saya menyekat wilayah/negara saya" Penyedia seperti OpenAI/Codex menyekat akses daripada kawasan geografi tertentu. Pengguna mendapat ralat seperti `unsupported_country_region_territory` semasa sambungan OAuth dan API. Ini amat mengecewakan bagi pemaju dari negara membangun. **Cara OmniRoute menyelesaikannya:** - **Konfigurasi Proksi 3 Tahap** โ€” Proksi boleh dikonfigurasikan pada 3 peringkat: global (semua trafik), setiap pembekal (satu pembekal sahaja) dan setiap sambungan/kunci - **Lencana Proksi Berkod Warna** โ€” Penunjuk visual: ๐ŸŸข proksi global, ๐ŸŸก proksi pembekal, ๐Ÿ”ต proksi sambungan, sentiasa menunjukkan IP - **Pertukaran Token OAuth Melalui Proksi** โ€” Aliran OAuth juga melalui proksi, menyelesaikan `unsupported_country_region_territory` - **Ujian Sambungan melalui Proksi** โ€” Ujian sambungan menggunakan proksi yang dikonfigurasikan (tiada lagi pintasan langsung) - **Sokongan SOCKS5** โ€” Sokongan proksi SOCKS5 penuh untuk penghalaan keluar - **TLS Fingerprint Spoofing** โ€” Cap jari TLS seperti pelayar melalui `wreq-js` untuk memintas pengesanan bot
๐Ÿ†“ 4. "Saya mahu menggunakan AI untuk pengekodan tetapi saya tidak mempunyai wang" Tidak semua orang boleh membayar $20โ€“200/bulan untuk langganan AI. Pelajar, pembangun dari negara baru muncul, penggemar dan pekerja bebas memerlukan akses kepada model berkualiti pada kos sifar. **Cara OmniRoute menyelesaikannya:** - **Pembekal Peringkat Percuma Terbina dalam** โ€” Sokongan asli untuk 100% pembekal percuma: iFlow (8 model tanpa had), Qwen (3 model tanpa had), Kiro (Claude secara percuma), Gemini CLI (180K/bulan percuma) - **Kombo Percuma Sahaja** โ€” Rantaian `gc/gemini-3-flash โ†’ if/kimi-k2-thinking โ†’ qw/qwen3-coder-plus` = $0/bulan dengan masa henti sifar - **Kredit Percuma NVIDIA NIM** โ€” 1000 kredit percuma disepadukan - **Strategi Dioptimumkan Kos** โ€” Strategi penghalaan yang secara automatik memilih pembekal yang tersedia paling murah
๐Ÿ”’ 5. "Saya perlu melindungi gerbang AI saya daripada akses tanpa kebenaran" Apabila mendedahkan get laluan AI kepada rangkaian (LAN, VPS, Docker), sesiapa sahaja yang mempunyai alamat boleh menggunakan token/kuota pembangun. Tanpa perlindungan, API terdedah kepada penyalahgunaan, suntikan segera dan penyalahgunaan. **Cara OmniRoute menyelesaikannya:** - **Pengurusan Kunci API** โ€” Penjanaan, penggiliran dan skop setiap pembekal dengan halaman `/dashboard/api-manager` khusus - **Kebenaran Tahap Model** โ€” Hadkan kunci API kepada model tertentu (`openai/*`, corak kad bebas), dengan Togol Benarkan Semua/Sekat - **Perlindungan Titik Akhir API** โ€” Memerlukan kunci untuk `/v1/models` dan menyekat penyedia tertentu daripada penyenaraian - **Auth Guard + CSRF Protection** โ€” Semua laluan papan pemuka dilindungi dengan `withAuth` middleware + token CSRF - **Penghad Kadar** โ€” Pengehadan kadar Per-IP dengan tetingkap boleh dikonfigurasikan - **Penapisan IP** โ€” Senarai Benar/senarai sekat untuk kawalan akses - **Pengawal Suntikan Segera** โ€” Pensanitasi terhadap corak segera yang berniat jahat - **Penyulitan AES-256-GCM** โ€” Bukti kelayakan disulitkan semasa rehat
๐Ÿ›‘ 6. "Pembekal saya gagal dan saya kehilangan aliran pengekodan saya" Pembekal AI boleh menjadi tidak stabil, mengembalikan ralat 5xx atau mencapai had kadar sementara. Jika pembangun bergantung pada penyedia tunggal, mereka akan terganggu. Tanpa pemutus litar, percubaan semula berulang boleh ranap aplikasi. **Cara OmniRoute menyelesaikannya:** - **Pemutus Litar bagi setiap pembekal** โ€” Auto buka/tutup dengan ambang boleh dikonfigurasikan dan cooldown (Ditutup/Buka/Separuh Terbuka) - **Penyingkiran Eksponen** โ€” Kelewatan percubaan semula progresif - **Kawanan Anti Gemuruh** โ€” Mutex + perlindungan semafor terhadap ribut percubaan semula serentak - **Kombo Rantai Sandar** โ€” Jika pembekal utama gagal, secara automatik jatuh melalui rantaian tanpa campur tangan - **Pemutus Litar Kombo** โ€” Lumpuhkan automatik pembekal yang gagal dalam rantaian kombo - **Papan Pemuka Kesihatan** โ€” Pemantauan masa aktif, keadaan pemutus litar, penguncian, statistik cache, kependaman p50/p95/p99
๐Ÿ”ง 7. "Mengkonfigurasi setiap alat AI adalah membosankan dan berulang" Pembangun menggunakan Kursor, Kod Claude, Codex CLI, OpenClaw, Gemini CLI, Kod Kilo... Setiap alat memerlukan konfigurasi yang berbeza (titik akhir API, kunci, model). Mengkonfigurasi semula apabila menukar pembekal atau model adalah membuang masa. **Cara OmniRoute menyelesaikannya:** - **Papan Pemuka Alat CLI** โ€” Halaman khusus dengan persediaan satu klik untuk Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** โ€” Menghasilkan `chatLanguageModels.json` untuk Kod VS dengan pemilihan model pukal - **Onboarding Wizard** โ€” Persediaan 4 langkah berpandu untuk pengguna kali pertama - **Satu titik akhir, semua model** โ€” Konfigurasikan `http://localhost:20128/v1` sekali, akses 36+ pembekal
๐Ÿ”‘ 8. "Menguruskan token OAuth daripada berbilang penyedia adalah neraka" Kod Claude, Codex, Gemini CLI, Copilot โ€” semuanya menggunakan OAuth 2.0 dengan token tamat tempoh. Pembangun perlu sentiasa mengesahkan semula, menangani `client_secret is missing`, `redirect_uri_mismatch` dan kegagalan pada pelayan jauh. OAuth pada LAN/VPS amat bermasalah. **Cara OmniRoute menyelesaikannya:** - **Muat Semula Token Auto** โ€” Token OAuth dimuat semula di latar belakang sebelum tamat tempoh - **OAuth 2.0 (PKCE) Terbina dalam** โ€” Aliran automatik untuk Kod Claude, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **OAuth Berbilang Akaun** โ€” Berbilang akaun bagi setiap pembekal melalui pengekstrakan token JWT/ID - **OAuth LAN/Remote Fix** โ€” Pengesanan IP peribadi untuk `redirect_uri` + mod URL manual untuk pelayan jauh - **OAuth Behind Nginx** โ€” Menggunakan `window.location.origin` untuk keserasian proksi terbalik - **Panduan OAuth Jauh** โ€” Panduan langkah demi langkah untuk kelayakan Google Cloud pada VPS/Docker
๐Ÿ“Š 9. "Saya tidak tahu berapa banyak yang saya belanjakan atau di mana" Pembangun menggunakan berbilang penyedia berbayar tetapi tidak mempunyai pandangan bersatu tentang perbelanjaan. Setiap pembekal mempunyai papan pemuka pengebilan sendiri, tetapi tiada paparan disatukan. Kos yang tidak dijangka boleh bertimbun. **Cara OmniRoute menyelesaikannya:** - **Papan Pemuka Analitis Kos** โ€” Penjejakan kos per-token dan pengurusan belanjawan bagi setiap pembekal - **Had Belanjawan setiap Peringkat** โ€” Siling perbelanjaan setiap peringkat yang mencetuskan sandaran automatik - **Konfigurasi Harga Per-Model** โ€” Harga boleh dikonfigurasikan bagi setiap model - **Statistik Penggunaan Setiap Kunci API** โ€” Kiraan permintaan dan cap masa yang terakhir digunakan setiap kunci - **Papan Pemuka Analitik** โ€” Kad statistik, carta penggunaan model, jadual pembekal dengan kadar kejayaan dan kependaman
๐Ÿ› 10. "Saya tidak dapat mendiagnosis ralat dan masalah dalam panggilan AI" Apabila panggilan gagal, pembangun tidak tahu sama ada ia adalah had kadar, token tamat tempoh, format yang salah atau ralat pembekal. Log berpecah-belah merentasi terminal yang berbeza. Tanpa pemerhatian, penyahpepijatan adalah percubaan-dan-ralat. **Cara OmniRoute menyelesaikannya:** - **Papan Pemuka Log Bersatu** โ€” 4 tab: Log Permintaan, Log Proksi, Log Audit, Konsol - **Pemapar Log Konsol** โ€” Pemapar gaya terminal masa nyata dengan tahap berkod warna, tatal automatik, carian, penapis - **Log Proksi SQLite** โ€” Log berterusan yang bertahan dimulakan semula - **Taman Permainan Penterjemah** โ€” 4 mod nyahpepijat: Taman Permainan (terjemahan format), Penguji Sembang (perjalanan pergi balik), Bangku Ujian (batch), Monitor Langsung (masa nyata) - **Permintaan Telemetri** โ€” kependaman p50/p95/p99 + pengesanan X-Request-Id - **Pengelogan Berasaskan Fail dengan Putaran** โ€” Pemintas konsol menangkap segala-galanya ke log JSON dengan putaran berasaskan saiz
๐Ÿ—๏ธ 11. "Menyedia dan menyelenggara gerbang adalah rumit" Memasang, mengkonfigurasi dan menyelenggara proksi AI merentas persekitaran yang berbeza (tempatan, VPS, Docker, awan) adalah intensif buruh. Masalah seperti laluan berkod keras, `EACCES` pada direktori, konflik port dan binaan merentas platform menambah geseran. **Cara OmniRoute menyelesaikannya:** - **pemasangan global npm** โ€” `npm install -g omniroute && omniroute` โ€” selesai - **Docker Multi-Platform** โ€” AMD64 + ARM64 asli (Apple Silicon, AWS Graviton, Raspberry Pi) - **Profil Karang Docker** โ€” `base` (tiada alat CLI) dan `cli` (dengan Kod Claude, Codex, OpenClaw) - **Apl Desktop Elektron** โ€” Apl asli untuk Windows/macOS/Linux dengan dulang sistem, auto mula, mod luar talian - **Mod Split-Port** โ€” API dan Papan Pemuka pada port berasingan untuk senario lanjutan (proksi terbalik, rangkaian kontena) - **Cloud Sync** โ€” Konfigurasikan penyegerakan merentas peranti melalui Cloudflare Workers - **Sandaran DB** โ€” Sandaran automatik, pulihkan, eksport dan import semua tetapan
๐ŸŒ 12. "Antara muka adalah bahasa Inggeris sahaja dan pasukan saya tidak berbahasa Inggeris" Pasukan di negara bukan berbahasa Inggeris, terutamanya di Amerika Latin, Asia dan Eropah, bergelut dengan antara muka bahasa Inggeris sahaja. Halangan bahasa mengurangkan penggunaan dan meningkatkan ralat konfigurasi. **Cara OmniRoute menyelesaikannya:** - **Papan pemuka i18n โ€” 30 Bahasa** โ€” Semua 500+ kunci diterjemahkan termasuk bahasa Arab, Bulgaria, Denmark, Jerman, Sepanyol, Finland, Perancis, Ibrani, Hindi, Hungary, Indonesia, Itali, Jepun, Korea, Melayu, Belanda, Norway, Poland, Portugis (PT/BR), Romania, Rusia, Slovak, Sweden, Thai, Ukraine, Vietnam, Cina - **Sokongan RTL** โ€” Sokongan kanan ke kiri untuk bahasa Arab dan Ibrani - **README Berbilang Bahasa** โ€” 30 terjemahan dokumentasi lengkap - **Pemilih Bahasa** โ€” Ikon Glob dalam pengepala untuk penukaran masa nyata
๐Ÿ”„ 13. "Saya perlukan lebih daripada sembang โ€” saya perlukan benam, imej, audio" AI bukan sekadar penyelesaian sembang. Pembangun perlu menjana imej, menyalin audio, membuat pembenaman untuk RAG, menyusun semula dokumen dan kandungan sederhana. Setiap API mempunyai titik akhir dan format yang berbeza. **Cara OmniRoute menyelesaikannya:** - **Pembenaman** โ€” `/v1/embeddings` dengan 6 pembekal dan 9+ model - **Penjanaan Imej** โ€” `/v1/images/generations` dengan 10 pembekal dan 20+ model (OpenAI, xAI, Together, Bunga Api, Nebius, Hiperbolik, NanoBanana, Antigraviti, SD WebUI, ComfyUI) - **Teks-ke-Video** โ€” `/v1/videos/generations` โ€” ComfyUI (AnimateDiff, SVD) dan SD WebUI - **Teks-ke-Muzik** โ€” `/v1/music/generations` โ€” ComfyUI (Audio Terbuka, MusicGen) - **Transkripsi Audio** โ€” `/v1/audio/transcriptions` โ€” Whisper + Nvidia NIM, HuggingFace, Qwen3 - **Teks-ke-Ucapan** โ€” `/v1/audio/speech` โ€” ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3, + pembekal sedia ada - **Moderasi** โ€” `/v1/moderations` โ€” Pemeriksaan keselamatan kandungan - **Penyusunan semula** โ€” `/v1/rerank` โ€” Penyusunan semula perkaitan dokumen - **Respons API** โ€” Sokongan penuh `/v1/responses` untuk Codex
๐Ÿงช 14. "Saya tiada cara untuk menguji dan membandingkan kualiti merentas model" Pembangun ingin mengetahui model mana yang terbaik untuk kes penggunaan mereka โ€” kod, terjemahan, penaakulan โ€” tetapi membandingkan secara manual adalah perlahan. Tiada alat eval bersepadu wujud. **Cara OmniRoute menyelesaikannya:** - **LLM Evaluations** โ€” Ujian set emas dengan 10 kes pra-muat meliputi salam, matematik, geografi, penjanaan kod, pematuhan JSON, terjemahan, penurunan harga, penolakan keselamatan - **4 Strategi Padanan** โ€” `exact`, `contains`, `regex`, `custom` (fungsi JS) - **Bangku Ujian Taman Permainan Penterjemah** โ€” Ujian kelompok dengan berbilang input dan output yang dijangka, perbandingan merentas pembekal - **Penguji Sembang** โ€” Perjalanan pergi balik penuh dengan pemaparan respons visual - **Pantau Langsung** โ€” Strim masa nyata semua permintaan yang mengalir melalui proksi
๐Ÿ“ˆ 15. "Saya perlu skala tanpa kehilangan prestasi" Apabila volum permintaan bertambah, tanpa menyimpan cache soalan yang sama menjana kos pendua. Tanpa idempotensi, pendua meminta pemprosesan sisa. Had kadar setiap pembekal mesti dipatuhi. **Cara OmniRoute menyelesaikannya:** - **Cache Semantik** โ€” Cache dua peringkat (tandatangan + semantik) mengurangkan kos dan kependaman - **Request Idempotency** โ€” tetingkap penyahduplikasi 5s untuk permintaan yang sama - **Pengesanan Had Kadar** โ€” RPM setiap pembekal, jurang min dan penjejakan serentak maks - **Had Kadar Boleh Diedit** โ€” Lalai boleh dikonfigurasikan dalam Tetapan โ†’ Ketahanan dengan kegigihan - **Cache Pengesahan Kunci API** โ€” Cache 3 peringkat untuk prestasi pengeluaran - **Papan Pemuka Kesihatan dengan Telemetri** โ€” kependaman p50/p95/p99, statistik cache, masa beroperasi
๐Ÿค– 16. "Saya mahu mengawal tingkah laku model secara global" Pembangun yang mahukan semua respons dalam bahasa tertentu, dengan nada tertentu atau ingin mengehadkan token penaakulan. Mengkonfigurasi ini dalam setiap alat/permintaan adalah tidak praktikal. **Cara OmniRoute menyelesaikannya:** - **System Prompt Injection** โ€” Gesaan global digunakan untuk semua permintaan - **Pengesahan Belanjawan Berfikir** โ€” Kawalan peruntukan token penaakulan setiap permintaan (laluan, auto, tersuai, adaptif) - **6 Strategi Penghalaan** โ€” Strategi global yang menentukan cara permintaan diedarkan - **Penghala Wildcard** โ€” Corak `provider/*` halakan secara dinamik kepada mana-mana pembekal - **Kombo Dayakan/Lumpuhkan Togol** โ€” Togol kombo terus dari papan pemuka - **Togol Pembekal** โ€” Dayakan/lumpuhkan semua sambungan untuk pembekal dengan satu klik - **Pembekal Disekat** โ€” Kecualikan pembekal khusus daripada penyenaraian `/v1/models`
๐Ÿงฐ 17. "Saya memerlukan alatan MCP sebagai keupayaan produk kelas pertama" Banyak get laluan AI mendedahkan MCP hanya sebagai butiran pelaksanaan tersembunyi. Pasukan memerlukan lapisan operasi yang boleh dilihat dan boleh diurus. **Cara OmniRoute menyelesaikannya:** - MCP muncul dalam navigasi papan pemuka dan tab protokol titik akhir - Halaman pengurusan MCP khusus dengan proses, alatan, skop dan audit - Permulaan pantas terbina dalam untuk `omniroute --mcp` dan onboarding pelanggan
๐Ÿง  18. "Saya memerlukan orkestrasi A2A dengan laluan tugas penyegerakan + aliran" Aliran kerja ejen memerlukan balasan langsung dan pelaksanaan strim jangka panjang dengan kawalan kitaran hayat. **Cara OmniRoute menyelesaikannya:** - Titik akhir A2A JSON-RPC (`POST /a2a`) dengan `message/send` dan `message/stream` - Penstriman SSE dengan penyebaran keadaan terminal - API kitaran hayat tugas untuk `tasks/get` dan `tasks/cancel`
๐Ÿ›ฐ๏ธ 19. "Saya memerlukan kesihatan proses MCP sebenar, bukan status yang diduga" Pasukan operasi perlu mengetahui sama ada MCP sebenarnya masih hidup, bukan hanya sama ada API boleh dicapai. **Cara OmniRoute menyelesaikannya:** - Fail degupan jantung masa jalan dengan PID, cap masa, pengangkutan, kiraan alat dan mod skop - API status MCP yang menggabungkan degupan jantung + aktiviti terkini - Kad status UI untuk kesegaran proses/masa hidup/degupan jantung
๐Ÿ“‹ 20. "Saya memerlukan pelaksanaan alat MCP yang boleh diaudit" Apabila alat mengubah konfigurasi atau mencetuskan tindakan ops, pasukan memerlukan kebolehkesanan forensik. **Cara OmniRoute menyelesaikannya:** - Pengelogan audit yang disokong SQLite untuk panggilan alat MCP - Tapis mengikut alat, kejayaan/kegagalan, kunci API dan penomboran - Jadual audit papan pemuka + titik akhir statistik untuk automasi
๐Ÿ” 21. "Saya memerlukan keizinan MCP berskop bagi setiap penyepaduan" Pelanggan yang berbeza harus mempunyai akses paling tidak istimewa kepada kategori alat. **Cara OmniRoute menyelesaikannya:** - 9 skop MCP berbutir untuk akses alat terkawal - Penguatkuasaan skop dan keterlihatan dalam UI pengurusan MCP - Postur lalai yang selamat untuk perkakas operasi
โš™๏ธ 22. "Saya memerlukan kawalan operasi tanpa mengatur semula" Pasukan memerlukan perubahan masa jalan yang cepat semasa insiden atau peristiwa kos. **Cara OmniRoute menyelesaikannya:** - Tukar pengaktifan kombo terus dari papan pemuka MCP - Gunakan profil daya tahan daripada pek dasar yang telah ditetapkan - Tetapkan semula keadaan pemutus litar daripada panel operasi yang sama
๐Ÿ”„ 23. "Saya memerlukan keterlihatan dan pembatalan kitaran hayat tugas A2A secara langsung" Tanpa keterlihatan kitaran hayat, insiden tugasan menjadi sukar untuk dicuba. **Cara OmniRoute menyelesaikannya:** - Penyenaraian tugas/penapisan mengikut keadaan/kemahiran dengan penomboran - Latih tubi tentang metadata tugas, peristiwa dan artifak - Titik akhir pembatalan tugas dan tindakan UI dengan pengesahan
๐ŸŒŠ 24. "Saya memerlukan metrik strim aktif untuk beban A2A" Aliran kerja penstriman memerlukan cerapan operasi tentang konkurensi dan sambungan langsung. **Cara OmniRoute menyelesaikannya:** - Kaunter aliran aktif disepadukan ke dalam status A2A - Cap masa tugas terakhir dan kiraan setiap negeri - Kad papan pemuka A2A untuk pemantauan operasi masa nyata
๐Ÿชช 25. "Saya memerlukan penemuan ejen standard untuk pelanggan" Pelanggan dan orkestra luar memerlukan metadata yang boleh dibaca mesin untuk onboarding. **Cara OmniRoute menyelesaikannya:** - Kad Agen terdedah pada `/.well-known/agent.json` - Keupayaan dan kemahiran ditunjukkan dalam UI pengurusan - API status A2A termasuk metadata penemuan untuk automasi
๐Ÿงญ 26. "Saya memerlukan kebolehtemuan protokol dalam produk UX" Jika pengguna tidak dapat menemui permukaan protokol, penggunaan dan kualiti sokongan akan menurun. **Cara OmniRoute menyelesaikannya:** - Entri bar sisi untuk MCP dan A2A - Tab Protokol halaman titik akhir dengan permulaan pantas dan status - Pautan dari gambaran keseluruhan ke papan pemuka pengurusan khusus
๐Ÿงช 27. "Saya memerlukan pengesahan protokol hujung ke hujung dengan pelanggan sebenar" Ujian olok-olok tidak mencukupi untuk mengesahkan keserasian protokol sebelum dikeluarkan. **Cara OmniRoute menyelesaikannya:** - Suite E2E yang but apl dan menggunakan pengangkutan pelanggan MCP SDK sebenar - Ujian pelanggan A2A untuk penemuan, menghantar, menstrim, mendapatkan dan membatalkan aliran - Periksa silang dakwaan terhadap audit MCP dan API tugasan A2A
๐Ÿ“ก 28. "Saya memerlukan pemerhatian bersatu merentas semua antara muka" Memisahkan kebolehmerhatian mengikut protokol mewujudkan titik buta dan MTTR yang lebih panjang. **Cara OmniRoute menyelesaikannya:** - Papan pemuka/log/analisis bersatu dalam satu produk - Kesihatan + audit + telemetri permintaan merentas lapisan OpenAI, MCP dan A2A - API Operasi untuk status dan automasi
๐Ÿ’ผ 29. "Saya memerlukan satu masa jalan untuk proksi + alatan + orkestrasi ejen" Menjalankan banyak perkhidmatan berasingan meningkatkan kos operasi dan mod kegagalan. **Cara OmniRoute menyelesaikannya:** - Proksi serasi OpenAI, pelayan MCP dan pelayan A2A dalam satu tindanan - Kebenaran dikongsi, daya tahan, stor data dan kebolehmerhatian - Model dasar yang konsisten merentas semua permukaan interaksi
๐Ÿš€ 30. "Saya perlu menghantar aliran kerja ejentik tanpa sebaran kod gam" Pasukan kehilangan halaju apabila mencantumkan berbilang perkhidmatan dan skrip ad-hoc. **Cara OmniRoute menyelesaikannya:** - Strategi titik akhir bersatu untuk pelanggan dan ejen - UI pengurusan protokol terbina dalam dan laluan pengesahan asap - Asas sedia pengeluaran (keselamatan, pembalakan, daya tahan, sandaran)
### Contoh Buku Main (Kes Penggunaan Bersepadu) **Playbook A: Maksimumkan langganan berbayar + sandaran murah** ```txt Combo: "maximize-claude" 1. cc/claude-opus-4-6 2. glm/glm-4.7 3. if/kimi-k2-thinking Monthly cost: $20 + small backup spend Outcome: higher quality, near-zero interruption ``` **Playbook B: Timbunan pengekodan kos sifar** ```txt Combo: "free-forever" 1. gc/gemini-3-flash 2. if/kimi-k2-thinking 3. qw/qwen3-coder-plus Monthly cost: $0 Outcome: stable free coding workflow ``` **Playbook C: 24/7 rantai sandaran sentiasa hidup** ```txt Combo: "always-on" 1. cc/claude-opus-4-6 2. cx/gpt-5.2-codex 3. glm/glm-4.7 4. minimax/MiniMax-M2.1 5. if/kimi-k2-thinking Outcome: deep fallback depth for deadline-critical workloads ``` **Playbook D: Operasi ejen dengan MCP + A2A** ```txt 1) Start MCP transport (`omniroute --mcp`) for tool-driven operations 2) Run A2A tasks via `message/send` and `message/stream` 3) Observe via /dashboard/mcp and /dashboard/a2a 4) Control incidents with resilience profile + task cancellation ``` --- ## โšก Mula Pantas **1. Pasang secara global:** ```bash npm install -g omniroute omniroute ``` ๐ŸŽ‰ Papan pemuka dibuka pada `http://localhost:20128` | Perintah | Penerangan | | ----------------------- | ---------------------------------- | | `omniroute` | Mulakan pelayan (port lalai 20128) | | `omniroute --port 3000` | Gunakan port tersuai | | `omniroute --no-open` | Jangan auto buka penyemak imbas | | `omniroute --help` | Tunjukkan bantuan | **2. Sambungkan pembekal PERCUMA:** Papan pemuka โ†’ Pembekal โ†’ Sambung **Kod Claude** atau **Antigraviti** โ†’ Log masuk OAuth โ†’ Selesai! **3. Gunakan dalam alat CLI anda:** ``` Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings: Endpoint: http://localhost:20128/v1 API Key: [copy from dashboard] Model: if/kimi-k2-thinking ``` **Itu sahaja!** Mulakan pengekodan dengan model AI PERCUMA. **Alternatif โ€” dijalankan dari sumber:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## ๐Ÿณ Docker OmniRoute tersedia sebagai imej Docker awam pada [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute). **Larian pantas:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Dengan fail persekitaran:** ```bash # Copy and edit .env first cp .env.example .env docker run -d \ --name omniroute \ --restart unless-stopped \ --env-file .env \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Menggunakan Docker Compose:** ```bash # Base profile (no CLI tools) docker compose --profile base up -d # CLI profile (Claude Code, Codex, OpenClaw built-in) docker compose --profile cli up -d ``` | Imej | Tag | Saiz | Penerangan | | ------------------------ | -------- | ------ | ----------------------- | | `diegosouzapw/omniroute` | `latest` | ~250MB | Keluaran stabil terkini | | `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Versi semasa | --- --- ## ๐Ÿ–ฅ๏ธ > ๐Ÿ†• **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) --- ## ๐Ÿ’ฐ Sekilas Pandang Harga | Peringkat | Pembekal | Kos | Set Semula Kuota | Terbaik Untuk | | ---------------- | ---------------- | ---------------------------- | ------------------ | ----------------------- | | **๐Ÿ’ณ LANGGANAN** | Kod Claude (Pro) | $20/bln | 5j + mingguan | Sudah melanggan | | | Codex (Plus/Pro) | $20-200/bln | 5j + mingguan | Pengguna OpenAI | | | Gemini CLI | **PERCUMA** | 180K/bln + 1K/hari | Semua orang! | | | GitHub Copilot | $10-19/bln | Bulanan | Pengguna GitHub | | **๐Ÿ”‘ KUNCI API** | NVIDIA NIM | **PERCUMA** (1000 kredit) | Satu kali | Ujian peringkat percuma | | | DeepSeek | Bayar setiap penggunaan | Tiada | Harga/kualiti terbaik | | | Groq | Peringkat percuma + berbayar | Kadar terhad | Inferens sangat pantas | | | xAI (Grok) | Bayar setiap penggunaan | Tiada | Model Grok | | | Mistral | Peringkat percuma + berbayar | Kadar terhad | AI Eropah | | | OpenRouter | Bayar setiap penggunaan | Tiada | 100+ model | | **๐Ÿ’ฐ MURAH** | GLM-4.7 | $0.6/1J | Setiap hari 10AM | Sandaran belanjawan | | | MiniMax M2.1 | $0.2/1J | 5 jam bergolek | Pilihan termurah | | | Kimi K2 | $9/bln flat | 10 juta token/bln | Kos yang boleh diramal | | **๐Ÿ†“ PERCUMA** | iFlow | $0 | tanpa had | 8 model percuma | | | Qwen | $0 | tanpa had | 3 model percuma | | | Kiro | $0 | tanpa had | Claude percuma | **๐Ÿ’ก Petua Pro:** Mulakan dengan Gemini CLI (180K percuma/bulan) + iFlow (percuma tanpa had) kombo = $0 kos! --- ## ๐Ÿ’ก Ciri Utama ### ๐Ÿง  Penghalaan Teras & Kepintaran | Ciri | Apa yang Dilakukan | | ---------------------------------- | --------------------------------------------------------------------------------------------- | | ๐ŸŽฏ **Smart 4-Tier Fallback** | Laluan automatik: Langganan โ†’ Kunci API โ†’ Murah โ†’ Percuma | | ๐Ÿ“Š **Penjejakan Kuota Masa Nyata** | Kiraan token langsung + tetapan semula kira detik setiap pembekal | | ๐Ÿ”„ **Terjemahan Format** | OpenAI โ†” Claude โ†” Gemini โ†” Kursor โ†” Kiro lancar + pembersihan tindak balas | | ๐Ÿ‘ฅ **Sokongan Berbilang Akaun** | Berbilang akaun bagi setiap pembekal dengan pemilihan pintar | | ๐Ÿ”„ **Muat Semula Token Auto** | Token OAuth dimuat semula secara automatik dengan cuba semula | | ๐ŸŽจ **Kombo Tersuai** | 6 strategi: isikan dahulu, round-robin, p2c, rawak, paling kurang digunakan, dioptimumkan kos | | ๐Ÿงฉ **Model Tersuai** | Tambahkan sebarang ID model pada mana-mana pembekal | | ๐ŸŒ **Penghala Wildcard** | Halakan corak `provider/*` kepada mana-mana pembekal secara dinamik | | ๐Ÿง  **Anggaran Berfikir** | Mod laluan, auto, tersuai dan adaptif untuk model penaakulan | | ๐Ÿ”€ **Model Aliases** | Auto-forward deprecated model IDs to current replacements (built-in + custom) | | โšก **Background Degradation** | Auto-route background tasks (titles, summaries) to cheaper models | | ๐Ÿ’ฌ **System Prompt Suntikan** | Gesaan sistem global digunakan merentas semua permintaan | | ๐Ÿ“„ **API Respons** | Sokongan OpenAI Responses API (`/v1/responses`) penuh untuk Codex | ### ๐ŸŽต API Berbilang Modal | Ciri | Apa yang Dilakukan | | ------------------------ | ------------------------------------------------------ | | ๐Ÿ–ผ๏ธ **Penjanaan Imej** | `/v1/images/generations` โ€” 4 pembekal, 9+ model | | ๐Ÿ“ **Pembenaman** | `/v1/embeddings` โ€” 6 pembekal, 9+ model | | ๐ŸŽค **Transkripsi Audio** | `/v1/audio/transcriptions` โ€” Serasi dengan bisikan | | ๐Ÿ”Š **Teks-ke-Ucapan** | `/v1/audio/speech` โ€” Sintesis audio berbilang pembekal | | ๐Ÿ›ก๏ธ **Kesederhanaan** | `/v1/moderations` โ€” Pemeriksaan keselamatan kandungan | | ๐Ÿ”€ **Penyusunan semula** | `/v1/rerank` โ€” Penarafan semula perkaitan dokumen | ### ๐Ÿ›ก๏ธ Ketahanan & Keselamatan | Ciri | Apa yang Dilakukan | | ----------------------------------- | ----------------------------------------------------------------------------------- | | ๐Ÿ”Œ **Pemutus Litar** | Auto buka/tutup setiap pembekal dengan ambang boleh dikonfigurasikan | | ๐Ÿ›ก๏ธ **Kawanan Anti Guruh** | Had kadar Mutex + semaphore untuk pembekal kunci API | | ๐Ÿง  **Cache Semantik** | Cache dua peringkat (tandatangan + semantik) mengurangkan kos & kependaman | | โšก **Minta Idepotency** | Tetingkap pendua 5s untuk permintaan pendua | | ๐Ÿ”’ **TLS Fingerprint Spoofing** | Pintas pengesanan bot berasaskan TLS melalui wreq-js | | ๐ŸŒ **Penapisan IP** | Senarai kebenaran/senarai sekat untuk kawalan akses API | | ๐Ÿ“Š **Had Kadar Boleh Diedit** | RPM boleh dikonfigurasikan, jurang min dan serentak maksimum pada tahap sistem | | ๐Ÿ’พ **Rate Limit Persistence** | Learned limits survive restarts via SQLite with 60s debounce + 24h staleness | | ๐Ÿ”„ **Token Refresh Resilience** | Per-provider circuit breaker (5 failsโ†’30min) + 30s timeout per attempt | | ๐Ÿ›ก **Perlindungan Titik Akhir API** | Gating pengesahan + penyekatan penyedia untuk titik akhir `/models` | | ๐Ÿ”’ **Keterlihatan Proksi** | Lencana berkod warna: ๐ŸŸข global, ๐ŸŸก pembekal, ๐Ÿ”ต setiap sambungan dengan paparan IP | | ๐ŸŒ **Konfigurasi Proksi 3 Tahap** | Konfigurasikan proksi pada peringkat global, setiap pembekal atau setiap sambungan | ### ๐Ÿ“Š Kebolehlihatan & Analitis | Ciri | Apa yang Dilakukan | | --------------------------------- | ------------------------------------------------------------------------------ | | ๐Ÿ“ **Minta Pembalakan** | Mod nyahpepijat dengan log permintaan/tindak balas penuh | | ๐Ÿ’พ **Log Proksi SQLite** | Log proksi berterusan bertahan dimulakan semula pelayan | | ๐Ÿ“Š **Papan Pemuka Analitik** | Dikuasakan semula: kad statistik, carta penggunaan model, jadual pembekal | | ๐Ÿ“ˆ **Penjejakan Kemajuan** | Ikut serta acara kemajuan SSE untuk penstriman | | ๐Ÿงช **Penilaian LLM** | Ujian set emas dengan 4 strategi perlawanan | | ๐Ÿ” **Minta Telemetri** | p50/p95/p99 pengagregatan kependaman + pengesanan X-Request-Id | | ๐Ÿ“‹ **Papan Pemuka Log** | Halaman 4 tab bersatu: Log Permintaan, Log Proksi, Log Audit, Konsol | | ๐Ÿ–ฅ๏ธ **Pemapar Log Konsol** | Pemapar gaya terminal masa nyata dengan penapis tahap, carian, tatal automatik | | ๐Ÿ“‘ **Pengelogan Berasaskan Fail** | Pemintas konsol menangkap semua output ke fail log JSON dengan putaran | | ๐Ÿฅ **Papan Pemuka Kesihatan** | Masa beroperasi sistem, keadaan pemutus litar, sekatan keluar, statistik cache | | ๐Ÿ’ฐ **Penjejakan Kos** | Pengurusan belanjawan + konfigurasi harga setiap model | ### โ˜๏ธ Penyerahan & Penyegerakan | Ciri | Apa yang Dilakukan | | ----------------------------- | ----------------------------------------------------------------------- | | ๐Ÿ’พ **Penyegerakan Awan** | Segerakkan konfigurasi merentas peranti melalui Cloudflare Workers | | ๐ŸŒ **Kerahkan Di Mana-mana** | Localhost, VPS, Docker, Pekerja Cloudflare | | ๐Ÿ”‘ **Pengurusan Kunci API** | Jana, putar dan skop kunci API bagi setiap pembekal | | ๐Ÿง™ **Onboarding Wizard** | Persediaan berpandu 4 langkah untuk pengguna kali pertama | | ๐Ÿ”ง **Papan Pemuka Alat CLI** | Konfigurasi satu klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity | | ๐Ÿ”„ **Sandaran DB** | Sandaran automatik, pulihkan, eksport & import untuk semua tetapan | | ๐ŸŒ **Pengantarabangsaan** | i18n penuh dengan next-intl โ€” sokongan Inggeris + Portugis (Brazil) | | ๐ŸŒ **Pemilih Bahasa** | Ikon glob dalam pengepala untuk penukaran bahasa masa nyata (๐Ÿ‡บ๐Ÿ‡ธ/๐Ÿ‡ง๐Ÿ‡ท) | | ๐Ÿ“‚ **Direktori Data Tersuai** | `DATA_DIR` env var untuk mengatasi laluan storan lalai `~/.omniroute` |
๐Ÿ“– Butiran Ciri ### ๐ŸŽฏ Kemunduran 4 Peringkat Pintar Cipta gabungan dengan sandaran automatik: ``` Combo: "my-coding-stack" 1. cc/claude-opus-4-6 (your subscription) 2. nvidia/llama-3.3-70b (free NVIDIA API) 3. glm/glm-4.7 (cheap backup, $0.6/1M) 4. if/kimi-k2-thinking (free fallback) โ†’ Auto switches when quota runs out or errors occur ``` ### ๐Ÿ“Š Penjejakan Kuota Masa Nyata - Penggunaan token setiap pembekal - Tetapkan semula kira detik (5 jam, harian, mingguan) - Anggaran kos untuk peringkat berbayar - Laporan perbelanjaan bulanan ### ๐Ÿ”„ Terjemahan Format Terjemahan lancar antara format: - **OpenAI** โ†” **Claude** โ†” **Gemini** โ†” **Respons OpenAI** - Alat CLI anda menghantar format OpenAI โ†’ OmniRoute menterjemah โ†’ Pembekal menerima format asli - Berfungsi dengan mana-mana alat yang menyokong titik akhir OpenAI tersuai - **Pembersihan tindak balas** โ€” Menghapuskan medan bukan standard untuk keserasian OpenAI SDK yang ketat - **Penormalan peranan** โ€” `developer` โ†’ `system` untuk bukan OpenAI; `system` โ†’ `user` untuk model GLM/ERNIE - **Pengekstrakan teg Think** โ€” `` blok โ†’ `reasoning_content` untuk model pemikiran - **Output berstruktur** โ€” `json_schema` โ†’ Gemini's `responseMimeType`/`responseSchema` ### ๐Ÿ‘ฅ Sokongan Berbilang Akaun - Tambah berbilang akaun bagi setiap pembekal - Auto round-robin atau penghalaan berasaskan keutamaan - Berundur ke akaun seterusnya apabila seseorang mencapai kuota ### ๐Ÿ”„ Muat Semula Token Auto - Token OAuth dimuat semula secara automatik sebelum tamat tempoh - Tiada pengesahan semula manual diperlukan - Pengalaman lancar merentas semua pembekal ### ๐ŸŽจ Kombo Tersuai - Buat kombinasi model tanpa had - 6 strategi: isikan dahulu, round-robin, kuasa dua pilihan, rawak, paling kurang digunakan, dioptimumkan kos - Kongsi gabungan merentas peranti dengan Cloud Sync ### ๐Ÿฅ Papan Pemuka Kesihatan - Status sistem (masa hidup, versi, penggunaan memori) - Keadaan pemutus litar bagi setiap pembekal (Tertutup/Terbuka/Separuh Terbuka) - Status had kadar dan sekatan aktif - Statistik cache tandatangan - Telemetri kependaman (p50/p95/p99) + cache segera - Tetapkan semula status kesihatan dengan satu klik ### ๐Ÿ”ง Taman Permainan Penterjemah OmniRoute termasuk Taman Permainan Penterjemah terbina dalam yang berkuasa dengan **4 mod** untuk penyahpepijatan, ujian dan pemantauan terjemahan API: | Mod | Penerangan | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **๐Ÿ’ป Taman permainan** | Terjemahan format langsung โ€” tampal mana-mana badan permintaan API dan lihat serta-merta cara OmniRoute menterjemahkannya antara format pembekal (OpenAI โ†” Claude โ†” Gemini โ†” Responses API). Termasuk templat contoh dan pengesanan automatik format. | | **๐Ÿ’ฌ Penguji Sembang** | Hantar permintaan sembang sebenar melalui OmniRoute dan lihat perjalanan pergi balik penuh: input anda, permintaan yang diterjemahkan, respons pembekal dan balasan yang diterjemahkan kembali. Tidak ternilai untuk mengesahkan penghalaan kombo. | | **๐Ÿงช Bangku Ujian** | Mod ujian kelompok โ€” tentukan berbilang kes ujian dengan input dan output yang dijangkakan berbeza, jalankan semuanya sekali gus dan bandingkan hasil merentas pembekal dan model. | | **๐Ÿ“ฑ Pemantau Langsung** | Pemantauan permintaan masa nyata โ€” tonton permintaan masuk semasa ia mengalir melalui OmniRoute, lihat terjemahan format berlaku secara langsung dan kenal pasti isu serta-merta. | **Akses:** Papan Pemuka โ†’ Penterjemah (bar sisi) ### ๐Ÿ’พ Penyegerakan Awan - Penyegerakan penyedia, gabungan dan tetapan merentas peranti - Penyegerakan latar belakang automatik - Storan yang disulitkan selamat
## ๐Ÿงช Penilaian (Evals) OmniRoute termasuk rangka kerja penilaian terbina dalam untuk menguji kualiti tindak balas LLM terhadap set emas. Aksesnya melalui **Analytics โ†’ Evals** dalam papan pemuka. ### Set Emas Terbina dalam "Set Emas OmniRoute" pra-muat mengandungi 10 kes ujian yang meliputi: - Salam, matematik, geografi, penjanaan kod - Pematuhan format JSON, terjemahan, penurunan harga - Penolakan keselamatan (kandungan berbahaya), pengiraan, logik boolean ### Strategi Penilaian | Strategi | Penerangan | Contoh | | ---------- | --------------------------------------------------------------------- | -------------------------------- | | `exact` | Output mesti sepadan dengan tepat | `"4"` | | `contains` | Output mesti mengandungi subrentetan (tidak peka huruf besar-besaran) | `"Paris"` | | `regex` | Output mesti sepadan dengan corak regex | `"1.*2.*3"` | | `custom` | Fungsi JS tersuai mengembalikan benar/salah | `(output) => output.length > 10` | --- ## ๐Ÿ“– Panduan Persediaan
๐Ÿ’ณ Pembekal Langganan ### Kod Claude (Pro/Max) ```bash Dashboard โ†’ Providers โ†’ Connect Claude Code โ†’ OAuth login โ†’ Auto token refresh โ†’ 5-hour + weekly quota tracking Models: cc/claude-opus-4-6 cc/claude-sonnet-4-5-20250929 cc/claude-haiku-4-5-20251001 ``` **Petua Pro:** Gunakan Opus untuk tugas yang rumit, Sonnet untuk kelajuan. OmniRoute menjejaki kuota setiap model! ### OpenAI Codex (Plus/Pro) ```bash Dashboard โ†’ Providers โ†’ Connect Codex โ†’ OAuth login (port 1455) โ†’ 5-hour + weekly reset Models: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` ### Gemini CLI (PERCUMA 180K/bulan!) ```bash Dashboard โ†’ Providers โ†’ Connect Gemini CLI โ†’ Google OAuth โ†’ 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Nilai Terbaik:** Peringkat percuma yang besar! Gunakan ini sebelum peringkat berbayar. ### Copilot GitHub ```bash Dashboard โ†’ Providers โ†’ Connect GitHub โ†’ OAuth via GitHub โ†’ Monthly reset (1st of month) Models: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```
๐Ÿ”‘ Pembekal Kunci API ### NVIDIA NIM (PERCUMA 1000 kredit!) 1. Daftar: [build.nvidia.com](https://build.nvidia.com) 2. Dapatkan kunci API percuma (1000 kredit inferens disertakan) 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ NVIDIA NIM: - Kunci API: `nvapi-your-key` **Model:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` dan 50+ lagi **Petua Pro:** API serasi OpenAI โ€” berfungsi dengan lancar dengan terjemahan format OmniRoute! ### DeepSeek 1. Daftar: [platform.deepseek.com](https://platform.deepseek.com) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ DeepSeek **Model:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder` ### Groq (Tier Percuma Tersedia!) 1. Daftar: [console.groq.com](https://console.groq.com) 2. Dapatkan kunci API (termasuk peringkat percuma) 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ Groq **Model:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b` **Petua Pro:** Inferens sangat pantas โ€” terbaik untuk pengekodan masa nyata! ### OpenRouter (100+ Model) 1. Daftar: [openrouter.ai](https://openrouter.ai) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Pembekal โ†’ OpenRouter **Model:** Akses 100+ model daripada semua pembekal utama melalui kunci API tunggal.
๐Ÿ’ฐ Penyedia Murah (Sandaran) ### GLM-4.7 (Tetapan semula harian, $0.6/1J) 1. Daftar: [Zhipu AI](https://open.bigmodel.cn/) 2. Dapatkan kunci API daripada Pelan Pengekodan 3. Papan Pemuka โ†’ Tambah Kunci API: - Pembekal: `glm` - Kunci API: `your-key` **Gunakan:** `glm/glm-4.7` **Petua Pro:** Pelan Pengekodan menawarkan kuota 3ร— pada kos 1/7! Tetapkan semula setiap hari 10:00 AM. ### MiniMax M2.1 (tetapan semula 5j, $0.20/1J) 1. Daftar: [MiniMax](https://www.minimax.io/) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Kunci API **Gunakan:** `minimax/MiniMax-M2.1` **Petua Pro:** Pilihan termurah untuk konteks panjang (token 1M)! ### Kimi K2 ($9/bulan rata) 1. Langgan: [Moonshot AI](https://platform.moonshot.ai/) 2. Dapatkan kunci API 3. Papan Pemuka โ†’ Tambah Kunci API **Gunakan:** `kimi/kimi-latest` **Petua Pro:** Tetap $9/bulan untuk 10J token = $0.90/1J kos efektif!
๐Ÿ†“ Pembekal PERCUMA (Sandaran Kecemasan) ### iFlow (8 model PERCUMA) ```bash Dashboard โ†’ Connect iFlow โ†’ iFlow OAuth login โ†’ Unlimited usage Models: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (3 model PERCUMA) ```bash Dashboard โ†’ Connect Qwen โ†’ Device code authorization โ†’ Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude PERCUMA) ```bash Dashboard โ†’ Connect Kiro โ†’ AWS Builder ID or Google/GitHub โ†’ Unlimited usage Models: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 ```
๐ŸŽจ Cipta Kombo ### Contoh 1: Maksimumkan Langganan โ†’ Sandaran Murah ``` Dashboard โ†’ Combos โ†’ Create New Name: premium-coding Models: 1. cc/claude-opus-4-6 (Subscription primary) 2. glm/glm-4.7 (Cheap backup, $0.6/1M) 3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M) Use in CLI: premium-coding ``` ### Contoh 2: Percuma-Sahaja (Kos Sifar) ``` Name: free-combo Models: 1. gc/gemini-3-flash-preview (180K free/month) 2. if/kimi-k2-thinking (unlimited) 3. qw/qwen3-coder-plus (unlimited) Cost: $0 forever! ```
๐Ÿ”ง CLI Integrasi ### IDE Kursor ``` Settings โ†’ Models โ†’ Advanced: OpenAI API Base URL: http://localhost:20128/v1 OpenAI API Key: [from OmniRoute dashboard] Model: cc/claude-opus-4-6 ``` ### Kod Claude Gunakan halaman **Alat CLI** dalam papan pemuka untuk konfigurasi satu klik atau edit `~/.claude/settings.json` secara manual. ### Codex CLI ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### OpenClaw **Pilihan 1 โ€” Papan Pemuka (disyorkan):** ``` Dashboard โ†’ CLI Tools โ†’ OpenClaw โ†’ Select Model โ†’ Apply ``` **Pilihan 2 โ€” Manual:** Edit `~/.openclaw/openclaw.json`: ```json { "models": { "providers": { "omniroute": { "baseUrl": "http://127.0.0.1:20128/v1", "apiKey": "sk_omniroute", "api": "openai-completions" } } } } ``` > **Nota:** OpenClaw hanya berfungsi dengan OmniRoute tempatan. Gunakan `127.0.0.1` dan bukannya `localhost` untuk mengelakkan isu resolusi IPv6. ### Cline / Teruskan / RooCode ``` Settings โ†’ API Configuration: Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [from OmniRoute dashboard] Model: if/kimi-k2-thinking ```
--- ## ๐Ÿ› Menyelesaikan masalah
Klik untuk mengembangkan panduan penyelesaian masalah **"Model bahasa tidak memberikan mesej"** - Kuota pembekal habis โ†’ Semak penjejak kuota papan pemuka - Penyelesaian: Gunakan sandaran kombo atau tukar kepada peringkat yang lebih murah **Penghadan kadar** - Kuota langganan habis โ†’ Sandar kepada GLM/MiniMax - Tambah kombo: `cc/claude-opus-4-6 โ†’ glm/glm-4.7 โ†’ if/kimi-k2-thinking` **Token OAuth tamat tempoh** - Dikemas semula secara automatik oleh OmniRoute - Jika isu berterusan: Papan Pemuka โ†’ Pembekal โ†’ Sambung semula **Kos tinggi** - Semak statistik penggunaan dalam Papan Pemuka โ†’ Kos - Tukar model utama kepada GLM/MiniMax - Gunakan peringkat percuma (Gemini CLI, iFlow) untuk tugasan yang tidak kritikal **Papan pemuka dibuka pada port yang salah** - Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128` **Ralat penyegerakan awan** - Sahkan `BASE_URL` mata pada contoh larian anda - Sahkan `CLOUD_URL` mata ke titik akhir awan anda yang dijangkakan - Pastikan nilai `NEXT_PUBLIC_*` sejajar dengan nilai sebelah pelayan **Log masuk pertama tidak berfungsi** - Semak `INITIAL_PASSWORD` dalam `.env` - Jika tidak ditetapkan, kata laluan sandaran ialah `123456` **Tiada log permintaan** - Tetapkan `ENABLE_REQUEST_LOGS=true` dalam `.env` **Ujian sambungan menunjukkan "Tidak sah" untuk pembekal yang serasi dengan OpenAI** - Banyak pembekal tidak mendedahkan titik akhir `/models` - OmniRoute v1.0.6+ termasuk pengesahan sandaran melalui pelengkapan sembang - Pastikan URL asas mengandungi akhiran `/v1` ### ๐Ÿ” OAuth > **โš ๏ธ PENTING untuk biasa menggunakan OmniRoute em VPS/Docker/servidor remoto** ### Adakah OAuth melakukan Antigraviti / Gemini CLI tidak menggunakan perkhidmatan anda? Ia membuktikan **Antigraviti** dan **Gemini CLI** menggunakan **Google OAuth 2.0** untuk autenticaรงรฃo. O Google exige que a `redirect_uri` gunakan tiada fluks OAuth seja **exatamente** uma das URIs sebelum kadastrada tiada Google Cloud Console untuk aplicativo. Sebagai credenciais OAuth embutidas no OmniRoute estรฃo cadastradas **apenas untuk `localhost`**. Quando vocรช acessa o OmniRoute em um servidor remoto (cth: `https://omniroute.meuservidor.com`), o Google rejeita a autenticaรงรฃo com: ``` Error 400: redirect_uri_mismatch ``` ### Penyelesaian: Konfigurasikan suas prรณprias credenciais OAuth Vocรช precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com a URI do seu servidor. #### Passo a passo **1. Akses ke Konsol Awan Google** Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials) **2. Crie um novo ID Pelanggan OAuth 2.0** - Klik em **"+ Cipta Bukti Kelayakan"** โ†’ **"ID klien OAuth"** - Tipo de aplicativo: **"Aplikasi web"** - Nama: escolha qualquer nome (cth: `OmniRoute Remote`) **3. Tambah sebagai URI Ubah Hala Dibenarkan** Tiada **"URI ubah hala yang dibenarkan"**, tambahan: ``` https://seu-servidor.com/callback ``` > Gantikan `seu-servidor.com` pelo domรญnio ou IP do seu servidor (termasuk porta se necessรกrio, cth: `http://45.33.32.156:20128/callback`). **4. Simpan dan salin sebagai kredensia** Apรณs criar, o Google mostrarรก o **ID Pelanggan** e o **Rahsia Pelanggan**. **5. Konfigurasikan sebagai variรกveis de ambiente** No seu `.env` (ou nas variรกveis de ambiente do Docker): ```bash # Para Antigravity: ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret # Para Gemini CLI: GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret ``` **6. Reinicie o OmniRoute** ```bash # Se usando npm: npm run dev # Se usando Docker: docker restart omniroute ``` **7. Tente conectar novamente** Papan pemuka โ†’ Pembekal โ†’ Antigraviti (ou Gemini CLI) โ†’ OAuth Agora o Google redirectionarรก corretamente untuk `https://seu-servidor.com/callback` dan a autenticaรงรฃo funcionarรก. --- ### Penyelesaian sementara (sem configurar credenciais prรณprias) Jika anda ingin mendapatkan credenciais prรณprias agora, ada kemungkinan penggunaan atau fluks **manual de URL**: 1. OmniRoute abrirรก a URL de authorizaรงรฃo do Google 2. Apรณs vocรช authorizar, o Google tentarรก redirectionar para `localhost` (que falha no servidor remoto) 3. **Salin URL lengkap** pada penyemak imbas barra de endereรงo do seu (mesmo que a pรกgina nรฃo carregue) 4. Cole essa URL no campo que aparece no modal de conexรฃo do OmniRoute 5. Klik em **"Sambung"** > Penyelesaian ini berfungsi sebagai kodigo de autorizaรงรฃo na URL adalah bebas untuk mengubah hala mengikut arahan atau tidak.
--- ## ๐Ÿ› ๏ธ - **Waktu Jalan**: Node.js 18โ€“22 LTS (โš ๏ธ Node.js 24+ **tidak disokong** โ€” `better-sqlite3` binari asli tidak serasi) - **Bahasa**: TypeScript 5.9 โ€” **100% TypeScript** merentas `src/` dan `open-sse/` (v1.0.6) - **Kerangka**: Next.js 16 + React 19 + Tailwind CSS 4 - **Pangkalan Data**: LowDB (JSON) + SQLite (keadaan domain + log proksi) - **Penstriman**: Acara Dihantar Pelayan (SSE) - **Auth**: OAuth 2.0 (PKCE) + JWT + Kunci API - **Ujian**: Pelari ujian Node.js (368+ ujian unit) - **CI/CD**: GitHub Actions (auto npm publish + Docker Hub pada keluaran) - **Laman web**: [omniroute.online](https://omniroute.online) - **Pakej**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute) - **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute) - **Ketahanan**: Pemutus litar, mundur eksponen, kumpulan anti gemuruh, penipuan TLS --- ## ๐Ÿ“– Dokumentasi | Dokumen | Penerangan | | -------------------------------------------- | --------------------------------------------------- | | [User Guide](docs/USER_GUIDE.md) | Pembekal, kombo, penyepaduan CLI, penggunaan | | [API Reference](docs/API_REFERENCE.md) | Semua titik akhir dengan contoh | | [Troubleshooting](docs/TROUBLESHOOTING.md) | Masalah dan penyelesaian biasa | | [Architecture](docs/ARCHITECTURE.md) | Seni bina sistem dan dalaman | | [Contributing](CONTRIBUTING.md) | Persediaan pembangunan dan garis panduan | | [OpenAPI Spec](docs/openapi.yaml) | Spesifikasi OpenAPI 3.0 | | [Security Policy](SECURITY.md) | Pelaporan kerentanan dan amalan keselamatan | | [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: Persediaan VM + nginx + Cloudflare | | [Features Gallery](docs/FEATURES.md) | Lawatan papan pemuka visual dengan tangkapan skrin | ### ๐Ÿ“ธ Pratonton Papan Pemuka
Klik untuk melihat tangkapan skrin papan pemuka | Halaman | Tangkapan skrin | | ------------------ | ------------------------------------------------- | | **Pembekal** | ![Providers](docs/screenshots/01-providers.png) | | **Kombo** | ![Combos](docs/screenshots/02-combos.png) | | **Analisis** | ![Analytics](docs/screenshots/03-analytics.png) | | **Kesihatan** | ![Health](docs/screenshots/04-health.png) | | **Penterjemah** | ![Translator](docs/screenshots/05-translator.png) | | **Tetapan** | ![Settings](docs/screenshots/06-settings.png) | | **Alat CLI** | ![CLI Tools](docs/screenshots/07-cli-tools.png) | | **Log Penggunaan** | ![Usage](docs/screenshots/08-usage.png) | | **Titik Akhir** | ![Endpoint](docs/screenshots/09-endpoint.png) |
--- ## ๐Ÿ—บ๏ธ OmniRoute mempunyai **210+ ciri yang dirancang** merentas berbilang fasa pembangunan. Berikut adalah bidang utama: | Kategori | Ciri Terancang | Sorotan | | ------------------------------ | -------------- | ---------------------------------------------------------------------------------------------------- | | ๐Ÿง  **Penghalaan & Perisikan** | 25+ | Penghalaan kependaman terendah, penghalaan berasaskan teg, kuota prapenerbangan, pemilihan akaun P2C | | ๐Ÿ”’ **Keselamatan & Pematuhan** | 20+ | Pengerasan SSRF, penyelubungan kelayakan, had kadar setiap titik akhir, skop kunci pengurusan | | ๐Ÿ“Š **Kebolehlihatan** | 15+ | Penyepaduan OpenTelemetry, pemantauan kuota masa nyata, penjejakan kos setiap model | | ๐Ÿ”„ **Integrasi Pembekal** | 20+ | Pendaftaran model dinamik, penyejukan pembekal, Codex berbilang akaun, penghuraian kuota Copilot | | โšก **Prestasi** | 15+ | Lapisan cache dwi, โ€‹โ€‹cache gesaan, cache respons, penstriman keepalive, API kelompok | | ๐ŸŒ **Ekosistem** | 10+ | API WebSocket, konfigurasi hot-reload, kedai konfigurasi teragih, mod komersial | ### ๐Ÿ”œ Akan Datang - ๐Ÿ”— **OpenCode Integration** โ€” Sokongan pembekal asli untuk IDE pengekodan AI OpenCode - ๐Ÿ”— **Pengintegrasian TRAE** โ€” Sokongan penuh untuk rangka kerja pembangunan TRAE AI - ๐Ÿ“ฆ **API Kelompok** โ€” Pemprosesan kelompok tak segerak untuk permintaan pukal - ๐ŸŽฏ **Penghalaan Berasaskan Teg** โ€” Permintaan laluan berdasarkan teg tersuai dan metadata - ๐Ÿ’ฐ **Strategi Kos Terendah** โ€” Pilih pembekal yang tersedia paling murah secara automatik > ๐Ÿ“ Spesifikasi ciri penuh tersedia dalam [link](docs/new-features/) (217 spesifikasi terperinci) --- ## ๐Ÿ‘ฅ Penyumbang [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### Cara Menyumbang 1. Garpu repositori 2. Buat cawangan ciri anda (`git checkout -b feature/amazing-feature`) 3. Serahkan perubahan anda (`git commit -m 'Add amazing feature'`) 4. Tolak ke cawangan (`git push origin feature/amazing-feature`) 5. Buka Permintaan Tarik Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk garis panduan terperinci. ### Mengeluarkan Versi Baharu ```bash # Create a release โ€” npm publish happens automatically gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## ๐Ÿ“Š Sejarah Bintang Star History Chart --- ## ๐Ÿ™ Ucapan terima kasih Terima kasih khas kepada **[9router](https://github.com/decolua/9router)** oleh **[decolua](https://github.com/decolua)** โ€” projek asal yang mengilhamkan garpu ini. OmniRoute membina asas yang luar biasa itu dengan ciri tambahan, API berbilang modal dan penulisan semula TypeScript penuh. Terima kasih khas kepada **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** โ€” pelaksanaan Go asal yang mengilhamkan port JavaScript ini. --- ## ๐Ÿ“„ Lesen Lesen MIT - lihat [LICENSE](LICENSE) untuk butiran. ---
Dibina dengan โค๏ธ untuk pembangun yang kod 24/7
omniroute.online