> 核心功能: 本技能提供中文交互、规范流程和配置说明、化工作流场景等能力。

模型路由工具(专业版)

导读

模型路由工具(专业版)面向团队与企业,在兼容免费版三层路由决策的基础上,扩展了成本分析仪表盘、批量任务分发、自定义路由规则、实时监控告警与团队策略治理能力.
当你在请求中提及 成本治理、批量路由、路由规则、预算告警、多供应商 等关键词时,本工具会自动激活,为团队提供结构化的模型路由治理方案.
本版本完全兼容 model-routing-tool-free 的三层路由决策(Flash → Standard → Plus / 32B),可平滑升级,已有路由逻辑无需改造.

功能能力

# 查看本月成本仪表盘
node （请参考skill目录中的脚本文件） --period month --group-by project
# ...
# 输出
# 项目成本仪表盘: 2026-07
#
# | 项目 | Flash | Standard | Plus | 总成本 | 预算 | 使用率 |
# | --- | --- | --- | --- | --- | --- | --- |
# | 客服机器人 | $12 | $45 | $8 | $65 | $100 | 65% |
# | 代码审查 | $3 | $28 | $15 | $46 | $80 | 57% |
# | 数据分析 | $5 | $12 | $22 | $39 | $50 | 78% |
# | 文档生成 | $8 | $6 | $0 | $14 | $30 | 47% |
# | 总计 | $28 | $91 | $45 | $164 | $260 | 63% |

设置预算告警:

# config/budget-alerts.yaml 预算告警配置
alerts:
  - name: 项目级月度预算
    threshold: 80%
    action: notify
    targets:
      - slack: "#ai-cost-alerts"
      - email: ["tech-lead@company.com"]
  - name: 单任务成本异常
    threshold: $5
    action: notify_and_review
    targets:
      - webhook: "https://hooks.internal/ai-anomaly"
  - name: 总预算硬上限
    threshold: $500
    action: degrade
    degrade_to: flash

场景二:批量任务分发

团队需要并发处理大量任务,按复杂度自动路由并聚合结果.

// batch-route.mjs 批量路由分发
import { routeBatch } from './lib/router.mjs';
// ...
const tasks = [
  { id: 't1', content: '翻译这段话', expectedComplexity: 'low' },
  { id: 't2', content: '实现用户认证模块', expectedComplexity: 'medium' },
  { id: 't3', content: '设计多区域部署架构', expectedComplexity: 'high' },
  // ... 100个任务
];
// ...
const results = await routeBatch(tasks, {
  concurrency: 10,
  costCap: 50,          // 单批成本上限$50
  fallbackModel: 'GLM-4.5-Flash',  // 超成本降级
  onProgress: (done, total) => console.log(`${done}/${total}`),
});
// ...
// 输出
// {
//   results: [...],
//   summary: {
//     total: 100,
//     success: 97,
//     failed: 3,
//     cost: $42.5,
//     routing: { flash: 45, standard: 48, plus: 7 },
//     duration: '3m 22s'
//   }
// }

场景三:自定义路由规则

团队希望根据任务特征自定义路由,而非完全依赖默认决策.

# config/routing-rules.yaml 自定义路由规则
rules:
  - name: 含敏感关键词强制Plus
    match:
      anyOf:
        - regex: "(安全|漏洞|审计|合规)"
        - regex: "(架构|设计|重构)"
    route: plus
    reason: "敏感/架构类任务需要深度推理"
# ...
  - name: 翻译任务用Flash
    match:
      allOf:
        - keyword: "翻译"
        - maxLength: 500
    route: flash
    reason: "短文本翻译用Flash足够"
# ...
  - name: 代码审查用Standard
    match:
      anyOf:
        - regex: "(审查|review|PR)"
        - filePattern: "*.py"
    route: standard
    reason: "代码审查是Standard主力场景"
# ...
  - name: 成本上限降级
    condition:
      monthlyBudgetUsed: ">80%"
    route: flash
    fallback: true
    reason: "月度预算超80%,降级到Flash"
