Weave Router 路由指令完全指南directives.tsv 中 10 条命令逐条解释【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/routerWeave Router 是面向 Agent 系统的模型路由器Model router for agentic systems把 Claude Code、Codex 等客户端的端点指向它每条 prompt 都能在 50ms 内被路由到最合适的模型仅改一个端点即可削减 40–70% 成本。而 install/directives.tsv 就是它所有「路由指令」的唯一注册表——你每天输入的/force-model、/router-off、/models等 10 条指令全部在这一个文件里一次声明再被安装器自动分发到各个客户端。这篇文章带你逐条读透这个指令字典每条命令做什么、哪些客户端支持、背后是发一句提示词还是改本地配置。一、先看懂注册表directives.tsv 的 8 个字段directives.tsv是一个竖线分隔的表格每行一条指令。文件开头的注释install/directives.tsv#L1-L3说明了它的结构字段含义canonical指令的规范名正式写法aliases别名逗号分隔如fmcapabilityprompt路由器直接解析的文本或local-toggle调本地安装器改配置claude/codex/opencode/pi/cursor该客户端是否安装此指令yes/noadapter原生资产类型command即commands/name.md包装文件或skill即codex-skills/name/SKILL.md可并列 设计亮点注册表是单一事实来源。所有安装路径、卸载器、状态栏刷新脚本和 npm 打包步骤都读这同一个文件一条指令只声明一次就能同步到达每个支持它的客户端。二、指令总览10 条路由指令一览表这是 install/directives.tsv#L4-L13 的完整内容整理指令别名能力类型ClaudeCodexopencodepiCursor资产类型force-modelfmprompt✅✅✅✅手动command skillunforce-modelufmprompt✅✅✅✅手动command skillrouter-feedbackrfprompt✅✅✅—手动command skillrouter-off—local-toggle✅✅——手动command skillrouter-on—local-toggle✅✅——手动command skillrouter-status—local-toggle✅✅——手动command skillrouter-session—prompt✅✅———command skillrouter-modelsmodelslocal-toggle✅✅———command skilldisable-routing—local-toggle—✅———skillbeta—prompt✅——✅手动command三、逐条解释每条路由指令到底做什么1./force-model别名/fm把会话钉在指定模型上这是最常用的模型钉选指令。语法是/force-model model-id告诉 Weave Router本会话内的请求都交给这个模型跳过自动路由。它属于prompt 型指令——指令本身是一段文本随请求发给路由器由路由器解析后给当前会话打上 pin。四个主力客户端都能用Claude Code斜杠命令/force-modelinstall/commands/force-model.mdCodex因为/被内置命令保留所以用$force-model技能install/codex-skills/force-model/SKILL.md技能会输出一行前导空格形式的指令文本交给路由器opencode、pi 同理pi 的/fm、/ufm直接注册在扩展里install/pi-router/src/force-model.tsCursor手动输入前导空格形式/force-model model-id2./unforce-model别名/ufm解除钉选回到自动路由/force-model的逆操作。执行后清除当前会话的模型钉选路由器恢复每次请求独立决策的默认模式。不需要任何参数。3./router-feedback别名/rf给路由决策和模型表现提反馈当路由器选错了模型或者某个模型输出不理想时用/router-feedback 反馈内容提交一条带上下文的反馈。路由器会把它和当前会话、所用模型关联记录用于改进路由策略。注意 pi 客户端不支持此指令注册表中为no。4./router-off、/router-on、/router-status路由开关三件套这三条是local-toggle 型指令——它们不走路由器而是调用本地安装器 CLI 修改客户端配置如npx weave-os/router off --claude见 install/commands/router-off.md把客户端从 Weave Router 切回直连供应商且不删除路由器配置随时一键切回客户端off具体做了什么Claude Code把ANTHROPIC_BASE_URL和密钥头移出settings.json回落到自己的 Anthropic 登录Codex注释掉model_provider weave一行[model_providers.weave]配置块保留opencode移除顶层weave/...模型provider.weave保留/router-on逐字节还原上面的改动/router-status报告当前是走路由器还是直连。⚠️ 生效时机Claude Code 只在启动时读取设置需要完全退出重开Codex 在下次启动codex时生效。5./router-session查看当前会话 ID打印路由器用来关联本会话遥测、日志和反馈的会话 IDClaude 侧取$CLAUDE_CODE_SESSION_IDCodex 侧取$CODEX_SESSION_ID。这个 ID 也是路由器 dashboard 里查转写记录的检索键。小技巧它现在由路由器直接应答——路由器本来就在每个请求的Session-Id头里收到并存储了这个 ID无需再浪费一次模型回合去猜设计背景见 install/README.md#L341-L347。6./router-models别名/models查看并开关可选模型列出该安装允许路由器挑选的所有模型按供应商分组[x]可挑 /[ ]不可挑并能按你的要求启用、禁用、排序。它与路由器 dashboard 设置页的复选框是同一份存储设置。常见用法/models仅查看清单把 模型id 关掉执行models disable id整供应商开关models providers enable/disable ...设置偏好顺序models prefer id id ...顺序即优先级禁用某个模型立即生效——从路由器的下一次路由决策开始无需重启。完整行为说明见 install/commands/router-models.md。7.$disable-routingCodex 专属的切回默认供应商Codex 独有的技能install/codex-skills/disable-routing/SKILL.md等价于$router-off——它是更早出现的写法保留为别名。两者都不会卸载路由器、不会动其他 Codex 配置。8./beta切换 HMM 实验路由仅 Claude 与 pi/beta在当前会话内开关实验性的 HMM隐马尔可夫模型路由策略。Claude Code 侧是斜杠命令install/commands/beta.mdpi 侧则把本地/beta作为一次规范用户回合转发给路由器install/pi-router/src/beta.ts。四、两种能力类型prompt 与 local-toggle 的本质区别理解这个区别就能看懂注册表里所有yes/nopromptlocal-toggle指令的本质一段被路由器解析的文本调本地安装器修改配置文件的动作谁来执行Weave Router 本体客户端本地的安装器 CLI存在前提请求经过路由器即可安装器拥有该客户端的配置文件例子/fm、/rf、/beta、/router-session/router-off、/router-on、/models这就是为什么local-toggle只出现在 Claude Code 和 Codex 两列——只有这两个客户端存在安装器负责写入的配置文件opencode、pi 的开关走各自的机制Cursor 的 base URL 开关则放在 Cursor 自己的设置界面里。五、各客户端支持的指令对照表安装器从注册表推导出的最终形态摘自 install/README.md#L403-L431指令Claude CodeCodexopencodepiCursorforce-model/force-model$force-model/force-model/fm原生手动unforce-model/unforce-model$unforce-model/unforce-model/ufm原生手动router-feedback/router-feedback$router-feedback/router-feedback—手动router-session/router-session$router-session———router-off / on / status/router-off等$router-off等含$disable-routing———router-models/router-models$router-models———几个值得记住的规则Codex 用$前缀/被 Codex 内置命令保留每条技能内部发送前导空格形式的提示词。pi 走原生扩展/fm、/ufm由weave-os/router扩展直接注册不依赖安装文件。Cursor 永远是manual安装器没有可写入的 Cursor 命令文件指令需要你手动键入前导空格形式on/off 则在Settings → Models → Override OpenAI Base URL里操作。六、一条指令如何从文件到达你的终端整个分发链条非常短且被测试锁死不允许漂移声明工程师在 install/directives.tsv 加一行并配上对应资产文件commands/name.md和/或codex-skills/name/SKILL.md。读取各安装脚本通过 install/registry.sh 的公共函数解析注册表按客户端列yes/no决定给谁装什么。内嵌install.sh支持curl | sh独立分发没有相邻文件可用所以make embed-registry会把注册表数据内嵌进脚本install/scripts/embed-registry.sh。校验install/tests/registry_test.sh 断言内嵌副本与源文件完全一致npm 打包install/npm/scripts/copy-installer.js也会检查每个命令文件都必须在注册表里声明。任何一处在注册表里有、资产文件里没有或反之测试与打包都会直接失败。七、常见疑问为什么 Cursor 一列全是手动因为安装器不拥有任何 Cursor 可写入的命令/技能文件。Cursor 用户直接键入前导空格形式的指令文本如/force-model gpt-5on/off 则在 Cursor 自己的设置界面切换 base URL。$disable-routing和$router-off有什么区别没有实质区别。disable-routing是 Codex 上更早出现的指令名router-off推出后它作为别名保留两者都执行同一个weave-router off --codex动作。改完开关要重启客户端吗Claude Code要——它在启动时读取一次设置重开即生效Codex / opencode下次启动codex/opencode时生效而/router-models的模型禁用不需要重启从下一次路由决策起就生效。在哪里能找到每条指令的说明书Claude 侧看 install/commands/ 目录下的同名.md文件Codex 侧看 install/codex-skills/ 目录下的SKILL.md——它们的 frontmatterdescription字段就是你输入指令时看到的提示文案。速记卡钉模型用/fm解钉用/ufm提反馈用/rf看模型清单用/models开关闭合用/router-off/router-on查状态用/router-status。10 条指令一个注册表改一个端点省 40–70% 成本——这就是 Weave Router 指令字典的全部。【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Weave Router 路由指令完全指南：directives.tsv 中 10 条命令逐条解释
Weave Router 路由指令完全指南directives.tsv 中 10 条命令逐条解释【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/routerWeave Router 是面向 Agent 系统的模型路由器Model router for agentic systems把 Claude Code、Codex 等客户端的端点指向它每条 prompt 都能在 50ms 内被路由到最合适的模型仅改一个端点即可削减 40–70% 成本。而 install/directives.tsv 就是它所有「路由指令」的唯一注册表——你每天输入的/force-model、/router-off、/models等 10 条指令全部在这一个文件里一次声明再被安装器自动分发到各个客户端。这篇文章带你逐条读透这个指令字典每条命令做什么、哪些客户端支持、背后是发一句提示词还是改本地配置。一、先看懂注册表directives.tsv 的 8 个字段directives.tsv是一个竖线分隔的表格每行一条指令。文件开头的注释install/directives.tsv#L1-L3说明了它的结构字段含义canonical指令的规范名正式写法aliases别名逗号分隔如fmcapabilityprompt路由器直接解析的文本或local-toggle调本地安装器改配置claude/codex/opencode/pi/cursor该客户端是否安装此指令yes/noadapter原生资产类型command即commands/name.md包装文件或skill即codex-skills/name/SKILL.md可并列 设计亮点注册表是单一事实来源。所有安装路径、卸载器、状态栏刷新脚本和 npm 打包步骤都读这同一个文件一条指令只声明一次就能同步到达每个支持它的客户端。二、指令总览10 条路由指令一览表这是 install/directives.tsv#L4-L13 的完整内容整理指令别名能力类型ClaudeCodexopencodepiCursor资产类型force-modelfmprompt✅✅✅✅手动command skillunforce-modelufmprompt✅✅✅✅手动command skillrouter-feedbackrfprompt✅✅✅—手动command skillrouter-off—local-toggle✅✅——手动command skillrouter-on—local-toggle✅✅——手动command skillrouter-status—local-toggle✅✅——手动command skillrouter-session—prompt✅✅———command skillrouter-modelsmodelslocal-toggle✅✅———command skilldisable-routing—local-toggle—✅———skillbeta—prompt✅——✅手动command三、逐条解释每条路由指令到底做什么1./force-model别名/fm把会话钉在指定模型上这是最常用的模型钉选指令。语法是/force-model model-id告诉 Weave Router本会话内的请求都交给这个模型跳过自动路由。它属于prompt 型指令——指令本身是一段文本随请求发给路由器由路由器解析后给当前会话打上 pin。四个主力客户端都能用Claude Code斜杠命令/force-modelinstall/commands/force-model.mdCodex因为/被内置命令保留所以用$force-model技能install/codex-skills/force-model/SKILL.md技能会输出一行前导空格形式的指令文本交给路由器opencode、pi 同理pi 的/fm、/ufm直接注册在扩展里install/pi-router/src/force-model.tsCursor手动输入前导空格形式/force-model model-id2./unforce-model别名/ufm解除钉选回到自动路由/force-model的逆操作。执行后清除当前会话的模型钉选路由器恢复每次请求独立决策的默认模式。不需要任何参数。3./router-feedback别名/rf给路由决策和模型表现提反馈当路由器选错了模型或者某个模型输出不理想时用/router-feedback 反馈内容提交一条带上下文的反馈。路由器会把它和当前会话、所用模型关联记录用于改进路由策略。注意 pi 客户端不支持此指令注册表中为no。4./router-off、/router-on、/router-status路由开关三件套这三条是local-toggle 型指令——它们不走路由器而是调用本地安装器 CLI 修改客户端配置如npx weave-os/router off --claude见 install/commands/router-off.md把客户端从 Weave Router 切回直连供应商且不删除路由器配置随时一键切回客户端off具体做了什么Claude Code把ANTHROPIC_BASE_URL和密钥头移出settings.json回落到自己的 Anthropic 登录Codex注释掉model_provider weave一行[model_providers.weave]配置块保留opencode移除顶层weave/...模型provider.weave保留/router-on逐字节还原上面的改动/router-status报告当前是走路由器还是直连。⚠️ 生效时机Claude Code 只在启动时读取设置需要完全退出重开Codex 在下次启动codex时生效。5./router-session查看当前会话 ID打印路由器用来关联本会话遥测、日志和反馈的会话 IDClaude 侧取$CLAUDE_CODE_SESSION_IDCodex 侧取$CODEX_SESSION_ID。这个 ID 也是路由器 dashboard 里查转写记录的检索键。小技巧它现在由路由器直接应答——路由器本来就在每个请求的Session-Id头里收到并存储了这个 ID无需再浪费一次模型回合去猜设计背景见 install/README.md#L341-L347。6./router-models别名/models查看并开关可选模型列出该安装允许路由器挑选的所有模型按供应商分组[x]可挑 /[ ]不可挑并能按你的要求启用、禁用、排序。它与路由器 dashboard 设置页的复选框是同一份存储设置。常见用法/models仅查看清单把 模型id 关掉执行models disable id整供应商开关models providers enable/disable ...设置偏好顺序models prefer id id ...顺序即优先级禁用某个模型立即生效——从路由器的下一次路由决策开始无需重启。完整行为说明见 install/commands/router-models.md。7.$disable-routingCodex 专属的切回默认供应商Codex 独有的技能install/codex-skills/disable-routing/SKILL.md等价于$router-off——它是更早出现的写法保留为别名。两者都不会卸载路由器、不会动其他 Codex 配置。8./beta切换 HMM 实验路由仅 Claude 与 pi/beta在当前会话内开关实验性的 HMM隐马尔可夫模型路由策略。Claude Code 侧是斜杠命令install/commands/beta.mdpi 侧则把本地/beta作为一次规范用户回合转发给路由器install/pi-router/src/beta.ts。四、两种能力类型prompt 与 local-toggle 的本质区别理解这个区别就能看懂注册表里所有yes/nopromptlocal-toggle指令的本质一段被路由器解析的文本调本地安装器修改配置文件的动作谁来执行Weave Router 本体客户端本地的安装器 CLI存在前提请求经过路由器即可安装器拥有该客户端的配置文件例子/fm、/rf、/beta、/router-session/router-off、/router-on、/models这就是为什么local-toggle只出现在 Claude Code 和 Codex 两列——只有这两个客户端存在安装器负责写入的配置文件opencode、pi 的开关走各自的机制Cursor 的 base URL 开关则放在 Cursor 自己的设置界面里。五、各客户端支持的指令对照表安装器从注册表推导出的最终形态摘自 install/README.md#L403-L431指令Claude CodeCodexopencodepiCursorforce-model/force-model$force-model/force-model/fm原生手动unforce-model/unforce-model$unforce-model/unforce-model/ufm原生手动router-feedback/router-feedback$router-feedback/router-feedback—手动router-session/router-session$router-session———router-off / on / status/router-off等$router-off等含$disable-routing———router-models/router-models$router-models———几个值得记住的规则Codex 用$前缀/被 Codex 内置命令保留每条技能内部发送前导空格形式的提示词。pi 走原生扩展/fm、/ufm由weave-os/router扩展直接注册不依赖安装文件。Cursor 永远是manual安装器没有可写入的 Cursor 命令文件指令需要你手动键入前导空格形式on/off 则在Settings → Models → Override OpenAI Base URL里操作。六、一条指令如何从文件到达你的终端整个分发链条非常短且被测试锁死不允许漂移声明工程师在 install/directives.tsv 加一行并配上对应资产文件commands/name.md和/或codex-skills/name/SKILL.md。读取各安装脚本通过 install/registry.sh 的公共函数解析注册表按客户端列yes/no决定给谁装什么。内嵌install.sh支持curl | sh独立分发没有相邻文件可用所以make embed-registry会把注册表数据内嵌进脚本install/scripts/embed-registry.sh。校验install/tests/registry_test.sh 断言内嵌副本与源文件完全一致npm 打包install/npm/scripts/copy-installer.js也会检查每个命令文件都必须在注册表里声明。任何一处在注册表里有、资产文件里没有或反之测试与打包都会直接失败。七、常见疑问为什么 Cursor 一列全是手动因为安装器不拥有任何 Cursor 可写入的命令/技能文件。Cursor 用户直接键入前导空格形式的指令文本如/force-model gpt-5on/off 则在 Cursor 自己的设置界面切换 base URL。$disable-routing和$router-off有什么区别没有实质区别。disable-routing是 Codex 上更早出现的指令名router-off推出后它作为别名保留两者都执行同一个weave-router off --codex动作。改完开关要重启客户端吗Claude Code要——它在启动时读取一次设置重开即生效Codex / opencode下次启动codex/opencode时生效而/router-models的模型禁用不需要重启从下一次路由决策起就生效。在哪里能找到每条指令的说明书Claude 侧看 install/commands/ 目录下的同名.md文件Codex 侧看 install/codex-skills/ 目录下的SKILL.md——它们的 frontmatterdescription字段就是你输入指令时看到的提示文案。速记卡钉模型用/fm解钉用/ufm提反馈用/rf看模型清单用/models开关闭合用/router-off/router-on查状态用/router-status。10 条指令一个注册表改一个端点省 40–70% 成本——这就是 Weave Router 指令字典的全部。【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考