mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-06 23:32:12 +03:00
docs(i18n): add Traditional Chinese (zh-TW) README and update zh-CN to latest (#5162)
Integrated into release/v3.8.39. Traditional Chinese (zh-TW) README + zh-CN refresh; docs-only.
This commit is contained in:
@@ -66,8 +66,8 @@
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<b>🌐 Available in 40+ languages</b>
|
||||
<table>
|
||||
<b>🌐 Available in 41+ languages</b>
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center"><a href="README.md">🇺🇸</a></td>
|
||||
<td align="center"><a href="docs/i18n/pt-BR/README.md">🇧🇷</a></td>
|
||||
@@ -76,6 +76,7 @@
|
||||
<td align="center"><a href="docs/i18n/it/README.md">🇮🇹</a></td>
|
||||
<td align="center"><a href="docs/i18n/ru/README.md">🇷🇺</a></td>
|
||||
<td align="center"><a href="docs/i18n/zh-CN/README.md">🇨🇳</a></td>
|
||||
<td align="center"><a href="docs/i18n/zh-TW/README.md">🇹🇼</a></td>
|
||||
<td align="center"><a href="docs/i18n/de/README.md">🇩🇪</a></td>
|
||||
<td align="center"><a href="docs/i18n/ja/README.md">🇯🇵</a></td>
|
||||
<td align="center"><a href="docs/i18n/ko/README.md">🇰🇷</a></td>
|
||||
|
||||
@@ -43,4 +43,5 @@ Translations of documentation into 40 languages. Code blocks remain in English.
|
||||
- 🇺🇦 **Українська** (`uk-UA`): [Docs Root](./uk-UA/README.md)
|
||||
- 🇵🇰 **اردو** (`ur`): [Docs Root](./ur/README.md)
|
||||
- 🇻🇳 **Tiếng Việt** (`vi`): [Docs Root](./vi/README.md)
|
||||
- 🇹🇼 **中文 (繁體)** (`zh-TW`): [Docs Root](./zh-TW/README.md)
|
||||
- 🇨🇳 **中文 (简体)** (`zh-CN`): [Docs Root](./zh-CN/README.md)
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
868
docs/i18n/zh-TW/README.md
Normal file
868
docs/i18n/zh-TW/README.md
Normal file
@@ -0,0 +1,868 @@
|
||||
# 🚀 OmniRoute — 免費 AI 閘道器
|
||||
|
||||
🌐 **語言:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇪🇸 [es](../es/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/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) · 🇸🇰 [sk](../sk/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) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md)
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
<img src="../../screenshots/MainOmniRoute.png" alt="OmniRoute 儀表板" width="820"/>
|
||||
|
||||
<br/>
|
||||
|
||||
# 🚀 OmniRoute — 免費 AI 閘道器
|
||||
|
||||
### 永遠不要停止開發。透過一個端點,將每個 AI 工具連接到 **231 個供應商** — **50+ 免費**。
|
||||
|
||||
**將 Claude Code、Codex、Cursor、Cline、Copilot 和 Antigravity 連接到免費的 Claude / GPT / Gemini。自動備援。**
|
||||
|
||||
**RTK + Caveman 壓縮可節省 15–95% 的 Token。永遠不會達到限制。**
|
||||
|
||||
**每月約 16 億個免費 Token** — 加上註冊獎勵,首月可達 **約 21 億** — 匯集自各個免費方案,再加上壓縮技術進一步放大。
|
||||
|
||||
[](#-231-ai-providers--50-free)
|
||||
[](#-231-ai-providers--50-free)
|
||||
[](../../reference/FREE_TIERS.md)
|
||||
[](#%EF%B8%8F-save-1595-tokens--automatically)
|
||||
[](#-combos--the-flagship)
|
||||
[](#-quick-start)
|
||||
|
||||
<br/>
|
||||
|
||||
### 💬 加入社群
|
||||
|
||||
[](https://discord.gg/EkzRkpzKYt)
|
||||
[](https://t.me/omnirouteOficial)
|
||||
[](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
|
||||
[](https://chat.whatsapp.com/BTGJXIyjeNIIgExvTMGGhI)
|
||||
|
||||
**問題、供應商訣竅、路線圖與支援 → [Discord](https://discord.gg/EkzRkpzKYt) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 全球](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) / [🇧🇷 巴西](https://chat.whatsapp.com/BTGJXIyjeNIIgExvTMGGhI)**
|
||||
|
||||
<br/>
|
||||
|
||||
<a href="https://trendshift.io/repositories/23589" target="_blank"><img src="https://trendshift.io/api/badge/repositories/23589" alt="diegosouzapw%2FOmniRoute | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
|
||||
|
||||
[](https://www.npmjs.com/package/omniroute)
|
||||
[](LICENSE)
|
||||
[](package.json)
|
||||
[](https://github.com/diegosouzapw/OmniRoute)
|
||||
|
||||
<div align="center">
|
||||
|
||||
[](https://www.npmjs.com/package/omniroute)
|
||||

|
||||
[](https://hub.docker.com/r/diegosouzapw/omniroute)
|
||||

|
||||

|
||||
[](https://omniroute.online)
|
||||
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
[**🚀 快速開始**](#-quick-start) • [**🎯 組合策略**](#-combos--the-flagship) • [**🌐 供應商**](#-231-ai-providers--50-free) • [**🔌 CLI 與 MCP**](#-full-cli--a2a--mcp) • [**🗜️ 壓縮**](#%EF%B8%8F-save-1595-tokens--automatically) • [**🌍 網站**](https://omniroute.online)
|
||||
|
||||
[💥 承諾](#-the-promise) • [🤔 為何選擇](#-why-omniroute) • [🏆 與眾不同](#-what-sets-omniroute-apart) • [🤖 相容工具](#-compatible-clis--coding-agents) • [🖥️ 執行環境](#%EF%B8%8F-where-omniroute-runs--anywhere) • [🔒 隱私](#-private--local-first) • [🎬 實際展示](#-omniroute-in-action) • [📚 探索更多](#-explore-more) • [📧 支援](#-support--community)
|
||||
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<b>🌐 提供 41+ 種語言</b>
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center"><a href="../../../README.md">🇺🇸</a></td>
|
||||
<td align="center"><a href="../pt-BR/README.md">🇧🇷</a></td>
|
||||
<td align="center"><a href="../es/README.md">🇪🇸</a></td>
|
||||
<td align="center"><a href="../fr/README.md">🇫🇷</a></td>
|
||||
<td align="center"><a href="../it/README.md">🇮🇹</a></td>
|
||||
<td align="center"><a href="../ru/README.md">🇷🇺</a></td>
|
||||
<td align="center"><a href="../zh-CN/README.md">🇨🇳</a></td>
|
||||
<td align="center"><a href="../zh-TW/README.md">🇹🇼</a></td>
|
||||
<td align="center"><a href="../de/README.md">🇩🇪</a></td>
|
||||
<td align="center"><a href="../ja/README.md">🇯🇵</a></td>
|
||||
<td align="center"><a href="../ko/README.md">🇰🇷</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><a href="../th/README.md">🇹🇭</a></td>
|
||||
<td align="center"><a href="../vi/README.md">🇻🇳</a></td>
|
||||
<td align="center"><a href="../id/README.md">🇮🇩</a></td>
|
||||
<td align="center"><a href="../ms/README.md">🇲🇾</a></td>
|
||||
<td align="center"><a href="../phi/README.md">🇵🇭</a></td>
|
||||
<td align="center"><a href="../ar/README.md">🇸🇦</a></td>
|
||||
<td align="center"><a href="../he/README.md">🇮🇱</a></td>
|
||||
<td align="center"><a href="../az/README.md">🇦🇿</a></td>
|
||||
<td align="center"><a href="../uk-UA/README.md">🇺🇦</a></td>
|
||||
<td align="center"><a href="../pl/README.md">🇵🇱</a></td>
|
||||
<td align="center"><a href="../cs/README.md">🇨🇿</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><a href="../nl/README.md">🇳🇱</a></td>
|
||||
<td align="center"><a href="../bg/README.md">🇧🇬</a></td>
|
||||
<td align="center"><a href="../da/README.md">🇩🇰</a></td>
|
||||
<td align="center"><a href="../fi/README.md">🇫🇮</a></td>
|
||||
<td align="center"><a href="../no/README.md">🇳🇴</a></td>
|
||||
<td align="center"><a href="../sv/README.md">🇸🇪</a></td>
|
||||
<td align="center"><a href="../hu/README.md">🇭🇺</a></td>
|
||||
<td align="center"><a href="../ro/README.md">🇷🇴</a></td>
|
||||
<td align="center"><a href="../sk/README.md">🇸🇰</a></td>
|
||||
<td align="center"><a href="../pt/README.md">🇵🇹</a></td>
|
||||
<td align="center"></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 💰 每月約 16 億個免費 Token
|
||||
|
||||
</div>
|
||||
|
||||
> 手動疊加免費方案很痛苦 — 幾十個 SDK、幾十個速率限制,而且你根本不知道自己實際上還剩多少配額。OmniRoute 匯總了 **40+ 供應商池 / 500+ 模型** 的免費方案,在儀表板上即時顯示真實數字。
|
||||
|
||||
- **每月約 16 億個免費 Token**(穩定)— 加上註冊獎勵,首月可達 **約 21 億**
|
||||
- **去重計算、誠實透明** — 我們對每個共享免費池**只計算一次**
|
||||
- **加上無法精確計算的部分** — 永久免費、無 Token 上限的供應商
|
||||
- **逐模型細項**、**當月即時已用/剩餘**,以及每個供應商的透明條款標記
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 💥 承諾
|
||||
|
||||
</div>
|
||||
|
||||
> 一個端點。**231 個供應商。** 永遠不要停止開發 — 讓 OmniRoute 自動挑選最便宜的可用選項。
|
||||
|
||||
| | | |
|
||||
|---|---|---|
|
||||
| **🚫 永不達標**<br/>毫秒級自動備援,跨越 231 個供應商。配額用完?下一個供應商立即接手 — 零停機。 | **💸 節省高達 95% Token**<br/>RTK + Caveman 疊加壓縮,可減少 15–95% 的 Token(工具密集型工作階段平均約 89%)。 | **🆓 從 $0 開始**<br/>50+ 供應商提供免費方案,11 個**永久免費**(Kiro、Qoder、Pollinations、LongCat...)。無需信用卡。 |
|
||||
| **🔌 每個工具都適用**<br/>16+ 程式碼代理 — Claude Code、Codex、Cursor、Cline、Copilot、Antigravity — 只需一個設定檔。 | **🧩 一個端點**<br/>OpenAI ↔ Claude ↔ Gemini ↔ Responses API 自動轉譯。將任何工具指向 `/v1` 即可使用。 | **🛡️ 生產級別**<br/>斷路器、TLS 隱匿、MCP(87 個工具)、A2A、記憶體、護欄、評估。14,965 項測試。 |
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🤔 為何選擇 OmniRoute?
|
||||
|
||||
</div>
|
||||
|
||||
> 告別十個儀表板、失效的 API 金鑰和意外的帳單。
|
||||
|
||||
| ❌ 日常痛點 | ✅ OmniRoute 如何解決 |
|
||||
|---|---|
|
||||
| 📉 訂閱配額每月未用完就歸零 | **最大化訂閱** — 追蹤配額,在重置前用完每個 Token |
|
||||
| 🛑 速率限制中斷你的開發 | **4 層自動備援** — 訂閱 → API → 便宜 → 免費,毫秒級切換 |
|
||||
| 🔥 工具輸出(`git diff`、`grep`、日誌)浪費 Token | **RTK + Caveman 壓縮** — 每次請求節省 15–95% Token |
|
||||
| 💸 昂貴的 API(每個供應商每月 $20–50) | **成本優化路由** — 自動路由到最便宜的可行模型 |
|
||||
| 🧰 每個 AI 工具都需要自己的設定 | **一個端點、所有工具、一個儀表板** |
|
||||
| 🌍 AI 在你所在的國家被封鎖 | **3 層代理** + TLS 指紋隱匿 — 從任何地方使用 AI |
|
||||
|
||||
<div align="center">
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────┐
|
||||
│ 你的 IDE / CLI(Claude Code、Cursor、Cline…) │
|
||||
└─────────────────────────┬──────────────────────────────────┘
|
||||
│ http://localhost:20128/v1
|
||||
▼
|
||||
┌──────────────────────────────────────────────────────────┐
|
||||
│ OmniRoute — 智慧路由器 │
|
||||
│ RTK + Caveman 壓縮 · 17 種路由策略 │
|
||||
│ 斷路器 · TLS 隱匿 · MCP · A2A · 護欄 │
|
||||
└─────────────────────────┬──────────────────────────────────┘
|
||||
┌─────────────┬────┴────────┬─────────────┐
|
||||
▼ 第 1 層 ▼ 第 2 層 ▼ 第 3 層 ▼ 第 4 層
|
||||
訂閱制 API 金鑰 便宜方案 免費方案
|
||||
Claude Code, DeepSeek, GLM $0.5, Kiro, Qoder,
|
||||
Codex, Copilot Groq, xAI MiniMax $0.2 Pollinations
|
||||
配額用完?───▶ 預算超標?───▶ 預算超標?───▶ 永遠可用
|
||||
```
|
||||
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🎯 組合策略 — 旗艦功能
|
||||
|
||||
</div>
|
||||
|
||||
> **組合(Combo)** 是一串模型的鏈條,OmniRoute 會**自動**在它們之間路由。配額用完、供應商故障或成本飆升 — 組合會無聲地切換到下一個模型。**這就是 OmniRoute 牢不可破的原因。** 🛡️
|
||||
|
||||
### ⚡ 零設定 — 只要用 `auto`
|
||||
|
||||
無需建立組合。將模型設為 `auto`(或變體),OmniRoute 就會根據你連接的供應商即時建立虛擬組合:
|
||||
|
||||
| 模型 ID | 最佳化目標 |
|
||||
|---|---|
|
||||
| `auto` | 🎯 平衡預設(LKGP — 停留在上次良好的供應商) |
|
||||
| `auto/coding` | 🧑💻 品質優先,適用於程式碼生成 |
|
||||
| `auto/fast` | ⚡ 最低延遲優先 |
|
||||
| `auto/cheap` | 💰 每個 Token 最便宜優先 |
|
||||
| `auto/offline` | 🔋 最多配額/速率限制餘裕優先 |
|
||||
| `auto/smart` | 🔭 品質優先 + 10% 探索以發現更好的模型 |
|
||||
|
||||
### 🔀 或自行建立 — 17 種路由策略
|
||||
|
||||
| 目標 | 策略 / 組合 |
|
||||
|---|---|
|
||||
| 🥇 先用完訂閱再付費 | `priority` / `fill-first` |
|
||||
| ⚖️ 在多個帳號間分散負載 | `round-robin` · `weighted` · `p2c` · `least-used` |
|
||||
| 💸 永遠選最便宜的可行模型 | `cost-optimized` · `auto/cheap` |
|
||||
| 🧠 在模型之間交接長上下文 | `context-relay` · `context-optimized` |
|
||||
| 🎲 隨機/隱私路由 | `random` · `strict-random` |
|
||||
| 🧬 分散到多個模型再綜合評判 | `fusion` |
|
||||
| 📊 依剩餘配額餘裕路由 | `reset-window` · `headroom` |
|
||||
| 🤖 讓它智慧化 | `auto`(9 因子評分)· `lkgp` · `reset-aware` |
|
||||
|
||||
### 🧱 內建三層彈性
|
||||
|
||||
| 層級 | 範圍 | 功能 |
|
||||
|---|---|---|
|
||||
| 🔌 **斷路器** | 整個供應商 | 停止對上游故障的供應商發送請求;自動探測恢復 |
|
||||
| 💤 **連線冷卻** | 一個帳號/金鑰 | 跳過受限的金鑰,同時其他金鑰繼續服務 |
|
||||
| 🎯 **模型鎖定** | 供應商 + 模型 | 只隔離配額受限的單一模型,不影響整個連線 |
|
||||
|
||||
```
|
||||
組合:"always-on" 策略:priority
|
||||
1. cc/claude-opus-4-7 ← 訂閱(充分使用)
|
||||
2. cx/gpt-5.5 ← 第二個訂閱
|
||||
3. glm/glm-5.1 ← 便宜備援($0.5/1M)
|
||||
4. kr/claude-sonnet-4.5 ← 免費、無限制(永不故障)
|
||||
結果:4 層備援 = 零停機
|
||||
```
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🏆 OmniRoute 與眾不同之處
|
||||
|
||||
</div>
|
||||
|
||||
| 功能 | OmniRoute | 其他路由器 |
|
||||
|---|---|---|
|
||||
| 🌐 供應商 | **231** | 20–100 |
|
||||
| 🆓 免費供應商 | **50+(11 個永久免費)** | 1–5 |
|
||||
| 🔀 路由策略 | **17 種** | 1–3 |
|
||||
| 🗜️ Token 壓縮 | **RTK + Caveman 疊加(15–95%)** | 無/20–40% |
|
||||
| 🧰 內建 MCP 伺服器 | **87 個工具、3 種傳輸、30 個範圍** | 少見 |
|
||||
| 🤝 A2A 代理協定 | **6 項技能、JSON-RPC 2.0** | 無 |
|
||||
| 🧠 記憶體(FTS5 + 向量) | **有** | 少見 |
|
||||
| 🛡️ 護欄(PII、注入、視覺) | **有** | 少見 |
|
||||
| ☁️ 雲端代理 | **Codex、Devin、Jules** | 無 |
|
||||
| 🥷 TLS 指紋隱匿 | **JA3/JA4 via wreq-js** | 無 |
|
||||
| 🖥️ 多平台 | **網頁 · 桌面 · Termux · PWA** | 僅網頁 |
|
||||
| 🌍 國際化 | **42 種語言** | 0–4 |
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# ✨ 最新消息
|
||||
|
||||
</div>
|
||||
|
||||
> **v3.8.20 → v3.8.38** 的精選更新。完整紀錄在 [`CHANGELOG.md`](CHANGELOG.md)。
|
||||
|
||||
- **⚖️ 配額共享路由** — 依可用配額在帳號間分散負載的專用組合策略
|
||||
- **🤖 一鍵 CLI/代理設定** — `setup-*` 命令為每個編碼工具設定 OmniRoute 路由
|
||||
- **🛰️ 遠端模式** — 從任何機器使用範圍存取 Token 驅動遠端 OmniRoute
|
||||
- **🧭 更智慧的自動路由** — OpenRouter 風格的組合、Fusion 策略、任務感知路由
|
||||
- **🗜️ 可插拔壓縮** — **9 個可組合引擎**的非同步管道
|
||||
- **🕵️ 透明 MITM 解密(TPROXY)** — 擷取並轉譯忽略代理環境變數的 CLI 流量
|
||||
- **💸 無處不在的成本遙測** — 每個端點都有 `X-OmniRoute-*` 成本/用量標頭
|
||||
- **🧠 你可控制的記憶體** — 可選的 int8 向量量化
|
||||
- **🛡️ 安全性** — 所有 LLM 路由的提示注入防護
|
||||
- **🤝 更多供應商與代理** — Cursor Cloud Agent、CodeBuddy CN、新閘道器
|
||||
- **⚡ 本地效能與基礎設施** — 一鍵啟動本地 Redis、Cloudflare Workers 中繼
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🤖 相容的 CLI 與編碼代理
|
||||
|
||||
</div>
|
||||
|
||||
> 一個設定檔 — `http://localhost:20128/v1` — **每個** AI IDE 或 CLI 都能在免費與低成本模型上執行。
|
||||
|
||||
<div align="center">
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center" width="120"><a href="https://github.com/anthropics/claude-code"><img src="../../public/providers/claude.svg" width="52" alt="Claude Code"/><br/><b>Claude Code</b></a></td>
|
||||
<td align="center" width="120"><a href="https://github.com/openai/codex"><img src="../../public/providers/codex.svg" width="52" alt="Codex CLI"/><br/><b>Codex CLI</b></a></td>
|
||||
<td align="center" width="120"><a href="https://github.com/google-gemini/gemini-cli"><img src="../../public/providers/gemini-cli.svg" width="52" alt="Gemini CLI"/><br/><b>Gemini CLI</b></a></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/cursor.png" width="52" alt="Cursor"/><br/><b>Cursor</b></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/copilot.png" width="52" alt="Copilot"/><br/><b>Copilot</b></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/continue.png" width="52" alt="Continue"/><br/><b>Continue</b></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center" width="120"><a href="https://github.com/anomalyco/opencode"><img src="../../public/providers/opencode.svg" width="52" alt="OpenCode"/><br/><b>OpenCode</b></a></td>
|
||||
<td align="center" width="120"><a href="https://github.com/Kilo-Org/kilocode"><img src="../../public/providers/kilocode.svg" width="52" alt="Kilo Code"/><br/><b>Kilo Code</b></a></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/droid.svg" width="52" alt="Droid"/><br/><b>Droid</b></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/openclaw.png" width="52" alt="OpenClaw"/><br/><b>OpenClaw</b></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/kiro.svg" width="52" alt="Kiro"/><br/><b>Kiro</b></td>
|
||||
<td align="center" width="120"><img src="../../public/providers/command-code.svg" width="52" alt="Command Code"/><br/><b>Command</b></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<b>+也相容於</b> · Cline · Antigravity · Windsurf · AMP · Hermes · Qwen CLI · Roo · Continue · <b>任何 OpenAI 相容工具</b>
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🌐 231 個 AI 供應商 — 50+ 免費
|
||||
|
||||
</div>
|
||||
|
||||
> 最完整的開源路由器目錄:**231 個供應商**、**50+ 有免費方案**、**11 個永久免費**。
|
||||
|
||||
<div align="center">
|
||||
|
||||
### 🆓 永久免費 — $0,無需信用卡
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/AgentRouter-FF6600?style=flat-square" alt="AgentRouter"/><br/><sub>GPT-5, Claude, Gemini<br/>$100 免費額度</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/Qoder_AI-6366F1?style=flat-square" alt="Qoder AI"/><br/><sub>Kimi-K2, DeepSeek-R1<br/>無限制免費</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/Pollinations-10B981?style=flat-square" alt="Pollinations"/><br/><sub>GPT-5, Claude, Llama 4<br/>無需金鑰</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/LongCat-FF7A00?style=flat-square" alt="LongCat"/><br/><sub>Flash-Lite<br/>每天 5000 萬 Token 🔥</sub></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/Cloudflare_AI-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare AI"/><br/><sub>50+ 模型<br/>每天 1 萬神經元</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/Gemini_CLI-8E75B2?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini CLI"/><br/><sub>gemini-3-flash<br/>每月 18 萬免費</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/NVIDIA_NIM-76B900?style=flat-square&logo=nvidia&logoColor=white" alt="NVIDIA NIM"/><br/><sub>129 個模型<br/>每分鐘約 40 次免費</sub></td>
|
||||
<td align="center" width="150"><img src="https://img.shields.io/badge/Cerebras-F15A29?style=flat-square" alt="Cerebras"/><br/><sub>Qwen3 235B<br/>每天 100 萬 Token</sub></td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🖥️ OmniRoute 執行環境 — 隨處可用
|
||||
|
||||
</div>
|
||||
|
||||
> 同一個應用程式、你的機器、你的規則。從全域 npm 安裝到**你的手機**(透過 Termux)。
|
||||
|
||||
| 平台 | 安裝方式 | 亮點 |
|
||||
|---|---|---|
|
||||
| 📦 **npm(全域)** | `npm install -g omniroute` | 一條命令,任何作業系統 |
|
||||
| 🐳 **Docker** | `docker run … diegosouzapw/omniroute` | 多架構 **AMD64 + ARM64** |
|
||||
| 🖥️ **桌面(Electron)** | `npm run electron:build` | 原生視窗 + 系統匣 — **Windows / macOS / Linux** |
|
||||
| 💪 **ARM** | 原生 `arm64` | Raspberry Pi、ARM 伺服器、Apple Silicon |
|
||||
| 📱 **Android(Termux)** | `pkg install nodejs-lts && npx -y omniroute` | **在你的手機上**執行,24/7,無需 Root |
|
||||
| 📲 **PWA** | 「新增至主畫面」 | 全螢幕、離線、可從瀏覽器安裝 |
|
||||
| 🧩 **OpenCode 插件** | `@omniroute/opencode-provider` | 原生 OpenCode 整合 |
|
||||
| 🛠️ **原始碼** | `npm install && npm run dev` | 自行修改、貢獻 |
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🔒 私密且本地優先
|
||||
|
||||
</div>
|
||||
|
||||
> 你的金鑰、你的機器、你的資料。OmniRoute 是一個**本地代理** — 它永遠不會回傳資料。
|
||||
|
||||
- 🏠 **100% 在你的硬體上執行** — npm、Docker、桌面或手機。請求路徑中沒有 OmniRoute 雲端。
|
||||
- 🔐 **憑證靜態加密** — API 金鑰和 OAuth Token 以 **AES-256-GCM** 加密保存。
|
||||
- 🚫 **預設零遙測** — 你的提示只會送到你選擇的供應商,不會送往其他地方。
|
||||
- 🛡️ **強化閘道** — API 金鑰範圍限制、IP 過濾、速率限制、提示注入防護。
|
||||
- 📜 **MIT 授權且完全開源** — 審計每一行程式碼,永遠可以自架。
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🔌 完整 CLI + A2A 與 MCP
|
||||
|
||||
</div>
|
||||
|
||||
> OmniRoute 不僅僅是一個伺服器 — 它是一個**完整的命令列駕駛艙**,擁有 **60+ 命令**,加上開放的代理協定,讓 AI 代理可以**自行**驅動 OmniRoute。
|
||||
|
||||
### ⌨️ 真正的 CLI(不只是 `start`)
|
||||
|
||||
```bash
|
||||
omniroute # 提供閘道 + 儀表板服務(通訊埠 20128)
|
||||
omniroute chat # 交談式 TUI 聊天客戶端
|
||||
omniroute setup # 引導式首次執行精靈
|
||||
omniroute doctor # 診斷供應商、通訊埠、原生相依性
|
||||
```
|
||||
|
||||
### 🛰️ 遠端模式 — 在本地執行 CLI,OmniRoute 在 VPS 上
|
||||
|
||||
OmniRoute 在伺服器上?用**相同的 CLI** 從你的筆電驅動它。使用範圍存取 Token 登入一次;之後每個命令都會指向遠端。
|
||||
|
||||
```bash
|
||||
omniroute connect 192.168.0.15 # 密碼 → 範圍 Token,儲存為一個環境
|
||||
omniroute models list # 對遠端伺服器執行
|
||||
omniroute configure codex # 選擇遠端模型,寫入本地 Codex 設定檔
|
||||
omniroute tokens create --name ci --scope read # 為其他機器建立更窄的 Token
|
||||
omniroute contexts use default # 切換回本地伺服器
|
||||
```
|
||||
|
||||
### 🤝 連接代理 — 它就能控制 OmniRoute 本身
|
||||
|
||||
將 OmniRoute 暴露於 **MCP** 或 **A2A**,任何有能力的代理就能取得整個閘道的控制權 — 路由、供應商、組合、快取、壓縮、記憶體 — 自主運作。
|
||||
|
||||
| 協定 | 端點 | 用途 |
|
||||
|---|---|---|
|
||||
| 🧰 **MCP(stdio)** | `omniroute --mcp` | 接入 Claude Desktop、Cursor、任何 MCP 客戶端 |
|
||||
| 🌊 **MCP(HTTP)** | `http://localhost:20128/api/mcp/stream` | 遠端 MCP — **87 個工具**、30 個範圍、完整審計軌跡 |
|
||||
| 📡 **MCP(SSE)** | `http://localhost:20128/api/mcp/sse` | 串流 MCP 傳輸 |
|
||||
| 🤝 **A2A** | `http://localhost:20128/.well-known/agent.json` | 代理間通訊,**JSON-RPC 2.0** + SSE、6 項技能 |
|
||||
|
||||
```bash
|
||||
# 透過 MCP 將完整的 OmniRoute 工具集提供給 Claude Code:
|
||||
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
|
||||
```
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🗜️ 自動節省 15–95% Token
|
||||
|
||||
</div>
|
||||
|
||||
> **Token 夠用就好,何必浪費?** 每個請求都會**透明地**通過 OmniRoute 的壓縮管道 — 無需修改客戶端。現在是一個**9 個可組合引擎**的堆疊,按順序執行,並可依路由組合混合搭配。
|
||||
|
||||
### 🧱 9 引擎堆疊
|
||||
|
||||
引擎按管道順序執行;每個引擎可獨立開關,並可依組合設定:
|
||||
|
||||
| # | 引擎 | 功能 |
|
||||
|---|---|---|
|
||||
| 1 | **Session-Dedup** | 刪除跨輪重複的內容(內容定址、跨輪) |
|
||||
| 2 | **CCR** | 將大型區塊歸檔到檢索標記後,按需提取 |
|
||||
| 3 | **RTK** | 智慧工具結果過濾、去重與截斷(命令感知) |
|
||||
| 4 | **Headroom** | 同質 JSON 陣列的無損表格壓縮(約 30%+) |
|
||||
| 5 | **Caveman** | 基於規則的文句壓縮(輸出約 65–75%) |
|
||||
| 6 | **LLMLingua-2** | 透過 MobileBERT ONNX 進行 ML 語義修剪 — 程式碼安全、非同步 |
|
||||
| 7 | **Lite** | 空白字元 + 圖片 URL 修剪(低延遲基準) |
|
||||
| 8 | **Aggressive** | 摘要 + 舊輪次漸進式老化 |
|
||||
| 9 | **Ultra** | 啟發式 Token 修剪,可選小型模型(SLM)層 |
|
||||
|
||||
### 🎛️ 一鍵預設
|
||||
|
||||
| 模式 | 節省幅度 | 最佳用途 |
|
||||
|---|---|---|
|
||||
| 🪶 **Lite** | 約 15% | 永遠開啟的安全預設 |
|
||||
| 🪨 **Standard(Caveman)** | 約 30% | 日常編碼 |
|
||||
| ⚡ **Aggressive** | 約 50% | 長時間工具密集型工作階段 |
|
||||
| 🔥 **Ultra** | 約 75% | 最大節省 |
|
||||
| 🧰 **RTK** | 60–90% | Shell/測試/建置/Git 輸出 |
|
||||
| 🔗 **疊加(RTK → Caveman)** | **78–95%** | 混合提示 + 工具日誌 |
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# ⚡ 快速開始
|
||||
|
||||
</div>
|
||||
|
||||
**1) 安裝並執行**
|
||||
|
||||
```bash
|
||||
npm install -g omniroute
|
||||
omniroute
|
||||
```
|
||||
|
||||
儀表板在 `http://localhost:20128` · API 在 `http://localhost:20128/v1`。
|
||||
|
||||
**2) 連接免費供應商(無需註冊)**
|
||||
|
||||
儀表板 → **Providers** → 連接 **Kiro AI**(免費 Claude,每個帳號每月約 50 點)或 **OpenCode Free**(無需驗證)→ 完成。
|
||||
|
||||
**3) 指向你的編碼工具**
|
||||
|
||||
```txt
|
||||
Base URL: http://localhost:20128/v1
|
||||
API Key: [從儀表板 → Endpoints 複製]
|
||||
Model: auto(零設定智慧路由 — 或任何供應商/模型)
|
||||
```
|
||||
|
||||
**4) 驗證是否正常運作**
|
||||
|
||||
```bash
|
||||
curl http://localhost:20128/v1/models -H "Authorization: Bearer ***"
|
||||
```
|
||||
|
||||
如果一切正常,你應該會看到已連接的模型列表。🎉
|
||||
|
||||
<br/>
|
||||
|
||||
## 📦 更多安裝方式
|
||||
|
||||
**🐳 Docker**
|
||||
```bash
|
||||
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
|
||||
-p 20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
|
||||
```
|
||||
|
||||
**🛠️ 從原始碼**
|
||||
```bash
|
||||
cp .env.example .env && npm install
|
||||
PORT=20128 npm run dev
|
||||
```
|
||||
|
||||
**📦 pnpm**
|
||||
```bash
|
||||
pnpm install -g omniroute && pnpm approve-builds -g && omniroute
|
||||
```
|
||||
|
||||
**🐧 Arch Linux(AUR)**
|
||||
```bash
|
||||
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
|
||||
```
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 🎬 OmniRoute 實際展示
|
||||
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center" width="280">
|
||||
<a href="https://www.youtube.com/watch?v=Rxdc36yUyOQ"><img src="https://img.youtube.com/vi/Rxdc36yUyOQ/maxresdefault.jpg" alt="葡萄牙語指南" width="260"/></a><br/>
|
||||
<b>🇧🇷 Português</b><br/><sub>完整指南</sub>
|
||||
</td>
|
||||
<td align="center" width="280">
|
||||
<a href="https://www.youtube.com/watch?v=CMzyOiUyEVc"><img src="https://img.youtube.com/vi/CMzyOiUyEVc/maxresdefault.jpg" alt="English Guide" width="260"/></a><br/>
|
||||
<b>🇺🇸 English</b><br/><sub>Complete walkthrough</sub>
|
||||
</td>
|
||||
<td align="center" width="280">
|
||||
<a href="https://www.youtube.com/watch?v=il_5Ii6v4-Y"><img src="https://img.youtube.com/vi/il_5Ii6v4-Y/maxresdefault.jpg" alt="俄語指南" width="260"/></a><br/>
|
||||
<b>🇷🇺 Русский</b><br/><sub>Полное руководство</sub>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 📚 探索更多
|
||||
|
||||
</div>
|
||||
|
||||
<details>
|
||||
<summary><b>💰 價格一覽與 $0 免費堆疊</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
| 層級 | 範例 | 費用 |
|
||||
|---|---|---|
|
||||
| 💳 **訂閱制** | Claude Code Pro / Codex / Copilot | $10–200/月 |
|
||||
| 🔑 **API 金鑰(免費方案)** | NVIDIA NIM、Cerebras、Groq | **免費** |
|
||||
| 💰 **便宜方案** | GLM-5 $0.5/1M · MiniMax M2.5 $0.3/1M | 極低 |
|
||||
| 🆓 **永久免費** | Kiro、Qoder、Qwen、Pollinations、LongCat | **$0** |
|
||||
|
||||
**$0 免費堆疊 — 組合成一個牢不可破的組合:**
|
||||
|
||||
| 供應商 | 字首 | 免費模型 | 配額 |
|
||||
|---|---|---|---|
|
||||
| **Kiro** | `kr/` | Claude Sonnet 4.5、Haiku 4.5、Opus 4.6 | 每月 50 點 |
|
||||
| **Qoder** | `if/` | kimi-k2-thinking、qwen3-coder-plus、deepseek-r1 | ♾️ 無限制 |
|
||||
| **Qwen** | `qw/` | qwen3-coder-plus/flash/next | ♾️ 無限制 |
|
||||
| **Pollinations** | `pol/` | GPT-5、Claude、Gemini、DeepSeek、Llama 4 | 無需金鑰 |
|
||||
| **LongCat** | `lc/` | LongCat-Flash-Lite | 每天 5000 萬 Token 🔥 |
|
||||
| **Cloudflare AI** | `cf/` | 50+ 模型 | 每天 1 萬神經元 |
|
||||
| **NVIDIA NIM** | `nvidia/` | 129 個模型 | 每分鐘約 40 次 |
|
||||
| **Cerebras** | `cerebras/` | Qwen3 235B、GPT-OSS 120B | 每天 100 萬 Token |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>🎯 使用案例 — 現成組合策略</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
**永久免費:**
|
||||
```
|
||||
1. kr/claude-sonnet-4.5 (Kiro — 每月約 50 點)
|
||||
2. if/kimi-k2-thinking (Qoder — 無限制)
|
||||
3. pol/gpt-5 (Pollinations — 無需金鑰)
|
||||
4. lc/longcat-flash-lite (每天 5000 萬 Token 備援)
|
||||
壓縮:aggressive(約 50%)→ 免費配額翻倍 · 費用:$0/月
|
||||
```
|
||||
|
||||
**24/7 不中斷:** 串聯 2 個訂閱 → 便宜方案 → 免費方案,共 5 層備援。
|
||||
**被封鎖地區:** 免費供應商 + 全域/每供應商代理 → 從任何國家存取 AI。
|
||||
**最大節省:** 訂閱 + 便宜備援 + `ultra` 壓縮(約 75%)→ 重度使用者每月約省 $150–300。
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>🌍 繞過地理封鎖 — 3 層代理 + 隱匿</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
在被封鎖的地區?OmniRoute 的 **3 層代理**(全域/每供應商/每連線)代理 API 請求、OAuth 流程、連線測試、Token 刷新和模型同步。
|
||||
|
||||
- **協定:** HTTP/HTTPS、SOCKS5、認證代理
|
||||
- **🆓 1proxy 市集** — 數百個經過驗證的免費代理、品質評分、自動輪換
|
||||
- **反偵測:** TLS 指紋偽裝(`wreq-js`)、CLI 指紋比對、代理 IP 保留
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>✨ 完整功能列表</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
**路由:** 15 種策略 · 任務感知智慧路由 · 思考預算控制 · 萬用字元路由 · 系統提示注入。
|
||||
**相容性:** OpenAI ↔ Claude ↔ Gemini ↔ Responses API · 自動 OAuth 刷新(PKCE、8 個供應商)· 多帳號輪詢 · Batch + Files API · 即時 OpenAPI 3.0。
|
||||
**協定:** MCP(87 個工具、3 種傳輸、30 個範圍)· A2A(JSON-RPC 2.0、SSE、6 項技能)· ACP · 雲端代理(Codex、Devin、Jules)。
|
||||
**插件:** 自訂插件市集 · 安裝/啟用/停用 · Notion + Obsidian 知識庫整合。
|
||||
**品質與維運:** 內建 **Evals**(金標準集)· 護欄(PII、注入、視覺)· 健康儀表板 · p50/p95/p99 遙測 · Webhooks · 合規審計。
|
||||
**AI 代理技能:** 可直接載入的 Markdown 清單 — 將任何代理指向 `skills/*/SKILL.md`。提供 43 項技能。
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>📖 設定、環境變數與常見問題</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
| 環境變數 | 預設值 | 用途 |
|
||||
|---|---|---|
|
||||
| `PORT` | `20128` | API + 儀表板通訊埠 |
|
||||
| `REQUIRE_API_KEY` | `false` | 要求所有請求提供 API 金鑰 |
|
||||
| `DATA_DIR` | `~/.omniroute` | 資料庫與設定儲存位置 |
|
||||
|
||||
**OmniRoute 會向我收費嗎?** 不會 — 它是免費、開源的軟體,執行在你的機器上。你只直接付費給付費供應商。OmniRoute 沒有計費系統。
|
||||
**免費供應商真的無限制嗎?** 大多如此 — Qoder、Pollinations、LongCat 和 Cloudflare 免費且無帳號信用上限。在組合中堆疊多個免費供應商,自動備援讓你能以 $0 持續使用。
|
||||
**壓縮會影響品質嗎?** 不會 — 它只壓縮**輸入**;程式碼、URL、JSON 始終受到保護。
|
||||
**在 AI 被封鎖的地方能運作嗎?** 可以 — 3 層代理 + 1proxy 市集可觸及全部 231 個供應商。
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>🐛 故障排除</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
| 問題 | 快速解決方案 |
|
||||
|---|---|
|
||||
| 「Language model did not provide messages」 | 供應商配額耗盡 → 使用組合備援 |
|
||||
| 速率限制(429) | 加入備援供應商 |
|
||||
| OAuth Token 過期 | 自動刷新;若卡住,在供應商頁面刪除並重新認證 |
|
||||
| `unsupported_country_region_territory` | 在設定 → Proxy 中設定代理 |
|
||||
| Docker SQLite 鎖定 | 使用 `--stop-timeout 40` 確保乾淨的 WAL 檢查點 |
|
||||
| Node 執行時期錯誤 | 使用 Node `>=22.0.0 <23` 或 `>=24.0.0 <27` |
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>📸 儀表板截圖</b></summary>
|
||||
|
||||
<br/>
|
||||
|
||||
| 頁面 | 截圖 | 頁面 | 截圖 |
|
||||
|---|---|---|---|
|
||||
| Providers |  | Combos |  |
|
||||
| Analytics |  | Health |  |
|
||||
| Translator |  | Settings |  |
|
||||
| CLI Tools |  | Usage Logs |  |
|
||||
|
||||
</details>
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# 📧 支援與社群
|
||||
|
||||
</div>
|
||||
|
||||
> 💬 **與社群聊天** — Discord、Telegram 和 WhatsApp 連結在 [本 README 頂部](#-join-the-community)。
|
||||
|
||||
- 🌍 **網站**:[omniroute.online](https://omniroute.online)
|
||||
- 🐙 **GitHub**:[github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
|
||||
- 🐛 **問題回報**:[回報錯誤](https://github.com/diegosouzapw/OmniRoute/issues)(請附上 `npm run system-info` 輸出)
|
||||
- 🤝 **貢獻**:詳細指南請見 [CONTRIBUTING.md](CONTRIBUTING.md)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
## 🛠️ 技術堆疊
|
||||
|
||||
</div>
|
||||
|
||||
- **執行時期**:Node.js 22.x 或 24.x LTS(建議 24 LTS)
|
||||
- **語言**:TypeScript 6.0 — `src/` 和 `open-sse/` **100% TypeScript**(自 v2.0 起核心模組零 `any`)
|
||||
- **框架**:Next.js 16 + React 19 + Tailwind CSS 4
|
||||
- **資料庫**:better-sqlite3(SQLite)+ LowDB(JSON 舊版)
|
||||
- **Schema**:Zod(MCP 工具 I/O 驗證、API 合約)
|
||||
- **協定**:MCP(stdio/HTTP)+ A2A v0.3(JSON-RPC 2.0 + SSE)
|
||||
- **串流**:Server-Sent Events(SSE)+ WebSocket 橋接(`/v1/ws`)
|
||||
- **認證**:OAuth 2.0(PKCE)+ JWT + API 金鑰 + MCP 範圍授權
|
||||
- **測試**:Node.js 測試執行器 + Vitest(**14,965 個測試案例**,涵蓋 517 個檔案)
|
||||
- **平台**:桌面(Electron)、Android(Termux)、PWA(任何瀏覽器)
|
||||
- **CI/CD**:GitHub Actions(發布時自動發佈 npm + Docker Hub)
|
||||
|
||||
<div align="center">
|
||||
|
||||
<br/>
|
||||
|
||||
## 📖 文件
|
||||
|
||||
</div>
|
||||
|
||||
### 📘 入門指南
|
||||
|
||||
| 文件 | 說明 |
|
||||
|---|---|
|
||||
| [使用者指南](docs/guides/USER_GUIDE.md) | 供應商、組合、CLI 整合、部署 |
|
||||
| [設定指南](docs/guides/SETUP_GUIDE.md) | 完整安裝方法、CLI 工具設定、協定設定 |
|
||||
| [CLI 工具指南](docs/reference/CLI-TOOLS.md) | 每個工具的設定方式 |
|
||||
| [遠端模式](docs/guides/REMOTE-MODE.md) | 從筆電 CLI 驅動遠端 OmniRoute |
|
||||
| [快速開始](README.md#-quick-start) | 3 步驟安裝 → 連接 → 設定 |
|
||||
|
||||
### 🔧 維運與部署
|
||||
|
||||
| 文件 | 說明 |
|
||||
|---|---|
|
||||
| [Docker 指南](docs/guides/DOCKER_GUIDE.md) | Docker 執行、Compose 設定檔、Caddy HTTPS |
|
||||
| [VM 部署](docs/ops/VM_DEPLOYMENT_GUIDE.md) | 完整指南:VM + nginx + Cloudflare 設定 |
|
||||
| [Termux 指南](docs/guides/TERMUX_GUIDE.md) | 在 Android 上透過 Termux 執行 OmniRoute |
|
||||
| [環境設定](docs/reference/ENVIRONMENT.md) | 完整的 `.env` 變數與參考 |
|
||||
|
||||
### 🧠 功能與架構
|
||||
|
||||
| 文件 | 說明 |
|
||||
|---|---|
|
||||
| [架構](docs/architecture/ARCHITECTURE.md) | 系統架構、資料流程與內部原理 |
|
||||
| [壓縮指南](docs/compression/COMPRESSION_GUIDE.md) | 7 種壓縮選項 |
|
||||
| [彈性指南](docs/architecture/RESILIENCE_GUIDE.md) | 斷路器、冷卻、佇列 |
|
||||
| [自動組合引擎](docs/routing/AUTO-COMBO.md) | 9 因子評分、模式套件、自我修復 |
|
||||
| [免費方案](docs/reference/FREE_TIERS.md) | 25+ 免費 API 供應商目錄 |
|
||||
|
||||
### 🤖 協定與 API
|
||||
|
||||
| 文件 | 說明 |
|
||||
|---|---|
|
||||
| [API 參考](docs/reference/API_REFERENCE.md) | 所有端點與範例 |
|
||||
| [MCP 伺服器](docs/frameworks/MCP-SERVER.md) | 87 個 MCP 工具、IDE 設定 |
|
||||
| [A2A 伺服器](docs/frameworks/A2A-SERVER.md) | A2A 代理卡片、任務、技能 |
|
||||
|
||||
### 📋 專案與品質
|
||||
|
||||
| 文件 | 說明 |
|
||||
|---|---|
|
||||
| [貢獻指南](CONTRIBUTING.md) | 開發設定與指引 |
|
||||
| [更新紀錄](CHANGELOG.md) | 完整版本歷史 |
|
||||
| [安全政策](SECURITY.md) | 漏洞回報與安全實務 |
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
# ⭐ 頂級貢獻者
|
||||
|
||||
</div>
|
||||
|
||||
> OmniRoute 由充滿熱情的開源社群塑造。這些人做出了卓越貢獻,直接影響了專案的品質、穩定性和影響力。**謝謝你們。**
|
||||
|
||||
感謝所有貢獻者 — 每個 PR、每個測試案例、每個 i18n 翻譯檔案都很重要。開源是由像他們這樣的人建立的。
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
## 👥 貢獻者
|
||||
|
||||
</div>
|
||||
|
||||
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
|
||||
|
||||
### 如何貢獻
|
||||
|
||||
1. Fork 此儲存庫
|
||||
2. 建立你的功能分支(`git checkout -b feature/amazing-feature`)
|
||||
3. 提交你的變更(`git commit -m 'Add amazing feature'`)
|
||||
4. 推送到分支(`git push origin feature/amazing-feature`)
|
||||
5. 開啟 Pull Request
|
||||
|
||||
詳細指引請見 [CONTRIBUTING.md](CONTRIBUTING.md)。
|
||||
|
||||
<br/>
|
||||
|
||||
<div align="center">
|
||||
|
||||
## 🙏 致謝
|
||||
|
||||
</div>
|
||||
|
||||
OmniRoute 站在巨人的肩膀上。每個子系統都是受到先行者的開源專案啟發。
|
||||
|
||||
> ⭐ 以下為 2026 年 6 月的星星數 — 去給這些專案一顆星吧。
|
||||
|
||||
### 🧬 源起與閘道
|
||||
|
||||
| 專案 | ⭐ | 啟發 |
|
||||
|---|---|---|
|
||||
| **[9router](https://github.com/decolua/9router)** · decolua | 17.9k | 本 fork 的原始專案 |
|
||||
| **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** · router-for-me | 37.8k | 啟發此 JS/TS 移植的 Go 實作 |
|
||||
| **[LiteLLM](https://github.com/BerriAI/litellm)** · BerriAI | 50.8k | 公開定價資料集與供應商標準化模型 |
|
||||
|
||||
### 🗜️ 上下文與 Token 壓縮 — 引擎
|
||||
|
||||
| 專案 | ⭐ | 啟發 |
|
||||
|---|---|---|
|
||||
| **[Caveman](https://github.com/JuliusBrussee/caveman)** · JuliusBrussee | 74.5k | 「Token 夠用就好」哲學 |
|
||||
| **[RTK](https://github.com/rtk-ai/rtk)** · rtk-ai | 63.6k | 高效能命令輸出壓縮 |
|
||||
| **[Headroom](https://github.com/chopratejas/headroom)** · chopratejas | 33.6k | 可逆上下文壓縮 |
|
||||
| **[LLMLingua](https://github.com/microsoft/LLMLingua)** · Microsoft | 6.3k | 提示壓縮研究 |
|
||||
| **[Ponytail](https://github.com/DietrichGebert/ponytail)** · DietrichGebert | 51.4k | 「懶惰資深開發者」YAGNI 編碼技能 |
|
||||
|
||||
### 🧠 記憶體與 RAG
|
||||
|
||||
| 專案 | ⭐ | 啟發 |
|
||||
|---|---|---|
|
||||
| **[Mem0](https://github.com/mem0ai/mem0)** · mem0ai | 58.9k | 通用記憶層 |
|
||||
| **[Letta (MemGPT)](https://github.com/letta-ai/letta)** · letta-ai | 23.4k | 有狀態代理與分層記憶 |
|
||||
|
||||
### 📄 授權
|
||||
|
||||
MIT License — 詳見 [LICENSE](LICENSE)。
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
**[⬆ 回到頂部](#-omniroute)** · 用 ❤️ 為開源 AI 社群打造。
|
||||
|
||||
<sub>OmniRoute v3.8.38 · Node ≥22.0.0 · MIT License · <a href="https://omniroute.online">omniroute.online</a></sub>
|
||||
|
||||
</div>
|
||||
Reference in New Issue
Block a user