9Router 智能路由与自动回退(Smart Routing Auto Fallback)实战指南

发布时间:2026/9/10 17:08:48

9Router 智能路由与自动回退(Smart Routing  Auto Fallback)实战指南 9Router 智能路由与自动回退Smart Routing Auto Fallback实战指南【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router本篇技术指南以 9Router 官方文档gitbook/content/ja/features/smart-routing.md为主体深入讲解其三层回退路由系统的架构原理、自动切换判定逻辑、Dashboard 配置项与配额重置策略并结合仓库源码open-sse/services/combo.js、open-sse/services/accountFallback.js剖析底层实现。读完本文你将掌握如何为 Claude Code、Codex、Cursor、Cline 等客户端配置永不中断的智能路由让订阅、低价 API 与免费层协同工作做到配额受限也不停编码。一、三层回退系统路由的核心骨架9Router 采用智能路由思想优先榨干你已经付费的订阅价值其次使用超低价 API 兜底最后回退到免费层保障 24 小时可用性。整体流程如下原文流程图Request → 9Router → 检查 Tier 1订阅 ↓ 配额耗尽 检查 Tier 2低价 ↓ 预算上限 检查 Tier 3免费 ↓ ResponseTier 1订阅层主用Claude CodePro/MaxOpenAI CodexPlus/ProGemini CLI每月 18 万次免费额度GitHub CopilotAntigravityGoogle目标从你已支付的订阅中获取最大价值避免额度闲置浪费。Tier 2低价层备份GLM-4.7输入 100 万 token 约 $0.60MiniMax M2.1输入 100 万 token 约 $0.20Kimi K2每月固定 $9目标订阅配额耗尽时提供超低价备份按文档口径比 ChatGPT API 便宜约 90%。Tier 3免费层应急iFlow8 个模型Qwen3 个模型Kiro免费使用 Claude目标零成本兜底实现无限制编码。以上价格与额度数字均出自官方文档原文实际价格与可用额度请以供应商当前公布为准。二、自动切换三类典型场景9Router 实时监控配额并按需切换供应商官方文档给出了三个典型场景。场景 1订阅配额耗尽用户请求 → cc/claude-opus-4-5 ↓ 配额耗尽达到 5 小时限制 自动切换 → glm/glm-4.7 ↓ 日配额耗尽 自动切换 → minimax/MiniMax-M2.1 ↓ 5 小时配额耗尽 自动切换 → if/kimi-k2-thinking免费 ↓ 响应送达 ✅结果零停机、无缝体验。场景 2速率限制用户请求 → cx/gpt-5.2-codex ↓ 被限流请求过多 自动切换 → glm/glm-4.7 ↓ 响应送达 ✅场景 3供应商不可用用户请求 → cc/claude-opus-4-5 ↓ 供应商错误503 自动切换 → 下一个可用模型 ↓ 响应送达 ✅底层实现handleComboChat 的逐级尝试上述切换在源码层面由 open-sse/services/combo.js 中的handleComboChat完成。它按序遍历 Combo 中的每个模型调用handleSingleModel(body, modelStr)发出请求若返回2xx成功立即返回响应中断遍历若失败解析错误体中的error.message与retryAfter记录所有模型中最早的retryAfter调用checkFallbackError(status, errorText)判定该错误是否应触发回退对于 503/502/504 这类瞬时错误若冷却时间在 5 秒内会先等待冷却再继续尝试下一个模型给短暂过载的供应商恢复机会源码注释明确说明这是为了修复Combo 在瞬时 503 时直接跳过的问题若判定为不应回退直接返回该错误响应全部模型失败后统一返回503 Service Unavailable而非 406并尽可能附带retryAfter供客户端重试若错误信息含 no credentials同样以 503 返回。错误是否触发回退由 open-sse/config/errorConfig.js 的ERROR_RULES驱动自上而下匹配文本规则优先no credentials冷却 2 分钟、request not allowed5 秒、improperly formed request2 分钟、rate limit/too many requests/quota exceeded/capacity/overloaded指数退避状态码规则401/402/403/404冷却 2 分钟、429指数退避。其中指数退避配置为 errorConfig.js基础 2 秒、指数递增、上限 5 分钟、最大 15 级未匹配的瞬时错误默认冷却 30 秒TRANSIENT_COOLDOWN_MS。三、模型选择逻辑9Router 依据以下四个维度选择最优模型配额可用性——检查供应商剩余配额成本层级——优先订阅 → 低价 → 免费重置时机——考虑配额何时重置供应商健康度——跳过持续报错的供应商。优先级判断示例以请求cc/claude-opus-4-5为例1. 检查 Claude Code 配额 ✅ 可用 → 使用 cc/claude-opus-4-5 ❌ 耗尽 → 进入步骤 2 2. 检查回退层级如已配置 ✅ GLM 配额可用 → 使用 glm/glm-4.7 ❌ 耗尽 → 进入步骤 3 3. 检查免费层 ✅ iFlow 可用 → 使用 if/kimi-k2-thinking ❌ 全部耗尽 → 返回配额错误能力感知的自动切换auto-switch除按序回退外源码还实现了能力感知重排。handleComboChat在开始遍历前若启用autoSwitch会先调用detectRequiredCapabilities(body)combo.js扫描当前用户轮次的输入模态OpenAI / Claude 的image_url、image、input_image→ 标记visionfile、document、input_file或application/pdfMIME → 标记pdfGemini / Antigravity 的inlineData/fileData图片 MIME → 标记vision。随后reorderByCapabilities(models, required)combo.js对模型做稳定排序将满足硬性能力vision/pdf/audioInput/videoInput的模型浮到队首且绝不丢弃任何模型——回退链完整性保持不变。这一点由测试 tests/unit/combo-autoswitch.test.js 验证例如将具备 vision 能力的模型浮到最前同时保留 deepseek 模型作为回退。轮询策略round-robin对于不希望永远只打第一个模型的场景Combo 支持round-robin策略与stickyLimit参数combo.js按配置的请求次数粘滞在当前模型上达到上限后轮转到下一个并在内存中按 Combo 名称独立记录轮转状态resetComboRotation可在 Combo/设置变更时清空状态。相关行为由 tests/unit/combo-routing.test.js 覆盖且默认fallback策略不参与轮转。四、配置选项Dashboard 操作手册1. 启用/停用自动回退Dashboard → Settings → Smart Routing → 切换「Auto Fallback」开/关开默认自动层级切换关严格模式Strict mode主用模型不可用时直接返回错误。2. 设置预算上限Dashboard → Settings → Budget Control → 日上限$5 → 月上限$50预算用尽后9Router 自动切换到免费层防止超支。底层配套的配额统计与预算判定逻辑可参考 open-sse/services/usage/ 与 src/lib/usageDb.js 相关实现。3. 配置回退顺序Dashboard → Settings → Fallback Priority → 在各层级内拖拽调整供应商顺序自定义顺序示例Tier 1: Gemini CLI → Claude Code → Codex Tier 2: MiniMax → GLM → Kimi Tier 3: iFlow → Kiro → Qwen该顺序最终即 Combo 的模型数组顺序由handleComboChat按序执行。4. 配额重置通知Dashboard → Settings → Notifications → 配额重置时发送邮件 → 配额使用 80% 时告警五、典型配置示例示例 1基础自动回退配置Model: cc/claude-opus-4-5-20251101 Fallback: 自动默认三层运行表现早晨配额全新: Request → cc/claude-opus-4-5 ✅ 下午配额耗尽: Request → glm/glm-4.7 ✅自动切换 傍晚GLM 配额用尽: Request → minimax/MiniMax-M2.1 ✅自动切换 深夜全部付费配额耗尽: Request → if/kimi-k2-thinking ✅免费层成本每月额外支出约 $5–10主要由订阅覆盖。示例 2预算敏感型路由配置Dashboard → Settings: Daily budget: $2 Monthly budget: $20 Fallback: 启用运行表现第 1~15 天预算内: Requests → glm/glm-4.7低价层 成本: $1.50/天 第 16 天到达预算: Requests → if/kimi-k2-thinking免费层 成本: $0 次月预算重置: Requests → 重新使用 glm/glm-4.7结果每月不超 $20始终可用。示例 3仅订阅模式配置Dashboard → Settings: Auto Fallback: 关 Strict mode: 开运行表现Request → cc/claude-opus-4-5 ✅ 配额可用 → 成功 ❌ 配额耗尽 → 返回错误不回退适用场景只想用付费订阅、零额外成本。示例 4仅免费模式配置Model: if/kimi-k2-thinking Fallback: qw/qwen3-coder-plus → kr/claude-sonnet-4.5运行表现所有请求 → 仅走免费层 成本: 永远 $0适用场景个人项目、学习、实验。六、最佳实践四种路由策略1. 最大化订阅价值策略: - 订阅模型设为 Tier 1 - 在 Dashboard 监控配额使用量 - 仅当订阅耗尽时使用低价层推荐 Combocc/claude-opus-4-5 → glm/glm-4.7 → if/kimi-k2-thinking2. 成本优先策略: - 先使用 Gemini CLI 免费层每月 18 万 - 回退到 GLM/MiniMax超低价 - 应急: iFlow免费推荐 Combogc/gemini-3-flash-preview → glm/glm-4.7 → if/kimi-k2-thinking3. 质量优先策略: - 使用最强模型Claude Opus、GPT-5.2 - 回退到优质低价模型GLM-4.7 - 最后手段: 免费层推荐 Combocc/claude-opus-4-5 → cx/gpt-5.2-codex → glm/glm-4.74. 24 小时可用性策略: - 回退链始终包含免费层 - 监控配额重置时间 - 在供应商间分散用量推荐 Combocc/claude-opus-4-5 → glm/glm-4.7 → minimax/MiniMax-M2.1 → if/kimi-k2-thinking结果永不缺配额随时编码。关于自定义回退链Combo的完整创建方法参见 Combos 自定义回退链指南其前端配置入口位于 Dashboard 的 Combos 页面服务端执行入口即上文分析的handleComboChat。七、配额重置策略不同供应商的配额窗口与重置节奏差异巨大规划用量可显著提升资源利用率下表为文档口径实际请以供应商为准供应商配额重置策略Claude Code5 小时 每周早晨使用全新配额Codex5 小时 每周Claude 配额耗尽后使用Gemini CLI每日1K 每月18 万全天使用GLM-4.7每天上午 10:00傍晚使用次日早晨重置MiniMax M2.15 小时滚动随时可用追踪滚动窗口iFlow/Qwen/Kiro无限制应急备份示例日课08:00 - 13:00: Claude Code全新 5 小时配额 13:00 - 18:00: Gemini CLI1K/日配额 18:00 - 22:00: GLM-4.7低价上午 10 点重置 22:00 - 08:00: MiniMax 或 iFlow5 小时滚动或免费源码层面供应商的限流恢复时间会记录在连接的rateLimitedUntil字段上getEarliestRateLimitedUntilopen-sse/services/accountFallback.js会汇总所有账号中最先恢复的时间而formatRetryAfter将其格式化为reset after Xm Ys这类人类可读文本供日志与响应头使用。八、监控与告警Dashboard 配额追踪器Dashboard → Quota Overview: Claude Code: 剩余 2.5h / 5h50% Gemini CLI: 今日 450 / 1000 次请求 GLM-4.7: 5M / 10M token8 小时后重置 MiniMax: 3M / 5M token5 小时滚动实时通知Dashboard → Notifications: ⚠️ Claude Code 配额已用 80%剩余 1 小时 ✅ GLM-4.7 配额已重置10M token 可用 日预算已用 50%$2.50 / $5使用统计Dashboard → Analytics: 今日: 5000 万 token - 3000 万 经 Claude Code订阅 - 1500 万 经 GLM-4.7$9 - 500 万 经 iFlow免费 成本: $9对比 ChatGPT API 约 $1000 节省: 99%上述节省比例为文档演示示例口径。用量统计的持久化实现在仓库中由 src/lib/usageDb.js 与 open-sse/services/usage/ 承担配额监控与预算控制的前端交互位于 src/app/(dashboard)) 目录下的 Dashboard 页面。九、故障排查问题All providers quota exhausted所有供应商配额耗尽解决步骤查看 Dashboard 配额追踪器等待配额重置查看倒计时在回退链中加入免费层或提高预算上限。问题Too many fallback switches回退切换过于频繁解决步骤检查主用供应商是否宕机提高配额上限升级订阅换用更便宜的主用模型如用 GLM 替代 Claude。问题Unexpected costs出现意外费用解决步骤Dashboard → Analytics → 复核用量设置日/月预算上限非关键任务切到免费层使用带免费回退的 Combo。若需要更深度的用量与成本监控方案可继续阅读 Quota Tracking 配额追踪指南自定义回退链的完整配置方法见 Combos 自定义回退链指南。英文原文文档位于 gitbook/content/en/features/smart-routing.md其他语言版本含日文原文可在 gitbook/content/ 下按语言目录查阅。【免费下载链接】9routerUnlimited FREE AI coding. Connect Claude Code, Codex, Cursor, Cline, Copilot, Antigravity to FREE Claude/GPT/Gemini via 40 providers. Auto-fallback, RTK -40% tokens, never hit limits.项目地址: https://gitcode.com/GitHub_Trending/9r/9router创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/9/10 17:08:48

