🚀 OmniRoute — 免費 AI 閘道

🛠️ 技術棧

層	技術
執行環境	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/CD	GitHub 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	約變更行數
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,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 _{🥇 220 次歸屬於 GitHub 的提交}	Paijo _{🥈 219 次歸屬於 GitHub 的提交}	Randi _{🥉 108 次歸屬於 GitHub 的提交}	Ravi Tharuma _{🏅 81 次歸屬於 GitHub 的提交}	Chris _{🏅 70 次歸屬於 GitHub 的提交}	Markus Hartung _{🏅 69 次歸屬於 GitHub 的提交 · 並列第 6 名}
Dizzle _{🏅 69 次歸屬於 GitHub 的提交 · 並列第 6 名}	Jan Leon _{🏅 64 次歸屬於 GitHub 的提交}	zenobit _{🏅 62 次歸屬於 GitHub 的提交}	Bob.Hou _{🏅 51 次歸屬於 GitHub 的提交 · 並列第 10 名}	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
_{💛 目前的每月贊助者}

Vlad I
_{💛 目前的每月贊助者}

Paco Cartones
_{💛 目前的一次性贊助者}

Prof. Igor Morais
_{💛 過去的一次性支持者}

longtao
_{💛 過去的一次性支持者}

_{……以及其他希望保持匿名的支持者 💛}

_{公開的 GitHub Sponsors 已於 2026-08-24 重新驗證。GitHub 的 activeOnly 狀態決定上方的目前贊助者標籤；先前已公開的一次性支持者仍列於感謝名單中，而私人贊助者則維持匿名。}

💖 成為贊助者 → — 每一美元都能幫助 OmniRoute 維持免費與獨立。

👥 600+ 位貢獻者

_{於 2026-08-24 以凍結基準 ac02c5b42f 進行稽核，並在即時 release/v3.8.50 最新提交 dafb4ae808 上重新檢查：共有 639 個正規化後的人類 Git 身分——其中 407 個以提交作者身分出現（包括維護者），另有 232 個僅出現在明確的 Co-authored-by 尾註中。此統計會正規化 GitHub noreply 使用者名稱、排除 26 個機器人／代理程式／服務／預留位置身分，且不會僅因顯示名稱相同，就合併一般電子郵件地址。}

如何貢獻

Fork 儲存庫
從目前使用中的 release/vX.Y.Z 最新提交建立分支（而非 main）——請參閱分支與發行模型
建立您的功能分支（git checkout -b feat/amazing-feature）
提交您的變更（git commit -m 'feat: add amazing feature'）
將變更推送至分支（git push origin feat/amazing-feature）
建立 Pull Request，並將 base 設為該 release/vX.Y.Z 分支

詳細指南請參閱 CONTRIBUTING.md。

發行新版本

# 建立發行版本 — npm publish 會自動執行
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 Stars

🌍 StarMapper

🙏 致謝

OmniRoute 站在巨人的肩膀上。它最初是 9router 的分支，也是 Go 專案 CLIProxyAPI 的 TypeScript 移植版本；在此基礎上，下列每個子系統都受到了率先實現相關功能的開源專案啟發。每個專案都具體塑造了 OmniRoute 的一部分。謹以此向它們致謝。🙏

⭐ Star 數已於 2026 年 8 月 24 日透過 GitHub REST API 驗證——請為這些專案點一顆 Star。這些數字是特定日期的精確快照，自然會隨時間變化。

🧬 血統與閘道

