Weave Router 请求头控制终极清单：8个 x-weave-* 头如何精确操控路由-北京尧图网络

Weave Router 请求头控制终极清单8个 x-weave-* 头如何精确操控路由【免费下载链接】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 是一款面向 AI Agent 的模型路由器能在 50ms 内将每个 prompt 路由到最合适的模型通过更换一个 endpoint 即可降低 40–70% 的推理成本。它提供了一组x-weave-*请求头让无界面客户端CI、评测脚本、headless 集成可以精确控制路由决策无需任何 slash 命令。本文列出 8 个核心请求头覆盖从模型固定、策略切换、评分旋钮调参到集群 A/B 测试的完整操控面。快速总览#请求头一句话用途1x-weave-force-model将会话固定到指定模型2x-weave-force-cluster限定本轮必须来自某个路由集群3x-weave-allowed-models缩小路由候选模型范围4x-weave-router-strategy按请求切换路由策略5x-weave-routing-alpha等微调评分函数的权重旋钮6x-weave-router-debug开关策略调试模式7x-weave-policy-pin锁定指定策略工件 roster8x-weave-cluster-version按请求切换评分器版本A/B1.x-weave-force-model— 将会话固定到指定模型作用等价于在聊天窗口输入/force-model 模型名但通过 HTTP 头实现适配无 UI 的 headless 客户端。取值规则接受标准目录 ID如qwen/qwen3.8-max、裸名称qwen3.8-max、或别名opus、sonnet、gpt可附加:level难度后缀如opus:high严格精确匹配不支持前缀/模糊匹配未知模型名直接返回HTTP 400为什么严格模糊匹配曾导致/fm qwen 3.8被解析为qwen/qwen3-coder并假装成功。现在整个命令行作为模型名解析无法匹配则拒绝。源码internal/proxy/force_model.go2.x-weave-force-cluster— 限定本轮来自某个路由集群作用将本轮请求约束到策略 sidecar 的某个命名集群cluster集群内的具体模型选择仍由策略决定。关键规则接受不透明标签opaque label路由器不维护合法集群列表标签不在当前 live roster 中 →HTTP 400无论是拼写错误还是已退役集群标签在 roster 中但无可用模型全部被排除/超窗/能力不匹配→HTTP 400仅在hmm/hmm_embedding策略下有效默认cluster策略无命名分组发此头返回 400不写入会话 pin每轮独立生效不改变后续请求行为与force-model的区别force-model写会话级 pin后续请求沿用force-cluster仅约束当前轮次。源码internal/proxy/force_cluster.go3.x-weave-allowed-models— 缩小路由候选范围作用指定本轮请求只从给定模型子集中路由相当于临时白名单。行为与 installation 级 allowlist 取交集未知别名或交集为空 →HTTP 400未授权的调用方 →HTTP 403不会静默回退到全量模型需要 installation 授权policy_header_overrides_enabled或组织级 flag 开启典型场景CI 流水线只允许路由到低成本模型避免意外消耗高端模型配额。源码internal/server/middleware/allowed_models_override.go、internal/proxy/allowed_models_header.go4.x-weave-router-strategy— 按请求切换路由策略作用覆盖 installation 持久化的路由策略让单次请求使用不同评分算法。可用值 | 值 | 说明 | |---|------| |cluster| 默认评分器匿名质心评分 | |rl| 训练好的 RL/DPO 策略路由 | |bandit| Thompson 采样冻结后验 | |hmm/hmm_embedding| HMM 隐马尔可夫分类器 |优先级从高到低已授权的x-weave-router-strategy请求头Installation 持久化策略部署级默认值ROUTER_DEFAULT_STRATEGY安全规则未授权的 installation 发送此头会被静默忽略不报错、不 503保证安全。源码internal/server/middleware/router_strategy_override.go5.x-weave-routing-*旋钮组 — 微调评分权重作用在请求级覆盖评分函数的超参数无需重启或修改部署配置。可用头及取值范围请求头范围含义x-weave-routing-alpha[0, 1]质量 vs 成本的权衡系数x-weave-routing-speed-weight[0, 1]延迟/速度权重x-weave-routing-output-cost-ratio[0, 10]输出 token 成本放大比x-weave-routing-expected-output-tokens[0, 100000]预期输出 token 数x-weave-routing-per-model-verbositytrue/false是否按模型细分评分示例CI 快速评测想优先速度 → 设置x-weave-routing-speed-weight: 0.9。源码internal/server/middleware/routing_knobs_override.go6.x-weave-router-debug— 开关策略调试模式作用按请求覆盖 installation 持久化的策略调试开关便于调试而不修改全局配置。取值true/false行为未授权的 installation → 头被忽略保持持久化值非布尔值 → 同上保持持久化值合法布尔值 → 覆盖本轮调试状态注意此头与x-weave-router-strategy遵循相同的授权规则policy_header_overrides_enabled。源码internal/server/middleware/policy_debug_override.go7.x-weave-policy-pin— 锁定策略工件 Roster作用将本轮路由锁定到指定的策略工件policy artifact和 roster 版本用于精确复现和回放。取值格式policy_artifact_sha256roster_sha256关键行为仅在ROUTER_POLICY_PIN_ENABLEDtrue时生效需 installation 开启policy_header_overrides_enabled格式错误 →HTTP 400policy_pin_malformed工件/roster 未加载 →HTTP 503policy_pin_unavailable永不回退到当前默认工件 — 要么精确命中要么失败会话 pin、force-model、usage-bypass 等在 pin 模式下全部绕过遥测记录policy_pin_requested/policy_pin_honoured典型场景评测回放、合规审计、生产问题精确复现。源码internal/server/middleware/policy_pin_override.go8.x-weave-cluster-version— 按请求切换评分器版本作用指定本轮使用哪个版本的 cluster 评分器实现无状态 A/B 测试。取值v0.X格式如v0.3行为携带此头的请求路由到对应版本的 Scorer未携带的普通流量始终使用部署默认版本ROUTER_CLUSTER_VERSION→artifacts/latest用于评估框架的逐请求 A/B 对比不影响线上生产流量源码internal/server/middleware/cluster_version_override.go⚠️ 授权与错误处理通则场景行为未授权 installation 发送 policy 类头静默忽略strategy、debug、pin未授权发送allowed-modelsHTTP 403值格式/取值非法HTTP 400按请求路径返回对应 API 格式的错误包策略不可用如 RL sidecar 未配置HTTP 503不回退到 cluster设计哲学宁可拒绝请求也不静默降级 — 拼写错误不会看起来生效了。相关文档与模块完整配置参考docs/CONFIGURATION.md中间件实现目录internal/server/middleware/路由策略注册internal/proxy/service.go策略 sidecar 契约docs/POLICY_ROUTER_HARNESS.md遥测 schema记录各头效果internal/analytics/schema.go总结Weave Router 的x-weave-*请求头体系为 headless 场景CI/CD、评测 harness、自动化流水线提供了与 slash 命令等价的完整控制面。从固定到某个模型到锁定精确策略工件版本8 个请求头覆盖了日常运维和高级调试的全部需求。核心原则只有一个严格验证拒绝即失败绝不假装成功。【免费下载链接】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 请求头控制终极清单：8个 x-weave-* 头如何精确操控路由

相关推荐

生物素-花生四烯酸复合物的特性与应用解析

OpenUSD 与 Houdini 的 USD 覆层（Overlay）工作流：基于官方 Houdini 示例教程的完整解析

论文降AI率效果验证方法与工具评测

更多资讯

Spring Boot民宿系统源码解析：事务边界、MyBatis映射与Vue权限拦截

STM32电机PID闭环控制：增量式算法、M法测速与调参实战

Android旅游APP毕设实战：高德地图集成与离线缓存开发

汕头30米DEM数据全流程处理：从Shapefile裁剪到Python分析

CubeSandbox 浏览器沙箱实战：在 MicroVM 中运行无头 Chromium 并用 Playwright CDP 远程驱动

STM32G431嵌入式开发：CubeMX驱动封装与BSP分层实战

今日更新

基于MATLAB的CRI显色指数计算：从SPD光谱到Ra的完整流程

JSP+Servlet+MySQL博客系统源码部署与优化全攻略

蜂窝调度算法 MATLAB 实现：比例公平、轮询与最大 C/I 对比

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？