OmniRoute开发者环境搭建本地构建、调试与贡献者循环教程【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRouteOmniRoute是一个开源免费的 AI 网关AI Gateway项目一个端点接入 350 供应商、1200 模型支持 Claude Code、Codex、Cursor 等工具自带配额感知自动回退与 Token 压缩。本教程带你完成OmniRoute 开发者环境搭建从克隆仓库、本地构建、配置环境变量到日常调试与提交贡献的完整贡献者循环零基础也能照着跑通。环境准备3 个工具先装好开始前确认本地已安装以下工具版本要求来自 CONTRIBUTING.md工具版本要求说明Node.js22.22.3 23或24 27推荐 24 LTSnpm10包管理器Git任意较新版本代码管理 使用 Node 24 npm v11 时安装后要验证原生模块是否就绪node -e require(better-sqlite3)。若报MODULE_NOT_FOUND执行npm approve-scripts better-sqlite3 npm install修复详见 docs/guides/TROUBLESHOOTING.md。克隆仓库与本地构建最快启动方法执行下面 3 条命令即可完成 OmniRoute 本地构建git clone https://gitcode.com/GitHub_Trending/om/OmniRoute cd OmniRoute npm install构建产物目录分工了解即可不影响日常开发src/— 应用源码TypeScript / TSX.build/—next build中间产物不入库dist/— 最终可部署产物由assembleStandalone组装配置环境变量30 秒生成密钥仓库提供了完整的.env.example模板复制后补上两个必填密钥即可cp .env.example .env echo JWT_SECRET$(openssl rand -base64 48) .env echo API_KEY_SECRET$(openssl rand -hex 32) .env开发阶段最常用的变量只有几个PORT默认20128、INITIAL_PASSWORD首次登录密码默认CHANGEME、APP_LOG_LEVEL。.env已被.gitignore忽略切勿提交管理细节见 docs/DEVELOPER-ENVIRONMENT.md。启动开发服务与常用调试入口npm run dev启动后两个默认地址仪表盘http://localhost:20128/dashboardAPIhttp://localhost:20128/v1调试时最实用的两个入口Settings → Advanced → Debug Mode开启调试请求日志UI 开关保存在数据库中重启依然生效Dashboard → Translator排查格式翻译问题OpenAI ↔ Claude ↔ Gemini 互转的最快路径其他常用命令完整版见 package.json 的 scripts 字段命令用途npm run dev热重载开发模式npm run build/npm run start生产构建与启动npm run lintESLint 检查提交前必跑node --import tsx/esm --test tests/unit/xxx.test.ts只跑单个测试文件npm run test:e2ePlaywright 端到端测试贡献者循环分支、测试与 PR 清单OmniRoute 有 450 贡献者协作流程非常规范核心要点如下分支永远不要直接提交main从当前活跃的release/vX.Y.Z分支拉出feat/、fix/等特性分支见 docs/ops/BRANCHING_MODEL.md提交信息遵循 Conventional Commits如feat: add circuit breaker for provider calls聚焦测试只跑覆盖你改动的最小测试文件 npm run lint全量矩阵交给 CI覆盖率门槛为60%变更路径每类改动Provider / 路由 / UI / i18n都有对应的黄金路径检查项见 docs/ops/CONTRIBUTION_GOLDEN_PATH.mdChangelog面向用户的改动请添加changelog.d/{features|fixes|maintenance}/PR-slug.md片段不要直接编辑CHANGELOG.md新增 Provider 是新手最友好的入口固定 6 步注册常量 → 写 Executor如需→ 写 Translator非 OpenAI 格式时→ OAuth 配置如适用→ 注册模型 → 补单测详见 CONTRIBUTING.md 的 Adding a New Provider 章节。常见问题速查症状解决方案启动报Cannot find module better-sqlite3npm approve-scripts better-sqlite3 npm installnpm v11 常见端口 20128 被占用PORT20130 NEXT_PUBLIC_BASE_URLhttp://localhost:20130 npm run dev首次登录失败检查.env中INITIAL_PASSWORD登录后在 Settings → Security 修改其他网络/构建问题查阅 docs/guides/TROUBLESHOOTING.md延伸阅读官方文档导航贡献指南CONTRIBUTING.md贡献黄金路径docs/ops/CONTRIBUTION_GOLDEN_PATH.md分支与发布模型docs/ops/BRANCHING_MODEL.md开发者环境与密钥管理docs/DEVELOPER-ENVIRONMENT.md排障手册docs/guides/TROUBLESHOOTING.md系统架构docs/architecture/ARCHITECTURE.md跑通npm run dev、打开仪表盘看到 Providers 列表的那一刻你的OmniRoute 开发者环境搭建就完成了。接下来找一个fix/小分支试试把贡献者循环变成肌肉记忆吧 【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