# ...
default: standard  # 未匹配规则时的默认路由

使用限制说明

以下场景模型路由工具(专业版)不适合处理：
- 实际人员绩效评估
- 财务预算审批
- 合同法务审核

调用前提

需要项目管理、任务规划、进度跟踪、团队协作时使用。不适用于非本工具能力范围的需求.

上手指南

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理

# config/team-policy.yaml 团队策略
policy:
  defaultTier: standard
  cost:
    monthlyBudget: 500
    perTaskCap: 5
    degradeAt: 80%
    degradeTo: flash
  routing:
    allowForce: true           # 允许任务强制指定层级
    allowOverride: false        # 禁止绕过规则
    auditLog: true             # 记录所有路由决策
  fallback:
    primaryProvider: provider-a
    fallbackProvider: provider-b
    healthCheck: 60s
  compliance:
    forbiddenModels: []        # 合规禁用的模型
    requiredTierForPII: plus   # 含PII数据强制用Plus

多供应商故障转移

# config/providers.yaml 多供应商配置
providers:
  - name: provider-a
    enabled: true
    priority: 1
    models:
      flash: "model-a-flash"
      standard: "model-a-standard"
      plus: "model-a-plus"
    apiKey: "${PROVIDER_A_KEY}"
    costMultiplier: 1.0
# ...
  - name: provider-b
    enabled: true
    priority: 2
    models:
      flash: "model-b-flash"
      standard: "model-b-standard"
      plus: "model-b-plus"
    apiKey: "${PROVIDER_B_KEY}"
    costMultiplier: 0.85  # 便宜15%
# ...
  - name: provider-c
    enabled: false          # 备用,默认禁用
    priority: 3
    models: { ... }
    apiKey: "${PROVIDER_C_KEY}"

使用技巧

1. 成本治理三阶段

# 健康检查
node （请参考skill目录中的脚本文件） --all-providers
# ...
# 手动切换主供应商
node （请参考skill目录中的脚本文件） --primary provider-b
# ...
# 成本对比报告
node （请参考skill目录中的脚本文件） --period month

6. 合规与审计

# 查询路由审计日志
node （请参考skill目录中的脚本文件） --task-id t-2026-07-18-001
# ...
# 导出合规报告
node （请参考skill目录中的脚本文件） \
  --since 2026-07-01 \
  --format csv \
  --output reports/compliance-july.csv

热门问题

Q1: 环境变量配置后不生效怎么办?

A: 确认已重启终端或会话。检查变量名拼写是否正确,使用 echo $变量名 验证是否生效。

Q2: 如何处理网络不稳定的情况?

A: 内置重试机制最多3次。如持续失败,检查网络代理设置,确认API端点可达性。

Q3: 技能支持自定义参数吗?

A: 支持通过输入参数自定义行为。参考参数说明表格中的可选参数项进行配置。

Q4: 并发调用有什么限制?

A: 建议并发不超过3个请求。高并发场景需配置请求间隔,避免触发平台限流策略。

Q5: 如何查看执行日志?

A: Agent平台会记录执行过程。检查输出格式章节的execution_log字段了解执行步骤详情。

依赖与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Node.js版本: 建议 20 LTS 及以上(用于运行路由与监控脚本)
• 数据库: 可选,用于持久化审计日志(建议使用时序数据库)

依赖详情

{
  "success": true,
  "data": {
    "result": "模型路由工具(专业版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "model routing pro"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}

安全规范

疑问解答汇总

Q1: 模型路由工具(专业版)支持哪些输入格式？

A1: 团队级模型路由套件,含成本仪表盘、批量分发、自定义规则与监控告警。。模型路由工具(专业版)面向团队与企业,在三层路由决策基础上,扩展成本分析仪表盘、批量任务分发。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

错误处理指引

针对模型路由工具(专业版)使用中可能遇到的常见问题,提供以下排查方案:

模型路由工具(专业版)通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