# OmniRoute — Dashboard Features Gallery (Kiswahili)

🌐 **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) · 🇲🇾 [ms](../../../ms/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) · 🇮🇳 [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) · 🇲🇾 [ms](../../../ms/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) · 🇮🇳 [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)

Mwongozo wa kuona wa kila sehemu ya dashibodi ya OmniRoute.

> 📅 **Ilisasishwa mwisho:** 2026-06-28 — **v3.8.40**

---

## ✨ Vivutio vya v3.8.0

Mzunguko wa v3.7.x → v3.8.0 umeongeza uelekezaji otomatiki usiohitaji usanidi, watoa huduma wapya, mitiririko ya OAuth, ustahimilivu wa kina zaidi, na matumizi bora zaidi ya CLI. Vipengele vikuu vimeorodheshwa hapa chini — maelezo kamili yanapatikana mbele zaidi katika hati hii na kwenye vipimo vilivyounganishwa.

- 🤖 **Mchanganyiko Otomatiki / Uelekezaji otomatiki usiohitaji usanidi** — tumia viambishi awali `auto/coding`, `auto/fast`, `auto/cheap`, `auto/offline`, `auto/smart`, `auto/lkgp`, `auto/chaos`. Unaendeshwa na injini ya ukadiriaji yenye vipengele 16 na **vifurushi 6 vya modi** vilivyoteuliwa (ship-fast, cost-saver, quality-first, offline-friendly, reliability-first, chaos-mode)
- 🆕 **Mtoa huduma wa Command Code** (#2199) — usajili kamili wenye katalogi ya modeli na ufuatiliaji wa mgao
- 🆕 **Mtoa huduma wa Z.AI** — mtoa huduma mpya wa kiwango cha bure mwenye lebo za mgao
- 🎬 **Upanuzi wa maudhui ya KIE** — katalogi iliyopanuliwa inayojumuisha modeli za kutengeneza video
- 🔐 **Uthibitishaji wa Devin** — Desktop huingiza ufunguo uliopo wa API wa Devin; CLI hutumia vitambulisho vya ndani vya `devin auth login`
- 🆓 **Watoa huduma 8 wapya wa bure** — LLM7, Lepton, UncloseAI, BazaarLink, Completions, Enally, FreeTheAi, Command Code
- 🎯 **Uelekezaji wa viwango W1–W4 unaozingatia manifesti** — manifesti za watoa huduma huendesha uteuzi wa viwango kulingana na uzani
- 🎨 **Cursor yenye ulinganifu kamili na OpenAI** — miito ya zana, utiririshaji, na usimamizi wa vipindi kuanzia mwanzo hadi mwisho
- 📊 **Matumizi ya mpango wa Cursor Pro** — data ya mgao na mzunguko huonyeshwa kwenye dashibodi ya vikomo vya watoa huduma
- ⚡ **Uchanganuzi wa viwango vya huduma / uchanganuzi wa kiwango cha kasi cha Codex** — mwonekano wa matumizi kwa kila kiwango
- 📌 **Uelekezaji thabiti kwa kila kipindi** — vipindi vya Codex hubaki kwenye akaunti ileile kati ya zamu
- 🔊 **Maboresho ya TTS ya Inworld** — katalogi za sauti, utiririshaji, na maboresho ya ucheleweshaji
- 🔑 **Uthibitishaji wa Kiro usio na kiolesura** — ingia kupitia hifadhi ya ndani ya SQLite ya `kiro-cli`, bila kuhitaji kivinjari
- 📉 **Ufuatiliaji wa mgao na vikomo vya DeepSeek** — matumizi ya kila siku/kila mwezi huonyeshwa kupitia dashibodi
- 🔄 **Mkakati wa uelekezaji unaozingatia uwekaji upya** — michanganyiko sasa hupendelea akaunti ambazo kipindi chake cha mgao kitawekwa upya mapema zaidi
- ⏱️ **`fallbackDelayMs`** na **utambuzi badilifu wa kikomo cha zana** — udhibiti sahihi zaidi wa muda wa kutumia mbadala + vikomo vya idadi ya zana kwa kila mtoa huduma
- 🔧 **Upunguzaji wa uwezo wa modi ya mandharinyuma (Responses API)** — hurudi kwenye modi sawia pamoja na onyo lililoundwa kwa mpangilio wakati huduma ya juu haina uwezo wa kuangalia hali ya mandharinyuma
- 🚦 **Uainishaji wa 429 kwa kila mtoa huduma** + kigeuzi cha `useUpstream429BreakerHints` — tabia sahihi zaidi ya kivunja mzunguko kwa kutumia vidokezo vya vikomo vya kasi kutoka huduma ya juu
- 🩺 **Dashibodi ya vipindi vya kusubiri vya modeli** — fuatilia kufungiwa kwa kila modeli na uwashe tena mwenyewe kutoka kwenye UI
- 🔒 **Utambuzi badilifu wa cheti cha Linux cha MITM** — hufanya kazi kwenye Debian/Ubuntu, Fedora/RHEL, Arch, na distro nyingine
- 💻 **Seti ya maboresho ya CLI** — amri zaidi ya 20 ikijumuisha `omniroute providers`, `omniroute combos`, `omniroute doctor`, `omniroute setup`
- 🔍 **Ugunduzi wa modeli ya upachikaji ya Qdrant** — uchunguzi otomatiki wa modeli ya hifadhi ya vekta
- 🔑 **Funguo za API / funguo za Bearer zenye mawanda ya `manage`** — tekeleza shughuli za usimamizi kiprogramu kupitia API
- 🏥 **Uchanganuzi wa afya ya malengo ya mchanganyiko** + **kiunda mchanganyiko chenye muundo** — afya ya kila lengo na kiunda cha UI cha kuunganisha hatua za `(provider, model, connection)`
- 🤝 **Mtoa huduma wa GitLab Duo OAuth** — ingia kwa kutumia vitambulisho vya GitLab
- 🧠 **Akiba ya Kurudia Uchakataji wa Kimantiki** — uhifadhi mseto wa kumbukumbu ya ndani + SQLite wa vifuatilizi vya uchakataji wa kimantiki

📚 **Nyaraka zinazohusiana:** [Mfumo wa Ujuzi](../frameworks/SKILLS.md) · [Mfumo wa Kumbukumbu](../frameworks/MEMORY.md) · [Mawakala wa Wingu](../frameworks/CLOUD_AGENT.md) · [Webhooks](../frameworks/WEBHOOKS.md) · [Akiba ya Kurudia Uchakataji wa Kimantiki](../routing/REASONING_REPLAY.md)

---

## 🔌 Watoa huduma

Dhibiti miunganisho ya watoa huduma za AI: watoa huduma wa OAuth (Claude Code, Codex), watoa huduma wa funguo za API (Groq, DeepSeek, OpenRouter), na watoa huduma bila malipo (Qoder, Kiro). Akaunti za Kiro zinajumuisha ufuatiliaji wa salio la mikopo — mikopo iliyosalia, jumla ya mgao, na tarehe ya kusasishwa huonekana katika Dashibodi → Matumizi.

Miunganisho ya OpenRouter inaweza kuhifadhi `preset` maalumu kwa kila muunganisho katika Mipangilio ya Kina. Ikiwekwa, OmniRoute huituma kama sehemu ya kiwango cha juu ya ombi la OpenRouter, kwa mfano `"preset": "email-copywriter"`, isipokuwa ombi la mteja tayari limetoa `preset` yake yenyewe.

![Dashibodi ya Watoa Huduma](../screenshots/01-providers.png)

---

## 🎨 Michanganyiko

Unda michanganyiko ya uelekezaji wa modeli kwa mikakati 19 ya umma: priority, weighted, round-robin, context-relay, fill-first, p2c (uchaguzi wa nguvu-ya-mbili), random, least-used, cost-optimized, reset-aware, reset-window, headroom, strict-random, auto, lkgp (mtoa-huduma-mzuri-wa-mwisho-anayejulikana), context-optimized, cache-optimized, **fusion** (tuma kwa kundi la modeli sambamba, kisha unganisha jibu moja kupitia mwamuzi), na **pipeline**. Kila mchanganyiko huunganisha modeli nyingi kwa ubadilishaji wa kiotomatiki endapo mojawapo itashindwa, na hujumuisha violezo vya haraka pamoja na ukaguzi wa utayari.

Maboresho ya hivi karibuni ya michanganyiko:

- **Kiunda michanganyiko kilichopangwa** — unda kila hatua kwa kuchagua mtoa huduma, modeli, na akaunti/muunganisho mahususi
- **Usaidizi wa mtoa huduma anayerudiwa** — tumia tena mtoa huduma yuleyule mara nyingi katika mchanganyiko mmoja mradi tu jozi tatu za `(provider, model, connection)` ziwe za kipekee
- **Afya ya lengo la mchanganyiko** — sehemu za takwimu na afya sasa hutofautisha malengo/hatua mahususi za mchanganyiko badala ya kukusanya kila kitu katika mifuatano ya modeli
- **Mpangilio wa tabaka changamani** — `defaultTier -> fallbackTier` sasa huathiri mpangilio wa utekelezaji/ubadilishaji wakati wa uendeshaji kwa hatua za kiwango cha juu za mchanganyiko
- **Violezo vya kidokezo cha mfumo** — `system_message` ya mchanganyiko inaauni
  vihifadhi nafasi vya upande wa seva `{{MODEL_ID}}`, `{{PROVIDER_ID}}`, `{{ACCOUNT}}` na `{{FINGERPRINT}}`,
  vinavyopanuliwa kutoka kwenye lengo lililoelekezwa kihalisi kabla tu ya kutumwa.
  Vimewekewa orodha ya vinavyoruhusiwa na havijirudii; vihifadhi nafasi visivyojulikana hubaki kama vilivyo; thamani tupu
  hupanuliwa kuwa tupu; vidokezo vya mfumo vya mteja haviandikwi upya kamwe. `{{FINGERPRINT}}`
  hutatuliwa tu kwa watoa huduma bila malipo wanaotegemea alama ya utambulisho na wenye alama ya utambulisho iliyobandikwa au
  inayozungushwa kiotomatiki — hupanuliwa kuwa tupu kwingineko (kwa mfano,
  miunganisho ya alama moja ya utambulisho, watoa huduma wasiotumia fp). Upanuzi unajumuisha
  mzunguko wa kawaida wa utumaji, round-robin, na vipindi vya akiba ya muktadha vilivyobandikwa;
  mikakati ya fusion, chaos, pipeline na nested-execute bado haipanui
  vihifadhi nafasi.

![Dashibodi ya Michanganyiko](../screenshots/02-combos.png)

---

## 📊 Takwimu

Takwimu za kina za matumizi zenye matumizi ya tokeni, makadirio ya gharama, ramani za joto za shughuli, chati za mgawanyo wa kila wiki, na uchanganuzi kwa kila mtoa huduma.

![Dashibodi ya Takwimu](../screenshots/03-analytics.png)

---

## 🏥 Afya ya Mfumo

Ufuatiliaji wa wakati halisi: muda wa uendeshaji, kumbukumbu, toleo, asilimia za ucheleweshaji (p50/p95/p99), takwimu za akiba, hali za vivunja mzunguko vya watoa huduma, vipindi vinavyotumika vinavyofuatiliwa viwango vya matumizi, na afya ya malengo ya michanganyiko.

![Dashibodi ya Afya](../screenshots/04-health.png)

---

## 🔧 Mazingira ya Majaribio ya Kitafsiri

Hali nne za kutatua hitilafu za tafsiri za API: **Mazingira ya Majaribio** (kigeuzi cha umbizo), **Kijaribu Gumzo** (maombi ya moja kwa moja), **Benchi la Majaribio** (majaribio ya kundi), na **Kifuatiliaji cha Moja kwa Moja** (mtiririko wa wakati halisi).

![Mazingira ya Majaribio ya Kitafsiri](../screenshots/05-translator.png)

---

## 🎮 Mazingira ya Majaribio ya Modeli _(v2.0.9+)_

Jaribu modeli yoyote moja kwa moja kutoka kwenye dashibodi. Chagua mtoa huduma, modeli na endpoint, andika vidokezo kwa kutumia Monaco Editor, tiririsha majibu kwa wakati halisi, katisha katikati ya mtiririko, na uone vipimo vya muda.

---

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

Mandhari za rangi zinazoweza kubinafsishwa kwa dashibodi nzima. Chagua kutoka kwenye rangi 7 zilizowekwa awali (Matumbawe, Bluu, Nyekundu, Kijani, Urujuani, Machungwa, Samawati) au unda mandhari maalum kwa kuchagua rangi yoyote ya hex. Inaauni hali ya mwanga, giza na mfumo.

---

## ⚙️ Mipangilio

Paneli ya mipangilio ya kina yenye **vichupo 7**:

- **Jumla** — Hifadhi ya mfumo, usimamizi wa nakala rudufu (hamisha/leta hifadhidata)
- **Mwonekano** — Kiteuzi cha mandhari (giza/mwanga/mfumo), mipangilio ya awali ya rangi za mandhari na rangi maalum, uonekanaji wa kumbukumbu ya afya, vidhibiti vya uonekanaji wa vipengee vya utepe wa pembeni na vitenganishi vya vikundi, vidhibiti vya uonekanaji wa handaki la endpoint
- **AI** — Vipengele vya msaidizi wa AI, mipangilio chaguomsingi ya uelekezaji (Auto Combo `auto/coding`, `auto/fast`, `auto/cheap`, `auto/smart`), akiba ya marudio ya u reasoning, na vibadilishaji vya ujuzi/kumbukumbu
- **Usalama** — Ulinzi wa endpoint ya API, uzuiaji wa watoa huduma maalum, uchujaji wa IP, taarifa za kipindi
- **Uelekezaji** — Majina mbadala ya modeli, upunguzaji wa kiwango cha majukumu ya chinichini, uelekezaji wa ngazi unaozingatia manifest (W1–W4), `fallbackDelayMs`, uelekezaji thabiti kwa kila kipindi
- **Ustahimilivu** — Udumishaji wa vikomo vya kiwango, urekebishaji wa circuit breaker, uzimaji kiotomatiki wa akaunti zilizopigwa marufuku, ufuatiliaji wa muda wa kuisha kwa watoa huduma, kiwango cha ukabidhishaji cha **Context Relay** na usanidi wa modeli ya muhtasari, uainishaji wa 429 kwa kila mtoa huduma na kibadilishaji cha `useUpstream429BreakerHints`, vipindi vya kupumzisha modeli
- **Mahiri** — Ubatilishaji wa usanidi, historia ya ukaguzi wa usanidi, hali ya upunguzaji wa fallback, upunguzaji wa hali ya chinichini kwa Responses API

![Dashibodi ya Mipangilio](../screenshots/06-settings.png)

---

## 🔧 Zana za CLI

Usanidi wa kubofya mara moja kwa zana za AI za uandishi wa msimbo: Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline, Continue, Cursor, na Factory Droid. Inajumuisha uwekaji/uwekaji upya wa usanidi kiotomatiki, wasifu wa miunganisho, na ulinganishaji wa modeli.

![Dashibodi ya Zana za CLI](../screenshots/07-cli-tools.png)

---

## 🤖 Mawakala wa CLI _(v2.0.11+)_

Dashibodi ya kugundua na kusimamia mawakala wa CLI. Inaonyesha gridi ya mawakala 16 waliojengewa ndani (Codex, Claude, Goose, OpenClaw, Aider, OpenCode, Cline, ForgeCode, Amazon Q, Open Interpreter, Cursor CLI, Warp, **Windsurf**, **Devin CLI**, **Kimi Coding**, **Command Code**) ikiwa na:

- **Hali ya usakinishaji** — Imesakinishwa / Haijapatikana pamoja na utambuzi wa toleo
- **Beji za itifaki** — stdio, HTTP, n.k.
- **Mawakala maalum** — Sajili zana yoyote ya CLI kupitia fomu (jina, faili tekelezi, amri ya toleo, hoja za spawn)
- **Ulinganishaji wa Alama ya Utambulisho ya CLI** — Kibadilishaji cha kila mtoa huduma ili kulinganisha sahihi asili za maombi ya CLI, kupunguza hatari ya kupigwa marufuku huku ikihifadhi IP ya proksi
- **Uthibitishaji wa Devin wa ndani** — Devin CLI hutumia `devin auth login`; mtiririko wa OAuth wa kivinjari hauhitajiki

---

## 🔗 Uhamishaji wa Muktadha _(v3.5.5+)_

Mkakati mseto unaohifadhi mwendelezo wa kipindi wakati ubadilishaji wa akaunti unapotokea katikati ya mazungumzo. Kabla ya akaunti inayotumika kumaliza kikomo chake, OmniRoute hutengeneza muhtasari uliopangwa wa makabidhiano chinichini. Baada ya ombi linalofuata kuelekezwa kwenye akaunti tofauti, muhtasari huingizwa kama ujumbe wa mfumo ili akaunti mpya iendelee ikiwa na muktadha kamili.

Inaweza kusanidiwa kupitia mipangilio ya kiwango cha mseto au mipangilio ya jumla:

- **Kizingiti cha Makabidhiano** — Asilimia ya matumizi ya kiwango kinachoruhusiwa inayosababisha utengenezaji wa muhtasari (chaguo-msingi 85%)
- **Idadi ya Juu ya Ujumbe kwa Muhtasari** — Kiasi cha historia ya hivi karibuni cha kufupisha
- **Modeli ya Muhtasari** — Modeli ya hiari ya kubatilisha chaguo la kawaida kwa ajili ya kutengeneza muhtasari wa makabidhiano

Kwa sasa inasaidia ubadilishaji wa akaunti za Codex. Angalia [nyaraka za Uhamishaji wa Muktadha](../architecture/ARCHITECTURE.md).

---

## 🗜️ Mfinyazo wa Kidokezo _(v3.7.9+)_

Muktadha na Akiba sasa hutoa kurasa mahususi kwa Caveman, RTK, na Michanganyiko ya Mfinyazo:

- **Caveman** — vifurushi vya kanuni vinavyozingatia lugha, onyesho la awali, vidhibiti vya hali ya matokeo, na uchanganuzi
- **RTK** — mfinyazo unaozingatia amri kwa matokeo ya shell, git, majaribio, uundaji, vifurushi, Docker, miundombinu, JSON, na ufuatiliaji wa rundo
- **Michanganyiko ya Mfinyazo** — mifumo mfululizo iliyopewa majina kama vile `rtk -> caveman`, inayohusishwa na michanganyiko ya uelekezaji; hesabu chaguo-msingi ya mrundikano hufikia wastani wa `~89%` na uokoaji wa muktadha unaostahiki wa `78-95%` wakati injini zote mbili zinatumika
- **Urejeshaji wa matokeo ghafi** — vielekezi vya hiari vya RTK vya matokeo ghafi yaliyofichwa taarifa nyeti kwa ajili ya kutatua hitilafu zilizofinyazwa

Angalia [Mwongozo wa Mfinyazo](../compression/COMPRESSION_GUIDE.md), [Mfinyazo wa RTK](../compression/RTK_COMPRESSION.md), na
[Injini za Mfinyazo](../compression/COMPRESSION_ENGINES.md).

---

## 🛡️ Uimarishaji wa Proksi _(v3.5.5+)_

Utekelezaji kamili wa usanidi wa proksi katika mtiririko mzima wa maombi:

- **Ukaguzi wa Afya ya Tokeni** — Uonyeshaji upya wa OAuth wa chinichini sasa hutatua usanidi wa proksi kwa kila muunganisho, na hivyo kuzuia hitilafu katika mazingira yanayohitaji proksi
- **Uthibitishaji wa Ufunguo wa API** — Uthibitishaji wa ufunguo wa mtoa huduma (`POST /api/providers/validate`) huelekezwa kupitia `runWithProxyContext`, huku ukiheshimu mipangilio ya proksi ya kiwango cha mtoa huduma na ya jumla
- **Marekebisho ya Kisambazaji cha undici** — Visambazaji vya proksi hutumia utekelezaji wa fetch wa undici yenyewe badala ya fetch iliyojengewa ndani ya Node, na hivyo kutatua hitilafu za `invalid onRequestStart method` kwenye Node.js 22
- **Utambuzi wa Toleo la Node.js** — Ukurasa wa kuingia hutambua mapema matoleo ya Node.js yasiyooana (24+) na kuonyesha bango la onyo lenye maagizo ya kutumia Node 22 LTS

---

## 📧 Ufichaji wa Faragha ya Barua Pepe _(v3.5.6+)_

Barua pepe za akaunti za OAuth hufichwa kwa chaguo-msingi (k.m. `di*****@g****.com`) ili kuzuia kufichuliwa kimakosa wakati wa kushiriki picha za skrini au kurekodi maonyesho. Tumia Mipangilio → Mwonekano → Uonekanaji wa barua pepe ya akaunti ili kuonyesha au kuficha barua pepe kamili za akaunti kwa ujumla katika skrini za watoa huduma, michanganyiko, kumbukumbu, kiwango kinachoruhusiwa, na mazingira ya majaribio.

---

## 👁️ Kitufe cha Kubadilisha Uonekanaji wa Modeli _(v3.5.6+)_

Orodha ya modeli kwenye ukurasa wa mtoa huduma sasa inajumuisha:

- **Upau wa utafutaji/uchujaji wa wakati halisi** — Tafuta modeli mahususi kwa haraka
- **Kitufe cha kubadilisha uonekanaji kwa kila modeli** (ikoni ya 👁) — Modeli zilizofichwa hufifishwa na kuondolewa kwenye katalogi ya `/v1/models`
- **Beji ya idadi inayotumika** (`N/M active`) — Huonyesha kwa muhtasari idadi ya modeli zilizowezeshwa ikilinganishwa na jumla

---

## 🔧 Urekebishaji wa Env ya OAuth _(v3.6.1+)_

Kitendo cha mbofyo mmoja cha "Rekebisha env" kwa watoa huduma wa OAuth ambacho hurejesha vigeu vya mazingira vinavyokosekana na kurekebisha hali ya uthibitishaji iliyoharibika. Kinaweza kufikiwa kupitia `Dashibodi → Watoa Huduma → [Mtoa Huduma wa OAuth] → Rekebisha env`. Hugundua na kurekebisha kiotomatiki:

- Vitambulisho vya mteja wa OAuth vinavyokosekana
- Maingizo ya faili ya env yaliyoharibika
- Usafishaji wa njia ya nakala rudufu

---

## 🗑️ Usakinishaji-ondoa / Usakinishaji-ondoa Kamili _(v3.6.2+)_

Hati za uondoaji safi kwa mbinu zote za usakinishaji:

| Amri                     | Kitendo                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| `npm run uninstall`      | Huondoa programu ya mfumo lakini **huhifadhi DB na usanidi wako** katika `~/.omniroute`. |
| `npm run uninstall:full` | Huondoa programu NA **hufuta kabisa usanidi, funguo na hifadhidata zote**.               |

---

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

Zalisha picha, video na muziki kutoka kwenye dashibodi. Inatumia OpenAI, xAI, Together, Hyperbolic, SD WebUI, ComfyUI, AnimateDiff, Stable Audio Open na MusicGen.

---

## 📝 Kumbukumbu za Maombi

Uwekaji kumbukumbu wa maombi katika muda halisi wenye uchujaji kwa mtoa huduma, modeli, akaunti na ufunguo wa API. Huonyesha misimbo ya hali, matumizi ya tokeni, muda wa kusubiri na maelezo ya majibu.

![Kumbukumbu za Matumizi](../screenshots/08-usage.png)

---

## 🌐 Endpoint ya API

Endpoint yako iliyounganishwa ya API yenye uchanganuzi wa uwezo: Ukamilishaji wa Gumzo, Responses API, Embeddings, Uzalishaji wa Picha, Upangaji Upya, Unukuzi wa Sauti, Ubadilishaji wa Maandishi kuwa Usemi, Ukaguzi wa Maudhui na funguo za API zilizosajiliwa. Cloudflare Quick Tunnel, Tailscale Funnel, ngrok Tunnel na proksi ya wingu zinapatikana kwa ufikiaji wa mbali.

![Dashibodi ya Endpoint](../screenshots/09-endpoint.png)

---

## 🔑 Usimamizi wa Funguo za API

Unda, weka mawanda na batilisha funguo za API. Kila ufunguo unaweza kuzuiwa kwa modeli/watoa huduma mahususi ukiwa na ufikiaji kamili au ruhusa za kusoma pekee. Usimamizi unaoonekana wa funguo wenye ufuatiliaji wa matumizi.

---

## 📋 Kumbukumbu ya Ukaguzi

Ufuatiliaji wa vitendo vya kiutawala wenye uchujaji kwa aina ya kitendo, mtendaji, lengo, anwani ya IP na muhuri wa muda. Historia kamili ya matukio ya usalama.

---

## 🖥️ Programu ya Eneo-kazi

Programu asilia ya eneo-kazi ya Electron kwa Windows, macOS na Linux. Endesha OmniRoute kama programu inayojitegemea yenye muunganisho wa trei ya mfumo, usaidizi wa nje ya mtandao, usasishaji kiotomatiki na usakinishaji wa mbofyo mmoja.

Vipengele muhimu:

- Ukaguzi wa mara kwa mara wa utayari wa seva (hakuna skrini tupu wakati wa kuanzisha kutoka hali baridi)
- Trei ya mfumo yenye usimamizi wa porti
- Sera ya Usalama wa Maudhui
- Kufuli la instansi moja
- Usasishaji kiotomatiki wakati wa kuwasha upya
- UI inayotegemea mfumo (vitufe vya dirisha vya macOS, upau-msingi wa kichwa wa Windows/Linux)
- Ufungashaji ulioimarishwa wa toleo la Electron — `node_modules` zilizounganishwa kwa viungo vya kiishara katika kifurushi kinachojitegemea hugunduliwa na kukataliwa kabla ya kufungasha, hivyo kuzuia utegemezi wa wakati wa utekelezaji kwa mashine ya ujenzi (v2.5.5+)
- **Uzimaji salama** — `before-quit` ya Electron huzima Next.js kwa usahihi, hivyo kuzuia kufungwa kwa hifadhidata ya SQLite WAL (v3.6.2+)

📖 Tazama [`electron/README.md`](../../electron/README.md) kwa nyaraka kamili.

---

## 🌐 Daraja la WebSocket la V1 _(v3.6.6+)_

OmniRoute sasa inatumia **viteja vya WebSocket vinavyooana na OpenAI** kupitia endpoint ya uboreshaji ya `/v1/ws`. Seva maalum ya `scripts/dev/v1-ws-bridge.mjs` hufunika Next.js na kuboresha miunganisho ya WS kuwa vipindi kamili vya utiririshaji wa pande mbili. Uthibitishaji hutumia ufunguo uleule wa API au kidakuzi cha kipindi kama maombi ya HTTP.

Tabia muhimu:

- Uboreshaji wa WS huthibitishwa na `src/lib/ws/handshake.ts` kabla ya muunganisho kuanzishwa
- Mitiririko husitishwa kwa usahihi kipindi kinapofungwa au hitilafu ya chanzo cha juu inapotokea
- Hufanya kazi kwa wakati mmoja sambamba na njia iliyopo ya utiririshaji ya HTTP+SSE

---

## 🔑 Tokeni za Usawazishaji na Kifurushi cha Usanidi _(v3.6.6+)_

Ufikiaji kutoka vifaa vingi na waendeshaji wa nje sasa unawezekana kupitia **tokeni za usawazishaji zenye mawanda maalum**:

- **`POST /api/sync/tokens`** — Toa tokeni mpya ya usawazishaji (yenye mawanda maalum na muda wa hiari wa kuisha)
- **`DELETE /api/sync/tokens/:id`** — Batilisha tokeni
- **`GET /api/sync/bundle`** — Pakua nakala ya JSON ya usanidi yenye toleo na inayotambulishwa kwa `ETag` (inathibitishwa kwa tokeni ya usawazishaji pekee). Mipangilio ya uthibitishaji kama vile nenosiri la dashibodi huondolewa, lakini vitambulisho vya watoa huduma na funguo za API hujumuishwa, kwa hivyo lichukulie faili hilo kama siri

Kifurushi cha usanidi huundwa na `src/lib/sync/bundle.ts`. Watumiaji hulinganisha kichwa cha jibu cha `ETag` ili kugundua mabadiliko bila kupakua upya data yote. Kutoka kwenye CLI, `omniroute sync bundle <outPath> --token <syncToken>` (au `OMNIROUTE_SYNC_TOKEN`) hukihifadhi kwenye faili inayoweza kufikiwa na mmiliki pekee.

---

## 🧠 Mpangilio Awali wa Kufikiri wa GLM _(v3.6.6+)_

**GLM Thinking (`glmt`)** sasa ni mtoa huduma mkuu aliyesajiliwa: kiwango cha juu cha tokeni 65 536 za matokeo, bajeti ya kufikiri ya 24 576, muda chaguo-msingi wa kuisha wa sekunde 900, muundo wa API unaooana na Claude, na usawazishaji wa pamoja wa matumizi na familia ya GLM.

**Uhesabuji mseto wa tokeni** pia umeongezwa katika v3.6.6: mtoa huduma anayeoana na Claude anapowasilisha `/messages/count_tokens`, OmniRoute huiita kabla ya maombi makubwa, huku ikitumia kwa urahisi ukadiriaji kama mbadala.

---

## 🛡️ Uletaji Salama wa Data Zinazotoka na Kinga ya SSRF _(v3.6.6+)_

Uthibitishaji wote wa watoa huduma na miito ya ugunduzi wa modeli sasa hupitia kinga ya safu mbili ya miunganisho inayotoka:

1. **Kinga ya URL** (`src/shared/network/outboundUrlGuard.ts`) — Huzuia masafa ya anwani za IP za faragha/loopback/link-local kabla soketi haijafunguliwa.
2. **Kifungashio salama cha uletaji** (`src/shared/network/safeOutboundFetch.ts`) — Hutumia kinga ya URL, husawazisha muda wa kuisha, na hujaribu tena hitilafu za muda kwa ongezeko la muda wa kusubiri kwa mpangilio wa eksponenti.

Ukiukaji wa kinga huwasilishwa kama HTTP 422 (`URL_GUARD_BLOCKED`) na huandikwa kwenye kumbukumbu ya ukaguzi wa uzingatiaji kupitia `providerAudit.ts`.

---

## 🔄 Majaribio Yanayozingatia Kipindi cha Kusubiri _(v3.6.6+)_

Maombi ya gumzo sasa **hujaribiwa tena kiotomatiki** wakati mtoa huduma wa juu anaporejesha kipindi cha kusubiri kinachohusu modeli mahususi. Huweza kusanidiwa kupitia `REQUEST_RETRY` (chaguo-msingi: 2) na `MAX_RETRY_INTERVAL_SEC` (chaguo-msingi: sekunde 30). Ujifunzaji wa vichwa vya ukomo wa kiwango umeboreshwa katika `x-ratelimit-reset-requests`, `x-ratelimit-reset-tokens`, na `Retry-After` — hali ya kipindi cha kusubiri kwa kila modeli inaonekana kwenye dashibodi ya Ustahimilivu.

---

## 📋 Ukaguzi wa Uzingatiaji v2 _(v3.6.6+)_

Kumbukumbu ya ukaguzi imepanuliwa kwa kuongeza uorodheshaji wa kurasa unaotumia kielekezi, uboreshaji wa muktadha wa ombi (kitambulisho cha ombi, wakala wa mtumiaji, IP), matukio ya uthibitishaji yaliyopangwa, matukio ya CRUD ya watoa huduma yenye muktadha wa tofauti, na uwekaji kumbukumbu wa uthibitishaji uliozuiwa na SSRF. Matukio mapya hutolewa na `src/lib/compliance/providerAudit.ts`.