@dedenlabs/claude-code-router-cli 2.0.0

package/examples/configs/fixed-router-config.json

@@ -0,0 +1,246 @@
+{
+  "LOG": false,
+  "LOG_LEVEL": "info",
+  "CLAUDE_PATH": "",
+  "HOST": "127.0.0.1",
+  "PORT": 3456,
+  "APIKEY": "sk-anything",
+  "API_TIMEOUT_MS": "600000",
+  "PROXY_URL": "",
+  "transformers": [
+    {
+      "name": "",
+      "path": "./transformers/glm-thinking.js",
+      "options": {
+        "enabled": "true",
+        "debug": "true"
+      }
+    }
+  ],
+  "Providers": [
+    {
+      "name": "haiku-minimax",
+      "api_base_url": "https://api.minimaxi.com/anthropic/v1/messages",
+      "api_key": "YOUR_MINIMAX_API_KEY",
+      "models": [
+        "MiniMax-M2"
+      ],
+      "transformer": {
+        "use": [
+          "Anthropic"
+        ]
+      }
+    },
+    {
+      "name": "sonnet-minimax",
+      "api_base_url": "https://api.minimaxi.com/anthropic/v1/messages",
+      "api_key": "YOUR_MINIMAX_API_KEY",
+      "models": [
+        "MiniMax-M2"
+      ],
+      "transformer": {
+        "use": [
+          "Anthropic"
+        ]
+      }
+    },
+    {
+      "name": "opus-minimax",
+      "api_base_url": "https://api.minimaxi.com/anthropic/v1/messages",
+      "api_key": "YOUR_MINIMAX_API_KEY",
+      "models": [
+        "MiniMax-M2"
+      ],
+      "transformer": {
+        "use": [
+          "Anthropic"
+        ]
+      }
+    },
+    {
+      "name": "haiku-glm",
+      "api_base_url": "https://open.bigmodel.cn/api/anthropic/v1/messages",
+      "api_key": "YOUR_GLM_API_KEY",
+      "models": [
+        "glm-4.6"
+      ],
+      "transformer": {
+        "use": [
+          "Anthropic"
+        ]
+      }
+    },
+    {
+      "name": "sonnet-glm",
+      "api_base_url": "https://open.bigmodel.cn/api/anthropic/v1/messages",
+      "api_key": "YOUR_GLM_API_KEY",
+      "models": [
+        "glm-4.6"
+      ],
+      "transformer": {
+        "use": [
+          "Anthropic"
+        ]
+      }
+    },
+    {
+      "name": "opus-glm",
+      "api_base_url": "https://api.z.ai/api/coding/paas/v4/chat/completions",
+      "api_key": "YOUR_GLM_API_KEY",
+      "models": [
+        "glm-4.6"
+      ],
+      "transformer": {
+        "use": [
+          "reasoning",
+          "glm-thinking"
+        ]
+      }
+    },
+    {
+      "name": "opus-openrouter",
+      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
+      "api_key": "api-key",
+      "models": [
+        "anthropic/claude-4.5-sonnet:thinking",
+        "google/gemini-2.5-pro-preview"
+      ],
+      "transformer": {
+        "use": [
+          "openrouter"
+        ]
+      }
+    }
+  ],
+  "Router": {
+    "engine": "unified",
+    "defaultRoute": "sonnet",
+    "rules": [
+      {
+        "name": "用户指定规则",
+        "condition": {
+          "type": "custom",
+          "customFunction": "modelContainsComma"
+        },
+        "action": {
+          "route": "${userModel}",
+          "description": "用户指定路由：用户在请求中直接指定provider,model格式"
+        },
+        "priority": 200,
+        "enabled": true
+      },
+      {
+        "name": "提供商映射规则",
+        "condition": {
+          "type": "custom",
+          "customFunction": "directModelMapping"
+        },
+        "action": {
+          "route": "${mappedModel}",
+          "description": "提供商映射：将用户指定的模型名映射到对应的provider格式"
+        },
+        "priority": 190,
+        "enabled": true
+      },
+      {
+        "name": "长上下文规则",
+        "condition": {
+          "type": "tokenThreshold",
+          "value": 180000,
+          "operator": "gt"
+        },
+        "action": {
+          "route": "sonnet",
+          "description": "长上下文路由：基于token阈值选择模型"
+        },
+        "priority": 100,
+        "enabled": true
+      },
+      {
+        "name": "子代理规则",
+        "condition": {
+          "type": "fieldExists",
+          "field": "system.1.text",
+          "value": "<CCR-SUBAGENT-MODEL>",
+          "operator": "contains"
+        },
+        "action": {
+          "route": "${subagent}",
+          "description": "子代理路由：通过特殊标记选择模型"
+        },
+        "priority": 90,
+        "enabled": true
+      },
+      {
+        "name": "后台规则",
+        "condition": {
+          "type": "modelContains",
+          "value": "haiku",
+          "operator": "contains"
+        },
+        "action": {
+          "route": "haiku",
+          "description": "后台路由：Haiku模型自动使用轻量级模型"
+        },
+        "priority": 80,
+        "enabled": true
+      },
+      {
+        "name": "网络搜索规则",
+        "condition": {
+          "type": "toolExists",
+          "value": "web_search",
+          "operator": "exists"
+        },
+        "action": {
+          "route": "sonnet",
+          "description": "网络搜索路由：检测到web_search工具时使用特定模型"
+        },
+        "priority": 70,
+        "enabled": true
+      },
+      {
+        "name": "思考规则",
+        "condition": {
+          "type": "fieldExists",
+          "field": "thinking",
+          "value": true,
+          "operator": "eq"
+        },
+        "action": {
+          "route": "opus",
+          "description": "思考路由：启用thinking参数时使用特定模型"
+        },
+        "priority": 60,
+        "enabled": true
+      }
+    ],
+    "contextThreshold": {
+      "default": 60000,
+      "longContext": 180000
+    },
+    "cache": {
+      "enabled": true,
+      "ttl": 300000,
+      "maxSize": 1000
+    },
+    "debug": {
+      "enabled": true,
+      "logLevel": "info"
+    }
+  },
+  "StatusLine": {
+    "enabled": false,
+    "currentStyle": "default",
+    "default": {
+      "modules": []
+    },
+    "powerline": {
+      "modules": []
+    }
+  },
+  "CUSTOM_ROUTER_PATH": "",
+  "OPENAI_API_KEY": "",
+  "OPENAI_BASE_URL": "",
+  "OPENAI_MODEL": ""
+}

