README (中文 (简体))

🛠️ 技术栈

<td nowrap>运行时<td nowrap>语言<td nowrap>框架<td nowrap>数据库<td nowrap>内存<td nowrap>模式<td nowrap>协议<td nowrap>流式传输<td nowrap>压缩<td nowrap>认证与安全<td nowrap>隐身<td nowrap>弹性<td nowrap>日志<td nowrap>测试<td nowrap>平台<td nowrap>CI/CD<td nowrap>链接

层级	技术
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 密钥 + MCP 范围授权 · 静态 AES-256-GCM · DOMPurify
wreq-js — JA3 / JA4 TLS 指纹伪装，3 级代理
断路器，指数退避，防群集效应，自动组合自愈
pino — 带有请求上下文的结构化 JSON 日志
Node.js 测试运行器 + Vitest — 跨 5,100+ 个跟踪测试文件（单元、集成、E2E、安全、生态系统）的 39,000+ 静态测试声明
桌面 (Electron) · Android (Termux) · PWA (任意浏览器)
GitHub Actions — 发布时自动 npm 发布 + Docker Hub
网站 · npm · Docker Hub

📖 文档

📘 入门指南

<td nowrap>用户指南<td nowrap>设置指南<td nowrap>CLI 工具指南<td nowrap>远程模式<td nowrap>Claude Code 配置<td nowrap>快速开始

文档	说明
提供者、组合、CLI 集成、部署
完整安装方法、CLI 工具配置、协议设置、超时调优
Claude Code、Codex、Cursor、Cline、OpenClaw、Kilo、Copilot 的逐工具设置
通过限定范围的访问令牌，从笔记本电脑上的 CLI 操控远程 OmniRoute（VPS）
使用 `launch` 和各模型配置文件，将 Claude Code 指向 OmniRoute（本地/远程）
3 步完成安装 → 连接 → 配置

🔧 运维与部署

<td nowrap>Docker 指南<td nowrap>Podman 指南<td nowrap>虚拟机部署<td nowrap>Fly.io 部署<td nowrap>Termux 指南<td nowrap>PWA 指南<td nowrap>卸载指南<td nowrap>环境配置

文档	说明
Docker 运行、Compose 配置文件、Caddy HTTPS、隧道、镜像标签
Quadlet systemd 集成、podman-compose、SELinux
完整指南：虚拟机 + nginx + Cloudflare 设置
使用持久化存储部署到 Fly.io
通过 Termux 在 Android 上运行 OmniRoute
渐进式 Web 应用安装、缓存、架构
彻底移除所有安装方式所安装的内容
完整的 `.env` 变量和参考说明

🧠 功能与架构

<td nowrap>架构<td nowrap>压缩指南<td nowrap>RTK 压缩<td nowrap>压缩引擎<td nowrap>压缩规则格式<td nowrap>压缩语言包<td nowrap>弹性指南<td nowrap>自动组合引擎<td nowrap>代理指南<td nowrap>免费套餐<td nowrap>功能展示<td nowrap>代码库文档

文档	说明
系统架构、数据流和内部机制
7 选项管道：关闭 / 轻量 / 标准 / 激进 / 超强 / RTK / 堆叠
命令输出压缩、过滤器、信任、验证、原始输出恢复
Caveman、RTK、堆叠管道、仪表板/API/MCP 接口
适用于 Caveman 和 RTK 过滤器的 JSON 规则包模式
语言检测和 Caveman 规则包编写
熔断器、冷却时间、队列、防惊群、TLS 欺骗
16 因素评分、模式包、自愈
3 级代理系统、1proxy 市场、注册表 CRUD
汇总目录：35 个有文档记录的周期性资源池 / 489 个已编入目录的免费套餐条目
带截图的可视化仪表板导览
适合初学者的代码库导览

🤖 协议与 API

<td nowrap>API 参考<td nowrap>OpenAPI 规范<td nowrap>MCP 服务器<td nowrap>MCP 服务器指南<td nowrap>A2A 服务器<td nowrap>A2A 服务器指南

文档	说明
所有端点及其示例
OpenAPI 3.0 规范
110 个 MCP 工具、IDE 配置、Python/TS/Go 客户端
MCP 安装、传输方式和工具参考
JSON-RPC 2.0 协议、技能、流式传输、任务管理
A2A 智能体卡片、任务、技能和流式传输

