你在 OpenCode 的opencode.json里写了router.rulesmatch.any也填了「文档」「代码生成」「架构设计」结果/models里看到的还是默认模型所有请求都落在同一个 provider 上。这种「多模型路由不生效」通常不是 OpenCode 的 router 插件坏了而是 provider 层没接上 TaoToken或者路由规则里的模型名跟通道里的模型 ID 对不上。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 Key再回到opencode.json把 provider 的baseURL与apiKey改对。TaoToken 只提供统一 Key 与兼容通道路由决策仍然是 OpenCode 自己做的通道通了OpenCode 才能从同一个入口发现多个模型router 规则才有机会按关键词命中。下面按报错1的现场往里查不先动 router 的规则先把 provider 和模型 ID 这两层对齐。1. 报错1现场router 规则在跑请求却一直落在默认模型1.1 先看 opencode.json 里 provider 是不是还指着官方地址报错1的典型表现是opencode-router已经安装opencode.json里也能看到router.enabled: true但不管是「帮我写 README」还是「对项目做架构设计」TUI 里显示的模型始终是model字段里那一个。你打开 debug 日志router 也说自己加载了规则但最后执行请求的模型没有变化。这种情况下先别怀疑 router 的关键词匹配写错了。先打开opencode.json看provider段里每个供应商的options.baseURL是什么。如果还是https://api.anthropic.com、https://api.openai.com这类官方地址而apiKey又没有填成 TaoToken 的 Key那么 router 就算选出了模型 AOpenCode 也会用官方通道去请求模型 A结果要么失败后回退默认模型要么直接在 provider 层被拦下。路由决策发生在 OpenCode 内部但请求能不能送到对应模型取决于 provider 的通道有没有接对。另一类常见情况是provider 里填了 TaoToken 的 Base URL但模型 ID 仍然沿用原来的anthropic/claude-sonnet-4-20250514这类写法。TaoToken 的通道里可用的模型 ID 以模型广场当时列表为准如果模型名不在通道内OpenCode 的模型列表里根本不会出现它router 规则即使命中了也没有可用的模型可切。表现就是「规则在跑请求没变」。1.2 把排障顺序倒过来先通通道再校规则很多人的排障顺序是打开 router 配置反复改match.any加更多关键词甚至装第二个路由插件。这个顺序容易白忙因为路由不生效的根因经常不在 router 本身。更省时间的顺序是先确认 provider 层能不能从 TaoToken 拿到模型列表再确认 router 规则里写的模型 ID 是不是这个列表里的值最后才回来看关键词有没有命中。你可以把这条排障顺序记成三步第一步opencode.json的 provider 统一指向https://taotoken.net/apiapiKey用YOUR_API_KEY第二步在 TUI 里执行/models看模型列表里有没有你准备写进 router 的模型第三步把 router 规则里的models数组换成/models里真实出现的 ID再发测试请求。三步都过了报错1基本就会消失。2. 在 opencode.json 里把 provider 统一指到 TaoToken 通道2.1 去官网创建 Key并确认 Base URL 的末尾不带 /v1准备材料只有两样一把 API Key一个 Base URL。打开 TaoToken 完成注册并创建 API Key复制后先放在本地安全位置。这个 Key 后面要填进opencode.json的provider选项里不要写进 router 规则也不要写进match.any。Base URL 填https://taotoken.net/api末尾不要加/v1也不要在这个地址后面拼 UTM 参数接口地址和官网落地页是两回事。模型 ID 也在这里确认。进入模型广场把你打算用于简单任务、中等任务、复杂任务的模型 ID 分别记下来。不要凭记忆写gpt-5或带随意日期后缀的名字。模型广场里显示什么 IDopencode.json的models和 router 规则里就写什么 ID。Key 填错的表现是请求直接失败模型 ID 填错的表现更隐蔽可能只是模型列表里少了一项router 命中了也取不到。2.2 新增 taotoken provider 的完整写法如果你想把原来的多个供应商收敛成一个入口可以在opencode.json里新增一个taotokenprovider用 OpenAI 兼容格式接入。下面这份配置可以直接复制把YOUR_API_KEY和YOUR_MODEL_ID_*替换成你从官网拿到的值。注意baseURL这一行必须是https://taotoken.net/api不要加/v1。{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY }, models: { YOUR_MODEL_ID_SIMPLE: {}, YOUR_MODEL_ID_MEDIUM: {}, YOUR_MODEL_ID_COMPLEX: {} } } }, model: taotoken/YOUR_MODEL_ID_MEDIUM, fallbacks: [ taotoken/YOUR_MODEL_ID_SIMPLE, taotoken/YOUR_MODEL_ID_COMPLEX ], plugin: [ opencode-model-fallback-chain, opencode-router ], experimental: { modelFallbackChain: { timeoutMs: 45000, chains: [ [ taotoken/YOUR_MODEL_ID_MEDIUM, taotoken/YOUR_MODEL_ID_SIMPLE, taotoken/YOUR_MODEL_ID_COMPLEX ] ] } }, router: { enabled: true, debug: true, rules: [ { name: docs-and-comments, match: { any: [ 文档, 注释, README, readme, doc, comment, 格式化, 翻译 ] }, models: [ taotoken/YOUR_MODEL_ID_SIMPLE ], strategy: cost }, { name: code-generation, match: { any: [ 代码生成, 写代码, 实现, bug修复, 单元测试, code, generate, fix ] }, models: [ taotoken/YOUR_MODEL_ID_MEDIUM, taotoken/YOUR_MODEL_ID_SIMPLE ], strategy: balanced }, { name: complex-analysis, match: { any: [ 架构, 设计, 审计, 优化, 重构, architecture, design, refactor ] }, models: [ taotoken/YOUR_MODEL_ID_COMPLEX, taotoken/YOUR_MODEL_ID_MEDIUM ], strategy: quality } ], default: { models: [ taotoken/YOUR_MODEL_ID_MEDIUM ], strategy: balanced } } }这份配置把 L1、L2、L3 三层都放在同一个文件里。provider.taotoken负责把请求送到 TaoToken 通道fallbacks负责主模型失败后的兜底experimental.modelFallbackChain负责超时切换router负责按任务关键词选择模型。三层各管一段别让它们互相抢职责。2.3 如果你保留 anthropic/openai 等旧 provider 名改 options 即可有些项目的opencode.json已经写了anthropic、openai、deepseek等多个 provider不想推倒重来也可以保留原来的 provider 名只把每个 provider 的options改到同一条通道。写法如下核心是把baseURL统一成https://taotoken.net/apiapiKey统一用从官网创建的YOUR_API_KEY。{ provider: { anthropic: { options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY } }, openai: { options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY } } } }这样改完provider 层通了但还要做一步把 router 规则里的models数组改成 TaoToken 通道中真实存在的模型 ID。如果原来的模型 ID 只是官方命名在 TaoToken 通道里不一定同名。你可以继续用anthropic/xxx这种前缀也可以用新增的taotoken/xxx前缀关键是/models里能看到它。看不到就说明模型 ID 没对上router 规则写再多关键词也不会生效。3. router 规则里的模型名必须来自 TaoToken 模型广场3.1 为什么模型名对不上会静默回退默认模型OpenCode 的 router 插件做的是「决策」它根据match.any判断任务类型再从models数组里挑一个模型。但它不会凭空创造模型。如果models数组里的模型 ID 在 OpenCode 当前模型列表里不存在插件可能跳过这条规则最后落到default规则如果default里的模型也不可用就继续落到顶层model字段。表现出来就是「我明明配了复杂任务用复杂模型结果还是默认模型」。这个回退过程通常不显眼除非你打开debug: true。所以报错1的排查重点不是「关键词够不够多」而是「router 写下的模型名OpenCode 能不能从 TaoToken 通道里取到」。模型名对不上时请求不会报一个很醒目的错它只是安静地换了一个模型。对于成本敏感的项目这种静默回退最麻烦你以为复杂任务走了强模型其实一直走的是默认模型。3.2 用 /models 和 debug 日志校对模型 ID改完 provider 后完全退出并重启 OpenCode在 TUI 里输入/models。你应该能看到taotoken/前缀的模型列表或者你保留的 provider 前缀下出现了从 TaoToken 通道拉回来的模型。把这里显示的 ID 逐个抄进opencode.json的router.rules[].models和fallbacks里。不要用「应该差不多」的名字也不要用带日期后缀的猜测值。然后打开debug: true发一条测试消息。日志里会打印路由决策过程重点看三件事命中了哪条规则、准备使用哪个模型、最终执行的是哪个模型。如果命中的规则里写的模型是taotoken/YOUR_MODEL_ID_COMPLEX但最终执行的是taotoken/YOUR_MODEL_ID_MEDIUM说明复杂模型 ID 没有被 OpenCode 识别或者它当时不可用。回到模型广场核对 ID再检查该模型是否在你的 Key 可用范围内。3.3 三条规则改成可命中的中英文关键词原文的关键词匹配思路是对的但中文项目和英文提示混用时容易因为关键词没写全而漏命中。比如用户输入「帮我 review 一下这个函数」你的match.any里只有「代码审查」那就命不中。更稳的做法是把每条规则的关键词写成中英文混排并且把常见动词和名词都放进去。文档类规则可以放「文档、注释、README、readme、doc、comment、格式化、翻译」代码生成类规则可以放「代码生成、写代码、实现、bug修复、单元测试、code、generate、fix」复杂分析类规则可以放「架构、设计、审计、优化、重构、architecture、design、refactor」。关键词不要只放一个也不要把所有规则的关键词写成同一批。规则是从上到下匹配的命中的第一条生效。如果你把「代码」放进文档规则用户说「给这段代码写注释」时就会先命中文档规则走小模型。这个结果有时是对的有时不是你要的。更好的方式是让不同规则的词尽量互斥或者把更具体的规则放前面。排障时可以先只保留一条规则确认它能命中并切换到目标模型再逐条加回来。4. 三层路由叠加时报错2和报错3怎么区分4.1 fallbacks 与 router 同时生效不是冲突报错2看起来很像 bugrouter 明明选了模型 A日志里也显示模型 A但最后执行的是模型 B。原因通常是模型 A 请求失败或超时fallbacks或modelFallbackChain接管了故障恢复切到了模型 B。这不是 router 失效而是三层路由的职责不同router 负责初始选择fallbacks 负责错误响应后的切换fallbackChain 负责超时后的切换。如果你希望 router 完全控制模型选择可以把fallbacks: []设为空数组但这样会失去故障自动恢复能力。更推荐的做法是让fallbacks里的模型也来自 router 的候选池比如 router 的复杂任务规则里包含模型 A 和模型 Bfallbacks里也放模型 A 和模型 B。这样即使发生故障切换最终使用的模型仍然在你为这类任务准备的范围内不会突然跑到一个不合适的便宜模型上。4.2 No model available for this task 的排查路径报错3的提示是No model available for this task。它通常出现在某条规则的models数组为空或者数组里的模型全部不可用的时候。排查第一步是看对应规则的models有没有写值别只写了strategy忘了models。第二步是确认这些模型 ID 在/models里存在。第三步是看模型是不是在冷却中或者因为 Key 的可用范围、通道状态而暂时不可达。给每条规则至少留两个模型一个作为首选一个作为同级别的备选。给default规则留一个稳定可用的模型。这样即使某个模型临时不可用router 也不会因为一条规则全军覆没而报「无模型可用」。如果你在日志里看到某条规则连续跳过多个模型先去模型广场确认这些 ID 是否还在列表中再检查通道是否正常。模型广场的列表是动态的以你打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 时看到的列表为准。5. 验证发三种任务看模型切换回控制台对用量5.1 TUI 里观察 /models 与 debug 日志配置保存后完全退出 OpenCode 再重启。在 TUI 里先输入/models确认模型列表里有router规则要用到的所有 ID。然后依次发三条消息第一条是「帮我给这个函数写一段注释并生成 README 摘要」第二条是「根据这段报错帮我修复这个 bug」第三条是「分析这个模块的架构给出重构设计」。这三条分别对应文档、代码生成、复杂分析三类规则。每条消息发完后看 debug 日志里的路由决策。文档类应该走docs-and-comments代码生成类应该走code-generation复杂分析类应该走complex-analysis。如果三条都走了默认模型回到opencode.json检查router.enabled是否为true、plugin数组里有没有opencode-router、match.any的关键词是否出现在你发的消息里。如果前两条对了、第三条没对重点查复杂模型的 ID 是否写对。5.2 回 TaoToken 控制台确认调用记上账路由切换成功只是第一步还要确认请求真的从 TaoToken 通道出去了。回到 TaoToken 控制台 看用量记录找到刚才那几条请求。如果控制台里没有记录说明opencode.json里的baseURL或apiKey没有真正生效请求可能还在走旧通道。如果控制台里有记录但模型列显示的不是 router 选中的模型说明模型 ID 或 fallback 逻辑还有偏差。这一步也能帮你区分「路由没生效」和「路由生效了但通道没通」。路由没生效控制台会看到默认模型的调用通道没通控制台可能一条记录都没有OpenCode 侧则表现为请求失败后回退。把 TUI 日志和控制台用量对照着看报错1、报错2、报错3 的边界会清楚很多。6. 收尾OpenCode 多模型路由的日常检查清单6.1 还卡在默认模型时的五步检查如果你改完一轮还是卡在默认模型按这五步走一遍。第一步opencode.json里provider的baseURL是不是https://taotoken.net/api末尾没有/v1。第二步apiKey是不是从官网创建的YOUR_API_KEY有没有多余空格或引号。第三步/models里能不能看到 router 规则要用的模型 ID。第四步router.rules[].models里的 ID 是不是和/models里完全一致。第五步match.any的关键词有没有出现在测试消息里中英文是否覆盖。这五步里前三步解决「通道通不通」后两步解决「规则命中不命中」。大多数报错1卡在前三步尤其是模型 ID 对不上和 Base URL 多写了/v1。把 provider 层理顺之后OpenCode 的多模型路由并不难调它只是需要你先把模型来源和模型名字对齐。6.2 下一步模型对话、Coding Plan 与创建 Key配完这一版你可以先在 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和通道都没问题。如果准备长期在 OpenCode 里跑多模型路由去 Coding Plan 看套餐是否够用。Key 不够或想重新建一把在 控制台 API Keys 创建。若你还顺手接了 Claude Code环境变量写法可以在 接入文档 里对照。排障到这一步你手里已经有一条可以复用的检查链provider 指向https://taotoken.net/apiKey 用YOUR_API_KEY模型 ID 从模型广场抄router 规则再按任务关键词命中。OpenCode 负责选模型通道负责把请求送到模型两边各做各的事多模型路由才会从「配置里写了」变成「请求里真的换了」。
你在 OpenCode 的opencode.json里写了router.rulesmatch.any也填了「文档」「代码生成」「架构设计」结果/models里看到的还是默认模型所有请求都落在同一个 provider 上。这种「多模型路由不生效」通常不是 OpenCode 的 router 插件坏了而是 provider 层没接上 TaoToken或者路由规则里的模型名跟通道里的模型 ID 对不上。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 Key再回到opencode.json把 provider 的baseURL与apiKey改对。TaoToken 只提供统一 Key 与兼容通道路由决策仍然是 OpenCode 自己做的通道通了OpenCode 才能从同一个入口发现多个模型router 规则才有机会按关键词命中。下面按报错1的现场往里查不先动 router 的规则先把 provider 和模型 ID 这两层对齐。1. 报错1现场router 规则在跑请求却一直落在默认模型1.1 先看 opencode.json 里 provider 是不是还指着官方地址报错1的典型表现是opencode-router已经安装opencode.json里也能看到router.enabled: true但不管是「帮我写 README」还是「对项目做架构设计」TUI 里显示的模型始终是model字段里那一个。你打开 debug 日志router 也说自己加载了规则但最后执行请求的模型没有变化。这种情况下先别怀疑 router 的关键词匹配写错了。先打开opencode.json看provider段里每个供应商的options.baseURL是什么。如果还是https://api.anthropic.com、https://api.openai.com这类官方地址而apiKey又没有填成 TaoToken 的 Key那么 router 就算选出了模型 AOpenCode 也会用官方通道去请求模型 A结果要么失败后回退默认模型要么直接在 provider 层被拦下。路由决策发生在 OpenCode 内部但请求能不能送到对应模型取决于 provider 的通道有没有接对。另一类常见情况是provider 里填了 TaoToken 的 Base URL但模型 ID 仍然沿用原来的anthropic/claude-sonnet-4-20250514这类写法。TaoToken 的通道里可用的模型 ID 以模型广场当时列表为准如果模型名不在通道内OpenCode 的模型列表里根本不会出现它router 规则即使命中了也没有可用的模型可切。表现就是「规则在跑请求没变」。1.2 把排障顺序倒过来先通通道再校规则很多人的排障顺序是打开 router 配置反复改match.any加更多关键词甚至装第二个路由插件。这个顺序容易白忙因为路由不生效的根因经常不在 router 本身。更省时间的顺序是先确认 provider 层能不能从 TaoToken 拿到模型列表再确认 router 规则里写的模型 ID 是不是这个列表里的值最后才回来看关键词有没有命中。你可以把这条排障顺序记成三步第一步opencode.json的 provider 统一指向https://taotoken.net/apiapiKey用YOUR_API_KEY第二步在 TUI 里执行/models看模型列表里有没有你准备写进 router 的模型第三步把 router 规则里的models数组换成/models里真实出现的 ID再发测试请求。三步都过了报错1基本就会消失。2. 在 opencode.json 里把 provider 统一指到 TaoToken 通道2.1 去官网创建 Key并确认 Base URL 的末尾不带 /v1准备材料只有两样一把 API Key一个 Base URL。打开 TaoToken 完成注册并创建 API Key复制后先放在本地安全位置。这个 Key 后面要填进opencode.json的provider选项里不要写进 router 规则也不要写进match.any。Base URL 填https://taotoken.net/api末尾不要加/v1也不要在这个地址后面拼 UTM 参数接口地址和官网落地页是两回事。模型 ID 也在这里确认。进入模型广场把你打算用于简单任务、中等任务、复杂任务的模型 ID 分别记下来。不要凭记忆写gpt-5或带随意日期后缀的名字。模型广场里显示什么 IDopencode.json的models和 router 规则里就写什么 ID。Key 填错的表现是请求直接失败模型 ID 填错的表现更隐蔽可能只是模型列表里少了一项router 命中了也取不到。2.2 新增 taotoken provider 的完整写法如果你想把原来的多个供应商收敛成一个入口可以在opencode.json里新增一个taotokenprovider用 OpenAI 兼容格式接入。下面这份配置可以直接复制把YOUR_API_KEY和YOUR_MODEL_ID_*替换成你从官网拿到的值。注意baseURL这一行必须是https://taotoken.net/api不要加/v1。{ $schema: https://opencode.ai/config.json, provider: { taotoken: { npm: ai-sdk/openai-compatible, name: TaoToken, options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY }, models: { YOUR_MODEL_ID_SIMPLE: {}, YOUR_MODEL_ID_MEDIUM: {}, YOUR_MODEL_ID_COMPLEX: {} } } }, model: taotoken/YOUR_MODEL_ID_MEDIUM, fallbacks: [ taotoken/YOUR_MODEL_ID_SIMPLE, taotoken/YOUR_MODEL_ID_COMPLEX ], plugin: [ opencode-model-fallback-chain, opencode-router ], experimental: { modelFallbackChain: { timeoutMs: 45000, chains: [ [ taotoken/YOUR_MODEL_ID_MEDIUM, taotoken/YOUR_MODEL_ID_SIMPLE, taotoken/YOUR_MODEL_ID_COMPLEX ] ] } }, router: { enabled: true, debug: true, rules: [ { name: docs-and-comments, match: { any: [ 文档, 注释, README, readme, doc, comment, 格式化, 翻译 ] }, models: [ taotoken/YOUR_MODEL_ID_SIMPLE ], strategy: cost }, { name: code-generation, match: { any: [ 代码生成, 写代码, 实现, bug修复, 单元测试, code, generate, fix ] }, models: [ taotoken/YOUR_MODEL_ID_MEDIUM, taotoken/YOUR_MODEL_ID_SIMPLE ], strategy: balanced }, { name: complex-analysis, match: { any: [ 架构, 设计, 审计, 优化, 重构, architecture, design, refactor ] }, models: [ taotoken/YOUR_MODEL_ID_COMPLEX, taotoken/YOUR_MODEL_ID_MEDIUM ], strategy: quality } ], default: { models: [ taotoken/YOUR_MODEL_ID_MEDIUM ], strategy: balanced } } }这份配置把 L1、L2、L3 三层都放在同一个文件里。provider.taotoken负责把请求送到 TaoToken 通道fallbacks负责主模型失败后的兜底experimental.modelFallbackChain负责超时切换router负责按任务关键词选择模型。三层各管一段别让它们互相抢职责。2.3 如果你保留 anthropic/openai 等旧 provider 名改 options 即可有些项目的opencode.json已经写了anthropic、openai、deepseek等多个 provider不想推倒重来也可以保留原来的 provider 名只把每个 provider 的options改到同一条通道。写法如下核心是把baseURL统一成https://taotoken.net/apiapiKey统一用从官网创建的YOUR_API_KEY。{ provider: { anthropic: { options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY } }, openai: { options: { baseURL: https://taotoken.net/api, apiKey: YOUR_API_KEY } } } }这样改完provider 层通了但还要做一步把 router 规则里的models数组改成 TaoToken 通道中真实存在的模型 ID。如果原来的模型 ID 只是官方命名在 TaoToken 通道里不一定同名。你可以继续用anthropic/xxx这种前缀也可以用新增的taotoken/xxx前缀关键是/models里能看到它。看不到就说明模型 ID 没对上router 规则写再多关键词也不会生效。3. router 规则里的模型名必须来自 TaoToken 模型广场3.1 为什么模型名对不上会静默回退默认模型OpenCode 的 router 插件做的是「决策」它根据match.any判断任务类型再从models数组里挑一个模型。但它不会凭空创造模型。如果models数组里的模型 ID 在 OpenCode 当前模型列表里不存在插件可能跳过这条规则最后落到default规则如果default里的模型也不可用就继续落到顶层model字段。表现出来就是「我明明配了复杂任务用复杂模型结果还是默认模型」。这个回退过程通常不显眼除非你打开debug: true。所以报错1的排查重点不是「关键词够不够多」而是「router 写下的模型名OpenCode 能不能从 TaoToken 通道里取到」。模型名对不上时请求不会报一个很醒目的错它只是安静地换了一个模型。对于成本敏感的项目这种静默回退最麻烦你以为复杂任务走了强模型其实一直走的是默认模型。3.2 用 /models 和 debug 日志校对模型 ID改完 provider 后完全退出并重启 OpenCode在 TUI 里输入/models。你应该能看到taotoken/前缀的模型列表或者你保留的 provider 前缀下出现了从 TaoToken 通道拉回来的模型。把这里显示的 ID 逐个抄进opencode.json的router.rules[].models和fallbacks里。不要用「应该差不多」的名字也不要用带日期后缀的猜测值。然后打开debug: true发一条测试消息。日志里会打印路由决策过程重点看三件事命中了哪条规则、准备使用哪个模型、最终执行的是哪个模型。如果命中的规则里写的模型是taotoken/YOUR_MODEL_ID_COMPLEX但最终执行的是taotoken/YOUR_MODEL_ID_MEDIUM说明复杂模型 ID 没有被 OpenCode 识别或者它当时不可用。回到模型广场核对 ID再检查该模型是否在你的 Key 可用范围内。3.3 三条规则改成可命中的中英文关键词原文的关键词匹配思路是对的但中文项目和英文提示混用时容易因为关键词没写全而漏命中。比如用户输入「帮我 review 一下这个函数」你的match.any里只有「代码审查」那就命不中。更稳的做法是把每条规则的关键词写成中英文混排并且把常见动词和名词都放进去。文档类规则可以放「文档、注释、README、readme、doc、comment、格式化、翻译」代码生成类规则可以放「代码生成、写代码、实现、bug修复、单元测试、code、generate、fix」复杂分析类规则可以放「架构、设计、审计、优化、重构、architecture、design、refactor」。关键词不要只放一个也不要把所有规则的关键词写成同一批。规则是从上到下匹配的命中的第一条生效。如果你把「代码」放进文档规则用户说「给这段代码写注释」时就会先命中文档规则走小模型。这个结果有时是对的有时不是你要的。更好的方式是让不同规则的词尽量互斥或者把更具体的规则放前面。排障时可以先只保留一条规则确认它能命中并切换到目标模型再逐条加回来。4. 三层路由叠加时报错2和报错3怎么区分4.1 fallbacks 与 router 同时生效不是冲突报错2看起来很像 bugrouter 明明选了模型 A日志里也显示模型 A但最后执行的是模型 B。原因通常是模型 A 请求失败或超时fallbacks或modelFallbackChain接管了故障恢复切到了模型 B。这不是 router 失效而是三层路由的职责不同router 负责初始选择fallbacks 负责错误响应后的切换fallbackChain 负责超时后的切换。如果你希望 router 完全控制模型选择可以把fallbacks: []设为空数组但这样会失去故障自动恢复能力。更推荐的做法是让fallbacks里的模型也来自 router 的候选池比如 router 的复杂任务规则里包含模型 A 和模型 Bfallbacks里也放模型 A 和模型 B。这样即使发生故障切换最终使用的模型仍然在你为这类任务准备的范围内不会突然跑到一个不合适的便宜模型上。4.2 No model available for this task 的排查路径报错3的提示是No model available for this task。它通常出现在某条规则的models数组为空或者数组里的模型全部不可用的时候。排查第一步是看对应规则的models有没有写值别只写了strategy忘了models。第二步是确认这些模型 ID 在/models里存在。第三步是看模型是不是在冷却中或者因为 Key 的可用范围、通道状态而暂时不可达。给每条规则至少留两个模型一个作为首选一个作为同级别的备选。给default规则留一个稳定可用的模型。这样即使某个模型临时不可用router 也不会因为一条规则全军覆没而报「无模型可用」。如果你在日志里看到某条规则连续跳过多个模型先去模型广场确认这些 ID 是否还在列表中再检查通道是否正常。模型广场的列表是动态的以你打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 时看到的列表为准。5. 验证发三种任务看模型切换回控制台对用量5.1 TUI 里观察 /models 与 debug 日志配置保存后完全退出 OpenCode 再重启。在 TUI 里先输入/models确认模型列表里有router规则要用到的所有 ID。然后依次发三条消息第一条是「帮我给这个函数写一段注释并生成 README 摘要」第二条是「根据这段报错帮我修复这个 bug」第三条是「分析这个模块的架构给出重构设计」。这三条分别对应文档、代码生成、复杂分析三类规则。每条消息发完后看 debug 日志里的路由决策。文档类应该走docs-and-comments代码生成类应该走code-generation复杂分析类应该走complex-analysis。如果三条都走了默认模型回到opencode.json检查router.enabled是否为true、plugin数组里有没有opencode-router、match.any的关键词是否出现在你发的消息里。如果前两条对了、第三条没对重点查复杂模型的 ID 是否写对。5.2 回 TaoToken 控制台确认调用记上账路由切换成功只是第一步还要确认请求真的从 TaoToken 通道出去了。回到 TaoToken 控制台 看用量记录找到刚才那几条请求。如果控制台里没有记录说明opencode.json里的baseURL或apiKey没有真正生效请求可能还在走旧通道。如果控制台里有记录但模型列显示的不是 router 选中的模型说明模型 ID 或 fallback 逻辑还有偏差。这一步也能帮你区分「路由没生效」和「路由生效了但通道没通」。路由没生效控制台会看到默认模型的调用通道没通控制台可能一条记录都没有OpenCode 侧则表现为请求失败后回退。把 TUI 日志和控制台用量对照着看报错1、报错2、报错3 的边界会清楚很多。6. 收尾OpenCode 多模型路由的日常检查清单6.1 还卡在默认模型时的五步检查如果你改完一轮还是卡在默认模型按这五步走一遍。第一步opencode.json里provider的baseURL是不是https://taotoken.net/api末尾没有/v1。第二步apiKey是不是从官网创建的YOUR_API_KEY有没有多余空格或引号。第三步/models里能不能看到 router 规则要用的模型 ID。第四步router.rules[].models里的 ID 是不是和/models里完全一致。第五步match.any的关键词有没有出现在测试消息里中英文是否覆盖。这五步里前三步解决「通道通不通」后两步解决「规则命中不命中」。大多数报错1卡在前三步尤其是模型 ID 对不上和 Base URL 多写了/v1。把 provider 层理顺之后OpenCode 的多模型路由并不难调它只是需要你先把模型来源和模型名字对齐。6.2 下一步模型对话、Coding Plan 与创建 Key配完这一版你可以先在 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和通道都没问题。如果准备长期在 OpenCode 里跑多模型路由去 Coding Plan 看套餐是否够用。Key 不够或想重新建一把在 控制台 API Keys 创建。若你还顺手接了 Claude Code环境变量写法可以在 接入文档 里对照。排障到这一步你手里已经有一条可以复用的检查链provider 指向https://taotoken.net/apiKey 用YOUR_API_KEY模型 ID 从模型广场抄router 规则再按任务关键词命中。OpenCode 负责选模型通道负责把请求送到模型两边各做各的事多模型路由才会从「配置里写了」变成「请求里真的换了」。
