后端API网关LLM 网关人工智能大模型MCP 服务桌面应用【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 359 providers (150 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 hundreds of contributors项目地址https://gitcode.com/GitHub_Trending/om/OmniRoute点击查看免费下载导读OmniRoute 是一个拥有src/Next.js 16 应用、open-sse/流式引擎工作区、electron/、tests/等多个子项目的统一 AI 网关仓库数百名贡献者共同维护。为了让所有 AI 助手Claude Code、Gemini、Codex、Copilot 等在改代码时遵循一致的目录纪律、不污染仓库根目录、不误用开发凭据仓库维护了一套以 AGENTS.md 为“单一事实来源”的助手规则。本文以德语版规则文档 docs/i18n/de/GEMINI.md 为主体结合仓库当前实现系统讲解测试文件与脚本的强制落点、仓库根目录白名单、以及 VPS 仪表盘凭据的真实处理姿势读完后你可以在任何 AI 编码会话或人工审查中快速套用这套规范。1. 规则从哪来GEMINI.md、CLAUDE.md 与 AGENTS.md 的关系德语版规则文档docs/i18n/de/GEMINI.md的标题是Security and Cleanliness Rules for AI AssistantsAI 助手的安全与整洁规则属于仓库为 AI 助手准备的规则文件的多语言矩阵之一英文原文位于仓库根的 GEMINI.md其余语言版本德语、中文、日语、西语、法语等 70 语种统一放在docs/i18n/lang/目录下。英文原文 GEMINI.md 明确了两条核心约定单一事实来源所有面向 AI 助手的项目规则都收敛在 AGENTS.md23 条硬规则、质量门禁、代码规范、文件放置/仓库根卫生规则、仓库地图以及原本散落在 GEMINI.md 里的本地开发访问说明均已迁入该文件。任何变更前必须通读全文。Gemini 专属增量技能Skills通过activate_skill工具激活——技能元数据在会话启动时加载完整内容按需激活。除此之外当前没有其他 Gemini 专属规则也不要往 GEMINI.md 里重复添加项目规则统一编辑 AGENTS.md 即可这样所有助手看到的是同一套指令。德语版文档正是这套“安全与整洁规则”的本地化呈现其正文由两条硬性纪律构成文件放置与组织、VPS 仪表盘凭据。下文逐一展开并结合 AGENTS.md 的权威版本与仓库实际目录结构进行核实与补充。2. 规则一测试文件只能进tests/德语规则第 1 节的第一条要求所有单元测试、集成测试、生态ecosystem测试或 Vitest 文件必须严格放在tests/目录内例如tests/unit/、tests/integration/严禁在项目根目录/创建测试文件。这条规则的仓库落地是显而易见的本仓库的 tests/ 目录下聚集了tests/unit/数千个用例、tests/integration/、tests/e2e/、tests/boundary/、tests/security/、tests/fixtures/、tests/helpers/等多个子目录测试文件与源码工作区src/、open-sse/严格隔离。权威规则 AGENTS.md 的措辞更进一步把范围明确为“ALL unit tests, integration tests, ecosystem tests, or Vitest files”。对 Agent 而言这意味着在新增用例时先判断类别再选落点测试类别强制落点单元测试tests/unit/集成测试tests/integration/端到端 / 协议 / 生态tests/e2e/、tests/protocols:e2e、tests/ecosystem对应套件Vitest 专属MCP server、autoCombo、cache仍位于tests/下的 Vitest 用例配合运行的命令见 AGENTS.md# 单文件Node.js 原生测试运行器大多数测试用这个 node --import tsx/esm --test tests/unit/your-file.test.ts # Vitest 套件MCP server、autoCombo、cache npm run test:vitest # 全部套件 npm run test:all # 单元测试 覆盖率门禁statements/lines/functions/branches 各 60% npm run test:coverage另有npm run test:e2e、npm run test:protocols:e2e、npm run test:ecosystem等独立套件。也就是说“放进tests/”不仅是目录纪律还直接决定了用例被哪个运行器发现、被哪道覆盖率门禁统计。3. 规则二脚本与工具只能进scripts/一次性代码有专门落点德语规则第 1 节的第二条要求所有维护、调试、生成或实验性脚本.cjs、.mjs、.js、.ts必须严格放在scripts/目录或scripts/scratch/用于临时一次性脚本严禁把零散脚本丢进项目根目录/。这里有一个需要以仓库现状为准的细节德语文档写的是scripts/scratch/但在当前仓库中并不存在该目录ls scripts/也找不到。权威版本 AGENTS.md 已将该规则更新为脚本必须放进scripts/的功能子文件夹之一并给出了完整清单——build/、dev/、check/、docs/、i18n/、ad-hoc/、quality/、release/、ci/、ops/、perf/、research/、sre/、vps/、homolog/、packs/、skills/、test/、cli/、compression/、compression-eval/、devin-bridge/、docker/、features/、router-eval/一次性或实验性代码放到scripts/ad-hoc/严禁丢在仓库根目录或scripts/顶层。当前仓库 scripts/ 目录实际包含的正是这些功能子目录ad-hoc/、check/、ci/、cli/、compression/、dev/、docs/、features/、i18n/、ops/、perf/、quality/、release/、research/、router-eval/、skills/、sre/、test/、vps/等与权威规则一一对应。因此给 Agent 的实操建议是以 AGENTS.md 为准把临时脚本放进scripts/ad-hoc/而不是文档中已过时的scripts/scratch/。这也提醒阅读多语言文档的开发者规则类文档可能存在滞后落地前务必回查根目录的权威文件。4. 仓库根目录白名单根目录只允许放四类文件德语规则进一步规定项目根目录 MUST ONLY CONTAIN只能包含配置文件如vitest.config.ts、next.config.mjs、eslint.config.mjs等依赖文件package.json、package-lock.json文档文件README.md、CHANGELOG.md、AGENTS.mdCI/CD 文件与忽略定义.gitignore、.dockerignore。AGENTS.md 的权威版本给出了更完整、可直接对照检查的清单配置文件vitest.config.ts、next.config.mjs、eslint.config.mjs、tsconfig*.json、playwright.config.ts、prettier.config.mjs、postcss.config.mjs、sonar-project.properties、fly.toml、docker-compose*.yml、Dockerfile依赖文件package.json、package-lock.json文档文件README.md、CHANGELOG.md、ROADMAP.md、LICENSE、AGENTS.md、CLAUDE.md、GEMINI.md、CONTRIBUTING.md、SECURITY.md、CODE_OF_CONDUCT.md、llm.txtCI/CD 与忽略定义.gitignore、.dockerignore、.npmignore、.npmrc、.node-version、.nvmrc、.env.example。对照当前仓库根目录可见这些文件正是根目录实际存在的内容如 .env.example、.gitignore、.dockerignore 均在列规则与现状一致。此外还有一条根目录“私有路径”纪律AGENTS.md根目录下所有_*前缀路径_tasks/、_references/、_cache/等是私有且永不跟踪的——它们只存在于磁盘、被锚定模式/_*//_*gitignore其中有些甚至是独立 git 仓库严禁git add其内部内容也严禁从主仓库“清理”它们取消跟踪必须用git rm --cached保留磁盘内容。check:tracked-artifacts门禁pre-commit CI会对任何以_开头的被跟踪根路径直接判失败。5. 默认落点新建校验测试与一次性脚本放哪德语规则的最后一条给出了“默认落点”指引创建任何校验测试或一次性逻辑脚本时默认按目标放进scripts/scratch/或tests/unit/目录。不要污染/根上下文。与第 3 节同理仓库现状把默认落点更新为scripts/ad-hoc/或tests/unit/见 AGENTS.md。这条规则的意图很明确给 Agent 一个“零思考”的默认答案——新建的东西要么归入tests/unit/校验逻辑要么归入scripts/ad-hoc/一次性脚本从而让根目录永远保持可审计的干净状态。仓库还为“干净”提供了自动化保障npm run check:docs-allAGENTS.md修改docs/后必须运行内含 fabricated-docs 校验防伪造文档约 90 个质量门禁脚本AGENTS.md分布在scripts/check/与scripts/quality/配合config/quality/下的基线文件如 config/quality/file-size-baseline.json持续把关check:tracked-artifacts拦截根目录_前缀的误跟踪。也就是说“文件放对地方”不仅靠纪律也靠 CI 中的硬校验。6. 规则三VPS 仪表盘凭据——文档里的表格与仓库的真实口径德语文档第 2 节给出了一张凭据表环境URL密码Local VPShttp://192.168.0.15:20128123456这张表在仓库中对应什么核实仓库证据后正确的解读是“这是一组已过时的非生产演示值切勿照单复用”仪表盘默认地址.env.example中PORT20128AGENTS.md 明确“dashboard 默认http://localhost:20128API 与 dashboard 同端口”凭据由操作者operator专属掌握初始管理员密码来自INITIAL_PASSWORD环境变量.env.example中默认CHANGEME首次登录后必须立即轮换权威规则的原话AGENTS.md“任何在此前版本文件中观察到的凭据都是非生产演示值应视为已泄露不要复用”——德语文档表格里的123456正是这类演示值192.168.0.15出现在仓库中仅作为生产 VPS 主机地址AGENTS.md 的“真实环境测试”一节提到root192.168.0.15而非可公开使用的凭据。因此给 Agent 与开发者的正确姿势是本地开发访问http://localhost:20128首次安装时通过INITIAL_PASSWORD设置初始密码登录后立即轮换在 VPS / 共享开发环境上向操作者索取当前 URL 与凭据存在操作者的个人密码库不在仓库中一旦发现某处文档/脚本中残留明文演示密码按“已泄露”处理不要复用到任何环境。7. 小结把“安全与整洁”变成可执行的检查清单回到德语规则文档的核心骨架这套规范可以浓缩为一份 Agent 可逐条自检的清单测试新建任何单元/集成/生态/Vitest 用例一律落tests/tests/unit/、tests/integration/…禁止根目录脚本维护、调试、生成、实验脚本一律进scripts/的功能子目录一次性代码放scripts/ad-hoc/文档中已过时的scripts/scratch/在仓库中不存在以 AGENTS.md 为准根目录白名单只允许配置文件、依赖文件、文档文件、CI/CD 与忽略定义四类_*私有路径永不跟踪凭据仪表盘默认http://localhost:20128初始密码走INITIAL_PASSWORD并立即轮换仓库内任何明文演示密码一律视为已泄露、不复用自动化兜底改动后运行npm run check:docs-all、npm run check让check:tracked-artifacts等门禁在 CI 层拦截违规。这套规则在德语版 docs/i18n/de/GEMINI.md 中只有两节但其背后是由 AGENTS.md23 条硬规则 质量门禁 仓库地图支撑的完整协作体系。无论你以 Claude Code、Gemini 还是其他助手身份进入该仓库先读 AGENTS.md 全文再动手改动是保证变更不破坏仓库卫生的最短路径。赞分享后端API网关LLM 网关人工智能大模型MCP 服务桌面应用【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 359 providers (150 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 hundreds of contributors项目地址https://gitcode.com/GitHub_Trending/om/OmniRoute点击查看免费下载相关推荐OmniRoute 仓库安全与整洁规范面向 Gemini 与 AI 助手的协作治理指南OmniRoute 仓库安全与整洁规范面向 Gemini 与 AI 助手的协作治理指南 导读 本篇文章围绕 OmniRoute 仓库中面向 AI 助手尤其是后端API网关LLM 网关人工智能大模型MCP 服务桌面应用Valibot 仓库协作指南Monorepo 架构、开发命令与 AI 辅助开发规范Valibot 仓库协作指南Monorepo 架构、开发命令与 AI 辅助开发规范 Valibot 是一个模块化、类型安全的 schema 校验库零运行时依后端前端Rufus USB 启动盘制作完整指南从分区方案选择到镜像哈希校验Rufus USB 启动盘制作完整指南从分区方案选择到镜像哈希校验 U 盘写入到一半弹出错误对话框或者制作完成后重启BIOS 里根本看不到这块 U 盘的启桌面应用开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考