Model Router Certification 2026 09 06T13 47 54 609Z

---
name: model-router
description: "当需要调度不同模型执行子任务时使用。根据任务类型匹配模型能力，自动选择最优模型并生成调用指令。TRIGGER: 模型调度、model dispatch、选模型、分派任务、多模型协作、路由到模型"

installCatalogName: model-router
clients: [codex, claude, gemini, opencode, hermes, workbuddy]
scopes: [global, project]
defaultInstall:
  global: true
  project: false
tags: [aios, model-router, orchestration, dispatch, essential]
repoTargets: [codex, claude, gemini, opencode, hermes, workbuddy]
---

# Model Router

你是 Agent Team 的调度中枢。先做语义判断（任务属于哪类），再用 `--task-type` 显式声明；不要把所有任务都默认塞给实现模型，也不要用关键词表假装识别任务类型。

> 北极星原则：程序不根据自由文本关键词猜任务类型。任务类型由模型语义判断后**显式声明**（`--task-type`）；无声明时程序返回中性 `general`（确定性默认），不猜测。

## CLI 协议

| 协议 | CLI | 使用场景 |
|------|-----|---------|
| **codex** | `codex exec --dangerously-bypass-approvals-and-sandbox -m <model> "<prompt>"` | GPT-5.5 |
| **gemini** | `gemini -m gemini-3-pro --yolo -p "<prompt>"` | Gemini-3-Pro |
| **claude** | `claude --model <model> --dangerously-skip-permissions -p "<prompt>"` | 其余模型 |

## 模型能力表

| 模型 | 协议 | 最擅长 | 成本 |
|------|------|--------|------|
| **Claude Opus 4.7** | claude | 代码审查、架构设计、安全审计 | 最高 |
| **Claude Sonnet 4.6** | claude | 日常开发、RAG、快速原型、文档 | 中 |
| **GPT-5.5** | codex | 通用推理、浏览器自动化、代码执行、兜底复杂任务 | 最高 |
| **DeepSeek-V4-Pro** | claude | 普通实现、算法、核心逻辑、批处理 | 最低 |
| **GLM-5.1** | claude | 数学推理、自主循环、系统规划 | 低 |
| **Kimi K2.6** | claude | 多Agent编排、前端UI、长周期执行 | 低 |
| **MiniMax-M2.7** | claude | 自愈运维、生产恢复 | 低 |
| **Gemini-3-Pro** | gemini | 多模态分析、长文档研究、1M上下文 | 中 |

## Balanced v2 Profiles

- `balanced` 默认：显式声明驱动升级，普通实现省成本。
- `premium`：复杂、低置信、高风险任务更积极使用订阅强模型。
- `budget`：优先低成本，仅在浏览器、长上下文、安全、生产恢复等硬能力约束下升级。

使用 `--profile` 或环境变量切换：

```bash
node scripts/aios.mjs model-router route --task "..." --profile balanced --explain
export AIOS_MODEL_ROUTER_PROFILE=premium
```

## 任务类型声明

任务类型是语义判断：你理解任务后，选择最贴合的 task type 并用 `--task-type` 显式声明。常用类型（完整列表见 `model-router list`）：

| task-type | 适用场景 | 典型首选模型 |
|-----------|----------|--------------|
| `browser-automation` | 浏览器操作、页面交互、上传填写、截图抓取 | **GPT-5.5** |
| `security-review` | 安全审计、漏洞分析、权限与合规检查 | **Claude Opus** |
| `code-review` | 代码审查、PR 质量评估 | **Claude Opus** |
| `self-healing` | 线上故障、日志恢复、生产自愈 | **MiniMax-M2.7** |
| `architecture` | 架构设计、技术选型、跨模块规划 | **Claude Opus** |
| `research` | 长文档、多模态、第三方 API 调研 | **Gemini-3-Pro** |
| `frontend` | 前端 UI、组件、落地页 | **Kimi K2.6** |
| `implementation` | 普通实现、算法、核心逻辑 | **DeepSeek-V4** |

无 `--task-type` 时程序返回中性 `general` 并采用默认实现模型——这是确定性兜底，不表示程序识别出了任务类型。

## Explain 输出

用 `--explain` 查看为什么选中某个模型：

```bash
node scripts/aios.mjs model-router route \
  --task "用浏览器打开小红书发布页面，上传图片并填写标题" \
  --task-type browser-automation \
  --profile balanced \
  --explain
```

重点看这些字段：

