# OmniRoute — Dashboard Features Gallery (Bahasa Melayu)

🌐 **Languages:** 🇺🇸 [English](../../../../guides/FEATURES.md) · 🇪🇹 [am](../../../am/docs/guides/FEATURES.md) · 🇸🇦 [ar](../../../ar/docs/guides/FEATURES.md) · 🇦🇿 [az](../../../az/docs/guides/FEATURES.md) · 🇧🇬 [bg](../../../bg/docs/guides/FEATURES.md) · 🇧🇩 [bn](../../../bn/docs/guides/FEATURES.md) · 🇧🇦 [bs](../../../bs/docs/guides/FEATURES.md) · 🇨🇿 [cs](../../../cs/docs/guides/FEATURES.md) · 🇩🇰 [da](../../../da/docs/guides/FEATURES.md) · 🇩🇪 [de](../../../de/docs/guides/FEATURES.md) · 🇬🇷 [el](../../../el/docs/guides/FEATURES.md) · 🇪🇸 [es](../../../es/docs/guides/FEATURES.md) · 🇪🇪 [et](../../../et/docs/guides/FEATURES.md) · 🇮🇷 [fa](../../../fa/docs/guides/FEATURES.md) · 🇫🇮 [fi](../../../fi/docs/guides/FEATURES.md) · 🇫🇷 [fr](../../../fr/docs/guides/FEATURES.md) · 🇮🇪 [ga](../../../ga/docs/guides/FEATURES.md) · 🇮🇳 [gu](../../../gu/docs/guides/FEATURES.md) · 🇳🇬 [ha](../../../ha/docs/guides/FEATURES.md) · 🇮🇱 [he](../../../he/docs/guides/FEATURES.md) · 🇮🇳 [hi](../../../hi/docs/guides/FEATURES.md) · 🇭🇷 [hr](../../../hr/docs/guides/FEATURES.md) · 🇭🇺 [hu](../../../hu/docs/guides/FEATURES.md) · 🇦🇲 [hy](../../../hy/docs/guides/FEATURES.md) · 🇮🇩 [id](../../../id/docs/guides/FEATURES.md) · 🇳🇬 [ig](../../../ig/docs/guides/FEATURES.md) · 🇮🇹 [it](../../../it/docs/guides/FEATURES.md) · 🇯🇵 [ja](../../../ja/docs/guides/FEATURES.md) · 🇬🇪 [ka](../../../ka/docs/guides/FEATURES.md) · 🇰🇭 [km](../../../km/docs/guides/FEATURES.md) · 🇮🇳 [kn](../../../kn/docs/guides/FEATURES.md) · 🇰🇷 [ko](../../../ko/docs/guides/FEATURES.md) · 🇱🇹 [lt](../../../lt/docs/guides/FEATURES.md) · 🇱🇻 [lv](../../../lv/docs/guides/FEATURES.md) · 🇮🇳 [ml](../../../ml/docs/guides/FEATURES.md) · 🇮🇳 [mr](../../../mr/docs/guides/FEATURES.md) · 🇲🇹 [mt](../../../mt/docs/guides/FEATURES.md) · 🇲🇲 [my](../../../my/docs/guides/FEATURES.md) · 🇳🇵 [ne](../../../ne/docs/guides/FEATURES.md) · 🇳🇱 [nl](../../../nl/docs/guides/FEATURES.md) · 🇳🇴 [no](../../../no/docs/guides/FEATURES.md) · 🇮🇳 [or](../../../or/docs/guides/FEATURES.md) · 🇮🇳 [pa](../../../pa/docs/guides/FEATURES.md) · 🇵🇭 [phi](../../../phi/docs/guides/FEATURES.md) · 🇵🇱 [pl](../../../pl/docs/guides/FEATURES.md) · 🇵🇹 [pt](../../../pt/docs/guides/FEATURES.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/guides/FEATURES.md) · 🇷🇴 [ro](../../../ro/docs/guides/FEATURES.md) · 🇷🇺 [ru](../../../ru/docs/guides/FEATURES.md) · 🇱🇰 [si](../../../si/docs/guides/FEATURES.md) · 🇸🇰 [sk](../../../sk/docs/guides/FEATURES.md) · 🇸🇮 [sl](../../../sl/docs/guides/FEATURES.md) · 🇷🇸 [sr](../../../sr/docs/guides/FEATURES.md) · 🇸🇪 [sv](../../../sv/docs/guides/FEATURES.md) · 🇰🇪 [sw](../../../sw/docs/guides/FEATURES.md) · 🇮🇳 [ta](../../../ta/docs/guides/FEATURES.md) · 🇮🇳 [te](../../../te/docs/guides/FEATURES.md) · 🇹🇭 [th](../../../th/docs/guides/FEATURES.md) · 🇹🇷 [tr](../../../tr/docs/guides/FEATURES.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/guides/FEATURES.md) · 🇵🇰 [ur](../../../ur/docs/guides/FEATURES.md) · 🇺🇿 [uz](../../../uz/docs/guides/FEATURES.md) · 🇻🇳 [vi](../../../vi/docs/guides/FEATURES.md) · 🇳🇬 [yo](../../../yo/docs/guides/FEATURES.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/guides/FEATURES.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/guides/FEATURES.md)