package/examples/configs/unified-router-example.json

@@ -0,0 +1,171 @@
+{
+  "LOG": true,
+  "HOST": "127.0.0.1",
+  "PORT": 8080,
+  "APIKEY": "1",
+  "API_TIMEOUT_MS": 600000,
+  "Providers": [
+    {
+      "name": "openrouter",
+      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
+      "api_key": "sk-or-v1-",
+      "models": [
+        "anthropic/claude-3.5-sonnet",
+        "anthropic/claude-3.7-sonnet:thinking",
+        "deepseek/deepseek-chat-v3-0324",
+        "@preset/kimi"
+      ],
+      "transformer": {
+        "use": ["openrouter"],
+        "deepseek/deepseek-chat-v3-0324": {
+          "use": ["tooluse"]
+        }
+      }
+    },
+    {
+      "name": "deepseek",
+      "api_base_url": "https://api.deepseek.com/chat/completions",
+      "api_key": "sk-",
+      "models": [
+        "deepseek-chat",
+        "deepseek-reasoner"
+      ],
+      "transformer": {
+        "use": ["deepseek"],
+        "deepseek-chat": {
+          "use": ["tooluse"]
+        }
+      }
+    },
+    {
+      "name": "gemini",
+      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
+      "api_key": "",
+      "models": [
+        "gemini-2.5-flash",
+        "gemini-2.5-pro"
+      ],
+      "transformer": {
+        "use": ["gemini"]
+      }
+    }
+  ],
+  "Router": {
+    "engine": "unified",
+    "defaultRoute": "openrouter,anthropic/claude-3.5-sonnet",
+    "rules": [
+      {
+        "name": "longContext",
+        "priority": 100,
+        "enabled": true,
+        "condition": {
+          "type": "tokenThreshold",
+          "value": 60000,
+          "operator": "gt"
+        },
+        "action": {
+          "route": "gemini,gemini-2.5-pro",
+          "transformers": []
+        }
+      },
+      {
+        "name": "subagent",
+        "priority": 90,
+        "enabled": true,
+        "condition": {
+          "type": "fieldExists",
+          "field": "system.1.text",
+          "operator": "exists"
+        },
+        "action": {
+          "route": "${subagent}",
+          "transformers": []
+        }
+      },
+      {
+        "name": "background",
+        "priority": 80,
+        "enabled": true,
+        "condition": {
+          "type": "modelContains",
+          "value": "haiku",
+          "operator": "contains"
+        },
+        "action": {
+          "route": "openrouter,@preset/kimi",
+          "transformers": []
+        }
+      },
+      {
+        "name": "webSearch",
+        "priority": 70,
+        "enabled": true,
+        "condition": {
+          "type": "toolExists",
+          "value": "web_search",
+          "operator": "exists"
+        },
+        "action": {
+          "route": "gemini,gemini-2.5-flash",
+          "transformers": []
+        }
+      },
+      {
+        "name": "thinking",
+        "priority": 60,
+        "enabled": true,
+        "condition": {
+          "type": "fieldExists",
+          "field": "thinking",
+          "operator": "exists"
+        },
+        "action": {
+          "route": "deepseek,deepseek-reasoner",
+          "transformers": []
+        }
+      },
+      {
+        "name": "directMapping",
+        "priority": 50,
+        "enabled": true,
+        "condition": {
+          "type": "custom",
+          "customFunction": "directModelMapping"
+        },
+        "action": {
+          "route": "${mappedModel}",
+          "transformers": []
+        }
+      },
+      {
+        "name": "userSpecified",
+        "priority": 40,
+        "enabled": true,
+        "condition": {
+          "type": "custom",
+          "customFunction": "modelContainsComma"
+        },
+        "action": {
+          "route": "${userModel}",
+          "transformers": []
+        }
+      }
+    ],
+    "cache": {
+      "enabled": true,
+      "maxSize": 1000,
+      "ttl": 300000
+    },
+    "debug": {
+      "enabled": false,
+      "logLevel": "info",
+      "logToFile": true,
+      "logToConsole": true
+    },
+    "contextThreshold": {
+      "default": 1000,
+      "longContext": 60000
+    }
+  },
+  "NON_INTERACTIVE_MODE": false
+}

