rexleimo/aios/model-router

Model Router

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

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

CLI 协议

模型能力表

Balanced v2 Profiles

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

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

aios model-router route --task "..." --profile balanced --explain
export AIOS_MODEL_ROUTER_PROFILE=premium

任务类型声明

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

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

弱任务钉死弱模型

以下旁路任务不参与强模型路由，直接使用低成本模型；超限时沿 fallback 链降级，不升级：

只有显式的硬能力约束（浏览器、1M 上下文、安全审计、生产恢复）才能打破钉死。任务类型由你语义判断后声明，程序不从文本关键词反推。

预算声明

每次调度显式声明预算字段，随路由请求一起记录，供后续熔断消费：

• budget: 本任务 token/费用上限（数字 + 单位，如 200k tokens）。
• quota_scope: 配额归属（单任务 / DAG 分支 / 整轮 run）。
• 超支行为（二选一并声明）：downgrade（降档弱模型继续）或 fail-fast（立即停并交接）。

无声明即无熔断——这是确定性语义，不是程序替你省钱。预算只做客观计数（token/费用），不做语义判断。

Explain 输出

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

aios 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. 记录/查看结果：aios model-router stats。

命令工具

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

环境变量

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 当成在线学习结果。