← 返回重点项目
查看 GitHub 项目

workweave/router

一句话定位

面向 agentic 系统的多模型路由器——OpenAI 兼容端点切换,<50ms 决定每个 prompt 走哪个模型,宣称节省 40-70% 成本;4 个月 2,662⭐。

它解决的问题

企业部署 AI Coding Agent(Claude Code / Codex / Cursor / Copilot 等)时面临:(1) 模型成本高——Sonnet / Opus / GPT-4 每次调用成本差异大,简单任务用大模型浪费;(2) 手动选模型繁琐——开发者需根据任务复杂度决定用哪个模型;(3) OpenAI 兼容协议壁垒——Anthropic / OpenAI / Cohere 各有 API 协议,迁移成本高。workweave/router 直接把这三类问题工程化:作为 OpenAI 兼容代理层(用户无需改 base URL)+ 多模型支持(Anthropic / OpenAI / Cohare 等)+ 智能路由(按 prompt 复杂度 / 成本 / 延迟动态选择),让企业可以"在不改 Agent 配置的前提下"按 prompt 选模型。

为什么值得关注(2026-08-30)

热度来源判断

router 的热度是 "AI Coding 成本压力 × OpenAI 兼容协议标准化 × 智能路由刚需 × Agentic Coding 部署真实需求" 的组合。2,662⭐/4 个月 + 77 forks 在 AI Gateway 类项目中合理规模。热度真实且具可持续性——但需警惕:(1) "<50ms / 40-70%" 是 README 自述宣称,未经独立 benchmark 复现;(2) NOASSERTION License 增加商业采用门槛;(3) 与云厂商 AI Gateway(Cloudflare AI Gateway / AWS Bedrock 等)竞争风险。

关键技术亮点

  1. OpenAI 兼容端点:用户无需改 base URL——降低迁移门槛,Topics 明示 openai-compatible
  2. <50ms 路由决策:README 自述宣称,决策延迟极低
  3. 多模型支持:Anthropic / OpenAI / Cohere 等——Topics 明示 anthropic / claude-code / codex
  4. agentic coding 友好:Topics 明示 agentic-coding / claude-code / codex——明确定位为 AI Coding 工具链中间件
  5. 40-70% 成本节省宣称:README 自述,需独立 benchmark
  6. 19 MB 极小仓库:轻量部署,单二进制(推断)

架构师速览

决策问题 研究判断 证据边界
系统边界 OpenAI 兼容代理层(输入:用户 prompt)→ 路由决策(按 prompt / 成本 / 延迟)→ 目标模型 API(Anthropic / OpenAI / Cohere 等) OpenAI 兼容 + 多模型是 Topics 明示;路由决策的具体算法(规则 / ML / embedding 相似度)需源码核验
主路径 Agent 通过 OpenAI 兼容协议发请求 → router 解析 prompt → 路由决策(<50ms)→ 调目标模型 API → 返回响应 OpenAI 兼容 + <50ms 是 README 明示;具体路由规则可配置性需独立核验
关键权衡 路由开销(<50ms)vs 决策质量 vs 多模型 API 稳定性 vs 缓存策略 vs 商业 license(NOASSERTION)vs 与云厂商 AI Gateway 竞争 "40-70% 节省" 是 README 自述;具体节省场景与边界条件需 benchmark 复现
最小 PoC 在 Claude Code 或 Codex 中把 base URL 指向 router → 验证简单 prompt 路由到便宜模型(如 Haiku)→ 验证复杂 prompt 路由到贵模型(如 Sonnet)→ 验证端到端延迟 <50ms + 整体节省比例 OpenAI 兼容端点切换是 Topics 明示;具体路由规则可配置性需 README 独立核验

架构启发

router 的核心启发是 "AI Gateway / Model Router 是 agentic 系统的必备中间层"。随着 Claude Code / Codex / Cursor 等 Coding Agent 在企业普及,"按 prompt 选模型"的省钱 / 提质需求变成必备。router 的创新不在于"AI Gateway"(Cloudflare / AWS Bedrock 等已有),而在于"OpenAI 兼容端点切换 + agentic coding 专属优化"——这是把"AI Gateway"从"云厂商基础设施"做成"AI Coding 工具链中间件"的关键一步。更深层的启发是 "agentic 系统的中间件栈正在形成"——router(模型选择层)+ acrylic(harness 选择层)+ workweave-router 的组合说明:"按 prompt 选模型"和"按 harness 选模型"形成完整栈,类似软件架构中的 API Gateway + Service Mesh 模式。下一波可能是按 prompt 选 embedding / RAG 引擎 / vector store 的"AI 工作流路由器"。

架构图(MMD)

证据边界:此图只采用本档案已有可核验描述;"待核验"节点不应视为项目实现事实。

flowchart LR
  Agent1[Claude Code] --> Router[workweave router
OpenAI 兼容端点] Agent2[Codex] --> Router Agent3[Cursor] --> Router Router --> Decision{<50ms 路由决策
算法待核验} Decision -->|简单 prompt| Cheap[便宜模型
Haiku / GPT-3.5] Decision -->|复杂 prompt| Expensive[贵模型
Sonnet / GPT-4] Decision -->|特定任务| Specialized[专用模型
待扩展] Cheap --> Agent1 Cheap --> Agent2 Cheap --> Agent3 Expensive --> Agent1 Expensive --> Agent2 Expensive --> Agent3 Specialized --> Agent1 Specialized --> Agent2 Specialized --> Agent3 Router -. 监控 .-> Metrics[节省比例 / 延迟 / 错误率]

定位判断

基础设施候选项目(agentic 系统的模型路由中间件)。 router 定位明确——agentic 系统的模型路由器。2,662⭐/4 个月在 AI Gateway 类项目中合理规模。但"AI Coding 模型路由器"的护城河在于:(1) 路由决策算法精度(决定 40-70% 节省的真实性);(2) 与云厂商 AI Gateway 的差异化(决定独立工具的价值);(3) NOASSERTION License 后续是否明确为可商用许可。目前定位是"agentic 系统的 AI Coding 模型路由器代表",向"agentic 系统中间件标准"演进是合理路径。

风险/局限/泡沫点

与同类项目的关系

是否值得持续跟踪

值得跟踪(agentic 系统的模型路由中间件)。 router 代表"AI Coding 工具链的模型路由层"方向,无论其本身成败,这一方向是行业趋势。建议关注:路由决策算法精度(决定 40-70% 节省的真实性)、是否被云厂商集成、是否扩展到 embedding / RAG / vector store 路由。对 AI Coding 部署团队,router 是当前最易用的 OpenAI 兼容模型路由器。对中间件观察者,它是"agentic 系统中间件栈"路径的成功样本。

后续观察点


首次记录:2026-08-30