OmniRoute 仪表盘功能全景指南从 Providers 到 Context Relay 的 30 核心模块深度解析【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 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 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute本文是一份面向 OmniRoute 用户的仪表盘Dashboard功能全景指南。OmniRoute 是统一的 AI 网关与路由层而仪表盘是其全部能力的可视化控制面从 Providers 连接管理、Combos 多模型组合路由到系统健康监控、CLI 工具配置、上下文继电Context Relay与安全加固全部集中在一个界面中完成。读完本文你将掌握 OmniRoute 仪表盘每个功能分区的用途、配置入口、关键参数与底层实现原理能够独立完成从接入提供商、编排路由组合到诊断系统健康状态的完整闭环操作。Providers提供商连接中枢Providers 是仪表盘的第一个核心分区用于管理全部 AI 提供商连接覆盖三类形态OAuth 提供商——如 Claude Code、Codex通过浏览器授权登录API Key 提供商——如 Groq、DeepSeek、OpenRouter填入密钥即可接入免费提供商——如 Qoder、Kiro无需付费即可使用。Kiro 账号内置额度追踪剩余额度remaining credits、总配额total allowance与续费日期renewal date直接展示在 Dashboard → Usage 中。OpenRouter 连接还支持在高级设置Advanced Settings中为单个连接存储preset设置后 OmniRoute 会将其作为 OpenRouter 请求的顶层字段下发例如preset: email-copywriter除非客户端请求已自带preset。提供商列表还内建了「模型可见性开关」v3.5.6模型列表带实时搜索/过滤栏每个模型可通过 图标单独隐藏——被隐藏的模型将置灰并从/v1/models目录中剔除列表顶部以N/M active徽章直观展示启用数与总数之比。Combos19 种策略的多模型路由组合Combos 是 OmniRoute 路由能力的核心。每个 Combo 将多个模型串联成一条执行链并具备自动回退automatic fallback、快速模板quick templates与就绪检查readiness checks。公开策略共 19 种priority优先级、weighted加权、round-robin轮询、context-relay上下文继电、fill-first先填满、p2c二选一、random随机、least-used最少使用、cost-optimized成本优化、reset-aware重置感知、reset-window重置窗口、headroom余量感知、strict-random严格随机、auto自动、lkgp最近可用提供商、context-optimized上下文优化、cache-optimized缓存优化、fusion并行扇出到一组模型再由裁判模型合成一个答案与pipeline流水线。近期组合构建能力增强包括结构化组合构建器——每一步按提供商、模型、精确账号/连接三层选择创建重复提供商支持——只要(provider, model, connection)三元组唯一同一提供商可在单个 Combo 中出现多次Combo 目标健康——分析与健康面板区分单个组合目标/步骤而非把一切折叠成模型字符串复合层级排序——defaultTier - fallbackTier现在影响顶层组合步骤的运行时执行/回退顺序系统提示词模板——Combo 的system_message支持服务端占位符{{MODEL_ID}}、{{PROVIDER_ID}}、{{ACCOUNT}}、{{FINGERPRINT}}在实际路由目标确定后、派发前展开。占位符采用白名单且不递归未知占位符保持字面量空值展开为空串客户端系统提示词永不被改写{{FINGERPRINT}}仅对基于指纹的免费提供商且已固定或自动轮换指纹解析其他场景展开为空。展开逻辑覆盖标准派发循环、轮询与固定上下文缓存会话fusion、chaos、pipeline 与嵌套执行策略暂不展开占位符。Analytics用量分析用量分析覆盖令牌消耗token consumption、成本估算cost estimates、活动热力图activity heatmaps、周分布图表weekly distribution charts与按提供商拆解per-provider breakdowns用于回答「钱花在了哪、哪些模型最活跃」等问题。System Health实时系统健康实时监控面包括运行时长uptime、内存memory、版本version、延迟百分位p50/p95/p99、缓存统计cache statistics、提供商熔断器状态circuit breaker states、受配额监控的活动会话数active quota-monitored sessions以及 Combo 目标健康combo target health。Translator PlaygroundAPI 翻译调试器提供四种调试模式模式用途Playground格式转换器把请求在 OpenAI / Anthropic 等格式间互转Chat Tester实时发起请求验证翻译行为Test Bench批量测试多条用例Live Monitor实时观察流式响应Model Playgroundv2.0.9无需离开仪表盘即可测试任意模型选择提供商、模型与端点用 Monaco Editor 编写提示词实时流式接收响应可随时中断流并查看耗时指标timing metrics。Themesv2.0.5整个仪表盘支持自定义配色主题7 种预设色Coral、Blue、Red、Green、Violet、Orange、Cyan也可直接输入任意 hex 颜色创建自定义主题支持 light、dark 与 system 三种模式。Settings七标签页设置面板设置面板包含 7 个标签页General常规——系统存储、备份管理数据库导出/导入Appearance外观——主题选择器dark/light/system、配色预设与自定义颜色、健康日志可见性、侧边栏项与分组分隔符可见性、Endpoint 隧道可见性控制AI——AI 助手特性、默认路由预设Auto Combo 的auto/coding、auto/fast、auto/cheap、auto/smart、推理回放缓存、技能/记忆开关Security安全——API 端点保护、自定义提供商屏蔽、IP 过滤、会话信息Routing路由——模型别名model aliases、后台任务降级、manifest 感知的层级路由W1–W4、fallbackDelayMs、按会话粘性路由Resilience韧性——限流持久化、熔断器调优、自动禁用被封账号、提供商过期监控、Context Relay交接阈值与摘要模型配置、按提供商的 429 分类及useUpstream429BreakerHints开关、模型冷却Advanced高级——配置覆盖、配置审计轨迹、回退降级模式、Responses API 的后台模式降级。CLI Tools一键配置 AI 编码工具支持一键配置 Claude Code、Codex CLI、OpenClaw、Kilo Code、Antigravity、Cline、Continue、Cursor 与 Factory Droid。提供自动化配置应用/重置apply/reset、连接配置档案connection profiles与模型映射model mapping。CLI Agentsv2.0.11CLI Agents 面板用于发现和管理命令行智能体以网格形式展示 16 个内置 AgentCodex、Claude、Goose、OpenClaw、Aider、OpenCode、Cline、ForgeCode、Amazon Q、Open Interpreter、Cursor CLI、Warp、Windsurf、Devin CLI、Kimi Coding、Command Code并支持安装状态——Installed / Not Found带版本检测协议徽章——stdio、HTTP 等自定义 Agent——通过表单注册任意 CLI 工具名称、二进制路径、版本命令、spawn 参数CLI 指纹匹配——按提供商开关匹配原生 CLI 请求签名以降低封号风险同时保留代理 IP本地 Devin 认证——Devin CLI 使用devin auth login无需浏览器 OAuth 流程。从源码结构看内置与自定义 Agent 的统一注册逻辑位于 src/lib/acp/registry.ts该模块明确支持「内置 Agent 用户自定义 Agent」两类来源。Context Relay会话连续性继电v3.5.5Context Relay 是一种组合策略解决对话中途发生账号轮换时的会话连续性问题在活跃账号额度耗尽之前OmniRoute 在后台生成一份结构化的交接摘要handoff summary当下一个请求解析到不同账号时该摘要作为系统消息注入使新账号在完整上下文的基础上继续对话。配置项可在 Combo 级或全局设置Handoff Threshold交接阈值——触发摘要生成的配额使用百分比默认 85%Max Messages For Summary——参与浓缩的最近历史消息量Summary Model——可选用于生成交接摘要的覆盖模型。目前支持 Codex 账号轮换场景。体系架构细节可参见 Context Relay 文档。Proxy Hardening全链路代理加固v3.5.5Token Health Check——后台 OAuth 刷新现在按连接解析代理配置避免代理必需环境下的刷新失败API Key 校验——提供商密钥校验POST /api/providers/validate经由runWithProxyContext路由遵守提供商级与全局代理设置undici Dispatcher 修复——代理分发器改用 undici 自身的 fetch 实现而非 Node 内置 fetch解决 Node.js 22 上的invalid onRequestStart method报错Node.js 版本检测——登录页主动探测不兼容的 Node.js 版本24并展示警告横幅提示改用 Node 22 LTS。Email Privacy Masking邮箱隐私掩码v3.5.6OAuth 账号邮箱默认脱敏显示如di*****g****.com避免分享截图或录制演示时意外泄露。完整邮箱仍可通过悬停title提示查看全局可在 Settings → Appearance → Account email visibility 中统一控制各界面providers、combos、logs、quota、playground的展示/掩码。OAuth Env Repair一键修复认证环境v3.6.1入口位于Dashboard → Providers → [OAuth Provider] → Repair env一键恢复缺失的环境变量并修复损坏的认证状态。自动检测并修复缺失的 OAuth 客户端凭据、损坏的 env 文件条目、备份路径清洗sanitization。卸载命令v3.6.2命令行为npm run uninstall移除系统应用但保留~/.omniroute中的数据库与配置npm run uninstall:full移除应用并永久擦除全部配置、密钥与数据库Media多媒体生成v2.0.3仪表盘内直接生成图片、视频与音乐支持 OpenAI、xAI、Together、Hyperbolic、SD WebUI、ComfyUI、AnimateDiff、Stable Audio Open 与 MusicGen。Request Logs实时请求日志按提供商、模型、账号与 API Key 过滤的实时请求日志展示状态码、令牌用量、延迟与响应详情。API Endpoint统一端点统一 API 端点带能力拆解Chat Completions、Responses API、Embeddings、Image Generation、Reranking、Audio Transcription、Text-to-Speech、Moderations 与已注册 API Keys。支持 Cloudflare Quick Tunnel、Tailscale Funnel、ngrok Tunnel 与云代理cloud proxy等远程访问方式。API Key Management密钥管理创建、限定作用域scope与吊销 API Key。每个 Key 可限制到特定模型/提供商并支持完全访问或只读权限可视化密钥管理带用量追踪。Audit Log审计日志管理操作追踪可按操作类型、操作者、目标、IP 地址与时间戳过滤形成完整的安全事件历史。Desktop ApplicationElectron 桌面应用支持 Windows、macOS、Linux 的原生 Electron 桌面应用独立运行并集成系统托盘、离线支持、自动更新与一键安装。关键特性服务就绪轮询冷启动不出现白屏系统托盘与端口管理内容安全策略CSP单实例锁重启时自动更新平台条件化 UImacOS 交通灯、Windows/Linux 默认标题栏加固的 Electron 打包——独立 bundle 中检测到符号链接的node_modules会在打包前被拒绝避免运行时依赖构建机v2.5.5优雅退出——Electronbefore-quit先干净关闭 Next.js防止 SQLite WAL 数据库锁死v3.6.2。完整文档见 electron/README.md。V1 WebSocket Bridgev3.6.6OmniRoute 通过/v1/ws升级端点支持 OpenAI 兼容的 WebSocket 客户端。自定义服务 scripts/dev/v1-ws-bridge.mjs 包裹 Next.js将 WS 升级为完整的双向流式会话该桥接在 scripts/dev/run-next.mjs 中导入。认证与 HTTP 请求一致使用同一个 API Key 或会话 Cookie。关键行为WS 升级在连接建立前由 src/lib/ws/handshake.ts 校验会话关闭或上游出错时流被干净终止可与既有 HTTPSSE 流式路径同时工作。从 src/lib/ws/handshake.ts 源码看握手认证支持三种类型none关闭 WS 认证时直接放行、api_key校验Authorization: Bearer头或 URL 查询参数api_key/token/access_token、session校验auth_tokenCookie 中的 JWT通过JWT_SECRET验签。默认路径常量为DEFAULT_WS_PATH /v1/wsWS 认证开关由设置项wsAuth控制。Sync Tokens Config Bundlev3.6.6通过作用域限定的同步令牌scoped sync tokens实现多设备与外部操作者访问POST /api/sync/tokens——签发新同步令牌可限定作用域可带过期时间DELETE /api/sync/tokens/:id——吊销令牌GET /api/sync/bundle——下载带版本号的 JSON 快照所有非敏感设置密码脱敏。配置包由 src/lib/sync/bundle.ts 构建涵盖 settings、providerConnections、providerNodes、modelAliases、combos、apiKeys 与 reasoningRoutingRules 七类数据敏感字段password、requireLogin、cloudEnabled等在序列化前被剔除。消费方通过对比ETag响应头判断变化无需重新下载完整载荷——computeConfigSyncVersion使用 SHA-256 对规范化按键排序、稳定序列化后的 bundle 计算版本指纹。GLM Thinking 预设v3.6.6GLM Thinkingglmt已成为注册的一等提供商65 536 最大输出令牌、24 576 思考预算thinking budget、900 秒默认超时、Claude 兼容 API 格式并与 GLM 家族共享用量同步。混合令牌计数同期落地当 Claude 兼容提供商暴露/messages/count_tokens端点时OmniRoute 在大型请求前调用它并带有优雅的估算回退。Safe Outbound Fetch 与 SSRF 防护v3.6.6所有提供商校验与模型发现调用都经过两层出站防护URL 守卫src/shared/network/outboundUrlGuard.ts——在建立 socket 之前拦截私有/回环/链路本地 IP 段安全 fetch 包装src/shared/network/safeOutboundFetch.ts——应用 URL 守卫、规范化超时并以指数退避重试瞬时错误。守卫违规以 HTTP 422URL_GUARD_BLOCKED呈现并通过 src/lib/compliance/providerAudit.ts 写入合规审计日志。Cooldown-Aware Retries冷却感知重试v3.6.6当上游提供商返回模型级冷却model-scoped cooldown时聊天请求现在会自动重试。可用REQUEST_RETRY默认 2与MAX_RETRY_INTERVAL_SEC默认 30 秒配置限流头学习覆盖x-ratelimit-reset-requests、x-ratelimit-reset-tokens与Retry-After——模型级冷却状态在 Resilience 仪表盘可见。对应的重试上限与区间约束可在 src/sse/services/cooldownAwareRetry.ts 中看到内部上限MAX_REQUEST_RETRY 10。Compliance Audit v2v3.6.6审计日志扩展了游标分页、请求上下文富化request ID、user agent、IP、结构化认证事件、带 diff 上下文的提供商 CRUD 事件以及 SSRF 拦截校验日志。新事件由 src/lib/compliance/providerAudit.ts 发出——该模块还会对连接对象做脱敏摘要剔除apiKey、accessToken、refreshToken、idToken等敏感字段并从响应中递归提取安全过滤/策略违规类警告内容写入审计记录。延伸阅读功能特性总览英文原版上下文继电架构压缩引擎指南Electron 桌面应用文档开源技能框架【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 352 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 550 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