Android ViewModel传参全攻略:Factory、SavedStateHandle与依赖注入实战

写在前面的废话 这几天好几个群里都在问“ViewModel怎么传参”,点开一看,翻来覆去就是那几个答案,要么是 new ViewModelProvider 套一层Factory,要么甩一个官方文档链接,很少有人把这事的来龙去脉讲清楚。我刚入行那…

2026/9/10 17:53:55

随机森林回归实战:从数据预处理到模型调优全解析

简介:随机森林回归模型项目实战资料包,面向Python机器学习初学者及需要项目练习的开发者,完整演示了从问题定义、数据获取、数据清洗与预处理、EDA探索性分析、特征工程,到随机森林建模、模型评估与实际应用的标准化流程。压缩包共…

2026/9/10 17:53:55

基于雨流计数法的源-荷-储双层协同优化配置及Matlab实现

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/10 17:53:54

门店库存系统数据准确性分析:从技术层面如何选型评估

在实体门店数字化运营中,库存数据失真属于高频且隐蔽的核心问题。库存账实不符、订单占用统计偏差、成本核算混乱、多渠道数据不同步等问题,会直接导致门店超卖、缺货积压、利润核算不准,长期影响门店的资金周转与经营决策。多数中小门店选用…

2026/9/10 17:48:54

