# 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 工具 → 358 家提供者 — 150+ 免費 — 透過一個端點。將 Claude Code、Codex、Cursor、Cline、Copilot 和 Antigravity 整合到免費的 Claude / GPT / Gemini 中，並具備自動備援功能。RTK + Caveman 堆疊壓縮可節省 15–95% 的代幣（平均約 89%）— 永不觸及限制。358 家 AI 提供者 · 150+ 免費層級 · 每月約 16.2 億免費代幣 · 19 種路由策略 · $0 即可開始。
## 💰 每月約 1.62B 個免費 Token
> 手動疊加免費方案非常痛苦——數十個 SDK、數十種速率限制，而且完全不知道自己實際擁有多少額度。OmniRoute 收錄了 **489 個免費方案項目，涵蓋 35 個週期性資源池鍵**，並根據**具有已公開正數每月預算的 17 個資源池，加上五個 Groq 單模型上限**計算 Token 總額，同時依共用資源池去除重複計算。只有在完成區域身分驗證後才開放的配額（目前為 ModelScope）會分開顯示，即通過區域身分驗證後可額外獲得約 6M，且絕不計入總額。結果會持續顯示在儀表板上（`/dashboard/free-tiers`）。 OmniRoute 免費方案預算卡：每月穩定提供約 1.62B 個免費 Token，若包含註冊點數，首月最高可達約 2.22B；透過單一端點提供 35 個有記錄的週期性資源池鍵，涵蓋 489 個已收錄的免費方案項目。誠實的資源池去重計算——每個共用資源池僅計算一次，包括具有已公開正數每月 Token 預算的 17 個週期性資源池，以及五個 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 [![Star History 排名](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)**
## 📈 Gateway 持續成長
| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ---------------------- | :-----: | :-------------------: | :------------: | | 🌐 提供者 | 290 | **357** | 更多已排入佇列 | | 🧠 不重複的聊天模型 ID | 1185 | **1312** | — | | 🖼️ 模態橋接 | — | 🆕 視覺 + 音訊 + 影片 | — | | 📡 Radar 免費目錄 | — | 🆕 選擇加入 | — | | ⚖️ 配額感知排程 | — | 🆕 Quota-Share | — | | 📊 配額遙測 | — | 🆕 即時 | — | **→ [路線圖](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
💚 支持 💚 支持／捐款 💬 社群 💖 贊助者
📦 專案 🛠️ 技術堆疊 📖 文件 👥 貢獻者
🌐 支援 66 種語言

英文 (en) 葡萄牙文 — 巴西 (pt-BR) 葡萄牙文 (pt) 西班牙文 (es) 法文 (fr) 義大利文 (it) 德文 (de) 荷蘭文 (nl) 俄文 (ru) 烏克蘭文 (uk-UA) 波蘭文 (pl) 捷克文 (cs) 斯洛伐克文 (sk) 羅馬尼亞文 (ro) 匈牙利文 (hu) 保加利亞文 (bg) 丹麥文 (da) 芬蘭文 (fi) 挪威文 (no) 瑞典文 (sv) 中文 — 簡體 (zh-CN) 中文 — 繁體 (zh-TW) 日文 (ja) 韓文 (ko) 泰文 (th) 越南文 (vi) 印尼文 (id) 馬來文 (ms) 菲律賓文 (phi) 印地文 (hi) 古吉拉特文 (gu) 馬拉地文 (mr) 坦米爾文 (ta) 泰盧固文 (te) 孟加拉文 (bn) 烏都文 (ur) 波斯文 (fa) 阿拉伯文 (ar) 希伯來文 (he) 土耳其文 (tr) 亞塞拜然文 (az) 斯瓦希里文 (sw) 希臘文 (el) 克羅埃西亞文 (hr) 塞爾維亞文 (sr) 立陶宛文 (lt) 愛沙尼亞文 (et) 拉脫維亞文 (lv) 斯洛維尼亞文 (sl) 馬爾他文 (mt) 愛爾蘭文 (ga) 康納達文 (kn) 馬拉雅拉姆文 (ml) 歐迪亞文 (or) 旁遮普文 (pa) 尼泊爾文 (ne) 僧伽羅文 (si) 緬甸文 (my) 高棉文 (km) 豪薩文 (ha) 約魯巴文 (yo) 伊博文 (ig) 阿姆哈拉文 (am) 烏茲別克文 (uz) 喬治亞文 (ka) 亞美尼亞文 (hy)


## 🆓 安裝後立即生效 — 無需金鑰，無需配置
安裝後立即生效 — 零配置。三個步驟：1. 安裝 — npm i -g omniroute，伺服器在 localhost:20128 啟動。2. 將您的工具指向 http://localhost:20128/v1 — 任何與 OpenAI 相容的工具 (Claude Code, Cursor, Cline)。3. 它會回應 — 呼叫模型 auto 即可立即獲得回覆，無需 API 金鑰、無需註冊、無需配置。無金鑰提供者 OpenCode Free 已預先連接到 auto 組合中，因此全新安裝即可立即回應。 ```bash # 全新安裝，零憑證 — `auto` 已可運作： curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` 偏好特定的免費後端？直接呼叫 `oc/…` (`OpenCode Free`)。然後升級到 `auto`，讓 `OmniRoute` 選擇。 📦 **Python、Node.js、PHP 和 cURL** 的複製貼上快速入門腳本 → [`examples/quickstart/`](examples/quickstart/)
# 💥 承諾
承諾 — 一個端點和 358 個提供者。自動備援確保在有其他健康目標可用時持續路由。六大支柱：跨 358 個提供者的彈性備援 · 在符合條件的工作負載上節省高達 95% 的代幣 · 150 多個免費層級和 54 個定期/無金鑰永久免費提供者，零成本啟動 · 透過一個配置實現 36 個 CLI/代理整合 · 在 /v1 支援 OpenAI、Claude、Gemini 和 Responses API 相容性 · 生產控制，包括斷路器、TLS 隱身、MCP 110 工具、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 智慧路由器 (RTK + Caveman 壓縮、19 種路由策略、斷路器、TLS 隱身、MCP、A2A、防護欄) 可以在有合格的健康目標時，在 4 個提供者層級之間進行備援 — Tier 1 Subscription、Tier 2 API Key、Tier 3 Cheap 和 Tier 4 Free。

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

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，我們會將其添加到這裡。

## 🎯 組合 — 旗艦功能
全部 19 種組合路由策略的動畫展示——每種策略各一格：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。每種策略的作用請參閱上表。 > **組合**是由多個模型串成的鏈，OmniRoute 會在其間**自動**進行路由。若配額耗盡、提供者發生故障或成本暴增，組合便可切換至下一個符合條件且運作正常的模型。🛡️ ### ⚡ 零設定 — 只需使用 `auto` 無需建立組合。將模型設為 `auto`（或其變體），OmniRoute 就會根據您已連線的提供者建立虛擬組合，並即時評分：
模型 ID最佳化目標
auto🎯 平衡的預設選項（LKGP——持續使用您上一個運作良好的提供者）
auto/coding🧑💻 程式碼生成採用品質優先的權重
auto/fast⚡ 最低延遲優先
auto/cheap💰 每個 token 成本最低者優先
auto/offline🔋 配額／速率限制餘裕最多者優先
auto/smart🔭 品質優先 + 10% 探索，以發現更好的模型
auto/lkgp📌 明確黏著至上一個已知運作良好的提供者
auto/chaos🧪 用於韌性測試的故障注入權重（混沌工程）
## ### 🔀 或自行建立 — 19 種路由策略 全部 **19** 種策略——可在每個組合步驟中自由搭配：
# 策略 作用
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 上一個已知良好路徑——固定使用上一個成功的提供者，之後再依規則容錯移轉
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：358 個提供者，內建 150+ 免費層級，19 種路由策略，12 引擎代幣壓縮，內建含 110 種工具的 MCP 伺服器，A2A 代理協定，持久記憶體，護欄，雲端代理，TLS 指紋隱匿，桌面/Termux/PWA 和 42 種國際化使用者介面語言。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) - **🗜️ 壓縮強化** — 預設啟用解壓膨脹防護、適用於德文／法文／日文及中文（文言）的 Caveman 套件，以及適用於 Gradle 與 .NET 的 RTK 篩選器。→ [壓縮](docs/compression/COMPRESSION_ENGINES.md) - **💸 如實呈現固定費率成本** — 訂閱／程式設計方案提供者在成本分析中顯示為 **$0**；預算、配額與路由仍會持續估算。→ [API 參考](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share 路由** — 在集區金鑰之間公平分配共用帳戶的配額，並以工作守恆方式將閒置份額借予其他金鑰。→ [韌性指南](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）** — 攔截忽略代理環境變數的 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)
## 🌐 357 個 AI 提供者 — 152 個標記為免費
> 在標準聊天、媒體、搜尋、本機、雲端代理程式與系統集合中，共有 **357 個已註冊的提供者**，其中 **152 個帶有 `hasFree: true` 探索中繼資料**。聊天模型登錄檔涵蓋 **229 個提供者 / 2,554 組不同的提供者－模型配對 / 1,283 個原始模型 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
每天 1M tokens		 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以無損為優先的 JSON，以及針對 shell／修補／搜尋／建置輸出的有界診斷壓縮（Responses API）
6Headroom透過內建的 GCF 編解碼器，對 JSON 陣列進行無損表格式壓縮（約 30%）
7Relevance根據最後一個使用者查詢，對擷取出的句子進行相關性評分
8Caveman基於規則的散文壓縮（輸出約可減少 65–75%）
9Aggressive摘要處理與舊輪次的漸進式老化
10LLMLingua-2透過 MobileBERT ONNX 進行 ML 語意剪枝 — 程式碼安全、非同步
11Ultra啟發式 token 剪枝，並提供選用的小型模型（SLM）層級
12OmniGlyph實驗性的上下文影像編碼，適用於透過 Anthropic 直接線路實測的 Claude Fable 5；GPT 5.6 transformers 在取得提供者回條之前仍維持故障關閉。四種壓縮設定檔（預設積極、平衡、程式碼安全、直接傳遞）（最積極；須主動啟用）
程式碼區塊、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)。 儀表板位於 `http://localhost:20128` · API 位於 `http://localhost:20128/v1`。 **2）連接免費提供者（無須註冊）** 儀表板 → **提供者** → 連接 **Kiro AI**（免費 Claude，每個帳戶每月約 50 點額度）或 **OpenCode Free**（無須驗證）→ 完成。 **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 舊版) — 122 個領域模組，183 次遷移
記憶體SQLite FTS5 全文檢索 + int8 量化向量嵌入，類型衰減
架構Zod 4 — MCP 工具 I/O 驗證 + API 契約
協定MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
串流Server-Sent Events (SSE) + WebSocket 橋接 (`/v1/ws`)
壓縮12 引擎管線 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
認證與安全OAuth 2.0 (PKCE) + JWT + API Keys + MCP 範圍認證 · 靜態 AES-256-GCM 加密 · DOMPurify
隱匿wreq-js — JA3 / JA4 TLS 指紋偽裝，3 級代理
韌性斷路器，指數退避，防洪，自動組合自我修復
日誌pino — 帶有請求上下文的結構化 JSON 日誌
測試Node.js test runner + 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.51 · Node ≥22.22.2 · MIT 授權條款 · omniroute.online