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

# 🚀 OmniRoute — 免費 AI 閘道 OmniRoute — 永不停止編寫程式碼。每款 AI 工具 → 372 個提供者 — 150+ 個免費方案 — 全部透過單一端點。將 Claude Code、Codex、Cursor、Cline、Copilot 與 Antigravity 接入免費的 Claude / GPT / Gemini，並支援自動備援。RTK + Caveman 疊加壓縮可節省 15–95% 的 Token（平均約 89%）— 永不觸及限制。372 個 AI 提供者 · 150+ 個免費方案 · 每月約 1.62B 個免費 Token · 19 種路由策略 · $0 即可開始。
## 💰 透過第三方免費方案每月約可使用 1.62B Token
> **使用您自己的提供者帳戶。** 這是分別符合資格的第三方免費方案之預估總量，並非 OmniRoute 提供的 Token 額度。請註冊帳戶、在需要時取得憑證，並連接您可以使用的提供者；每個提供者均自行管理其限制、可用性與條款。 > > 手動疊加免費方案相當麻煩——數十個 SDK、數十種速率限制，而且完全不知道自己實際擁有多少額度。OmniRoute 收錄了 **35 個週期性額度池鍵中的 489 個免費方案項目**，並根據**具有公開正數月度預算的 17 個額度池，加上五個 Groq 單模型上限**計算 Token 標示總量，同時依共用額度池進行去重。只有在通過地區身分驗證後才能使用的配額（目前為 ModelScope）會分開顯示，在地區身分驗證後可額外獲得約 6M，且絕不計入標示總量。結果會持續顯示於儀表板（`/dashboard/free-tiers`）。 OmniRoute 免費方案預算卡：每月穩定提供約 1.62B 個免費 Token，若計入註冊贈送額度，首月最高可達約 2.22B；35 個有文件記載的週期性額度池鍵，涵蓋透過單一端點使用的 489 個已收錄免費方案項目。誠實採用額度池去重計算——每個共用額度池僅計算一次，其中包括 17 個具有公開正數月度 Token 預算的週期性額度池，以及五個 Groq 單模型上限；條款風險目錄中有 13 家提供者被標記為應避免使用，最終由您自行決定。預算列包括 Mistral 1B、Nara 210M、LLM7 150M、xKiro 150M、Groq 30M（五個單模型上限）及其他較小額度池；首月註冊贈送額度與永久免費且無 Token 上限的提供者則分開顯示，絕不虛增標示總量。可在 /dashboard/free-tiers 即時查看已用與剩餘額度。 > 即時 `/dashboard/free-tiers` 頁面的動畫摘要。完整方法（額度池去重、贈送額度層級、提供者條款）：**[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**。 > > 我們每兩週都會根據即時目錄重新稽核這些數據，而且數字**可能上升，也可能下降**——提供者終止免費方案時，數字就會下降；新增免費方案時，數字則會上升。我們公布的是目錄實際計算出的結果，絕不採用向上取整的最佳情況。

⭐ 如果 OMNIROUTE 幫您節省了費用並讓工作更輕鬆，請為此儲存庫加上星號。

[![星號](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![星號歷史排名](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 加入社群 **👋 關注維護者——搶先獲得新提供者、版本發布與技巧資訊：** [![在 LinkedIn 上關注 Diego](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![在 GitHub 上關注 @diegosouzapw](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp 全球社群](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp 巴西社群](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![網站](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **問題、提供者資訊、開發藍圖與支援 → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 全球社群](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 巴西社群](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [入口網站](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 閘道持續成長
| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ---------------------- | :-------------------: | :---------: | :-------------------: | | 🌐 提供者 | 352 | **358** | 372 | | 🧠 不重複的聊天模型 ID | 1320 | **1374** | 1443 | | 🖼️ 模態橋接 | 🆕 視覺 + 音訊 + 影片 | ✓ | ✓ | | 📡 Radar 免費目錄 | 🆕 選擇性加入 | ✓ | ✓ | | ⚖️ 配額感知排程 | 🆕 Quota-Share | ✓ | ✓ | | 📊 配額遙測 | 🆕 即時資料 | ✓ | ✓ | | 🧰 無頭模式 | — | — | 🆕 `serve --headless` | | 🛤️ LTS 軌道基礎架構 | — | — | 🆕 發布通道 | **→ [路線圖](ROADMAP.md) — 沿著軌道邁向 `v3.9.0 LTS`**

## 🧩 可用版本 [![npm 版本](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM 每月下載量](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![授權條款：MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker 拉取次數](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron 下載次數](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)
🚀 開始使用 🚀 快速開始 📦 安裝 🆓 零設定
💡 瞭解更多 💥 承諾 🤔 為何選擇 OmniRoute 🏆 獨特之處
⚙️ 功能 🎯 組合 🌐 提供者 🔌 CLI 與 MCP
🗜️ 壓縮 🖥️ 執行環境 🔒 隱私
👀 查看展示 🎬 實際運作 ✨ 最新內容 🤖 相容的 CLI
💚 支持 💚 支持／捐款 💬 社群 💖 贊助者
📦 專案 🛠️ 技術堆疊 📖 文件 👥 貢獻者
🌐 提供 67 種語言

英文 (en) Português — Brasil (pt-BR) Português (pt) Español (es) Français (fr) Italiano (it) Deutsch (de) Nederlands (nl) Русский (ru) Українська (uk-UA) Polski (pl) Čeština (cs) Slovenčina (sk) Română (ro) Magyar (hu) Български (bg) Dansk (da) Suomi (fi) Norsk (no) Svenska (sv) 中文 — 簡體 (zh-CN) 中文 — 繁體 (zh-TW) 日本語 (ja) 한국어 (ko) ไทย (th) Tiếng Việt (vi) Bahasa Indonesia (id) Bahasa Melayu (ms) Filipino (phi) हिन्दी (hi) ગુજરાતી (gu) मराठी (mr) தமிழ் (ta) తెలుగు (te) বাংলা (bn) اردو (ur) فارسی (fa) العربية (ar) עברית (he) Türkçe (tr) Azərbaycan (az) Kiswahili (sw) Ελληνικά (el) Hrvatski (hr) Српски (sr) Lietuvių (lt) Eesti (et) Latviešu (lv) Slovenščina (sl) Malti (mt) Gaeilge (ga) ಕನ್ನಡ (kn) മലയാളം (ml) ଓଡ଼ିଆ (or) ਪੰਜਾਬੀ (pa) नेपाली (ne) සිංහල (si) မြန်မာ (my) ខ្មែរ (km) Hausa (ha) Yorùbá (yo) Igbo (ig) አማርኛ (am) Oʻzbekcha (uz) ქართული (ka) Հայերեն (hy) Bosanski (bs)


## 🆓 安裝、連接提供者，然後透過單一端點路由
三個步驟：安裝並啟動 OmniRoute、使用您自己的帳戶或 API 金鑰連接符合資格的提供者，然後使用 OmniRoute API 金鑰和 auto 模型，將您的工具指向 localhost:20128/v1。路由取決於可用且符合資格的連線及提供者限制。 ```bash # 連接提供者後，從 Dashboard → Endpoints 複製您的 OmniRoute 金鑰： curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` `auto` 需要符合資格的路由。全新安裝可能沒有符合資格的無金鑰目標，而無金鑰提供者也可能拒絕第三方用戶端。標記為 `tos: avoid` 的提供者（包括 OpenCode Free 和 Kiro）預設會被排除在自動路由之外；連接帳戶不會覆寫該設定。選擇提供者之前，請參閱[免費方案指南](docs/getting-started/FREE-TIERS-GUIDE.md)。 📦 適用於 **Python、Node.js、PHP 和 cURL** 的可直接複製貼上快速入門指令碼 → [`examples/quickstart/`](examples/quickstart/)
# 💥 我們的承諾
我們的承諾 — 單一端點與 372 個提供者。只要仍有其他健康的目標可用，自動容錯移轉便會持續進行路由。六大支柱：涵蓋 372 個提供者的韌性容錯移轉 · 符合資格的工作負載最多可節省 95% 的權杖 · 以 $0 起步，提供 150+ 個免費方案，以及 54 個週期性／無金鑰且永久免費的提供者 · 透過單一設定支援 36 種 CLI／代理程式整合 · 在 /v1 相容於 OpenAI、Claude、Gemini 和 Responses API · 生產環境控制功能，包括斷路器、TLS 隱匿、具備 110 項工具的 MCP、A2A、記憶體、護欄、評估，以及分布於 5,100+ 個受追蹤測試檔案中的 39,000+ 項靜態測試宣告。

# 🤔 為什麼選擇 OmniRoute？
為什麼選擇 OmniRoute — 不必再周旋於 10 個儀表板、失效的 API 金鑰和意外帳單之間。十大日常痛點與解決方式：配額未使用便到期 → 充分利用訂閱；寫程式途中遇到速率限制 → 4 層自動容錯移轉（訂閱 → API → 低價 → 免費）；工具輸出消耗大量權杖 → RTK + Caveman 壓縮（15–95%）；API 費用高昂 → 成本最佳化路由；每個工具都有各自的設定 → 單一端點、單一儀表板；AI 遭封鎖 → 3 級代理伺服器 + TLS 隱匿；金鑰失效 → 3 層韌性機制（斷路器、金鑰冷卻、模型鎖定）；團隊共用單一訂閱 → 具備公平分配配額的金鑰池；提示詞經過他人的雲端 → 本機優先，並使用 AES-256-GCM 加密金鑰；無法掌握支出 → 即時分析（使用量、配額、節省金額、p95 延遲）。
OmniRoute 請求流程：您的 IDE 或 CLI（Claude Code、Cursor、Cline……）呼叫單一本機端點（http://localhost:20128/v1）；只要仍有符合資格且健康的目標，OmniRoute Smart Router（RTK + Caveman 壓縮、19 種路由策略、斷路器、TLS 隱匿、MCP、A2A、護欄）便可在 4 個提供者層級之間進行容錯移轉 — 第 1 層：訂閱、第 2 層：API 金鑰、第 3 層：低價、第 4 層：免費。

## 🤝 由我們的開源夥伴支持

Kimi K3 — Open Frontier Intelligence · 2.8T parameters · 1M-token context

> **想加入成為開源夥伴嗎？** 這些公司支持開源並幫助 OmniRoute 持續發展 — 我們公開說明他們提供的每一筆資金的用途。請聯繫：[diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi (Moonshot AI)
Kimi
Moonshot AI

Founding Open Source Friend 		感謝我們的創始開源夥伴 Kimi (月之暗面) 對本專案的支持！Kimi 是開源權重 K2 和 K3 模型系列背後的 AI 實驗室 — Kimi K3 提供 1M-token 的上下文視窗、原生視覺和前沿級別的編碼能力，價格僅為閉源模型的一小部分，並且與 Claude Code、Codex 以及 OmniRoute 支援的所有編碼工具開箱即用。

Kimi 的支持用途： Kimi 的 API 積分為 OmniRoute 的 AI 驗證發布流程提供動力 — 即在每個拉取請求發布前進行審查的 由 Kimi K3 提供支援的合併驗證 階段 — 以及日常功能開發。一流的 Kimi 支援透過兩種方式提供：直接的 Kimi API (kimi-k3) 和 Kimi Code 編碼方案 (OAuth 和 API 金鑰)。OmniRoute 也是 Kimi 支援計畫中第一個巴西開源專案。獲取 Kimi API 金鑰，額外獲得 15% 積分 →
Cheaper Inference
Cheaper Inference
cheaperinference.com

Open Source Friend 		感謝 OmniRoute 的開源夥伴 Cheaper Inference 對本專案的支持！Cheaper Inference 是一個按成本排名的閘道，透過一個與 OpenAI 相容的端點轉售 42 個前沿模型 — Claude、GPT-5.x、Gemini、Kimi K3、GLM、DeepSeek、Grok 和 MiniMax — 將每個請求路由到最便宜的合格提供者，且絕不收取高於模型製造商標價的費用。

OmniRoute 中的一流支援： 聊天補全、原生 /v1/responses 端點、視覺、工具呼叫以及 3 個圖像模型 (grok-imagine、nano-banana-pro、nano-banana-2，可透過 cheaperinference/<model> 訪問)。獲取 API 金鑰 →
標記為 aff=omniroute 的連結是合作夥伴連結。它們在不增加您費用的情況下資助本專案。
🎟️ 聯盟推廣 — 我們未贊助的提供者提供的免費註冊優惠券（點擊展開） 本節僅適用於推薦/優惠券代碼。贊助合作夥伴關係位於上方的 **🤝 由我們的開源夥伴支持** 中。OmniRoute 與此處列出的提供者沒有任何贊助或合作關係 — 這些是任何人都可以使用的公開優惠券。
AgentRouter
AgentRouter
agentrouter.org 		AgentRouter — 聯盟註冊 · 註冊即送 $100 免費積分（免費伺服器，預計延遲較高 — 最適合測試，不適合生產）。自 v3.8.50 起在 OmniRoute 中提供一流支援：聊天補全、與 Anthropic 相容的線路格式和與 OpenAI 相容的路徑。可用模型包括 claude-opus-4-8、claude-opus-5、gpt-5.6-sol 等。領取您的 $100 →

⚠️ 聯盟連結 — OmniRoute 與此提供者沒有任何贊助或合作關係。
知道還有其他提供慷慨免費註冊優惠券且對 OmniRoute 用戶有益的提供者嗎？請提出一個 issue，我們會將其添加到這裡。

## 🎯 Combo — 旗艦功能
全部 19 種 Combo 路由策略的動畫展示——每種策略各一格：priority、fill-first、weighted、round-robin、p2c、least-used、random、strict-random、cost-optimized、headroom、reset-window、reset-aware、context-relay、context-optimized、cache-optimized、lkgp、auto、fusion、pipeline。各策略的功能請參閱上方表格。 > **Combo** 是一連串由 OmniRoute **自動**進行跨模型路由的模型鏈。如果配額用盡、提供者發生故障或成本激增，Combo 可移至下一個符合條件且健康的模型。🛡️ ### ⚡ 零設定——只需使用 `auto` 無須建立 Combo。將模型設為 `auto`（或其變體），OmniRoute 就會根據已連線的提供者建立虛擬 Combo，並即時評分：
模型 ID最佳化目標
auto🎯 平衡的預設選項（LKGP——持續使用上次運作良好的提供者）
auto/coding🧑💻 針對程式碼生成的品質優先權重
auto/fast⚡ 優先選擇最低延遲
auto/cheap💰 優先選擇每個 token 成本最低者
auto/offline🔋 優先選擇配額／速率限制餘裕最大者
auto/smart🔭 品質優先，並加入 10% 探索以發掘更好的模型
auto/lkgp📌 明確黏著於最後一個已知運作良好的提供者
auto/chaos🧪 平行扇出至一組模型（每個提供者一個，預設為 5 個），並傳回一個答案；每個面板模型各進行一次上游呼叫，而非故障注入
## ### 🔀 或自行建立——19 種路由策略 全部 **19** 種策略——可在每個 Combo 步驟中混搭：
# 策略 功能
1 priority 第一目標優先的排序清單——用盡一個目標後再移至下一個 🥇
2 fill-first 先完整用盡每個目標的配額，再移至下一個
3 weighted 依各目標權重進行加權隨機選擇
4 round-robin 依序輪流使用各個目標
5 p2c 二選一隨機負載平衡
6 least-used 選擇目前負載最低的目標
7 random 均勻隨機選擇（去除重複）
8 strict-random 隨機選擇且不移除重複項目 🎲
9 cost-optimized 依即時目錄定價，將每次請求的成本降至最低 💸
10 headroom 選擇剩餘配額最多的目標
11 reset-window 優先選擇配額週期最快重設的目標
12 reset-aware 依配額重設時間排序——短週期優先 📊
13 context-relay 在不同目標間轉交上下文，以支援長時間對話 🧠
14 context-optimized 選擇最適合目前上下文大小的目標
15 cache-optimized 將每個可重複使用的提示詞前綴固定至同一帳號——最大化提示詞快取命中率 🎯
16 lkgp 最後已知良好路徑（Last-Known-Good Path）——固定使用最後一次成功的提供者，之後再依規則進行備援
17 auto 針對每個連線進行 16 項因素的即時評分 🤖
18 fusion 扇出至一組模型，再由評審模型綜合產生一個答案 🧬
19 pipeline 串連多個步驟——每個目標的輸出會傳入下一個目標 🔗
Auto-Combo 引擎會根據 **16 項因素**（健康狀態、配額、成本、延遲、任務適配度、品質、工作階段可用性……）對每個候選項目評分——請參閱 [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)。 ## ### 🧱 內建韌性（3 個獨立層級） OmniRoute 韌性機制 — 3 個彼此獨立的自我修復層級，針對不同故障採用適當層級。第 1 層：提供者斷路器（整個提供者）：僅在 408/5xx 時觸發，閾值為 OAuth 8 次 / API 金鑰 12 次 / 本機 2 次，經過 60 秒/30 秒/15 秒後重設並進入 HALF-OPEN 探測，採用惰性復原；處於 OPEN 狀態時，組合會重新路由至下一個提供者。第 2 層：連線冷卻（一個金鑰/帳戶）：OAuth 基準為 5 秒 / API 金鑰為 3 秒，採用指數 ×2 退避並具備防驚群保護，429 會遵循 Retry-After，成功後會清除所有錯誤狀態；正在冷卻的金鑰會被略過，而同組的其他金鑰會繼續提供服務。第 3 層：模型鎖定（一個模型）：每個模型各自的 429、本機 404 或模式拒絕只會鎖定該模型，而不會鎖定整個連線。終止狀態（遭封禁、已過期、點數耗盡）應由操作人員處理，而非進入冷卻。 📖 [自動組合引擎](docs/routing/AUTO-COMBO.md) · [韌性指南](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute 的獨特優勢
OmniRoute 的獨特優勢——與 9router、OpenRouter、CLIProxyAPI 和 LiteLLM 針對 13 項功能所做的特定時間點功能比較。OmniRoute：支援 372 個提供者、內建 150+ 個免費方案、19 種路由策略、12 引擎權杖壓縮、內建具備 110 項工具的 MCP 伺服器、A2A 代理協定、持久記憶、護欄機制、雲端代理、TLS 指紋隱匿、Desktop/Termux/PWA，以及支援 42 種國際化 UI 語言環境。OmniRoute 採用 MIT 授權，並支援自行託管。競爭產品的功能與數量可能有所變動；請參閱連結中的方法論。 📊 完整方法論及與 9router、OpenRouter、CLIProxyAPI 和 LiteLLM 的各項功能詳細比較 → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 支持 OmniRoute OmniRoute 採用 MIT 授權，並以開放方式維護。如果它為您節省了時間或金錢，您可以透過以下方式協助它保持獨立 — 請選擇最適合您的方式。贊助絕不會影響路由優先順序；它只能換取曝光，而非排名。
⭐ 為儲存庫加上星號免費 — 確實有助於提升能見度為 OmniRoute 加上星號
🐙 GitHub Sponsors單次或每月贊助 · 平台費用為零github.com/sponsors/diegosouzapw
☕ Ko-fi快速單次贊助，贊助者無須註冊ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee小額、非正式的支持buymeacoffee.com/diegosouzapw
🖐 Liberapay定期贊助 · 非營利 · 開放原始碼liberapay.com/diegosouzapw
🇧🇷 PIX（巴西）即時、免手續費金鑰與 QR 碼如下
₿ 加密貨幣BTC · ETH · USDT-TRC20 · USDC-Solana地址如下
**🇧🇷 PIX** — 即時、免手續費（巴西） OmniRoute PIX QR 碼 金鑰（隨機）：`5d865059-bc44-483a-962d-43ceb80126eb` Pix 複製貼上碼： ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```
₿ 加密貨幣 — BTC · ETH · USDT-TRC20 · USDC-Solana（點擊展開）
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ 每種貨幣請僅透過所示網路傳送 — 使用錯誤的網路可能導致資金遺失。
🐛 發現錯誤或有意見要回饋？請建立一則[討論](https://github.com/diegosouzapw/OmniRoute/discussions)。

開發者注意事項：為方便開發者，本專案可能會在 npm install/postinstall 期間產生本機 .env 檔案。此檔案已刻意透過 .gitignore 忽略（請參閱 .gitignore），且絕不可提交 — 若不慎提交，請輪替所有可能外洩的密鑰，並從歷史記錄中移除該檔案。如需管理本機環境檔案與密鑰的指引，請參閱 docs/DEVELOPER-ENVIRONMENT.md。

## 📡 OmniRoute Radar 免費方案的主要亮點仍是上述已記錄且經資源池去重複處理的目錄所提供的**每月約 1.62B 個 token**。提供者提供的臨時註冊額度可另行將首月額度提升至**約 2.22B**。Radar 是可選用且具簽章驗證的目錄覆蓋層，適合希望在 OmniRoute 發布版本之間取得更新免費模型可用性資訊的使用者；社群目錄及所有現有免費功能仍維持免費。 贊助者可取得即時目錄及其他提供者機會。其獨立且可能變動的上限為**每月至多約 3B 個 token**，實際取決於提供者的可用性。此上限並非保證：提供者可隨時變更配額、資格條件、模型或地區。 Radar 採選擇加入制，且僅使用 GET。OmniRoute 用戶端不會上傳提示詞、流量、提供者設定、使用情況遙測資料，或本機公告忽略狀態。如需瞭解資格條件與目前目錄，請前往 **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**。
## ✨ 最新功能
> **v3.8.20 → v3.8.50** 的近期亮點。完整歷史記錄請見 [`CHANGELOG.md`](CHANGELOG.md)。 - **🎛️ OmniConductor** — 將傳入的 A2A 委派給您的代理程式叢集、在 Agent Card 上提供 Conductor 技能，以及包含 Faro 按鍵通話語音聊天的儀表板面板。→ [A2A 伺服器](docs/frameworks/A2A-SERVER.md) - **🛂 自適應准入與過載保護** — 重量級聊天請求會排入佇列，而非回傳 503；每個連線均採用原子化 RPM 滾動租約。→ [韌性指南](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ 標準化 `/v1/models` 排序** — 每個提供者各自形成一個連續且依提供者分組的區塊（組合固定置頂），並在所有目錄來源中維持穩定順序。→ [API 參考](docs/reference/API_REFERENCE.md) - **🗜️ 強化壓縮** — 預設啟用膨脹防護、適用於 DE / FR / JA 與中文（文言）的 Caveman 套件，以及適用於 Gradle 和 .NET 的 RTK 篩選器。→ [壓縮](docs/compression/COMPRESSION_ENGINES.md) - **💸 如實呈現固定費率成本** — 訂閱／程式設計方案提供者在成本分析中顯示為 **$0**；預算、配額與路由仍會持續估算。→ [API 參考](docs/reference/API_REFERENCE.md) - **⚖️ 配額共享路由** — 在集區金鑰之間公平分配共用帳戶的配額，並採用工作守恆機制，將閒置份額借予其他金鑰使用。→ [韌性指南](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 單一命令完成 CLI／代理程式設定** — 13 個已註冊的 `setup-*` 命令；`omniroute run` 可啟動 7 個 CLI（Claude Code、Codex、Aider、Goose、OpenCode、Qwen Code、Gemini CLI）；`omniroute configure` 支援 10 個目標，提供互動式提供者與模型選擇器，以及依情境設定的最愛項目。→ [CLI 整合](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ 遠端模式** — 使用具範圍限制的權杖（`connect` / `contexts` / `tokens`）操作遠端 OmniRoute，另提供適用於 VPS 安裝的 `antigravity` OAuth 輔助工具。→ [遠端模式](docs/guides/REMOTE-MODE.md) - **🧭 更智慧的自動路由** — `auto/:` 組合、**Fusion**（模型評議小組 + 裁判）、可感知任務的路由，以及每項請求的模型／模式／USD 預算覆寫。→ [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ 可插拔壓縮** — 12 個可組合引擎與 Compression Studios：LLMLingua-2、雙層 Ultra、omniglyph、逐步保真度閘門、GCF v3.2，以及拖放重新排序編輯器。→ [壓縮](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ 透明 MITM 解密（TPROXY）** — 攔截忽略 Proxy 環境變數的 CLI，並提供逐 SNI CA 與信任存放區安裝程式。→ [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 無所不在的成本遙測** — 每個端點均提供 `X-OmniRoute-*` 成本／用量標頭、快取命中節省標頭，以及每個金鑰的 USD 支出配額。→ [API 參考](docs/reference/API_REFERENCE.md) - **🧠 由您掌控的記憶體** — 預設關閉，可選擇啟用 int8 向量量化與類型化衰減，並可為每項請求設定 `x-omniroute-no-memory`。→ [記憶體](docs/frameworks/MEMORY.md) - **🛡️ 安全性** — 所有 LLM 路由皆具備提示詞注入防護（紅隊測試套件）、可選擇啟用的憑證遮罩防護機制（雙向刪節外洩的 API 金鑰／祕密）、免費的 DuckDuckGo 最後手段網路搜尋，以及可選用的儀表板 OIDC 登入閘門（密碼登入一律維持可用）。→ [防護機制](docs/security/GUARDRAILS.md) - **🖼️ 新端點** — `/v1/ocr`（Mistral OCR）與 `/v1/audio/translations`（Whisper 風格）進一步完善媒體功能介面。→ [API 參考](docs/reference/API_REFERENCE.md) - **🎨 圖片／影片／音訊生成** — 以單一 API 處理媒體：xAI Grok Imagine 與 Novita AI 影片、ComfyUI、Magnific、Adobe Firefly、Segmind，以及 ElevenLabs 等語音提供者。→ [API 參考](docs/reference/API_REFERENCE.md) - **🌍 部署與維運** — 反向代理 `basePath`、瀏覽器語言自動偵測、每個金鑰的裝置追蹤、無需 root 的 MITM 信任機制，以及 zh-TW 在地化。→ [環境](docs/reference/ENVIRONMENT.md) - **🤝 更多提供者與代理程式** — 雲端代理程式（Codex Cloud、Cursor、Devin、Jules）、具備瀏覽器與 OAuth 登入功能的 Grok Build（xAI）、一級支援的 Ollama 卡片、Claude Opus 5 與 Sonnet 5、Kimi 官方合作夥伴關係（Code/Web/Moonshot）、Zed、Requesty、SenseNova、Yuanbao、Agnes AI……以及全面更新的 **352 個提供者目錄**。→ [提供者](docs/reference/PROVIDER_REFERENCE.md) - **📡 路由透明度** — 每個回應都會包含 `X-OmniRoute-Decision` 標頭，標明為其提供服務的策略／提供者／延遲；全新的 `cache-optimized` 組合策略與 Auto-Combo `cacheAffinity` 因子會將重複請求路由回持有快取前綴的連線；唯讀的 `/v1/auto-combo/{channel}/candidates` 端點則會公開 `auto/*` 通道的即時候選集區。→ [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ 本機效能與基礎架構** — 一鍵式本機 Redis、Cloudflare Workers / Deno Deploy 中繼部署工具，以及作為受監管內嵌服務執行的 Bifrost 與 Mux。→ [內嵌服務](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 其他內建功能** — 外掛框架與市集、Omni/Agent/GitHub 技能框架、Obsidian 儲存庫整合（22 個 MCP 工具）、OpenAI 相容的 Batch 與 Files API、語意回應快取、含排行榜的遊戲化機制、ACP 代理程式探索（15 個內建代理程式）、排程匯出日誌至 BigQuery、`auto/chaos` 平行多模型扇出、Telegram 機器人橋接器、應用程式內版本管理器，以及 LMArena-ELO 免費提供者排名。→ [文件](docs/README.md)
## 🤖 相容的 CLI 與程式設計代理 > 一份設定 — `http://localhost:20128/v1` — 即可讓**所有** AI IDE 或 CLI 使用免費與低成本模型。
Claude Code
Claude Code
                           		 Codex CLI
Codex CLI
                           		 Cline
Cline
                           		 Kilo Code
Kilo Code
 Zoo Code
Zoo Code
 Continue
Continue
                           
Aider
Aider
                           		 ForgeCode
ForgeCode
                           		 jcode
jcode
                           		 DeepSeek TUI
DeepSeek TUI
                           		 CodeWhale
CodeWhale
                           		 OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           		 GitHub Copilot CLI
Copilot CLI
                           		 Cursor CLI
Cursor CLI
                           		 Smelt
Smelt
                           		 Pi (pi-coding-agent)
Pi
                           		 Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           		 OpenClaw
OpenClaw
                           		 Goose
Goose
                           		 Open Interpreter
Open Interpreter
                           		 Warp AI
Warp AI
                           		 deyin.ai
deyin.ai
                           
＋ 亦適用於 · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · 任何與 OpenAI 相容的工具
📖 全部 36 個工具（26 個 CLI Code + 10 個 CLI Agent）的個別設定方式 → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode 外掛程式 → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)

**只需一個命令，即可透過 OmniRoute 啟動任何支援的 CLI** — 不會寫入設定檔、 憑證會按處理程序注入，且 Qwen/Gemini 會使用拋棄式的隔離主目錄： ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # 或以互動方式選擇提供者與模型，並寫入工具本身的設定： omniroute configure codex # 亦支援：claude opencode qwen aider goose gemini cline continue kilo ``` 每個命令都會遵循目前使用中的遠端情境（`omniroute connect `）；`--dry-run` 可在不執行的情況下預覽確切的環境變數／引數，而 `--api-key-env NAME` 則可避免 祕密出現在你的 shell 歷程記錄中。→ [CLI 整合](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 個 AI 提供者 — 154 個標記於目錄中為免費
> **372 個已註冊的提供者**，涵蓋標準的聊天、媒體、搜尋、本機、雲端代理及系統集合，其中 **154 個帶有 `hasFree: true` 探索中繼資料**。聊天模型登錄庫涵蓋 **237 個提供者 / 3,009 個不同的提供者－模型配對 / 1,443 個原始模型 ID**；獨立的免費額度目錄則包含 **491 筆逐模型資料列**、**35 個週期性資源池**，以及 **54 個提供週期性或免金鑰永久免費方案的提供者**。這些資料依設計採用不同的分母；定義及排除重複資源池後的計算方式，請參閱[提供者參考資料](docs/reference/PROVIDER_REFERENCE.md)與[免費方案](docs/reference/FREE_TIERS.md)。
### 🏢 所有主要實驗室 — 透過單一端點存取
OpenAI
OpenAI
                           		 Anthropic
Anthropic
                           		 Gemini
Gemini
                           		 xAI Grok
xAI Grok
                           		 DeepSeek
DeepSeek
                           		 Mistral
Mistral
                           
Qwen
Qwen
                           		 Meta Llama
Meta Llama
                           		 Groq
Groq
                           		 NVIDIA
NVIDIA
                           		 MiniMax
MiniMax
                           		 Cohere
Cohere
                           
Perplexity
Perplexity
                           		 Hugging Face
HuggingFace
                           		 Together
Together
                           		 Fireworks
Fireworks
                           		 Cloudflare
Cloudflare
                           		 Baidu
Baidu
                           
……以及另外 330 多個提供者 — 每個圖示皆即時取自儀表板的提供者目錄。📖 [提供者參考資料](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 永久免費 — $0，無須信用卡
OpenCode Zen
OpenCode Zen
DeepSeek V4、Nemotron 3
無 token 上限		 Kilo Code
Kilo Code
自動路由、Tencent Hy3
永久免費		 Requesty
Requesty
GPT-OSS 120B、Nemotron
永久免費		 SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
免費方案		 Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
永久免費		 Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
永久免費
Qoder AI
Qoder AI
Qwen3-Max、Kimi-K2
無限量免費		 Pollinations
Pollinations
GPT、Llama、Claude
不需要金鑰		 Cloudflare AI
Cloudflare AI
50+ 個模型
每天 10K 個神經元		 NVIDIA NIM
NVIDIA NIM
GLM、MiniMax
免費約 40 RPM		 Cerebras
Cerebras
GLM 4.7、GPT-OSS
一次性 $5 額度；需綁定信用卡		 OpenRouter
OpenRouter
:free 模型
+$10 → 更高的 RPM
📖 完整的機器可讀目錄 → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute 可在何處執行 — 任何地方
> 同一個應用程式、您的裝置、您的規則。從全域 npm 安裝，到透過 Termux 在**您的手機**上執行。
平台安裝方式特色
📦 npm（全域）npm install -g omniroute一行指令，適用於任何作業系統
🐳 Dockerdocker run … diegosouzapw/omniroute多架構支援：AMD64 + ARM64
🖥️ 桌面版（Electron）npm run electron:build原生視窗 + 系統匣 — Windows / macOS / Linux
🎩 選單列（OmniRouteTray）brew install --cask zoispag/tap/omniroute-tray監控伺服器並自動更新 — macOS
💪 ARM原生 arm64Raspberry Pi、ARM 伺服器、Apple Silicon
📱 Android（Termux）pkg install nodejs && npx -y omniroute直接在您的手機上全天候執行，無需 root
📲 PWA「新增至主畫面」全螢幕、離線可用、可從瀏覽器安裝
🧩 OpenCode 外掛程式@omniroute/opencode-provider原生 OpenCode 整合
🤖 VS Code Copilot Chat安裝 OmniCopilot 擴充功能在原生 Copilot Chat 選擇器中使用所有 OmniRoute 模型 — 穩定版與 Insiders
🛠️ 從原始碼執行npm install && npm run dev自行修改、參與貢獻
📖 [Docker 指南](docs/guides/DOCKER_GUIDE.md) · [桌面版](electron/README.md) · [選單列系統匣](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)
### 🧩 全新功能：在 VS Code 原生 Copilot Chat 中使用 OmniRoute
> 無需新側邊欄，也無需新的聊天介面 — OmniRoute 提供的每個模型都會直接顯示在 > **您原本就在使用的 Copilot Chat 模型選擇器中**。從 VS Code 1.122 起，提供者模型無需 > 登入 GitHub 或訂閱 Copilot 即可使用 — 免費享有代理程式模式、工具呼叫及視覺功能。 安裝 **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** 擴充功能，將它指向 您的 OmniRoute 伺服器（預設為 `localhost:20128`），然後開啟 Copilot Chat → 模型選擇器 → **管理模型…** → **OmniRoute**。
商店連結相容於
🧩 VS Code Marketplace安裝 →VS Code — 穩定版與 Insiders
🔓 Open VSX Registry安裝 →Cursor、Windsurf、VSCodium、Theia、code-server、Gitpod、Antigravity、Kiro…
在編輯器中：開啟**擴充功能**檢視，搜尋 **「OmniRoute」**，然後按一下**安裝** — 在兩個商店中的使用方式完全相同。原始碼、問題追蹤及發佈操作手冊位於 [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)。 📖 [VS Code Copilot Chat 指南](docs/guides/VSCODE-COPILOT.md) — 設定、選擇器顯示的內容、分頁內儀表板、疑難排解
### 🎩 全新功能：OmniRouteTray — 常駐選單列的閘道
> `omniroute serve` 最適合持續運行。**[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > 將它變成設定完成後即可放著不管的 macOS 選單列應用程式：它會啟動伺服器、讓伺服器 > 在重新啟動後持續運行、就地更新，並讓您一鍵查看即時權杖額度 — **無需 > 保持終端機視窗開啟，也無需費心維護 `npm install -g omniroute`。** 它使用 [Tauri v2](https://v2.tauri.app/) 建置（Rust 核心小到幾乎可忽略不計），內附 已簽署的 Node 24 執行環境，並管理由應用程式擁有的 OmniRoute 安裝，因此絕不會與您的 全域 `node`/`bun` 衝突。它會**共用您現有的 `~/.omniroute/` 設定與資料庫** — 所以它仍是 您原本執行的同一個 OmniRoute，只是多戴了一頂帽子。🎩
功能運作方式
🟢 監控伺服器啟動 omniroute serve；若已有執行中的執行個體，則接管該執行個體，而非建立重複執行個體
📊 即時用量一目瞭然提供者配額列、附重設倒數計時的 Claude 工作階段／每週限制，以及 30 天費用明細
🔄 自動就地更新分階段安裝、不可分割交換、失敗時回復 — 永遠使用最新版本
🚀 登入時啟動可選擇登入時啟動；僅顯示於選單列，不顯示 Dock 圖示
🩺 診斷與記錄一鍵執行診斷並存取伺服器記錄
```sh brew install --cask zoispag/tap/omniroute-tray ``` 偏好直接下載？請從 Releases 取得最新的 .dmg。原始碼、問題回報與建置 文件位於 zoispag/omniroute-tray。
💛 由 @zoispag 建立的社群專案——並非 OmniRoute 官方版本。
## 🔒 隱私優先與本機優先
隱私優先與本機優先 — OmniRoute 的閘道與控制平面皆在您的電腦上執行。提示會傳送至每個請求所選的上游提供者；OmniRoute 不會額外加入任何託管式提示處理中繼站，且預設停用遙測。憑證以 AES-256-GCM 加密後靜態儲存；控制措施包括 API 金鑰範圍限制、IP 篩選、速率限制、提示注入防護、上游標頭清理、選擇性 PII 遮蔽、經清理的錯誤訊息，以及本機 SQLite 稽核軌跡。OmniRoute 採用 MIT 授權，並支援自行託管。 📖 [授權](docs/architecture/AUTHZ_GUIDE.md) · [防護機制](docs/security/GUARDRAILS.md) · [合規性](docs/security/COMPLIANCE.md)
## 🔌 完整 CLI + A2A 與 MCP
> 除了伺服器之外，OmniRoute 還是一套具備 **80+ 個命令的完整命令列控制台**，並支援開放式代理協定，讓 AI 代理能夠**自行**操控它。 ### ⌨️ 真正的 CLI（不只有 `start`） ```bash omniroute # 啟動閘道與儀表板（連接埠 20128） omniroute chat # 互動式 TUI 聊天用戶端（斜線命令：/model /combo /skill /memory） omniroute setup # 引導式首次執行精靈 omniroute doctor # 診斷提供者、連接埠與原生相依套件 ``` ### 🛰️ 遠端模式 — 在這裡執行 CLI，於 VPS 上執行 OmniRoute 在伺服器上執行 OmniRoute？您可以在筆記型電腦上使用**相同的 CLI** 操控它。只需使用具範圍限制的存取權杖登入一次， 之後每個命令都會以遠端伺服器為目標。 ```bash omniroute connect 192.168.0.15 # 密碼 → 具範圍限制的權杖，儲存為一個環境 omniroute models list # ← 對遠端伺服器執行 omniroute configure codex # ← 選取遠端模型，寫入本機 Codex 設定檔 omniroute tokens create --name ci --scope read # 為其他機器簽發範圍更受限的權杖 omniroute contexts use default # ← 切換回本機伺服器 ``` 權杖範圍分為 `read` / `write` / `admin`；會產生程序的路由僅限迴路介面使用。 📖 [遠端模式](docs/guides/REMOTE-MODE.md)
OmniRoute CLI 的動態終端機示範 — omniroute providers list、omniroute combo list 與 omniroute health — 循環展示 86 個頂層命令：providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …
### 🤝 連接代理 — 讓它自行控制 OmniRoute 透過 **MCP**、**A2A**、**REST API**、**webhooks** 或**遠端 CLI** 公開 OmniRoute — 任何具備相應能力的代理（或您自己的程式碼）都能自主操控整個閘道：路由、提供者、組合、快取、壓縮、記憶體。下列 HTTP 端點皆位於 `http://localhost:20128`。
介面端點／命令用途
🧰 MCP (stdio)omniroute --mcp整合至 Claude Desktop、Cursor 或任何 MCP 用戶端
🌊 MCP (HTTP)/api/mcp/stream遠端 MCP — 110 個工具、33 種範圍（可選擇啟用強制執行），以及完整的稽核軌跡
📡 MCP (SSE)/api/mcp/sse串流 MCP 傳輸
🤝 A2A/.well-known/agent.json代理對代理，JSON-RPC 2.0 + SSE，6 項技能
🌐 REST API/v1/*與 OpenAI 相容 — 聊天、嵌入、圖片、音訊、OCR
🔔 Webhooks/api/webhooks將請求／配額事件推送至 Slack、Discord、Telegram 或任何 URL
🛰️ 遠端 CLIomniroute connect 使用具範圍限制的存取權杖操控遠端執行個體
```bash # 透過 MCP 將完整的 OmniRoute 工具集提供給 Claude Code： claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` 📖 [MCP 伺服器](docs/frameworks/MCP-SERVER.md) · [A2A 伺服器](docs/frameworks/A2A-SERVER.md) · [代理協定](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 自動節省 15–95% Token
### 📖 運作方式 — 管線、架構與節省量計算 OmniRoute 壓縮管線：一個包含 10,000 個 Token 的用戶端請求會通過 12 個可組合引擎——Session-Dedup、CCR、Lite、RTK、Responses Tool Output、Headroom、Relevance、Caveman、Aggressive、LLMLingua-2、Ultra 與 OmniGlyph——在文件所述的堆疊範例中，到達提供者時可縮減至約 1,080 個 Token。結構化內容受到保留防護機制與逐步保真閘門的保護；明確啟用的有損或實驗模式可能會轉換符合條件的內容。 預設的堆疊組合會依序執行 `RTK → Caveman`。當兩者處理相同的工具／上下文酬載時，節省效果會複合疊加： ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` 程式碼區塊、URL、JSON 與結構化資料**一律受到**保留引擎的保護。 > **能用少量 Token 完成的事，何必使用大量 Token？** 每個請求都會**透明地**通過 OmniRoute 的壓縮管線——無須變更用戶端。它現在是由 **12 個可組合引擎構成的堆疊**，會依序執行，並可針對每個路由組合自由搭配——其概念建立於 [RTK](https://github.com/rtk-ai/rtk)、[Caveman](https://github.com/JuliusBrussee/caveman)（⭐ 90K+）、[LLMLingua-2](https://github.com/microsoft/LLMLingua) 與 [Troglodita](https://github.com/leninejunior/troglodita)（PT-BR）之上。 ### 🧱 12 引擎堆疊 引擎會依管線順序執行；每個引擎都可獨立切換，並可針對各組合進行設定：
#引擎功能
1Session-Dedup移除不同對話輪次間重複的內容（內容定址、跨輪次）
2CCR將大型區塊封存於擷取標記之後，並按需取得
3Lite修剪空白與圖片 URL（低延遲基準）
4RTK智慧篩選工具結果、去除重複內容並截斷（可辨識命令）
5Responses Tool Output針對 shell／patch／搜尋／建置輸出，進行無損優先的 JSON 壓縮與有界診斷壓縮（Responses API）
6Headroom透過內嵌的 GCF 轉碼器，對 JSON 陣列進行無損表格式壓縮（約 30%）
7Relevance依據最後一個使用者查詢，對擷取出的句子評分
8Caveman基於規則的散文壓縮（輸出約可壓縮 65–75%）
9Aggressive摘要並逐步老化較舊的對話輪次
10LLMLingua-2透過 MobileBERT ONNX 進行機器學習語意修剪——程式碼安全、非同步
11Ultra啟發式 Token 修剪，並可選用小型模型（SLM）層級
12OmniGlyph實驗性的上下文即圖片編碼，適用於經測量的 Claude Fable 5，透過直接 Anthropic 線路傳輸；在收到提供者回執前，GPT 5.6 轉換器仍採失敗關閉機制。四種壓縮設定檔（預設積極、平衡、程式碼安全、直通）（最積極；須選擇啟用）
程式碼區塊、URL 與結構化資料**一律會以位元組完全一致的方式保留**。**一鍵預設集**可組合這些引擎：
模式節省量最適合
🪶 Lite~15%可常駐啟用的安全預設值
🪨 Standard（Caveman）~30%日常程式開發
⚡ Aggressive~50%長時間且大量使用工具的工作階段
🔥 Ultra~75%最大化節省量
🧰 RTK60–90%Shell／測試／建置／git 輸出
🔗 Stacked（RTK → Caveman）78–95%混合提示詞與工具日誌
**實際範例 — Standard 模式：** > **壓縮前（69 個 Token）：** _「你的 React 元件會重新渲染，可能是因為你在每次渲染週期中都建立了新的物件參照。當你將內嵌物件作為 prop 傳遞時，React 的淺層比較會在每次都將其視為不同的物件，因而觸發重新渲染。我建議使用 useMemo 來記憶化該物件。」_ > > **壓縮後（19 個 Token）：** _「每次渲染都有新物件參照。內嵌物件 prop = 新參照 = 重新渲染。使用 useMemo 包裝。」_ > > **答案相同。Token 減少 72%。準確度零損失。** ✅ **PT-BR 範例 — [Troglodita](https://github.com/leninejunior/troglodita) 模式：** > **之前（42 個 token）：** _「問題在於元件會重新渲染，因為每個渲染週期都會建立新的物件參照。我建議使用 useMemo。」_ > > **之後（12 個 token）：** _「重新渲染：每個週期都有新參照（重新建立行內物件）。使用 `useMemo`。」_ > > **相同答案。token 減少約 70%。技術精確度不變。** ✅
### 🎚️ 不僅是引擎 — 輸出風格、自適應旋鈕與逐請求控制 上述 12 個引擎會縮減**輸入**內容。另有三個層面決定**如何**、**何時**以及實際**輸出**的內容： - **🪄 輸出風格** _（輸出軸向引導）_ — 注入確定性且快取安全的回應塑形指令；可組合使用，每種風格皆有 `lite` / `full` / `ultra` 強度。新增風格只需在登錄檔加入一行： - **精簡文字** — 移除贅詞／冠詞／模糊措辭；完整保留技術實質。 - **減少程式碼** — 「懶惰資深開發者」式 YAGNI：只做最小可運作的變更，不加入未要求的基礎架構。 - **馬尾（懶惰資深開發者）** — 沿著 YAGNI 階梯向上，修正根本原因，採用最小可運作的差異。 - **我有 ADHD（行動優先）** — 先列下一步行動、步驟編號、只給一個具體的下一步，不加前言。 - **精簡 CJK（文言）** — 極度精簡的文言文風格（僅限 `zh` 語系）。 - **🎯 自適應上下文預算** _（旋鈕）_ — 不再只用單一開／關 token 閾值，而是僅在必要範圍內逐步啟用成本最低、資訊損失最少的引擎，以**符合模型的上下文視窗**。策略：`reserve-output`（預設，依模型調整）· `percentage` · `absolute`。模式：`floor`（保證容納）· `replace-autotrigger`（以你的明確選擇為準）· `off`（舊版閾值）。 - **🎛️ 壓縮決策的位置** _（優先順序，由高至低）_ — 逐請求 `x-omniroute-compression` 標頭 › 路由組合覆寫 › 使用中的具名設定檔 › 自適應／自動觸發 › 面板預設值 › 關閉。套用的方案會在 `X-OmniRoute-Compression: ; source=` 回應標頭中回傳。 可依 token 閾值自動觸發、開啟自適應旋鈕、固定使用具名設定檔、為單次請求指定設定，或為每個路由組合指派管線 — 選擇最符合工作負載的方式即可。選擇性啟用的離線**評估工具**（`npm run eval:compression`）可在你正式採用變更前，使用固定語料庫評估保真度與節省量。 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ 快速開始
**1) 安裝並執行** ```bash npm install -g omniroute omniroute ``` > 💡 看到 `npm warn ERESOLVE` 或 peer-dep 警告嗎？[這些警告無害](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)。 > **使用 npm 11 或更新版本？** 除非明確允許，否則 npm 可能會封鎖套件生命週期指令碼。必須執行 OmniRoute 的 `postinstall`（`node scripts/build/postinstall.mjs`），才能準備其原生執行階段檔案。全域安裝時，請允許 npm 警告中列出的套件。對於 OmniRoute 3.8.51 回報的套件集合： > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > 若要在未來的全域安裝中重複使用此允許清單，請先設定一次，再照常安裝： > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > 相依套件清單可能會隨版本而變；如果 npm 回報不同的清單，請使用該警告中的套件名稱。允許某個套件，即代表允許執行其安裝指令碼。 > **使用 Gemini Web 或其他以網頁 Cookie 驗證的提供者？** npm 套件包含 > Playwright，但不包含其 Chromium 二進位檔。首次發出網頁提供者請求前，請參閱 > [Playwright Chromium 設定](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > 說明。 儀表板位於 `http://localhost:20128` · API 位於 `http://localhost:20128/v1`。 **2) 使用你自己的帳戶連接符合資格的提供者** 儀表板 → **提供者** → 選擇目前條款與配額符合你使用情境的提供者 → 新增其 API 金鑰或完成帳戶流程。免費方案可能需要註冊、審核或付款方式。請參閱[免費方案指南](docs/getting-started/FREE-TIERS-GUIDE.md)；不保證一定有無需金鑰的選項，且標記為 `tos: avoid` 的提供者預設不會納入 `auto`。 **3) 設定你的程式開發工具** ```txt 基礎 URL： http://localhost:20128/v1 API 金鑰： [從儀表板 → 端點複製] 模型： auto （在符合資格的連線之間進行路由，或選擇提供者／模型） ``` **4) 驗證是否正常運作** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` 你應該會看到已連接的模型清單。🎉 就這樣 — 開始撰寫程式碼，OmniRoute 會自動為你進行路由與容錯切換。 如果你的用戶端無法傳送自訂標頭，OmniRoute 也提供含 token 的相容性別名： ```txt OpenAI 目錄： http://localhost:20128/vscode/YOUR_KEY/ OpenAI 模型： http://localhost:20128/vscode/YOUR_KEY/models OpenAI 聊天： http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI 回應： http://localhost:20128/vscode/YOUR_KEY/responses Ollama 聊天： http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama 標籤： http://localhost:20128/vscode/YOUR_KEY/api/tags ``` 這些別名僅供無法附加 `Authorization: Bearer ...` 的用戶端使用。標頭驗證仍是建議的方式。
## 📦 更多安裝方式 — Docker、原始碼、pnpm、Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` 會跟隨已**發布**的最高穩定 SemVer 版本，而不會追蹤 git `main`。若使用 GitOps，請固定為 `:X.Y.Z`。請參閱 [Docker 發布頻道](docs/guides/DOCKER_GUIDE.md#release-channels)。此映像檔固定設定 **`OMNIROUTE_MEMORY_MB=1024`**。這足以執行儀表板和輕量聊天。**程式設計代理程式**（來自 Claude Code、Codex、Grok 等的 `POST /v1/responses`）需要大得多的 V8 堆積，否則當兩個長上下文重疊時，程序會在約 12 GiB 處發生 `FATAL ERROR`。容器容量應高於堆積大小（原生緩衝區位於 V8 之外）： | 工作負載 | 堆積（`-e OMNIROUTE_MEMORY_MB`） | 容器（`--memory`） | | -------------------------------- | -------------------------------- | ------------------ | | 儀表板／輕量聊天 | `1024`（映像檔預設值） | ≥2 g | | 一個程式設計代理程式 | `8192` | ≥10 g | | 兩個並行的長時間 `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` 完整表格：[Docker 指南 — 執行階段 RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)。 > **預發行 Docker 頻道：** `diegosouzapw/omniroute:next` 和 > `diegosouzapw/omniroute:next-web` 會跟隨目前預設的 `release/v*` > 分支。這些可變標籤僅用於測試尚未發布的修正， > **不支援用於正式環境**。請參閱 > [Docker 發布頻道](docs/guides/DOCKER_GUIDE.md#release-channels)。 **🥟 Bun** 透過 Bun 執行階段偵測，支援標準的 `bun install` 和全域安裝（`bun install -g omniroute`）： - **內建 `bun:sqlite`**：在 Bun 下執行時，OmniRoute 會使用 Bun 內建的 `bun:sqlite` 驅動程式；在 Node.js 下則會回退至 `better-sqlite3` 或 `sql.js`。 - **開發環境中自動選擇 Webpack 打包工具**：開發模式（`bun run dev`）會自動偵測 Bun，並停用 Turbopack、改用 Webpack，以避免原生 V8 繫結不相容。正式環境建置（`bun run build`）會和 Node 上一樣，完全依照 `OMNIROUTE_USE_TURBOPACK`：預設使用 Turbopack；設定 `OMNIROUTE_USE_TURBOPACK=0` 則使用 Webpack 建置（`Dockerfile.bun` 將其公開為 `--build-arg`）。 - **專用 Bun Dockerfile**：用於原生 Bun 正式環境部署的多階段 `Dockerfile.bun`（`docker build -f Dockerfile.bun -t omniroute:bun .`）。 ```bash # 使用 Bun 安裝並執行 bun install bun run dev ``` **🛠️ 從原始碼安裝** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux（AUR）** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix（Flake）** ```bash # 使用 Nix flakes nix develop npm run dev # 或使用 devbox devbox run npm run dev ``` 📖 [Docker 指南](docs/guides/DOCKER_GUIDE.md) — Compose 設定檔、Caddy HTTPS、Cloudflare 通道。 **🦭 Podman** ```bash # 1. 準備繫結掛載的資料目錄 mkdir -p data # 2. 僅限 Linux + 本機 rootless Podman（絕不可用於遠端 Podman Machine 用戶端）： podman unshare chown 1000:1000 ./data # 3. 設定執行階段提示、建置本機 Compose 映像檔並啟動 echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` 在 macOS 或 Windows 上，Podman 使用遠端 Podman Machine：請略過 `podman unshare`，並 遵循[針對各拓撲的資料目錄指引](contrib/podman/README.md#data-directory-permissions-by-topology)。 📖 [Podman 指南](contrib/podman/README.md) — Compose 建置、Podman Machine，以及 Linux/systemd Quadlet 設定。 **⚡ 更快速／更精簡的安裝方式（略過原生建置）** 原生 SQLite 引擎（`better-sqlite3`）是**選用**相依套件，因此全域 安裝絕不會因原始碼編譯而受阻：當預先建置的二進位檔與您的 平台／Node 相符時便會使用該檔案，否則會透明地回退至純 JS 引擎 （Node 22+ 使用 `node:sqlite`，否則使用隨附的 `sql.js` WASM）— 無需建置工具。 若要完全略過安裝後的原生預熱（適用於 CI、無頭環境或較慢的機器）： ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 也會略過 ``` 若要獲得最快的安裝速度，建議使用 **pnpm**（內容定址儲存區 + 硬連結 — 請見上文）。 若需要不含儀表板的無頭執行階段，請使用 Docker `base` 設定檔（見上文）或 [Termux 指南](docs/guides/TERMUX_GUIDE.md)。CLI 和網頁儀表板由同一個 程序透過同一個連接埠提供，因此目前沒有獨立的純 CLI 套件。
# 🎬 OmniRoute 實際運作
## 📹 影片指南
2026-08-24 的儀表板快照 · 原始目錄：YT 809 | TT 137 | IG 124 · 更新時效（天）：YT 1 | TT 21 | IG 22
Instagram 短片
🎬 #1 — Instagram
nick_saraev — 3,042,474 次觀看 		Instagram 短片 — theopenstack
🎬 #2 — Instagram
theopenstack — 692,419 次觀看 		TikTok — milesreevesai
🎬 #3 — TikTok
milesreevesai — 620,400 次觀看 		YouTube — Vaibhav Sisinty
🎬 #4 — YouTube
Vaibhav Sisinty — 391,109 次觀看 		Instagram 短片 — buildwithai.club
🎬 #5 — Instagram
buildwithai.club — 347,652 次觀看
**完整排名（已去除重複的標準網址，`v > 0`，依觸及人數由高至低）：** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | 截至 2026-08-24 的標準化指標：**1.029 部不重複影片** · **11.132.922 次已知觀看**（`v > 0`）· **各平台共 639 個頻道／個人檔案**。原始儀表板包含 1.070 列；41 個 Instagram 重複項目已依標準網址正規化，並保留每部影片的最高觀看次數。 > 🎬 **製作了關於 OmniRoute 的影片嗎？** 請附上連結並建立 [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) 或發起 [discussion](https://github.com/diegosouzapw/OmniRoute/discussions)——我們會在此展示。
# 📧 社群與協助 > 所有資源盡在一處——追蹤維護者、與社群交流，或建立 issue。 | 管道 | 位置／方式 | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — 追蹤維護者 | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — 追蹤版本發布與秘訣 | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 全球** | [加入群組](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 巴西** | [加入群組](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **網站** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute 社群（免費）** | [StHub 入口網站](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **原始碼** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **回報錯誤** | [建立問題](https://github.com/diegosouzapw/OmniRoute/issues) — 附上 `npm run system-info` 的輸出 | | 🤝 **參與貢獻** | [CONTRIBUTING.md](CONTRIBUTING.md) · [分支與發布模型](docs/ops/BRANCHING_MODEL.md) · 挑選一個 `good first issue` | | 💚 **支持此專案** | [支持方式 ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
---
## 🛠️ 技術堆疊
層級技術
執行環境Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
語言TypeScript 6.0 — 在 src/ 與 open-sse/ 中使用 100% TypeScript（自 v2.0 起，核心中零 any）
框架Next.js 16 + React 19 + Tailwind CSS 4
資料庫better-sqlite3（SQLite、WAL 日誌模式）+ LowDB（舊版 JSON）— 137 個領域模組、202 次遷移
記憶體SQLite FTS5 全文檢索 + int8 量化向量嵌入、類型化衰減
結構描述Zod 4 — MCP 工具輸入／輸出驗證 + API 契約
協定MCP（stdio / HTTP / SSE）+ A2A v0.3（JSON-RPC 2.0 + SSE）
串流伺服器傳送事件（SSE）+ WebSocket 橋接器（/v1/ws）
壓縮12 引擎管線 — RTK、Caveman、LLMLingua-2（MobileBERT ONNX）、GCF、OmniGlyph
驗證與安全性OAuth 2.0（PKCE）+ JWT + API 金鑰 + MCP 範圍式驗證 · 靜態資料採用 AES-256-GCM 加密 · DOMPurify
隱匿性wreq-js — JA3 / JA4 TLS 指紋模擬、3 級代理
韌性斷路器、指數退避、防驚群、自動組合自我修復
日誌記錄pino — 包含請求上下文的結構化 JSON 日誌
測試Node.js 測試執行器 + Vitest — 在 5,100+ 個追蹤中的測試檔案內共有 39,000+ 個靜態測試宣告（單元、整合、E2E、安全性、生態系統）
平台桌面版（Electron）· Android（Termux）· PWA（任何瀏覽器）
CI/CDGitHub Actions — 發佈時自動發佈至 npm + Docker Hub
連結網站 · npm · Docker Hub

## 📖 文件
### 📘 快速入門
文件說明
使用者指南提供者、組合、CLI 整合、部署
設定指南完整安裝方法、CLI 工具設定、協定設定、逾時調校
CLI 工具指南Claude Code、Codex、Cursor、Cline、OpenClaw、Kilo、Copilot 的個別工具設定
遠端模式透過限定範圍的存取權杖，從筆記型電腦的 CLI 操作遠端 OmniRoute（VPS）
Claude Code 設定使用 launch 與各模型設定檔，將 Claude Code 指向 OmniRoute（本機／遠端）
快速開始3 步驟：安裝 → 連線 → 設定
### 🔧 維運與部署
文件說明
Docker 指南Docker 執行、Compose 設定檔、Caddy HTTPS、隧道、映像標籤
Podman 指南Quadlet systemd 整合、podman-compose、SELinux
VM 部署完整指南：VM + nginx + Cloudflare 設定
Fly.io 部署使用持久性儲存空間部署至 Fly.io
Termux 指南透過 Termux 在 Android 上執行 OmniRoute
PWA 指南漸進式網頁應用程式的安裝、快取與架構
解除安裝指南適用於所有安裝方式的完整移除方法
環境設定完整的 .env 變數與參考資料
### 🧠 功能與架構
文件說明
架構系統架構、資料流與內部機制
壓縮指南7 種選項的管線：關閉／輕量／標準／積極／極致／RTK／堆疊
RTK 壓縮命令輸出壓縮、篩選器、信任、驗證、原始輸出復原
壓縮引擎Caveman、RTK、堆疊管線、儀表板／API／MCP 介面
壓縮規則格式Caveman 與 RTK 篩選器的 JSON 規則套件結構描述
壓縮語言套件語言偵測與 Caveman 規則套件編寫
韌性指南斷路器、冷卻時間、佇列、防驚群效應、TLS 欺騙
自動組合引擎16 因素評分、模式套件、自我修復
代理伺服器指南3 層代理伺服器系統、1proxy 市集、登錄檔 CRUD
免費方案整合目錄：35 個已有文件記錄的週期性資源池／489 個已收錄的免費方案項目
功能展示附螢幕擷取畫面的視覺化儀表板導覽
程式碼庫文件適合初學者的程式碼庫導覽
### 🤖 協定與 API
文件說明
API 參考所有端點及其範例
OpenAPI 規格OpenAPI 3.0 規格
MCP 伺服器110 個 MCP 工具、IDE 設定、Python/TS/Go 用戶端
MCP 伺服器指南MCP 安裝、傳輸方式與工具參考
A2A 伺服器JSON-RPC 2.0 協定、技能、串流、工作管理
A2A 伺服器指南A2A 代理程式卡片、工作、技能與串流
### 📋 專案與品質
文件說明
貢獻指南開發環境設定與準則
分支與發布模型PR 的目標分支（release/*），以及 main 和標籤的含義
變更日誌各版本的完整發布歷程
安全性政策漏洞回報與安全性實務
i18n 指南42 種語言支援、翻譯工作流程、RTL
發布檢查清單發布前驗證步驟
涵蓋率計畫針對 5,100 多個追蹤測試檔案中 39,000 多項靜態測試宣告的測試涵蓋率策略

# ⭐ 頂尖貢獻者 > OmniRoute 由充滿熱忱的開放原始碼社群共同塑造。這些貢獻者做出了傑出貢獻，直接影響了專案的品質、穩定性與觸及範圍。**謝謝你們。** ### 依已合併拉取請求數量排名的外部貢獻者
排名貢獻者已合併 PR約變更行數
1backryun190227,977
2oyi77180407,678
3rdself14580,663
4JxnLexn128387,049
5KooshaPari101125,747
6herjarsa88230,872
7RaviTharuma7955,106
8maxmad64bis69394,715
9artickc5933,260
10HouMinXi5147,334
10chirag127515,153
12xz-dev50245,976
13hartmark4752,185
14rqzbeh39143,181
15dhaern3419,559
16Dingding-leo331,986
17NomenAK3213,854
18MumuTW3016,953
19benzntech2911,641
20pacocartones249,331
20Prudhvivuda246,312
資料凍結於即時 release/v3.8.50 最新提交 dafb4ae808，納入截至 2026-08-24 05:26:03 UTC 的合併。分頁式 GitHub GraphQL 統計共包含 5,911 個已合併 PR：其中 2,707 個來自儲存庫擁有者、179 個來自 Dependabot，以及來自 535 位不同貢獻者的 3,025 個外部 PR。「變更行數」為 GitHub 的新增行數加刪除行數，並包含產生的檔案、鎖定檔、目錄、翻譯與文件；此數值代表程式碼變動量，而非實際撰寫的程式碼行數。排名截止點上的同名次者皆予以保留。 ### GitHub 歸屬的提交數
backryun
backryun
🥇 220 次歸屬於 GitHub 的提交 		Paijo
Paijo
🥈 219 次歸屬於 GitHub 的提交 		Randi
Randi
🥉 108 次歸屬於 GitHub 的提交 		Ravi Tharuma
Ravi Tharuma
🏅 81 次歸屬於 GitHub 的提交 		Chris
Chris
🏅 70 次歸屬於 GitHub 的提交 		Markus Hartung
Markus Hartung
🏅 69 次歸屬於 GitHub 的提交 · 並列第 6 名
Dizzle
Dizzle
🏅 69 次歸屬於 GitHub 的提交 · 並列第 6 名 		Jan Leon
Jan Leon
🏅 64 次歸屬於 GitHub 的提交 		zenobit
zenobit
🏅 62 次歸屬於 GitHub 的提交 		Bob.Hou
Bob.Hou
🏅 51 次歸屬於 GitHub 的提交 · 並列第 10 名 		Xiangzhe
Xiangzhe
🏅 51 次歸屬於 GitHub 的提交 · 並列第 10 名
於 2026-08-24 06:14:31 UTC 重新檢查：由儲存庫 Contributors API 回報 release/v3.8.50 預設分支中歸屬於 GitHub 的提交。API 傳回 525 個身分（415 名使用者、2 個機器人、108 名匿名者）；此表排除維護者、機器人與匿名身分，並保留並列名次。此表有別於上方的已合併 PR 排名，以及下方包含 639 人的 Git 中繼資料普查。 > 🙏 這些貢獻者所提供的功能、錯誤修正與基礎設施改進，是讓 OmniRoute 可靠且功能豐富的**核心要素**。每個拉取請求、每個測試案例，以及每個 i18n 翻譯檔案都至關重要。開放原始碼正是由像他們這樣的人共同打造的。
---
## 💖 贊助者
衷心感謝自掏腰包資助 OmniRoute 的每一位朋友——每一筆贊助都讓本專案得以維持免費、獨立並持續發展。
Andrew
Andrew
💛 目前的每月贊助者 		Vlad I
Vlad I
💛 目前的每月贊助者 		Paco Cartones
Paco Cartones
💛 目前的一次性贊助者 		Professor Igor Morais Vasconcelos
Prof. Igor Morais
💛 過去的一次性支持者 		longtao
longtao
💛 過去的一次性支持者
……以及其他希望保持匿名的支持者 💛 公開的 GitHub Sponsors 已於 2026-08-24 重新驗證。GitHub 的 activeOnly 狀態決定上方的目前贊助者標籤；先前已公開的一次性支持者仍列於感謝名單中，而私人贊助者則維持匿名。 💖 成為贊助者 → — 每一美元都能幫助 OmniRoute 維持免費與獨立。

## 👥 600+ 位貢獻者
[![貢獻者](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) 於 2026-08-24 以凍結基準 ac02c5b42f 進行稽核，並在即時 release/v3.8.50 最新提交 dafb4ae808 上重新檢查：共有 639 個正規化後的人類 Git 身分——其中 407 個以提交作者身分出現（包括維護者），另有 232 個僅出現在明確的 Co-authored-by 尾註中。此統計會正規化 GitHub noreply 使用者名稱、排除 26 個機器人／代理程式／服務／預留位置身分，且不會僅因顯示名稱相同，就合併一般電子郵件地址。 ### 如何貢獻 1. Fork 儲存庫 2. 從**目前使用中的** `release/vX.Y.Z` 最新提交建立分支（而非 `main`）——請參閱[分支與發行模型](docs/ops/BRANCHING_MODEL.md) 3. 建立您的功能分支（`git checkout -b feat/amazing-feature`） 4. 提交您的變更（`git commit -m 'feat: add amazing feature'`） 5. 將變更推送至分支（`git push origin feat/amazing-feature`） 6. 建立 Pull Request，並將 **base 設為該 `release/vX.Y.Z` 分支** 詳細指南請參閱 [CONTRIBUTING.md](CONTRIBUTING.md)。 ### 發行新版本 ```bash # 建立發行版本 — npm publish 會自動執行 VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```
## 📊 Stars Star 歷史圖表
## 🌍 StarMapper StarMapper

## 🙏 致謝
OmniRoute 站在巨人的肩膀上。它最初是 **[9router](https://github.com/decolua/9router)** 的分支，也是 Go 專案 **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** 的 TypeScript 移植版本；在此基礎上，下列每個子系統都受到了率先實現相關功能的開源專案啟發。每個專案都具體塑造了 OmniRoute 的一部分。謹以此向它們致謝。🙏 > ⭐ Star 數已於 2026 年 8 月 24 日透過 GitHub REST API 驗證——請為這些專案點一顆 Star。這些數字是特定日期的精確快照，自然會隨時間變化。 ### 🧬 血統與閘道
專案⭐它如何啟發 OmniRoute
9router26,161此分支所基於的原始專案——在此擴充了多模態 API，並以 TypeScript 完整重寫。
CLIProxyAPI48,497啟發此 JavaScript / TypeScript 移植版本的 Go 實作。
LiteLLM57,100這個 AI 閘道的公開定價資料集供我們的成本追蹤同步功能使用，而其提供者正規化模型也為我們的路由機制提供了參考。
codex-chatgpt-web1,410其 MIT 原始碼經調整後整合至內建的 ChatGPT Web → Codex Responses 橋接器，包括瀏覽器工作階段、回應框架、用量及網頁搜尋轉接器。
free-claude-code48,112其模式已移植至串流復原、無思考別名、備援網頁搜尋、滑動視窗限制、日誌遮蔽及強化的啟動器流程。
composer-api322Cursor Composer 的工具選擇、輸出限制及工具提交模式，經調整後整合至原生 Cursor 執行器。
codex-multi-auth457其全新登入與重新整理權杖輪替模式已移植至 Codex OAuth 重新驗證機制。
opencode-anthropic-auth510與 Claude Code 相容的轉換預設值和計費標頭行為，已泛化至 OmniRoute 由設定驅動的橋接器。
grok2api-merged2其 Grok 模型對應、偽 TypeError Statsig 產生器、請求與裝置預設值，以及 NDJSON 回應處理器，均經實質調整後整合至 OmniRoute 的 Grok Web 執行器。
TQZHR/grok2api705grok2api-merged 背後主要的間接程式碼來源；其模型、標頭、酬載、Statsig 及處理器實作均保留於 Grok Web 的沿襲脈絡中。
chenyme/grok2api7,520這是 Grok 酬載與裝置預設值、Statsig 產生器，以及經由 TQZHR 和 grok2api-merged 沿用的 result.response 處理器之底層 MIT 原始碼。
grok2api-pro27grok2api-merged 所註明、用於其代理集區層的間接來源；OmniRoute 保留該沿襲聲明，但不宣稱在其範圍受限的 Grok Web 執行器中移植了代理集區。
GrokProxy50其採用 Cookie 驗證的 Grok 代理，以及 result.response.token 串流模式，為 OmniRoute 的 Grok Web 傳輸層提供了參考。
GrokBridge5原始 Grok Web 實作參考了其 HTTP／瀏覽器上游設計；由於其直接 HTTP 路徑衍生自 GrokProxy，因此不宣稱有獨立的程式碼移植。
grok-web-api14其 Rust ChatOptions 與回應封裝結構描述，為 OmniRoute 的 TypeScript Grok 請求及串流回應類型提供了參考。
### 🗜️ 上下文與權杖壓縮——引擎
專案⭐它如何啟發 OmniRoute
Caveman100,538爆紅的「能用少量 token 搞定，何必用很多 token」專案——其穴居人式語言哲學驅動了我們的標準壓縮模式，以及 30 多項贅詞刪除／濃縮規則。
RTK – Rust Token Killer77,185高效能的命令輸出壓縮——啟發了我們的 RTK 引擎、JSON 篩選 DSL、原始輸出還原，以及堆疊式 RTK → Caveman 管線。
headroom67,310可逆式上下文壓縮（SmartCrusher）——啟發了我們的 headroom 引擎與 ccr 擷取標記模式。
LLMLingua6,598提示詞壓縮研究（LLMLingua / LLMLingua-2）——啟發了我們具備非同步、程式碼安全與失敗時開放特性的 llmlingua 引擎。
llmlingua-2-js31作為我們 LLMLingua 引擎工作執行緒後端的 JS/ONNX 移植版本（MobileBERT / XLM-RoBERTa）。
Troglodita40巴西葡萄牙文 token 壓縮——驅動我們的 pt-BR 語言套件：針對巴西葡萄牙文文法調校的贅語精簡與贅詞移除。
ponytail108,957爆紅的「懶惰資深開發者」YAGNI 程式設計技能——啟發了我們的少寫程式碼輸出風格：以最小可行變更為導向，減少_生成的_程式碼（在輸出面向上，對應於 Caveman 的精簡文字風格）。
i-have-adhd23,526其行動優先、對 ADHD 友善的回應風格，經調整後成為 OmniRoute 橫跨五種語言的精簡輸出風格。
### 🧩 精簡格式、token 研究與程式碼感知工具
專案⭐它如何啟發 OmniRoute
TOON25,233Token 導向物件表示法——其欄式、標頭加資料列的模型塑造了我們的表格式壓縮階段。
GCF – Graph Compact Format41其精簡圖形格式與通用設定檔設計，為 OmniRoute 的表格式壓縮與 Headroom 編解碼器格式提供了參考。
gcf-typescript4直接內嵌並擴充為 Headroom 通用設定檔編解碼器的 MIT TypeScript 實作。
token-optimizer-mcp494Brotli/SQLite 快取與各工作階段的上下文差異——啟發了我們的 session-dedup 引擎。
token-savior1,122Bash 輸出壓縮與 MCP 設定檔——啟發了我們的壓縮退出原則與 MCP 工具清單精簡。
token-saver138可感知內容、依檔案類型進行的輸出壓縮，並具備失敗感知的退出機制——驗證了我們依類型分派與未達最低效益時略過的設計。
token-optimizer1,951「找出幽靈 token」——其卸載與可復原控制代碼模式，為我們的 CCR 卸載構想提供了參考。
TokenMizer28工作階段圖與跨輪次行去重藍圖，為我們的 session-dedup 設計提供了參考。
OmniCompress3Rust 欄式 JSON、內容定址擷取與跨訊息去重——驗證了我們的 headroom/ccr/session-dedup 引擎設計，以及「壓縮形式與位置無關」這項快取穩定性不變條件。
mcp-compressor113MCP 工具綱要／描述壓縮——為我們縮減 MCP 工具清單的基數提供了參考。
RepoMapper197Aider 風格的儲存庫地圖排序——為我們的儲存庫地圖／擷取排序探索提供了參考。
quiet-shell-mcp4透過 MCP 進行宣告式 shell 輸出精簡——驗證了我們的宣告式 Bash 輸出壓縮。
ts-morph6,162TypeScript Compiler API 工具組——啟發了我們以剖析器為基礎的註解移除機制，同時保留字串、範本與正規表示式常值。
### 🧠 記憶體與 RAG
專案⭐如何啟發 OmniRoute
Mem063,902通用記憶層——其將代理伺服器作為寫入／讀取邊界的模型，塑造了我們的記憶體架構。
Letta (MemGPT)24,382採用分層記憶體的有狀態代理——啟發了我們的上下文控制與復原（CCR）分層模型。
WFGY1,781ProblemMap 對 16 種反覆出現的 RAG／LLM 失敗模式所做的分類——成為我們疑難排解指南中的共通詞彙。
### 🛰️ 流量檢查、MITM 與透明代理
專案⭐如何啟發 OmniRoute
llm-interceptor66對程式設計助理 ↔ LLM 流量的 MITM 攔截／分析，為早期的流量檢查器需求提供了參考。先前衍生的四個模組——SSE 合併、對話正規化、祕密資訊遮罩與標頭清理——已由依據公開通訊協定標準獨立進行的潔淨室實作取代。兩個主機直通介面（passthrough.ts 與 _internal/bypass.cjs）仍是獨立分類的 OmniRoute 內部實作；它們並未在該次替換中重寫。
ProxyBridge5,995透明的逐程序代理路由——啟發了我們可安全處理當機的 MITM 拆除機制、通訊端閒置逾時、/proc 程序歸屬判定與 TPROXY 流量擷取。
### 📚 模型資料、可觀測性與 UI
專案⭐如何啟發 OmniRoute
models.dev6,555涵蓋 AI 模型規格、定價與功能的開放式資料庫——以原生方式同步至我們的模型目錄。
React Flow / xyflow38,108為我們的即時壓縮工作室與組合／路由工作室提供支援的節點式圖形程式庫。
LangGraph40,314LangGraph Studio 的即時工作流程圖視覺化，啟發了我們各個工作室的即時級聯檢視。
Langfuse33,592其追蹤 → 區段 → 生成的可觀測性模型，塑造了我們壓縮工作室的瀑布圖。
Kiali3,631Istio 服務網格可觀測性——啟發了路由／組合工作室中的斷路器徽章與錯誤邊線視覺效果。
lobe-icons2,428用於在儀表板各處呈現提供者圖示的 AI／LLM 品牌標誌。
flag-icons12,354提供 README 語言選擇器所使用、採用 MIT 授權的 SVG 旗幟。
### 🛡️ 安全性
專案⭐如何啟發 OmniRoute
awesome-secure-defaults721一份精選的預設安全程式庫清單，為我們的安全性選擇提供指引（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）。
### 🧭 互補工具
專案⭐如何啟發 OmniRoute
ClawRouter6,564啟發了請求去重、緊急零成本備援、可插拔的 Auto-Combo 策略，以及多語言意圖分類。
Antigravity-Manager30,652其帳戶感知模型重新對應、可執行檔路徑驗證與方案標籤行為，為 OmniRoute 的 Antigravity 執行環境提供了參考。
vscode-antigravity-cockpit4,817其精簡的配額重設倒數格式，啟發了 OmniRoute 中相應的提供者限制顯示方式。
AionUi32,230其 ACP 整合啟發了 OmniRoute 自動偵測已安裝 CLI 代理的功能。
CodexBar20,507辨識出 Grok Build 的配額介面；OmniRoute 隨後獨立驗證並修正了即時線路格式。
## 📄 授權條款 MIT 授權條款 - 詳情請參閱 [LICENSE](LICENSE)。 ---
**[⬆ 返回頂部](#-omniroute)** · 用 ❤️ 為開源 AI 社群打造。 OmniRoute v3.8.52 · Node ≥22.22.2 · MIT 授權條款 · omniroute.online