📋 项目与质量

<td nowrap>贡献指南<td nowrap>分支与发布模型<td nowrap>变更日志<td nowrap>安全策略<td nowrap>i18n 指南<td nowrap>发布检查清单<td nowrap>覆盖率计划

文档	说明
开发环境设置与准则
PR 的目标分支（`release/*`），以及 `main` 和标签的含义
完整的逐版本发布历史
漏洞报告与安全实践
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，3,025 个外部 PR 来自 535 位不同的贡献者。“变更行数”是 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 排名，也不同于下方基于 Git 元数据统计的 639 人名录。}

🙏 这些贡献者提供的功能、错误修复和基础设施改进，是 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，并将基础分支设置为该 release/vX.Y.Z 分支

详细指南请参阅 CONTRIBUTING.md。

发布新版本

# 创建发布版本——npm publish 会自动执行
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 星标

🌍 StarMapper

🙏 致谢

OmniRoute 站在巨人的肩膀上。它最初是 9router 的一个分支，也是 Go 项目 CLIProxyAPI 的 TypeScript 移植版本——在此基础上，下面的每个子系统都受到了率先实现相关功能的开源项目的启发。它们都塑造了 OmniRoute 的具体组成部分。谨以此向所有这些项目致谢。🙏

⭐ 星标数已于 2026 年 8 月 24 日通过 GitHub 的 REST API 验证——也请为这些项目点亮星标。所列数量是特定日期的精确快照，自然会随时间发生变化。

🧬 项目传承与网关

<td nowrap>9router<td nowrap>CLIProxyAPI<td nowrap>LiteLLM<td nowrap>codex-chatgpt-web<td nowrap>free-claude-code<td nowrap>composer-api<td nowrap>codex-multi-auth<td nowrap>opencode-anthropic-auth<td nowrap>grok2api-merged<td nowrap>TQZHR/grok2api<td nowrap>chenyme/grok2api<td nowrap>grok2api-pro<td nowrap>GrokProxy<td nowrap>GrokBridge<td nowrap>grok-web-api

项目	⭐	它如何启发 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 请求与流式响应类型提供了参考。

🗜️ 上下文与令牌压缩——引擎

<td nowrap>Caveman<td nowrap>RTK – Rust Token Killer<td nowrap>headroom<td nowrap>LLMLingua<td nowrap>llmlingua-2-js<td nowrap>Troglodita<td nowrap>ponytail<td nowrap>i-have-adhd

项目	⭐	它如何启发 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	JS/ONNX 移植版本（MobileBERT / XLM-RoBERTa），被用作我们 LLMLingua 引擎的工作线程后端。
40	巴西葡萄牙语 token 压缩——为我们的 pt-BR 语言包提供支持：针对巴西葡萄牙语语法优化的赘述精简和填充词移除。
108,957	爆火的“懒惰资深开发者”YAGNI 编码技能——启发了我们的少写代码输出风格：通过引导采用最小可行改动来减少_生成的_代码（与 Caveman 简练文风相对应的输出维度方案）。
23,526	其行动优先、对 ADHD 友好的响应风格被改编为 OmniRoute 支持五种语言的简洁输出风格。

🧩 紧凑格式、token 研究与代码感知工具

<td nowrap>TOON<td nowrap>GCF – Graph Compact Format<td nowrap>gcf-typescript<td nowrap>token-optimizer-mcp<td nowrap>token-savior<td nowrap>token-saver<td nowrap>token-optimizer<td nowrap>TokenMizer<td nowrap>OmniCompress<td nowrap>mcp-compressor<td nowrap>RepoMapper<td nowrap>quiet-shell-mcp<td nowrap>ts-morph

项目	⭐	它如何启发 OmniRoute
25,233	面向 token 的对象表示法——其列式“表头加数据行”模型塑造了我们的表格压缩阶段。
41	其紧凑图格式和通用配置设计为 OmniRoute 的表格压缩与 Headroom 编解码器格式提供了参考。
4	该 MIT TypeScript 实现被直接内嵌并扩展为 Headroom 通用配置编解码器。
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