專案	⭐	它如何啟發 OmniRoute
9router	26,161	此分支所基於的原始專案——在此擴充了多模態 API，並以 TypeScript 完整重寫。
CLIProxyAPI	48,497	啟發此 JavaScript / TypeScript 移植版本的 Go 實作。
LiteLLM	57,100	這個 AI 閘道的公開定價資料集供我們的成本追蹤同步功能使用，而其提供者正規化模型也為我們的路由機制提供了參考。
codex-chatgpt-web	1,410	其 MIT 原始碼經調整後整合至內建的 ChatGPT Web → Codex Responses 橋接器，包括瀏覽器工作階段、回應框架、用量及網頁搜尋轉接器。
free-claude-code	48,112	其模式已移植至串流復原、無思考別名、備援網頁搜尋、滑動視窗限制、日誌遮蔽及強化的啟動器流程。
composer-api	322	Cursor Composer 的工具選擇、輸出限制及工具提交模式，經調整後整合至原生 Cursor 執行器。
codex-multi-auth	457	其全新登入與重新整理權杖輪替模式已移植至 Codex OAuth 重新驗證機制。
opencode-anthropic-auth	510	與 Claude Code 相容的轉換預設值和計費標頭行為，已泛化至 OmniRoute 由設定驅動的橋接器。
grok2api-merged	2	其 Grok 模型對應、偽 TypeError Statsig 產生器、請求與裝置預設值，以及 NDJSON 回應處理器，均經實質調整後整合至 OmniRoute 的 Grok Web 執行器。
TQZHR/grok2api	705	grok2api-merged 背後主要的間接程式碼來源；其模型、標頭、酬載、Statsig 及處理器實作均保留於 Grok Web 的沿襲脈絡中。
chenyme/grok2api	7,520	這是 Grok 酬載與裝置預設值、Statsig 產生器，以及經由 TQZHR 和 grok2api-merged 沿用的 `result.response` 處理器之底層 MIT 原始碼。
grok2api-pro	27	grok2api-merged 所註明、用於其代理集區層的間接來源；OmniRoute 保留該沿襲聲明，但不宣稱在其範圍受限的 Grok Web 執行器中移植了代理集區。
GrokProxy	50	其採用 Cookie 驗證的 Grok 代理，以及 `result.response.token` 串流模式，為 OmniRoute 的 Grok Web 傳輸層提供了參考。
GrokBridge	5	原始 Grok Web 實作參考了其 HTTP／瀏覽器上游設計；由於其直接 HTTP 路徑衍生自 GrokProxy，因此不宣稱有獨立的程式碼移植。
grok-web-api	14	其 Rust `ChatOptions` 與回應封裝結構描述，為 OmniRoute 的 TypeScript Grok 請求及串流回應類型提供了參考。

🗜️ 上下文與權杖壓縮——引擎

專案	⭐	它如何啟發 OmniRoute
Caveman	100,538	爆紅的「能用少量 token 搞定，何必用很多 token」專案——其穴居人式語言哲學驅動了我們的標準壓縮模式，以及 30 多項贅詞刪除／濃縮規則。
RTK – Rust Token Killer	77,185	高效能的命令輸出壓縮——啟發了我們的 RTK 引擎、JSON 篩選 DSL、原始輸出還原，以及堆疊式 RTK → Caveman 管線。
headroom	67,310	可逆式上下文壓縮（SmartCrusher）——啟發了我們的 `headroom` 引擎與 `ccr` 擷取標記模式。
LLMLingua	6,598	提示詞壓縮研究（LLMLingua / LLMLingua-2）——啟發了我們具備非同步、程式碼安全與失敗時開放特性的 `llmlingua` 引擎。
llmlingua-2-js	31	作為我們 LLMLingua 引擎工作執行緒後端的 JS/ONNX 移植版本（MobileBERT / XLM-RoBERTa）。
Troglodita	40	巴西葡萄牙文 token 壓縮——驅動我們的 pt-BR 語言套件：針對巴西葡萄牙文文法調校的贅語精簡與贅詞移除。
ponytail	108,957	爆紅的「懶惰資深開發者」YAGNI 程式設計技能——啟發了我們的少寫程式碼輸出風格：以最小可行變更為導向，減少_生成的_程式碼（在輸出面向上，對應於 Caveman 的精簡文字風格）。
i-have-adhd	23,526	其行動優先、對 ADHD 友善的回應風格，經調整後成為 OmniRoute 橫跨五種語言的精簡輸出風格。

🧩 精簡格式、token 研究與程式碼感知工具

