Model Router Hook V4

智能模型路由系统 - 自动根据任务复杂度选择最优 AI 模型。

快速开始

from model_router_hook import create_router

# 创建路由器
router = create_router(
    user_id="user_001",
    daily_budget=5.0  # 每日预算 5 美元
)

# 处理用户输入 - 自动路由并切换模型
result = router.on_user_input("帮我写个快排算法")
# 返回: {'mode': 'thinking', 'model': 'kimi-coding/kimi-k2-thinking', ...}

# 回复完成后 - 自动反思学习
router.on_response_complete(
    user_input="帮我写个快排",
    response=generated_response,
    user_next_input=user_next_message
)

# 记录实际成本
router.record_actual_cost(tokens_in=1500, tokens_out=800, 
                         actual_cost=0.005, latency_ms=1200)

系统架构

P0-P5 核心层

优化A-G

• A: OpenClaw 集成 - 真正调用 session_status
• B: 实际成本追踪 - 支持 API 实际成本
• C: P3 质量评估增强 - 自动检测回复质量
• D: A/B 测试框架 - 策略效果量化
• E: 并发安全 - 线程锁+原子操作
• F: 降级容错 - 错误时自动 fallback
• G: 实时仪表板 - 监控与学习进度

详细使用指南

基础使用

from model_router_hook import create_router

router = create_router(
    user_id="my_user",           # 用户ID，用于全局画像
    daily_budget=10.0,           # 每日预算（美元）
    enable_ab_test=False         # 是否开启 A/B 测试
)

# 处理输入
result = router.on_user_input("帮我分析这个架构")
print(result['mode'])          # 'thinking' 或 'fast'
print(result['switched'])      # 是否发生了切换
print(result['decision_log'])  # 决策原因

# 结束会话（保存学习成果）
router.end_session()

在 OpenClaw 中集成

class SmartAgent:
    def __init__(self):
        self.router = create_router(
            user_id="agent_main",
            daily_budget=10.0
        )
    
    async def on_message(self, user_input: str):
        # 1. 自动路由决策
        result = self.router.on_user_input(user_input)
        
        # 2. 使用当前模型生成回复
        response = await self.generate_response(user_input)
        
        # 3. 等待下一条消息，然后反思
        next_input = await self.wait_for_next_message()
        self.router.on_response_complete(
            user_input, response, next_input
        )
        
        return response

API 参考

详见 scripts/model_router.py 完整代码。

主要类：

• ModelRouterHook: 主路由器类
• SessionMemory: 会话记忆
• GlobalUserMemory: 全局用户画像
• CostControllerV2: 成本控制器
• ResponseQualityEvaluator: 质量评估器
• Dashboard: 实时仪表板

文件结构

model-router-hook/
├── SKILL.md                    # 本文件
└── scripts/
    └── model_router.py         # 主代码 (894行)

存储位置

数据自动存储在：

• ~/.openclaw/workspace/memory/model-router/
  • user_{id}_profile.json - 全局用户画像
  • session_{id}_memory.json - 会话记忆
  • cost_{user}_{month}.jsonl - 成本记录

测试状态

✅ 全部测试通过 (10/10)

• 意图识别: 14/14 (100%)
• 复杂度分析: 5/5 (100%)
• 成本控制器: ✅
• 质量评估: ✅
• OpenClaw 集成: ✅
• 路由器流程: 4/4 (100%)
• 降级容错: ✅
• 并发安全: ✅

生产就绪！

Version: V4.0
Code: 894 lines, 33.9KB
Date: 2026-03-04