- `profile`：实际使用的策略，默认 `balanced`。
- `confidence`：显式声明时为 1，无声明时为 0。
- `matchedSignals`：恒为空数组（程序不做关键词匹配）。
- `why`：人类可读解释。
- `recommendedPhases`：复合任务的分阶段建议；v2 只报告建议，不自动改写 team plan。

## Agent Team 集成

- `aios team` / `aios orchestrate --dispatch local --execute live` 默认启用 per-phase model routing，并为 planner / implementer / reviewer / security-reviewer 分别解析模型。
- 每个 phase job 的 `launchSpec.modelRouting` 包含 `role`、`taskType`、`modelId`、`provider`、`clientId`、`cliCommand`、`reason`、`fallback`，v2 还会保留 `profile`、`confidence`、`matchedSignals`、`why`、`recommendedPhases`。
- live subagent / GroupChat 运行时会按 `clientId` 切换 CLI 协议并附加模型参数；Codex 子进程默认附加 `--dangerously-bypass-approvals-and-sandbox`，Claude 默认附加 `--dangerously-skip-permissions`，Gemini 默认附加 `--yolo`，避免后台 approval/sandbox prompt 卡死。
- 每个 phase / speaker 完成或阻塞后写入 ContextDB `kind=model.dispatch` 事件，`turn.environment=model-router`，refs 包含 model/task/role，供 `model-router stats` 汇总。
- 如需只使用外层 `AIOS_SUBAGENT_CLIENT`，设置 `AIOS_MODEL_ROUTER=0`（也支持 `false` / `off` / `no`）；dry-run 仍可展示计划中的 routing metadata。

## 决策流程

1. 语义判断任务类型：理解任务后选择最贴合的 task type，**显式**传 `--task-type`（例如浏览器类任务 → `--task-type browser-automation`）。
2. 如果用户明确指定 task type 或角色 env override，优先尊重 override。
3. 按 profile 调整：`balanced` 成本感知、`premium` 更积极升级、`budget` 更保守。
4. 用 `--explain` 检查 `why` 与 `confidence`。
5. 对复合任务按 `recommendedPhases` 拆成规划、实现、文档、审查等子任务。
6. 记录/查看结果：`node scripts/aios.mjs model-router stats`。

## 命令工具

```bash
node scripts/aios.mjs model-router list
node scripts/aios.mjs model-router route --task "build a beautiful landing page component" --task-type frontend --profile balanced --explain
node scripts/aios.mjs model-router route --task "实现一个登录接口" --task-type implementation
node scripts/aios.mjs model-router stats
```

## 环境变量

```bash
export AIOS_MODEL_ROUTER=0                    # 关闭 live 执行期模型覆盖；metadata 仍可生成
export AIOS_MODEL_ROUTER_PROFILE=premium      # balanced | premium | budget
export AIOS_MODEL_PLANNER=claude-opus         # 按角色覆盖
export AIOS_MODEL_IMPLEMENTER=deepseek-v4
export AIOS_MODEL_REVIEWER=claude-opus
export AIOS_MODEL_SECURITY_REVIEWER=claude-opus
export AIOS_MODEL_BROWSER_AUTOMATION=gpt-5.5  # 按任务类型覆盖
export AIOS_MODEL_IMPLEMENTATION=deepseek-v4
export AIOS_MODEL_PLANNING=glm-5.1
export AIOS_SUBAGENT_CODEX_UNATTENDED=0       # 关闭 Codex 子进程 bypass（默认开启）
export AIOS_SUBAGENT_CLAUDE_UNATTENDED=0      # 关闭 Claude 子进程 skip permissions（默认开启）
export AIOS_SUBAGENT_GEMINI_UNATTENDED=0      # 关闭 Gemini 子进程 yolo（默认开启）
```

## Troubleshooting

- 如果 `model-router stats` 全是 `deepseek-v4 / implementation`，先用 `route --task "..." --task-type <type> --profile balanced --explain` 检查显式声明后的路由是否合理；stats 反映历史执行记录，不会自动证明当前路由仍然错误。
- 如果浏览器/上传/填写类任务没有到 GPT-5.5，显式加 `--task-type browser-automation`。
- 如果前端 UI 被当成普通实现，显式使用 `--task-type frontend`。
- 如果任务很大且 `confidence` 低，优先拆分子任务；需要更强模型时用 `--profile premium`。
- 当前 v2 记录历史 dispatch 供诊断和统计；历史成功率尚未自动参与权重计算，不要把 stats 当成在线学习结果。