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

发布时间:2026/11/9 21:40:19

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/11/5 8:49:35

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

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

2026/11/10 10:43:39

特种作业证到底什么工是特种作业?通过率揭秘帮你避开坑

特种作业证到底什么工是特种作业?通过率揭秘帮你避开坑 你缺的不是技术,是特种作业证!刚进工地就被要求拿证上岗,连面试机会都没给你,这年头什么工是特种作业?特种作业证怎么考?通过率又怎么样?这些问题,直接决定你能不能顺利上岗、拿到工资。今天咱…

2026/11/10 10:43:39

武汉特种作业操作证考试地点曝光内部消息 从业者必看避坑指南

武汉特种作业操作证考试地点曝光内部消息 从业者必看避坑指南 不知道去哪报名怕被中介坑?武汉特种作业操作证考试地点到底在哪?最近不少同行都在打听,特别是周口转岗过来的兄弟,对武汉的考试流程和报名方式不太熟悉,一不小心就踩坑。今天我就从…

2026/11/10 10:43:39

芙蓉区特种工建筑资质含金量高不高?外省证能转吗?

芙蓉区特种工建筑资质含金量高不高?外省证能转吗? 之前考的证在外省能不能转过来?这是很多在芙蓉区或者打算考芙蓉区特种工建筑资质的学员最关心的问题。特别是在建筑行业,特种作业证书是上岗的“硬门槛”,但如果你之前在外地考的证,现在想在芙蓉区从事…

2026/11/10 10:43:39

武汉特种作业操作证考试地点保姆级教程:新手避坑全攻略

武汉特种作业操作证考试地点保姆级教程:新手避坑全攻略 你是不是正在为 武汉特种作业操作证考试地点 发愁?或者担心自己在报名过程中被中介坑了?别急,今天这篇保姆级教程就是为像你一样的人量身打造的,从报名到考试、再到补办和复审,一步步带你走通流…

2026/11/10 10:43:39

电工证考什么试题怎么考才能不白交培训费?上岗必备干货全在这了

电工证考什么试题怎么考才能不白交培训费?上岗必备干货全在这了 怕考不过白交培训费?别急,电工证考什么试题,真题怎么练,我用十年行业经验告诉你,这不仅是上岗必备,更是你进工地、拿高薪的“通行证”。今天就从 考试内容、培训避坑、薪资前景…

2026/11/10 10:38:38

面试要求电工证合理吗?考前押题怎么用才有效

面试要求电工证合理吗?考前押题怎么用才有效 你有没有过这样的经历:面试时被问“你有电工证吗?”心里一咯噔,想着要是早几年考个证就好了。现在特种作业证已经成了不少岗位的门槛, 急需特种作业证才能上岗找工作…

2026/11/10 8:12:38

电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。…

2026/11/10 0:01:28

学历不高怕报不上名?考电工证报名费+网上查询全攻略来了

学历不高怕报不上名?考电工证报名费+网上查询全攻略来了 你是不是也担心自己学历不高,考电工证报名费太贵,根本报不上名?别急,今天就来给你讲讲,怎么用最少的钱,把证拿到手,还能在工地上多挣点钱。 电工证报名费多少钱?网上查询是关键…

2026/11/10 0:01:29

绍兴考电工证培训机构怎么选?2026河南最新政策别错过

绍兴考电工证培训机构怎么选?2026河南最新政策别错过 怕考不过白交培训费?你不是一个人。2026河南最新政策出台,对电工证考试、报名、培训、复审都有明确规定。选择绍兴考电工证培训机构,别再踩坑,下面一步步教你避坑。…

2026/11/9 6:30:27

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/10 10:29:37

SSM电子书店源码全解析:结构、原理、部署与排错实战

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

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

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

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