package/examples/external-rules/complex-routing.js

@@ -0,0 +1,116 @@
+/**
+ * 复杂路由规则示例
+ * 演示如何组合多个条件进行路由决策
+ */
+
+/**
+ * 评估复杂的路由条件
+ * @param {RouteContext} context - 路由上下文
+ * @returns {boolean} - 路由决策结果
+ */
+function evaluateComplexCondition(context) {
+  // 获取请求信息
+  const request = context.req;
+  const messages = context.messages || [];
+  const tools = context.tools || [];
+
+  // 条件1：检查是否为复杂任务
+  const isComplexTask = checkComplexity(messages);
+
+  // 条件2：检查是否使用了特定工具
+  const hasCodeTools = checkCodeTools(tools);
+
+  // 条件3：检查token数量
+  const hasLongContext = context.tokenCount > 10000;
+
+  // 条件4：检查是否有系统指令
+  const hasSystemInstruction = checkSystemInstruction(context);
+
+  // 组合决策逻辑
+  const score = calculateRouteScore({
+    complexity: isComplexTask,
+    hasCode: hasCodeTools,
+    longContext: hasLongContext,
+    hasSystem: hasSystemInstruction
+  });
+
+  console.log(`复杂路由评估:`, {
+    complexity: isComplexTask,
+    hasCode: hasCodeTools,
+    longContext: hasLongContext,
+    hasSystem: hasSystemInstruction,
+    score
+  });
+
+  // 分数超过3分使用高级模型
+  return score >= 3;
+}
+
+/**
+ * 检查任务复杂度
+ */
+function checkComplexity(messages) {
+  const userMessages = messages.filter(m => m.role === 'user');
+
+  if (userMessages.length === 0) return false;
+
+  const lastMessage = userMessages[userMessages.length - 1];
+  const content = typeof lastMessage.content === 'string'
+    ? lastMessage.content
+    : lastMessage.content.map(item => item.text).join('');
+
+  // 简单的复杂度指标
+  const indicators = [
+    content.includes('分析') || content.includes('设计'),
+    content.includes('实现') || content.includes('开发'),
+    content.includes('优化') || content.includes('重构'),
+    content.length > 500, // 长文本
+    (content.match(/[？?]/g) || []).length > 3 // 多个问题
+  ];
+
+  return indicators.filter(Boolean).length >= 2;
+}
+
+/**
+ * 检查是否包含代码相关工具
+ */
+function checkCodeTools(tools) {
+  const codeToolNames = ['code_interpreter', 'run_code', 'execute', 'bash', 'terminal'];
+  return tools.some(tool => {
+    const toolName = tool.type || tool.function?.name || '';
+    return codeToolNames.includes(toolName);
+  });
+}
+
+/**
+ * 检查是否有系统指令
+ */
+function checkSystemInstruction(context) {
+  if (!context.system || context.system.length === 0) return false;
+
+  const systemText = typeof context.system[0] === 'string'
+    ? context.system[0]
+    : context.system[0]?.text || '';
+
+  const instructionKeywords = ['请', '必须', '要求', '确保', '严格'];
+  return instructionKeywords.some(keyword => systemText.includes(keyword));
+}
+
+/**
+ * 计算路由分数
+ */
+function calculateRouteScore(factors) {
+  let score = 0;
+
+  if (factors.complexity) score += 1;
+  if (factors.hasCode) score += 1;
+  if (factors.longContext) score += 1;
+  if (factors.hasSystem) score += 1;
+
+  return score;
+}
+
+// 导出函数
+module.exports = {
+  evaluateComplexCondition
+};

