README (中文 (繁體))
🛠️ 技術棧
Section titled “🛠️ 技術棧”| 層 | 技術 |
|---|---|
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 (任何瀏覽器) | |
| GitHub Actions — 自動 npm 發布 + 發布時 Docker Hub | |
| 網站 · npm · Docker Hub |
📘 快速入門
Section titled “📘 快速入門”| 文件 | 說明 |
|---|---|
| 提供者、組合、CLI 整合、部署 | |
| 完整安裝方法、CLI 工具設定、協定設定、逾時調校 | |
| Claude Code、Codex、Cursor、Cline、OpenClaw、Kilo、Copilot 的個別工具設定 | |
| 透過限定範圍的存取權杖，從筆記型電腦的 CLI 操作遠端 OmniRoute（VPS） | |
使用 launch 與各模型設定檔，將 Claude Code 指向 OmniRoute（本機／遠端） | |
| 3 步驟：安裝 → 連線 → 設定 |
🔧 維運與部署
Section titled “🔧 維運與部署”| 文件 | 說明 |
|---|---|
| Docker 執行、Compose 設定檔、Caddy HTTPS、隧道、映像標籤 | |
| Quadlet systemd 整合、podman-compose、SELinux | |
| 完整指南：VM + nginx + Cloudflare 設定 | |
| 使用持久性儲存空間部署至 Fly.io | |
| 透過 Termux 在 Android 上執行 OmniRoute | |
| 漸進式網頁應用程式的安裝、快取與架構 | |
| 適用於所有安裝方式的完整移除方法 | |
完整的 .env 變數與參考資料 |
🧠 功能與架構
Section titled “🧠 功能與架構”| 文件 | 說明 |
|---|---|
| 系統架構、資料流與內部機制 | |
| 7 種選項的管線：關閉／輕量／標準／積極／極致／RTK／堆疊 | |
| 命令輸出壓縮、篩選器、信任、驗證、原始輸出復原 | |
| Caveman、RTK、堆疊管線、儀表板／API／MCP 介面 | |
| Caveman 與 RTK 篩選器的 JSON 規則套件結構描述 | |
| 語言偵測與 Caveman 規則套件編寫 | |
| 斷路器、冷卻時間、佇列、防驚群效應、TLS 欺騙 | |
| 16 因素評分、模式套件、自我修復 | |
| 3 層代理伺服器系統、1proxy 市集、登錄檔 CRUD | |
| 整合目錄：35 個已有文件記錄的週期性資源池／489 個已收錄的免費方案項目 | |
| 附螢幕擷取畫面的視覺化儀表板導覽 | |
| 適合初學者的程式碼庫導覽 |
🤖 協定與 API
Section titled “🤖 協定與 API”| 文件 | 說明 |
|---|---|
| 所有端點及其範例 | |
| OpenAPI 3.0 規格 | |
| 110 個 MCP 工具、IDE 設定、Python/TS/Go 用戶端 | |
| MCP 安裝、傳輸方式與工具參考 | |
| JSON-RPC 2.0 協定、技能、串流、工作管理 | |
| A2A 代理程式卡片、工作、技能與串流 |
📋 專案與品質
Section titled “📋 專案與品質”| 文件 | 說明 |
|---|---|
| 開發環境設定與準則 | |
PR 的目標分支（release/*），以及 main 和標籤的含義 | |
| 各版本的完整發布歷程 | |
| 漏洞回報與安全性實務 | |
| 42 種語言支援、翻譯工作流程、RTL | |
| 發布前驗證步驟 | |
| 針對 5,100 多個追蹤測試檔案中 39,000 多項靜態測試宣告的測試涵蓋率策略 |
⭐ 頂尖貢獻者
Section titled “⭐ 頂尖貢獻者”OmniRoute 由充滿熱忱的開放原始碼社群共同塑造。這些貢獻者做出了傑出貢獻，直接影響了專案的品質、穩定性與觸及範圍。謝謝你們。
依已合併拉取請求數量排名的外部貢獻者
Section titled “依已合併拉取請求數量排名的外部貢獻者”| 排名 | 貢獻者 | 已合併 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 歸屬的提交數
Section titled “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+ 位貢獻者
Section titled “👥 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.zgh release create "v${VERSION}" --title "v${VERSION}" --generate-notes📊 Stars
Section titled “📊 Stars”🌍 StarMapper
Section titled “🌍 StarMapper”OmniRoute 站在巨人的肩膀上。它最初是 9router 的分支，也是 Go 專案 CLIProxyAPI 的 TypeScript 移植版本；在此基礎上，下列每個子系統都受到了率先實現相關功能的開源專案啟發。每個專案都具體塑造了 OmniRoute 的一部分。謹以此向它們致謝。🙏
⭐ Star 數已於 2026 年 8 月 24 日透過 GitHub REST API 驗證——請為這些專案點一顆 Star。這些數字是特定日期的精確快照，自然會隨時間變化。
🧬 血統與閘道
Section titled “🧬 血統與閘道”| 專案 | ⭐ | 它如何啟發 OmniRoute |
|---|---|---|
| 26,161 | 此分支所基於的原始專案——在此擴充了多模態 API，並以 TypeScript 完整重寫。 | |
| 48,497 | 啟發此 JavaScript / TypeScript 移植版本的 Go 實作。 | |
| 57,100 | 這個 AI 閘道的公開定價資料集供我們的成本追蹤同步功能使用，而其提供者正規化模型也為我們的路由機制提供了參考。 | |
| 1,410 | 其 MIT 原始碼經調整後整合至內建的 ChatGPT Web → Codex Responses 橋接器，包括瀏覽器工作階段、回應框架、用量及網頁搜尋轉接器。 | |
| 48,112 | 其模式已移植至串流復原、無思考別名、備援網頁搜尋、滑動視窗限制、日誌遮蔽及強化的啟動器流程。 | |
| 322 | Cursor Composer 的工具選擇、輸出限制及工具提交模式，經調整後整合至原生 Cursor 執行器。 | |
| 457 | 其全新登入與重新整理權杖輪替模式已移植至 Codex OAuth 重新驗證機制。 | |
| 510 | 與 Claude Code 相容的轉換預設值和計費標頭行為，已泛化至 OmniRoute 由設定驅動的橋接器。 | |
| 2 | 其 Grok 模型對應、偽 TypeError Statsig 產生器、請求與裝置預設值，以及 NDJSON 回應處理器，均經實質調整後整合至 OmniRoute 的 Grok Web 執行器。 | |
| 705 | grok2api-merged 背後主要的間接程式碼來源；其模型、標頭、酬載、Statsig 及處理器實作均保留於 Grok Web 的沿襲脈絡中。 | |
| 7,520 | 這是 Grok 酬載與裝置預設值、Statsig 產生器，以及經由 TQZHR 和 grok2api-merged 沿用的 result.response 處理器之底層 MIT 原始碼。 | |
| 27 | grok2api-merged 所註明、用於其代理集區層的間接來源；OmniRoute 保留該沿襲聲明，但不宣稱在其範圍受限的 Grok Web 執行器中移植了代理集區。 | |
| 50 | 其採用 Cookie 驗證的 Grok 代理，以及 result.response.token 串流模式，為 OmniRoute 的 Grok Web 傳輸層提供了參考。 | |
| 5 | 原始 Grok Web 實作參考了其 HTTP／瀏覽器上游設計；由於其直接 HTTP 路徑衍生自 GrokProxy，因此不宣稱有獨立的程式碼移植。 | |
| 14 | 其 Rust ChatOptions 與回應封裝結構描述，為 OmniRoute 的 TypeScript Grok 請求及串流回應類型提供了參考。 |
🗜️ 上下文與權杖壓縮——引擎
Section titled “🗜️ 上下文與權杖壓縮——引擎”| 專案 | ⭐ | 它如何啟發 OmniRoute |
|---|---|---|
| 100,538 | 爆紅的「能用少量 token 搞定，何必用很多 token」專案——其穴居人式語言哲學驅動了我們的標準壓縮模式，以及 30 多項贅詞刪除／濃縮規則。 | |
| 77,185 | 高效能的命令輸出壓縮——啟發了我們的 RTK 引擎、JSON 篩選 DSL、原始輸出還原，以及堆疊式 RTK → Caveman 管線。 | |
| 67,310 | 可逆式上下文壓縮（SmartCrusher）——啟發了我們的 headroom 引擎與 ccr 擷取標記模式。 | |
| 6,598 | 提示詞壓縮研究（LLMLingua / LLMLingua-2）——啟發了我們具備非同步、程式碼安全與失敗時開放特性的 llmlingua 引擎。 | |
| 31 | 作為我們 LLMLingua 引擎工作執行緒後端的 JS/ONNX 移植版本（MobileBERT / XLM-RoBERTa）。 | |
| 40 | 巴西葡萄牙文 token 壓縮——驅動我們的 pt-BR 語言套件：針對巴西葡萄牙文文法調校的贅語精簡與贅詞移除。 | |
| 108,957 | 爆紅的「懶惰資深開發者」YAGNI 程式設計技能——啟發了我們的少寫程式碼輸出風格：以最小可行變更為導向，減少_生成的_程式碼（在輸出面向上，對應於 Caveman 的精簡文字風格）。 | |
| 23,526 | 其行動優先、對 ADHD 友善的回應風格，經調整後成為 OmniRoute 橫跨五種語言的精簡輸出風格。 |
🧩 精簡格式、token 研究與程式碼感知工具
Section titled “🧩 精簡格式、token 研究與程式碼感知工具”| 專案 | ⭐ | 它如何啟發 OmniRoute |
|---|---|---|
| 25,233 | Token 導向物件表示法——其欄式、標頭加資料列的模型塑造了我們的表格式壓縮階段。 | |
| 41 | 其精簡圖形格式與通用設定檔設計，為 OmniRoute 的表格式壓縮與 Headroom 編解碼器格式提供了參考。 | |
| 4 | 直接內嵌並擴充為 Headroom 通用設定檔編解碼器的 MIT TypeScript 實作。 | |
| 494 | Brotli/SQLite 快取與各工作階段的上下文差異——啟發了我們的 session-dedup 引擎。 | |
| 1,122 | Bash 輸出壓縮與 MCP 設定檔——啟發了我們的壓縮退出原則與 MCP 工具清單精簡。 | |
| 138 | 可感知內容、依檔案類型進行的輸出壓縮，並具備失敗感知的退出機制——驗證了我們依類型分派與未達最低效益時略過的設計。 | |
| 1,951 | 「找出幽靈 token」——其卸載與可復原控制代碼模式，為我們的 CCR 卸載構想提供了參考。 | |
| 28 | 工作階段圖與跨輪次行去重藍圖，為我們的 session-dedup 設計提供了參考。 | |
| 3 | Rust 欄式 JSON、內容定址擷取與跨訊息去重——驗證了我們的 headroom/ccr/session-dedup 引擎設計，以及「壓縮形式與位置無關」這項快取穩定性不變條件。 | |
| 113 | MCP 工具綱要／描述壓縮——為我們縮減 MCP 工具清單的基數提供了參考。 | |
| 197 | Aider 風格的儲存庫地圖排序——為我們的儲存庫地圖／擷取排序探索提供了參考。 | |
| 4 | 透過 MCP 進行宣告式 shell 輸出精簡——驗證了我們的宣告式 Bash 輸出壓縮。 | |
| 6,162 | TypeScript Compiler API 工具組——啟發了我們以剖析器為基礎的註解移除機制，同時保留字串、範本與正規表示式常值。 |
🧠 記憶體與 RAG
Section titled “🧠 記憶體與 RAG”| 專案 | ⭐ | 如何啟發 OmniRoute |
|---|---|---|
| 63,902 | 通用記憶層——其將代理伺服器作為寫入／讀取邊界的模型，塑造了我們的記憶體架構。 | |
| 24,382 | 採用分層記憶體的有狀態代理——啟發了我們的上下文控制與復原（CCR）分層模型。 | |
| 1,781 | ProblemMap 對 16 種反覆出現的 RAG／LLM 失敗模式所做的分類——成為我們疑難排解指南中的共通詞彙。 |
🛰️ 流量檢查、MITM 與透明代理
Section titled “🛰️ 流量檢查、MITM 與透明代理”| 專案 | ⭐ | 如何啟發 OmniRoute |
|---|---|---|
| 66 | 對程式設計助理 ↔ LLM 流量的 MITM 攔截／分析，為早期的流量檢查器需求提供了參考。先前衍生的四個模組——SSE 合併、對話正規化、祕密資訊遮罩與標頭清理——已由依據公開通訊協定標準獨立進行的潔淨室實作取代。兩個主機直通介面（passthrough.ts 與 _internal/bypass.cjs）仍是獨立分類的 OmniRoute 內部實作；它們並未在該次替換中重寫。 | |
| 5,995 | 透明的逐程序代理路由——啟發了我們可安全處理當機的 MITM 拆除機制、通訊端閒置逾時、/proc 程序歸屬判定與 TPROXY 流量擷取。 |
📚 模型資料、可觀測性與 UI
Section titled “📚 模型資料、可觀測性與 UI”| 專案 | ⭐ | 如何啟發 OmniRoute |
|---|---|---|
| 6,555 | 涵蓋 AI 模型規格、定價與功能的開放式資料庫——以原生方式同步至我們的模型目錄。 | |
| 38,108 | 為我們的即時壓縮工作室與組合／路由工作室提供支援的節點式圖形程式庫。 | |
| 40,314 | LangGraph Studio 的即時工作流程圖視覺化，啟發了我們各個工作室的即時級聯檢視。 | |
| 33,592 | 其追蹤 → 區段 → 生成的可觀測性模型，塑造了我們壓縮工作室的瀑布圖。 | |
| 3,631 | Istio 服務網格可觀測性——啟發了路由／組合工作室中的斷路器徽章與錯誤邊線視覺效果。 | |
| 2,428 | 用於在儀表板各處呈現提供者圖示的 AI／LLM 品牌標誌。 | |
| 12,354 | 提供 README 語言選擇器所使用、採用 MIT 授權的 SVG 旗幟。 |
🛡️ 安全性
Section titled “🛡️ 安全性”| 專案 | ⭐ | 如何啟發 OmniRoute |
|---|---|---|
| 721 | 一份精選的預設安全程式庫清單，為我們的安全性選擇提供指引（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）。 |
🧭 互補工具
Section titled “🧭 互補工具”| 專案 | ⭐ | 如何啟發 OmniRoute |
|---|---|---|
| 6,564 | 啟發了請求去重、緊急零成本備援、可插拔的 Auto-Combo 策略，以及多語言意圖分類。 | |
| 30,652 | 其帳戶感知模型重新對應、可執行檔路徑驗證與方案標籤行為，為 OmniRoute 的 Antigravity 執行環境提供了參考。 | |
| 4,817 | 其精簡的配額重設倒數格式，啟發了 OmniRoute 中相應的提供者限制顯示方式。 | |
| 32,230 | 其 ACP 整合啟發了 OmniRoute 自動偵測已安裝 CLI 代理的功能。 | |
| 20,507 | 辨識出 Grok Build 的配額介面；OmniRoute 隨後獨立驗證並修正了即時線路格式。 |
📄 授權條款
Section titled “📄 授權條款”MIT 授權條款 - 詳情請參閱 LICENSE。
⬆ 返回頂部 · 用 ❤️ 為開源 AI 社群打造。
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT 授權條款 · omniroute.online
HagiCode
HagiCode 是智慧代理程式開發工作台，結合結構化工作流程、多代理程式執行與 Hero Dungeon 介面，將想法化為交付成果。
以更聰明、更快速且更有趣的智慧代理程式工作流程，打造實用的軟體。
- Smart結構化流程將意圖轉化為從構想到交付的可執行步驟。
- Efficient多代理程式工作流程讓研究、實作與審查並行進行。
- FunHero Dungeon 讓長時間的程式協作更直覺、更有參與感。