GSD动态模型路由完整指南：如何按任务复杂度自动切换最便宜的模型-创锋一号

GSD动态模型路由完整指南：如何按任务复杂度自动切换最便宜的模型

【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址: https://gitcode.com/gh_mirrors/gs/gsd-2

GSD 的动态模型路由（Dynamic Model Routing）是一项智能成本控制功能：它会自动判断每个任务的复杂程度，为简单任务分配最便宜的轻量模型，把昂贵的旗舰模型留给真正的难题。开启后，在成本封顶的套餐下通常可节省20%–50% 的 token 消耗，而且在关键任务上不牺牲质量。本文用最通俗的方式讲透它的原理、配置与省钱技巧，零基础也能上手。

核心原理：两阶段流水线自动选模型

GSD 在自动模式（auto-mode）下派发每一个工作单元时，都会让它经过一条"两阶段选路流水线"：

阶段 1：复杂度分类 —— 先给任务"定级"

系统用纯规则启发式（不调用大模型、毫秒级完成）把工作划分到三个层级：

层级	典型工作	默认模型级别
🪶Light（轻）	切片收尾、UAT 测试、hooks	Haiku 级（最便宜）
⚖️Standard（标准）	调研、规划、执行、里程碑收尾	Sonnet 级（均衡）
🏋️Heavy（重）	重新规划、路线图重估、复杂执行	Opus 级（最强）

分类依据包括任务类型默认值、任务计划分析（步骤数、文件数、描述长度、复杂关键词如refactor/migrate/concurrent等）：步骤 ≤3、文件 ≤3 的小任务会被判为 Light，而 ≥8 步或 ≥8 文件的复杂任务则会升到 Heavy。

阶段 2：能力评分 —— 在候选池里挑"最合适的"

从 v2.52.0 开始，路由不再只是"选该层级里最便宜的"，而是用能力感知评分（capability-aware scoring）：每个模型都有一份内置的 7 维能力档案（0–100 分）——编码、调试、调研、推理、速度、长上下文、指令遵循。系统会按任务类型给不同维度加权（比如执行类任务加权"编码 0.9 + 指令 0.7"，调研类任务加权"调研 0.9 + 长上下文 0.7"），算出加权得分选出胜者。

💡 关键规则：只降不升（downgrade-only）。你配置的模型永远是"天花板"，路由只会向下省钱，绝不会偷偷升级成比你配置更贵的模型。

快速启用：3 步开启动态模型路由

动态路由默认关闭。只需在偏好设置文件中打开开关即可：

--- version: 1 dynamic_routing: enabled: true ---

推荐顺手加上两个省钱/保质量的默认增强项：

dynamic_routing: enabled: true escalate_on_failure: true # 任务失败时自动升级层级重试，避免便宜模型空转 budget_pressure: true # 接近预算上限时自动整体降级

省钱进阶：5 个关键配置项

tier_models：为每个层级显式指定模型（如 light 用gpt-4o-mini、heavy 用claude-opus-4-6），不填则使用内置能力映射表。
cross_provider: true（默认开）：允许跨服务商选择，用内置成本表找出每个层级全局最便宜的可用模型。
budget_pressure：预算使用率 ≥50% 时 Standard 自动降到 Light，≥75% 更激进降级，>90% 时几乎全部任务都用最便宜的模型。
capability_routing: false：如果想回到"每层最便宜"的纯省钱模式，关掉评分即可。
modelOverrides：发现某个模型在特定任务上比内置档案更强？可以在模型配置中按维度修正评分，把路由器"掰"向你熟悉的模型。

自适应学习：路由会越用越聪明

GSD 还会记录.gsd/routing-history.json路由历史：跟踪每个层级、每类任务的成功/失败率。如果某个层级在某类任务上失败率超过 20%，后续同类任务会自动被提升一个层级重试。

此外，你对路由结果的反馈（过强 / 过弱 / 合适）权重是自动结果记录的2 倍——多给反馈，路由就更快贴合你的项目。

搭配 Token 配置实现"极限省钱"

动态模型路由与 Token 配置（budget/balanced/quality）是互补关系：

Token 配置控制阶段跳过与上下文压缩（管"少做什么"）
动态路由控制每个工作单元的模型选择（管"用谁来做"）

二者叠加时，budgetToken 配置 + 动态路由 =最大省钱组合，适合成本封顶套餐跑长时自动任务。

常见问题 FAQ

Q1：我订阅的是固定月费（如 Copilot 套餐），开启路由有意义吗？

默认情况下，对包月/统一定价服务商，GSD 会自动抑制路由——因为每次请求成本相同，降级只会掉质量。你可以设置allow_flat_rate_providers: true来在单一订阅内按任务智能选模型（调研用轻量、架构用旗舰），建议同时保持cross_provider: false。

Q2：路由器怎么选错了模型怎么办？

两个保险机制：一是escalate_on_failure失败自动升级层级；二是扩展可通过before_model_select钩子完全接管选路逻辑（比如强制调研任务用 Gemini 系）。开启详细日志后，每次路由决策都会打印评分明细，例如：

Dynamic routing [S]: claude-sonnet-4-6 (capability-scored) — claude-sonnet-4-6: 82.3, gpt-4o: 78.1, deepseek-chat: 72.0

Q3：能力评分是跑分数据吗？

不是。内置档案是启发式相对排名，反映模型家族的大致长板而非验证过的基准测试。对你熟悉的模型，用modelOverrides修正即可。