package/examples/external-rules/time-based.js

@@ -0,0 +1,51 @@
+/**
+ * 基于时间的路由规则
+ * 根据当前时间决定使用不同的模型
+ */
+
+/**
+ * 检查是否为工作时间
+ * @param {RouteContext} context - 路由上下文
+ * @returns {boolean} - 是否为工作时间
+ */
+function isBusinessHours(context) {
+  const now = new Date();
+  const hour = now.getHours();
+  const dayOfWeek = now.getDay(); // 0=周日, 1=周一, ..., 6=周六
+
+  // 工作时间：周一到周五，9:00-18:00
+  const isWeekday = dayOfWeek >= 1 && dayOfWeek <= 5;
+  const isWorkHour = hour >= 9 && hour < 18;
+
+  const inBusinessHours = isWeekday && isWorkHour;
+
+  console.log(`时间检查: ${now.toISOString()}, 小时: ${hour}, 星期${dayOfWeek}, 工作时间: ${inBusinessHours}`);
+
+  return inBusinessHours;
+}
+
+/**
+ * 检查是否为高峰时段
+ * @param {RouteContext} context - 路由上下文
+ * @returns {boolean} - 是否为高峰时段
+ */
+function isPeakHours(context) {
+  const now = new Date();
+  const hour = now.getHours();
+
+  // 高峰时段：9:00-11:00 和 14:00-17:00
+  const isMorningPeak = hour >= 9 && hour < 11;
+  const isAfternoonPeak = hour >= 14 && hour < 17;
+
+  const isPeakHours = isMorningPeak || isAfternoonPeak;
+
+  console.log(`高峰时段检查: 当前${hour}点，高峰: ${isPeakHours}`);
+
+  return isPeakHours;
+}
+
+// 导出多个函数
+module.exports = {
+  isBusinessHours,
+  isPeakHours
+};

package/examples/external-rules/user-preference.js

@@ -0,0 +1,70 @@
+/**
+ * 用户偏好路由规则
+ * 根据用户的系统消息中保存的偏好设置进行路由
+ */
+
+// 模拟用户偏好数据库
+const userPreferences = {
+  'user@example.com': {
+    preferredModel: 'gpt-4',
+    provider: 'openai'
+  },
+  'admin@example.com': {
+    preferredModel: 'claude-3-opus',
+    provider: 'anthropic'
+  }
+};
+
+/**
+ * 检查用户偏好
+ * @param {RouteContext} context - 路由上下文
+ * @returns {boolean} - 是否匹配用户偏好
+ */
+function checkUserPreference(context) {
+  // 从系统消息或会话信息中提取用户标识
+  const userEmail = extractUserEmail(context);
+
+  if (!userEmail) {
+    console.log(`无法识别用户邮箱，使用默认路由`);
+    return false;
+  }
+
+  const preference = userPreferences[userEmail];
+  if (!preference) {
+    console.log(`用户 ${userEmail} 没有设置偏好，使用默认路由`);
+    return false;
+  }
+
+  // 记录匹配结果
+  console.log(`用户偏好匹配: ${userEmail} -> ${preference.provider}/${preference.preferredModel}`);
+  return true;
+}
+
+/**
+ * 从上下文中提取用户邮箱
+ */
+function extractUserEmail(context) {
+  // 尝试从多个可能的来源获取用户邮箱
+  if (context.req?.headers?.['x-user-email']) {
+    return context.req.headers['x-user-email'];
+  }
+
+  if (context.sessionId && context.sessionId.includes('@')) {
+    return context.sessionId;
+  }
+
+  // 可以从系统消息中解析
+  if (context.system && context.system[0]?.text) {
+    const emailMatch = context.system[0].text.match(/user:\s*([^\s]+)/);
+    if (emailMatch) {
+      return emailMatch[1];
+    }
+  }
+
+  return null;
+}
+
+// 导出函数
+module.exports = {
+  checkUserPreference
+};