无刷双馈电机原理、控制与应用全解析

1. 无刷双馈电机的独特魅力 第一次接触无刷双馈电机(Brushless Doubly-Fed Machine,简称BDFM或BDFIG)是在2015年的一个风电项目现场。当时工程师指着机舱里那个比传统双馈电机小一号的设备说:"这玩意儿不用碳刷,维…

2026/9/10 16:39:38

超人会飞不算本事:系统稳定依赖清晰规则与边界设计

开头先不绕弯子。“#斯坦李吐槽dc 所以超人是无缘无故会飞的嘛哈哈哈哈哈哈哈锤哥真是技术人才啊!#雷神 #复联”这类调侃式短标题,第一波冲击力在于它把两个宇宙的角色塞进同一个吐槽箱里,但细想一下就能发现,它真正碰到的根本不是…

2026/9/10 11:16:38

超人VS蜘蛛侠:拆解超级IP的影响力与传播方法论

把“蜘蛛侠 vs 超人”放在 CSDN 上聊,可能很多人第一反应是走错片场了。但如果把这两个角色看成“两个持续运营了 80 多年的文化产品”,你会发现,这场比较本质上是两个不同 IP 策略的长期结果对比:超人赢在定义了整个超级英雄题材…

2026/9/9 16:31:09

基于CNN的调制信号识别:MATLAB实现时频图分类实战