<td nowrap>Mem0<td nowrap>Letta (MemGPT)<td nowrap>WFGY

项目	⭐	它如何启发 OmniRoute
63,902	通用记忆层——其以代理作为写入/读取边界的模型塑造了我们的记忆架构。
24,382	具有分层记忆的有状态智能体——启发了我们的上下文控制与恢复（CCR）分层模型。
1,781	对 16 种反复出现的 RAG/LLM 故障模式进行分类的 ProblemMap 体系——构成了我们故障排除指南中的通用术语。

🛰️ 流量检查、MITM 与透明代理

<td nowrap>llm-interceptor<td nowrap>ProxyBridge

项目	⭐	它如何启发 OmniRoute
66	对编码助手 ↔ LLM 流量进行 MITM 拦截/分析，为早期流量检查器的需求提供了参考。此前衍生的四个模块——SSE 合并、对话规范化、敏感信息遮蔽和请求头净化——已被基于公开协议标准、独立洁净室实现的版本取代。两个主机直通层面（`passthrough.ts` 和 `_internal/bypass.cjs`）仍是独立归类的 OmniRoute 内部实现；它们未作为此次替换的一部分进行重写。
5,995	按进程进行透明代理路由——启发了我们的崩溃安全型 MITM 拆除机制、套接字空闲超时、`/proc` 进程归因和 TPROXY 捕获。

📚 模型数据、可观测性与 UI

<td nowrap>models.dev<td nowrap>React Flow / xyflow<td nowrap>LangGraph<td nowrap>Langfuse<td nowrap>Kiali<td nowrap>lobe-icons<td nowrap>flag-icons

项目	⭐	它如何启发 OmniRoute
6,555	开放的 AI 模型规格、定价和能力数据库——已原生同步到我们的模型目录中。
38,108	为我们的实时压缩工作室和组合/路由工作室提供支持的节点式图库。
40,314	LangGraph Studio 的实时工作流图可视化启发了我们工作室中的实时级联视图。
33,592	其追踪 → 跨度 → 生成的可观测性模型塑造了我们的压缩工作室瀑布图。
3,631	Istio 服务网格可观测性——启发了路由/组合工作室中的断路器徽章和错误边可视化。
2,428	用于在整个仪表板中呈现提供者图标的 AI/LLM 品牌标志。
12,354	提供 README 语言选择器所使用的 MIT 许可 SVG 旗帜图标。

🛡️ 安全性

<td nowrap>awesome-secure-defaults

项目	⭐	它如何启发 OmniRoute
721	精心整理的默认安全库清单，为我们的安全选型提供指导（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）。

🧭 互补工具

<td nowrap>ClawRouter<td nowrap>Antigravity-Manager<td nowrap>vscode-antigravity-cockpit<td nowrap>AionUi<td nowrap>CodexBar

项目	⭐	它如何启发 OmniRoute
6,564	启发了请求去重、紧急零成本回退、可插拔的自动组合策略和多语言意图分类。
30,652	其账号感知的模型重映射、可执行文件路径验证和套餐标签行为，为 OmniRoute 的 Antigravity 运行时提供了参考。
4,817	其紧凑的配额重置倒计时格式启发了 OmniRoute 中相应的提供者限额显示。
32,230	其 ACP 集成启发了 OmniRoute 对已安装 CLI 智能体的自动检测。
20,507	识别出了 Grok Build 配额接口；随后 OmniRoute 独立验证并修正了实时线上格式。

📄 许可证

MIT 许可证——详情请参阅 LICENSE。

⬆ 返回顶部 · 用 ❤️ 为开源 AI 社区打造。

_{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT 许可证 · omniroute.online}

OmniRoute 源码 (a58000c7685f)

HagiCode

HagiCode 是一套智能体编码工作台：结构化工作流、多 Agent 并行执行与 Hero Dungeon 视图，把想法变成真正交付的软件。

让想法更快变成好用的软件，让智能编码更聪明、更高效，也更有趣。

Smart结构化工作流将意图转化为从想法到交付的可执行路径。
Efficient多 Agent 工作流让调研、实现与审阅并行推进。
FunHero Dungeon 让长时间编码协作更直观、更有参与感。

访问 HagiCode

选择语言