專案	⭐	它如何啟發 OmniRoute
TOON	25,233	Token 導向物件表示法——其欄式、標頭加資料列的模型塑造了我們的表格式壓縮階段。
GCF – Graph Compact Format	41	其精簡圖形格式與通用設定檔設計，為 OmniRoute 的表格式壓縮與 Headroom 編解碼器格式提供了參考。
gcf-typescript	4	直接內嵌並擴充為 Headroom 通用設定檔編解碼器的 MIT TypeScript 實作。
token-optimizer-mcp	494	Brotli/SQLite 快取與各工作階段的上下文差異——啟發了我們的 `session-dedup` 引擎。
token-savior	1,122	Bash 輸出壓縮與 MCP 設定檔——啟發了我們的壓縮退出原則與 MCP 工具清單精簡。
token-saver	138	可感知內容、依檔案類型進行的輸出壓縮，並具備失敗感知的退出機制——驗證了我們依類型分派與未達最低效益時略過的設計。
token-optimizer	1,951	「找出幽靈 token」——其卸載與可復原控制代碼模式，為我們的 CCR 卸載構想提供了參考。
TokenMizer	28	工作階段圖與跨輪次行去重藍圖，為我們的 session-dedup 設計提供了參考。
OmniCompress	3	Rust 欄式 JSON、內容定址擷取與跨訊息去重——驗證了我們的 `headroom`/`ccr`/`session-dedup` 引擎設計，以及「壓縮形式與位置無關」這項快取穩定性不變條件。
mcp-compressor	113	MCP 工具綱要／描述壓縮——為我們縮減 MCP 工具清單的基數提供了參考。
RepoMapper	197	Aider 風格的儲存庫地圖排序——為我們的儲存庫地圖／擷取排序探索提供了參考。
quiet-shell-mcp	4	透過 MCP 進行宣告式 shell 輸出精簡——驗證了我們的宣告式 Bash 輸出壓縮。
ts-morph	6,162	TypeScript Compiler API 工具組——啟發了我們以剖析器為基礎的註解移除機制，同時保留字串、範本與正規表示式常值。

🧠 記憶體與 RAG

專案	⭐	如何啟發 OmniRoute
Mem0	63,902	通用記憶層——其將代理伺服器作為寫入／讀取邊界的模型，塑造了我們的記憶體架構。
Letta (MemGPT)	24,382	採用分層記憶體的有狀態代理——啟發了我們的上下文控制與復原（CCR）分層模型。
WFGY	1,781	ProblemMap 對 16 種反覆出現的 RAG／LLM 失敗模式所做的分類——成為我們疑難排解指南中的共通詞彙。

🛰️ 流量檢查、MITM 與透明代理

專案	⭐	如何啟發 OmniRoute
llm-interceptor	66	對程式設計助理 ↔ LLM 流量的 MITM 攔截／分析，為早期的流量檢查器需求提供了參考。先前衍生的四個模組——SSE 合併、對話正規化、祕密資訊遮罩與標頭清理——已由依據公開通訊協定標準獨立進行的潔淨室實作取代。兩個主機直通介面（`passthrough.ts` 與 `_internal/bypass.cjs`）仍是獨立分類的 OmniRoute 內部實作；它們並未在該次替換中重寫。
ProxyBridge	5,995	透明的逐程序代理路由——啟發了我們可安全處理當機的 MITM 拆除機制、通訊端閒置逾時、`/proc` 程序歸屬判定與 TPROXY 流量擷取。

📚 模型資料、可觀測性與 UI

專案	⭐	如何啟發 OmniRoute
models.dev	6,555	涵蓋 AI 模型規格、定價與功能的開放式資料庫——以原生方式同步至我們的模型目錄。
React Flow / xyflow	38,108	為我們的即時壓縮工作室與組合／路由工作室提供支援的節點式圖形程式庫。
LangGraph	40,314	LangGraph Studio 的即時工作流程圖視覺化，啟發了我們各個工作室的即時級聯檢視。
Langfuse	33,592	其追蹤 → 區段 → 生成的可觀測性模型，塑造了我們壓縮工作室的瀑布圖。
Kiali	3,631	Istio 服務網格可觀測性——啟發了路由／組合工作室中的斷路器徽章與錯誤邊線視覺效果。
lobe-icons	2,428	用於在儀表板各處呈現提供者圖示的 AI／LLM 品牌標誌。
flag-icons	12,354	提供 README 語言選擇器所使用、採用 MIT 授權的 SVG 旗幟。

🛡️ 安全性

專案	⭐	如何啟發 OmniRoute
awesome-secure-defaults	721	一份精選的預設安全程式庫清單，為我們的安全性選擇提供指引（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）。

🧭 互補工具

專案	⭐	如何啟發 OmniRoute
ClawRouter	6,564	啟發了請求去重、緊急零成本備援、可插拔的 Auto-Combo 策略，以及多語言意圖分類。
Antigravity-Manager	30,652	其帳戶感知模型重新對應、可執行檔路徑驗證與方案標籤行為，為 OmniRoute 的 Antigravity 執行環境提供了參考。
vscode-antigravity-cockpit	4,817	其精簡的配額重設倒數格式，啟發了 OmniRoute 中相應的提供者限制顯示方式。
AionUi	32,230	其 ACP 整合啟發了 OmniRoute 自動偵測已安裝 CLI 代理的功能。
CodexBar	20,507	辨識出 Grok Build 的配額介面；OmniRoute 隨後獨立驗證並修正了即時線路格式。