简介:本资源是一套面向通信工程与信号处理方向学习者、研究者的深度学习实践方案,聚焦调制信号自动检测与识别这一典型无线通信任务,解决传统方法依赖人工特征、低信噪比下性能下降等痛点。压缩包共12个文件(10.73MB)&…

2026/9/10 0:00:55

目录对比去重实战:用哈希算法精准清理重复文件

我电脑里现在还有一块换了三次机的“数据墓地”硬盘,里面存着2016年以前所有旧笔记本的完整备份。平时不觉得有什么,直到前阵子想把它整理归档,发现同一个安装包、同一批照片、同一份论文草稿,在几个不同的备份目录里反复出现。更…

2026/9/10 0:00:55

Leaflet离线地图完整Demo合集:内网部署与坐标纠偏实战

简介:这是一份面向Web GIS开发者的LeafLet离线地图示例合集,帮助开发者快速掌握离线地图从搭建到交互的完整流程。压缩包共723个文件,大小14.06MB,以319个js脚本、175个html页面和29个css样式文件为主体,配合png/svg图…

2026/9/10 0:00:55

MATLAB读取Rinex 3.02观测文件:多系统GNSS数据解析实战

简介:基于MATLAB开发的Rinex3.02版观测文件(o文件)读取代码包,面向卫星定位导航方向的学习者与研究人员,用于解决新版观测文件的数据解析、历元提取与时间转换问题。压缩包共4个文件,包含两个m脚本、一个19…

2026/9/10 12:32:02

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/10 15:19:50

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/10 15:49:53

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码