---

🌐 **Languages:** 🇺🇸 [English](../../../../guides/FEATURES.md) · 🇪🇹 [am](../../../am/docs/guides/FEATURES.md) · 🇸🇦 [ar](../../../ar/docs/guides/FEATURES.md) · 🇦🇿 [az](../../../az/docs/guides/FEATURES.md) · 🇧🇬 [bg](../../../bg/docs/guides/FEATURES.md) · 🇧🇩 [bn](../../../bn/docs/guides/FEATURES.md) · 🇧🇦 [bs](../../../bs/docs/guides/FEATURES.md) · 🇨🇿 [cs](../../../cs/docs/guides/FEATURES.md) · 🇩🇰 [da](../../../da/docs/guides/FEATURES.md) · 🇩🇪 [de](../../../de/docs/guides/FEATURES.md) · 🇬🇷 [el](../../../el/docs/guides/FEATURES.md) · 🇪🇸 [es](../../../es/docs/guides/FEATURES.md) · 🇪🇪 [et](../../../et/docs/guides/FEATURES.md) · 🇮🇷 [fa](../../../fa/docs/guides/FEATURES.md) · 🇫🇮 [fi](../../../fi/docs/guides/FEATURES.md) · 🇫🇷 [fr](../../../fr/docs/guides/FEATURES.md) · 🇮🇪 [ga](../../../ga/docs/guides/FEATURES.md) · 🇮🇳 [gu](../../../gu/docs/guides/FEATURES.md) · 🇳🇬 [ha](../../../ha/docs/guides/FEATURES.md) · 🇮🇱 [he](../../../he/docs/guides/FEATURES.md) · 🇮🇳 [hi](../../../hi/docs/guides/FEATURES.md) · 🇭🇷 [hr](../../../hr/docs/guides/FEATURES.md) · 🇭🇺 [hu](../../../hu/docs/guides/FEATURES.md) · 🇦🇲 [hy](../../../hy/docs/guides/FEATURES.md) · 🇮🇩 [id](../../../id/docs/guides/FEATURES.md) · 🇳🇬 [ig](../../../ig/docs/guides/FEATURES.md) · 🇮🇹 [it](../../../it/docs/guides/FEATURES.md) · 🇯🇵 [ja](../../../ja/docs/guides/FEATURES.md) · 🇬🇪 [ka](../../../ka/docs/guides/FEATURES.md) · 🇰🇭 [km](../../../km/docs/guides/FEATURES.md) · 🇮🇳 [kn](../../../kn/docs/guides/FEATURES.md) · 🇰🇷 [ko](../../../ko/docs/guides/FEATURES.md) · 🇱🇹 [lt](../../../lt/docs/guides/FEATURES.md) · 🇱🇻 [lv](../../../lv/docs/guides/FEATURES.md) · 🇮🇳 [ml](../../../ml/docs/guides/FEATURES.md) · 🇮🇳 [mr](../../../mr/docs/guides/FEATURES.md) · 🇲🇹 [mt](../../../mt/docs/guides/FEATURES.md) · 🇲🇲 [my](../../../my/docs/guides/FEATURES.md) · 🇳🇵 [ne](../../../ne/docs/guides/FEATURES.md) · 🇳🇱 [nl](../../../nl/docs/guides/FEATURES.md) · 🇳🇴 [no](../../../no/docs/guides/FEATURES.md) · 🇮🇳 [or](../../../or/docs/guides/FEATURES.md) · 🇮🇳 [pa](../../../pa/docs/guides/FEATURES.md) · 🇵🇭 [phi](../../../phi/docs/guides/FEATURES.md) · 🇵🇱 [pl](../../../pl/docs/guides/FEATURES.md) · 🇵🇹 [pt](../../../pt/docs/guides/FEATURES.md) · 🇧🇷 [pt-BR](../../../pt-BR/docs/guides/FEATURES.md) · 🇷🇴 [ro](../../../ro/docs/guides/FEATURES.md) · 🇷🇺 [ru](../../../ru/docs/guides/FEATURES.md) · 🇱🇰 [si](../../../si/docs/guides/FEATURES.md) · 🇸🇰 [sk](../../../sk/docs/guides/FEATURES.md) · 🇸🇮 [sl](../../../sl/docs/guides/FEATURES.md) · 🇷🇸 [sr](../../../sr/docs/guides/FEATURES.md) · 🇸🇪 [sv](../../../sv/docs/guides/FEATURES.md) · 🇰🇪 [sw](../../../sw/docs/guides/FEATURES.md) · 🇮🇳 [ta](../../../ta/docs/guides/FEATURES.md) · 🇮🇳 [te](../../../te/docs/guides/FEATURES.md) · 🇹🇭 [th](../../../th/docs/guides/FEATURES.md) · 🇹🇷 [tr](../../../tr/docs/guides/FEATURES.md) · 🇺🇦 [uk-UA](../../../uk-UA/docs/guides/FEATURES.md) · 🇵🇰 [ur](../../../ur/docs/guides/FEATURES.md) · 🇺🇿 [uz](../../../uz/docs/guides/FEATURES.md) · 🇻🇳 [vi](../../../vi/docs/guides/FEATURES.md) · 🇳🇬 [yo](../../../yo/docs/guides/FEATURES.md) · 🇨🇳 [zh-CN](../../../zh-CN/docs/guides/FEATURES.md) · 🇹🇼 [zh-TW](../../../zh-TW/docs/guides/FEATURES.md)

Panduan visual untuk setiap bahagian papan pemuka OmniRoute.

> 📅 **Kemas kini terakhir:** 2026-06-28 — **v3.8.40**

---

## ✨ Sorotan v3.8.0

Kitaran v3.7.x → v3.8.0 menambahkan penghalaan automatik tanpa konfigurasi, penyedia baharu, aliran OAuth, ketahanan yang lebih mendalam dan pengalaman CLI yang jauh lebih kaya. Ciri utama disenaraikan di bawah — butiran penuh terdapat selanjutnya dalam dokumen ini dan dalam spesifikasi yang dipautkan.

- 🤖 **Kombo Automatik / Penghalaan automatik tanpa konfigurasi** — gunakan awalan `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp`, `auto/chaos`. Disokong oleh enjin pemarkahan 16 faktor dan 6 **pek mod** yang dipilih susun (ship-fast, cost-saver, quality-first, offline-friendly, reliability-first, chaos-mode)
- 🆕 **Penyedia Command Code** (#2199) — pendaftaran kelas pertama dengan katalog model dan penjejakan kuota
- 🆕 **Penyedia Z.AI** — penyedia peringkat percuma baharu dengan label kuota
- 🎬 **Peluasan media KIE** — katalog diperluas termasuk model penjanaan video
- 🔐 **Pengesahan Devin** — Desktop mengimport kunci API Devin sedia ada; CLI menggunakan kelayakan `devin auth login` setempat
- 🆓 **8 penyedia percuma baharu** — LLM7, Lepton, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi, Command Code
- 🎯 **Penghalaan peringkat W1–W4 yang peka manifes** — manifes penyedia memacu pemilihan peringkat berwajaran
- 🎨 **Kesetaraan penuh OpenAI untuk Cursor** — panggilan alat, penstriman dan pengurusan sesi dari hujung ke hujung
- 📊 **Penggunaan pelan Cursor Pro** — data kuota & kitaran dipaparkan dalam papan pemuka had penyedia
- ⚡ **Pecahan peringkat perkhidmatan / analitik peringkat pantas Codex** — keterlihatan penggunaan bagi setiap peringkat
- 📌 **Penghalaan melekat bagi setiap sesi** — sesi Codex dikekalkan pada akaun yang sama antara giliran
- 🔊 **Penambahbaikan TTS Inworld** — katalog suara, penstriman dan peningkatan kependaman
- 🔑 **Pengesahan tanpa antara muka Kiro** — log masuk melalui stor SQLite `kiro-cli` setempat, tanpa memerlukan pelayar
- 📉 **Pemantauan kuota dan had DeepSeek** — penggunaan harian/bulanan dipaparkan melalui papan pemuka
- 🔄 **Strategi penghalaan yang peka tetapan semula** — kombo kini mengutamakan akaun yang tetingkap kuotanya akan ditetapkan semula paling awal
- ⏱️ **`fallbackDelayMs`** dan **pengesanan had alat dinamik** — pemasaan sandaran yang lebih terperinci + had bilangan alat bagi setiap penyedia
- 🔧 **Penurunan taraf mod latar belakang (API Responses)** — beralih kepada mod segerak dengan amaran berstruktur apabila perkhidmatan huluan tidak menyokong peninjauan latar belakang
- 🚦 **Pengelasan 429 bagi setiap penyedia** + togol `useUpstream429BreakerHints` — gelagat pemutus yang lebih terperinci menggunakan petunjuk had kadar daripada perkhidmatan huluan
- 🩺 **Papan pemuka tempoh bertenang model** — pantau sekatan setiap model dan dayakan semula secara manual daripada UI
- 🔒 **Pengesanan sijil Linux dinamik MITM** — berfungsi merentas Debian/Ubuntu, Fedora/RHEL, Arch dan distro lain
- 💻 **Suite penambahbaikan CLI** — lebih 20 perintah termasuk `omniroute providers`, `omniroute combos`, `omniroute doctor`, `omniroute setup`
- 🔍 **Penemuan model pembenaman Qdrant** — prob model stor vektor secara automatik
- 🔑 **Kunci API / Kunci Bearer dengan skop `manage`** — lakukan operasi pentadbir secara berprogram melalui API
- 🏥 **Analitik kesihatan sasaran kombo** + **pembina kombo berstruktur** — kesihatan bagi setiap sasaran & pembina UI untuk menyusun langkah `(provider, model, connection)`
- 🤝 **Penyedia OAuth GitLab Duo** — log masuk dengan kelayakan GitLab
- 🧠 **Cache Main Semula Penaakulan** — pengekalan hibrid dalam memori + SQLite untuk jejak penaakulan

📚 **Dokumen berkaitan:** [Rangka Kerja Kemahiran](../frameworks/SKILLS.md) · [Sistem Memori](../frameworks/MEMORY.md) · [Ejen Awan](../frameworks/CLOUD_AGENT.md) · [Webhook](../frameworks/WEBHOOKS.md) · [Cache Main Semula Penaakulan](../routing/REASONING_REPLAY.md)

---

## 🔌 Penyedia

Urus sambungan penyedia AI: penyedia OAuth (Claude Code, Codex), penyedia kunci API (Groq, DeepSeek, OpenRouter), dan penyedia percuma (Qoder, Kiro). Akaun Kiro menyertakan penjejakan baki kredit — baki kredit, jumlah peruntukan, dan tarikh pembaharuan boleh dilihat dalam Papan Pemuka → Penggunaan.

Sambungan OpenRouter boleh menyimpan `preset` bagi setiap sambungan dalam Tetapan Lanjutan. Apabila ditetapkan, OmniRoute menghantarnya sebagai medan permintaan peringkat teratas OpenRouter, contohnya `"preset": "email-copywriter"`, melainkan permintaan klien telah membekalkan `preset` sendiri.

![Papan Pemuka Penyedia](../screenshots/01-providers.png)

---

## 🎨 Kombo

Cipta kombo penghalaan model dengan 19 strategi awam: priority, weighted, round-robin, context-relay, fill-first, p2c (pilihan kuasa dua), random, least-used, cost-optimized, reset-aware, reset-window, headroom, strict-random, auto, lkgp (penyedia-terakhir-yang-diketahui-baik), context-optimized, cache-optimized, **fusion** (menghantar permintaan kepada sekumpulan model secara selari, kemudian mensintesis satu jawapan melalui penilai), dan **pipeline**. Setiap kombo merantaikan berbilang model dengan sandaran automatik serta menyertakan templat pantas dan semakan kesiapsiagaan.

Penambahbaikan kombo terkini:

- **Pembina kombo berstruktur** — cipta setiap langkah dengan memilih penyedia, model, dan akaun/sambungan yang tepat
- **Sokongan penyedia berulang** — gunakan semula penyedia yang sama berkali-kali dalam satu kombo selagi tupel `(provider, model, connection)` adalah unik
- **Kesihatan sasaran kombo** — paparan analitik dan kesihatan kini membezakan setiap sasaran/langkah kombo dan bukannya menggabungkan semuanya menjadi rentetan model
- **Susunan peringkat komposit** — `defaultTier -> fallbackTier` kini mempengaruhi susunan pelaksanaan/sandaran masa jalan untuk langkah kombo peringkat teratas
- **Templat gesaan sistem** — `system_message` kombo menyokong ruang letak bahagian pelayan
  `{{MODEL_ID}}`, `{{PROVIDER_ID}}`, `{{ACCOUNT}}` dan `{{FINGERPRINT}}`
  yang dikembangkan daripada sasaran yang benar-benar dihalakan sejurus sebelum penghantaran.
  Dikawal melalui senarai dibenarkan dan tidak rekursif; ruang letak yang tidak diketahui kekal sebagai teks literal; nilai kosong
  dikembangkan kepada kosong; gesaan sistem klien tidak pernah ditulis semula. `{{FINGERPRINT}}`
  hanya diselesaikan untuk penyedia percuma berasaskan cap jari dengan cap jari yang dipinkan atau
  diputarkan secara automatik — ia dikembangkan kepada kosong di tempat lain (contohnya
  sambungan cap jari tunggal, penyedia bukan fp). Pengembangan meliputi
  gelung penghantaran standard, round-robin, dan sesi cache konteks yang dipinkan;
  strategi fusion, chaos, pipeline dan nested-execute belum lagi mengembangkan
  ruang letak.

![Papan Pemuka Kombo](../screenshots/02-combos.png)

---

## 📊 Analitik

Analitik penggunaan yang menyeluruh dengan penggunaan token, anggaran kos, peta haba aktiviti, carta taburan mingguan, dan pecahan mengikut penyedia.

![Papan Pemuka Analitik](../screenshots/03-analytics.png)

---

## 🏥 Kesihatan Sistem

Pemantauan masa nyata: masa aktif, memori, versi, persentil kependaman (p50/p95/p99), statistik cache, keadaan pemutus litar penyedia, sesi aktif yang dipantau kuotanya, dan kesihatan sasaran kombo.

![Papan Pemuka Kesihatan](../screenshots/04-health.png)

---

## 🔧 Ruang Uji Penterjemah

Empat mod untuk menyahpepijat terjemahan API: **Ruang Uji** (penukar format), **Penguji Sembang** (permintaan langsung), **Bangku Ujian** (ujian berkelompok), dan **Pemantau Langsung** (strim masa nyata).

![Ruang Uji Penterjemah](../screenshots/05-translator.png)

---

## 🎮 Ruang Uji Model _(v2.0.9+)_

Uji mana-mana model secara terus daripada papan pemuka. Pilih penyedia, model dan titik akhir, tulis gesaan dengan Monaco Editor, strim respons dalam masa nyata, hentikan di pertengahan strim dan lihat metrik pemasaan.

---

## 🎨 Tema _(v2.0.5+)_

Tema warna yang boleh disesuaikan untuk keseluruhan papan pemuka. Pilih daripada 7 warna pratetap (Karang, Biru, Merah, Hijau, Ungu, Jingga, Sian) atau cipta tema tersuai dengan memilih sebarang warna heksadesimal. Menyokong mod cerah, gelap dan sistem.

---

## ⚙️ Tetapan

Panel tetapan menyeluruh dengan **7 tab**:

- **Umum** — Storan sistem, pengurusan sandaran (eksport/import pangkalan data)
- **Penampilan** — Pemilih tema (gelap/cerah/sistem), pratetap tema warna dan warna tersuai, keterlihatan log kesihatan, kawalan keterlihatan item bar sisi dan pemisah kumpulan, kawalan keterlihatan terowong titik akhir
- **AI** — Ciri pembantu AI, pratetap penghalaan lalai (Gabungan Auto `auto/coding`, `auto/fast`, `auto/cheap`, `auto/smart`), cache main semula penaakulan dan togol kemahiran/memori
- **Keselamatan** — Perlindungan titik akhir API, penyekatan penyedia tersuai, penapisan IP, maklumat sesi
- **Penghalaan** — Alias model, penurunan taraf tugas latar belakang, penghalaan peringkat yang mengambil kira manifes (W1–W4), `fallbackDelayMs`, penghalaan kekal bagi setiap sesi
- **Ketahanan** — Pengekalan had kadar, penalaan pemutus litar, nyahaktif automatik akaun yang dilarang, pemantauan tamat tempoh penyedia, ambang penyerahan **Penyampai Konteks** dan konfigurasi model ringkasan, pengelasan 429 bagi setiap penyedia serta togol `useUpstream429BreakerHints`, tempoh bertenang model
- **Lanjutan** — Penggantian konfigurasi, jejak audit konfigurasi, mod penurunan taraf sandaran, penurunan taraf mod latar belakang untuk Responses API

![Papan Pemuka Tetapan](../screenshots/06-settings.png)

---

## 🔧 Alat CLI

Konfigurasi satu klik untuk alat pengekodan AI: Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline, Continue, Cursor dan Factory Droid. Menampilkan penggunaan/penetapan semula konfigurasi secara automatik, profil sambungan dan pemetaan model.

![Papan Pemuka Alat CLI](../screenshots/07-cli-tools.png)

---

## 🤖 Ejen CLI _(v2.0.11+)_

Papan pemuka untuk menemukan dan mengurus ejen CLI. Memaparkan grid 16 ejen terbina dalam (Codex, Claude, Goose, OpenClaw, Aider, OpenCode, Cline, ForgeCode, Amazon Q, Open Interpreter, Cursor CLI, Warp, **Windsurf**, **Devin CLI**, **Kimi Coding**, **Command Code**) dengan:

- **Status pemasangan** — Dipasang / Tidak Ditemui dengan pengesanan versi
- **Lencana protokol** — stdio, HTTP dan sebagainya
- **Ejen tersuai** — Daftarkan sebarang alat CLI melalui borang (nama, binari, perintah versi, argumen pelancaran)
- **Pemadanan Cap Jari CLI** — Togol bagi setiap penyedia untuk memadankan tandatangan permintaan CLI natif, sekali gus mengurangkan risiko sekatan sambil mengekalkan IP proksi
- **Pengesahan Devin setempat** — Devin CLI menggunakan `devin auth login`; tiada aliran OAuth pelayar diperlukan

---

## 🔗 Penyampaian Konteks _(v3.5.5+)_

Strategi kombo yang mengekalkan kesinambungan sesi apabila penggiliran akaun berlaku di tengah-tengah perbualan. Sebelum akaun aktif kehabisan kuota, OmniRoute menjana ringkasan penyerahan berstruktur di latar belakang. Selepas permintaan seterusnya dialihkan kepada akaun lain, ringkasan tersebut disuntik sebagai mesej sistem supaya akaun baharu dapat meneruskan perbualan dengan konteks penuh.

Boleh dikonfigurasikan melalui tetapan peringkat kombo atau global:

- **Ambang Penyerahan** — Peratusan penggunaan kuota yang mencetuskan penjanaan ringkasan (lalai 85%)
- **Mesej Maksimum untuk Ringkasan** — Jumlah sejarah terkini untuk diringkaskan
- **Model Ringkasan** — Model penggantian pilihan untuk menjana ringkasan penyerahan

Pada masa ini menyokong penggiliran akaun Codex. Lihat [dokumentasi Penyampaian Konteks](../architecture/ARCHITECTURE.md).

---

## 🗜️ Pemampatan Prom _(v3.7.9+)_

Konteks & Cache kini menyediakan halaman khusus untuk Caveman, RTK dan Kombo Pemampatan:

- **Caveman** — pek peraturan peka bahasa, pratonton, kawalan mod output dan analitik
- **RTK** — pemampatan peka perintah untuk output shell, git, ujian, binaan, pakej, Docker, infrastruktur, JSON dan surih tindanan
- **Kombo Pemampatan** — saluran paip bernama seperti `rtk -> caveman` yang ditetapkan kepada kombo penghalaan; pengiraan bertindan lalai mencapai purata `~89%` dan penjimatan konteks yang layak sebanyak `78-95%` apabila kedua-dua enjin digunakan
- **Pemulihan output mentah** — penuding output mentah RTK yang disunting secara pilihan untuk menyahpepijat kegagalan pemampatan

Lihat [Panduan Pemampatan](../compression/COMPRESSION_GUIDE.md), [Pemampatan RTK](../compression/RTK_COMPRESSION.md) dan
[Enjin Pemampatan](../compression/COMPRESSION_ENGINES.md).

---

## 🛡️ Pengukuhan Proksi _(v3.5.5+)_

Penguatkuasaan konfigurasi proksi yang menyeluruh di seluruh saluran paip permintaan:

- **Pemeriksaan Kesihatan Token** — Penyegaran OAuth di latar belakang kini menentukan konfigurasi proksi bagi setiap sambungan, sekali gus mencegah kegagalan dalam persekitaran yang memerlukan proksi
- **Pengesahan Kunci API** — Pengesahan kunci penyedia (`POST /api/providers/validate`) dihalakan melalui `runWithProxyContext`, dengan mematuhi tetapan proksi peringkat penyedia dan global
- **Pembaikan Penghantar undici** — Penghantar proksi menggunakan pelaksanaan fetch milik undici dan bukannya fetch terbina dalam Node, sekali gus menyelesaikan ralat `invalid onRequestStart method` pada Node.js 22
- **Pengesanan Versi Node.js** — Halaman log masuk mengesan versi Node.js yang tidak serasi (24+) secara proaktif dan memaparkan sepanduk amaran dengan arahan untuk menggunakan Node 22 LTS

---

## 📧 Penyamaran Privasi E-mel _(v3.5.6+)_

E-mel akaun OAuth disamarkan secara lalai (contohnya `di*****@g****.com`) untuk mengelakkan pendedahan tidak sengaja ketika berkongsi tangkap layar atau merakam demo. Gunakan Tetapan → Penampilan → Keterlihatan e-mel akaun untuk mendedahkan atau menyamarkan e-mel akaun penuh secara global merentas skrin penyedia, kombo, log, kuota dan ruang uji.

---

## 👁️ Togol Keterlihatan Model _(v3.5.6+)_

Senarai model pada halaman penyedia kini merangkumi:

- **Bar carian/penapis masa nyata** — Cari model tertentu dengan pantas
- **Togol keterlihatan bagi setiap model** (ikon 👁) — Model tersembunyi dikelabukan dan dikecualikan daripada katalog `/v1/models`
- **Lencana kiraan aktif** (`N/M aktif`) — Menunjukkan sepintas lalu bilangan model yang didayakan berbanding jumlah keseluruhan

---

## 🔧 Pembaikan Env OAuth _(v3.6.1+)_

Tindakan "Baiki env" dengan satu klik untuk penyedia OAuth yang memulihkan pemboleh ubah persekitaran yang hilang dan membaiki keadaan pengesahan yang rosak. Boleh diakses melalui `Papan Pemuka → Penyedia → [Penyedia OAuth] → Baiki env`. Mengesan dan membaiki secara automatik:

- Bukti kelayakan klien OAuth yang hilang
- Entri fail env yang rosak
- Penormalan laluan sandaran

---

## 🗑️ Nyahpasang / Nyahpasang Sepenuhnya _(v3.6.2+)_

Skrip pembuangan bersih untuk semua kaedah pemasangan:

| Perintah                 | Tindakan                                                                                       |
| ------------------------ | ---------------------------------------------------------------------------------------------- |
| `npm run uninstall`      | Membuang aplikasi sistem tetapi **mengekalkan DB dan konfigurasi anda** dalam `~/.omniroute`.  |
| `npm run uninstall:full` | Membuang aplikasi DAN **memadamkan semua konfigurasi, kunci dan pangkalan data** secara kekal. |

---

## 🖼️ Media _(v2.0.3+)_

Jana imej, video dan muzik daripada papan pemuka. Menyokong OpenAI, xAI, Together, Hyperbolic, SD WebUI, ComfyUI, AnimateDiff, Stable Audio Open dan MusicGen.

---

## 📝 Log Permintaan

Pengelogan permintaan masa nyata dengan penapisan mengikut penyedia, model, akaun dan kunci API. Memaparkan kod status, penggunaan token, kependaman dan butiran respons.

![Log Penggunaan](../screenshots/08-usage.png)

---

## 🌐 Titik Akhir API

Titik akhir API bersepadu anda dengan pecahan keupayaan: Pelengkapan Sembang, API Respons, Pembenaman, Penjanaan Imej, Penyusunan Semula Kedudukan, Transkripsi Audio, Teks-ke-Pertuturan, Penyederhanaan dan kunci API berdaftar. Sokongan Cloudflare Quick Tunnel, Tailscale Funnel, ngrok Tunnel dan proksi awan tersedia untuk akses jauh.

![Papan Pemuka Titik Akhir](../screenshots/09-endpoint.png)

---

## 🔑 Pengurusan Kunci API

Cipta, tetapkan skop dan batalkan kunci API. Setiap kunci boleh dihadkan kepada model/penyedia tertentu dengan akses penuh atau kebenaran baca sahaja. Pengurusan kunci secara visual dengan penjejakan penggunaan.

---

## 📋 Log Audit

Penjejakan tindakan pentadbiran dengan penapisan mengikut jenis tindakan, pelaku, sasaran, alamat IP dan cap masa. Sejarah penuh peristiwa keselamatan.

---

## 🖥️ Aplikasi Desktop

Aplikasi desktop Electron natif untuk Windows, macOS dan Linux. Jalankan OmniRoute sebagai aplikasi kendiri dengan penyepaduan dulang sistem, sokongan luar talian, kemas kini automatik dan pemasangan satu klik.

Ciri utama:

- Peninjauan kesediaan pelayan (tiada skrin kosong semasa permulaan sejuk)
- Dulang sistem dengan pengurusan port
- Dasar Keselamatan Kandungan
- Kunci tika tunggal
- Kemas kini automatik semasa mula semula
- UI bersyarat mengikut platform (butang lampu isyarat macOS, bar tajuk lalai Windows/Linux)
- Pemakejan binaan Electron yang diperkukuh — `node_modules` berpaut simbolik dalam berkas kendiri dikesan dan ditolak sebelum pemakejan, sekali gus menghalang kebergantungan masa jalan pada mesin binaan (v2.5.5+)
- **Penutupan lancar** — `before-quit` Electron menutup Next.js dengan bersih, sekali gus menghalang kunci pangkalan data SQLite WAL (v3.6.2+)

📖 Lihat [`electron/README.md`](../../electron/README.md) untuk dokumentasi penuh.

---

## 🌐 Jambatan WebSocket V1 _(v3.6.6+)_

OmniRoute kini menyokong **klien WebSocket yang serasi dengan OpenAI** melalui titik akhir naik taraf `/v1/ws`. Pelayan tersuai `scripts/dev/v1-ws-bridge.mjs` membungkus Next.js dan menaik taraf sambungan WS kepada sesi penstriman dua hala penuh. Pengesahan menggunakan kunci API atau kuki sesi yang sama seperti permintaan HTTP.

Tingkah laku utama:

- Naik taraf WS disahkan oleh `src/lib/ws/handshake.ts` sebelum sambungan diwujudkan
- Strim ditamatkan dengan bersih apabila sesi ditutup atau berlaku ralat huluan
- Berfungsi serentak bersama laluan penstriman HTTP+SSE sedia ada

---

## 🔑 Token Penyegerakan & Himpunan Konfigurasi _(v3.6.6+)_

Akses berbilang peranti dan akses pengendali luaran kini boleh dilakukan melalui **token penyegerakan berskop**:

- **`POST /api/sync/tokens`** — Keluarkan token penyegerakan baharu (berskop, dengan tamat tempoh pilihan)
- **`DELETE /api/sync/tokens/:id`** — Batalkan token
- **`GET /api/sync/bundle`** — Muat turun petikan JSON berversi dan berkunci ETag bagi semua tetapan tidak sensitif (kata laluan disunting)

Himpunan konfigurasi dibina oleh `src/lib/sync/bundle.ts`. Pengguna membandingkan pengepala respons `ETag` untuk mengesan perubahan tanpa memuat turun semula keseluruhan muatan.

---

## 🧠 Pratetap Pemikiran GLM _(v3.6.6+)_

**GLM Thinking (`glmt`)** kini ialah penyedia kelas pertama yang berdaftar: maksimum 65 536 token output, belanjawan pemikiran 24 576, tamat masa lalai 900 s, format API serasi Claude dan penyegerakan penggunaan dikongsi dengan keluarga GLM.

**Pengiraan token hibrid** turut diperkenalkan dalam v3.6.6: apabila penyedia serasi Claude menyediakan `/messages/count_tokens`, OmniRoute akan memanggilnya sebelum permintaan besar, dengan anggaran sandaran secara terkawal.

---

## 🛡️ Pengambilan Keluar Selamat & Perlindungan SSRF _(v3.6.6+)_

Semua panggilan pengesahan penyedia dan penemuan model kini melalui perlindungan keluar dua lapisan:

1. **Perlindungan URL** (`src/shared/network/outboundUrlGuard.ts`) — Menyekat julat IP peribadi/gelung balik/pautan setempat sebelum soket dibuka.
2. **Pembalut pengambilan selamat** (`src/shared/network/safeOutboundFetch.ts`) — Menggunakan perlindungan URL, menormalkan tamat masa dan mencuba semula ralat sementara dengan undur eksponen.

Pelanggaran perlindungan dipaparkan sebagai HTTP 422 (`URL_GUARD_BLOCKED`) dan ditulis ke dalam log audit pematuhan melalui `providerAudit.ts`.

---

## 🔄 Percubaan Semula Peka Tempoh Bertenang _(v3.6.6+)_

Permintaan sembang kini **dicuba semula secara automatik** apabila penyedia huluan mengembalikan tempoh bertenang berskop model. Boleh dikonfigurasikan melalui `REQUEST_RETRY` (lalai: 2) dan `MAX_RETRY_INTERVAL_SEC` (lalai: 30 s). Pembelajaran pengepala had kadar dipertingkat merentas `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens` dan `Retry-After` — keadaan tempoh bertenang setiap model boleh dilihat dalam papan pemuka Ketahanan.

---

## 📋 Audit Pematuhan v2 _(v3.6.6+)_

Log audit telah diperluas dengan penomboran halaman berasaskan kursor, pengayaan konteks permintaan (ID permintaan, ejen pengguna, IP), peristiwa pengesahan berstruktur, peristiwa CRUD penyedia dengan konteks perbezaan dan pengelogan pengesahan yang disekat SSRF. Peristiwa baharu dipancarkan oleh `src/lib/compliance/providerAudit.ts`.