@dedenlabs/claude-code-router-cli 2.0.0

package/dist/transformers/glm-thinking.js

@@ -0,0 +1,130 @@
+"use strict";
+
+// src/transformers/glm-thinking.ts
+var GLMThinkingTransformer = class {
+  name;
+  enabled;
+  debug;
+  constructor(options = {}) {
+    this.name = "glm-thinking";
+    this.enabled = options.enabled !== "false" && options.enabled !== false;
+    this.debug = options.debug !== "false" && options.debug !== false || false;
+    console.log("\u{1F4A1}GLM\u601D\u8003\u6A21\u5F0F\u8F6C\u6362\u5668\u5DF2\u6FC0\u6D3B", { enabled: this.enabled });
+  }
+  /**
+   * 检测思维链类型
+   */
+  detectThinkingType(prompt) {
+    const keywords = {
+      mathematical: ["\u8BA1\u7B97", "\u6570\u5B66", "\u516C\u5F0F", "\u65B9\u7A0B", "\u51E0\u4F55", "\u4EE3\u6570", "calculate", "math", "formula", "\u6C42\u89E3", "\u51FD\u6570", "\u79EF\u5206", "\u5BFC\u6570", "\u6781\u9650", "\u8BC1\u660E\u9898"],
+      logical: ["\u903B\u8F91", "\u63A8\u7406", "\u8BC1\u660E", "\u6F14\u7ECE", "\u5F52\u7EB3", "logic", "reasoning", "proof", "\u63A8\u65AD", "\u5047\u8BBE", "\u7ED3\u8BBA"],
+      causal: ["\u539F\u56E0", "\u7ED3\u679C", "\u56E0\u679C", "\u5F71\u54CD", "\u5BFC\u81F4", "cause", "effect", "impact", "\u5206\u6790", "\u9884\u6D4B", "\u5173\u7CFB"],
+      analytical: ["\u5206\u6790", "\u5206\u89E3", "\u8BC4\u4F30", "\u5224\u65AD", "analyze", "evaluate", "assess", "\u6BD4\u8F83", "\u603B\u7ED3", "\u4F18\u7F3A\u70B9"],
+      creative: ["\u521B\u610F", "\u521B\u65B0", "\u60F3\u8C61", "\u8BBE\u8BA1", "creative", "innovative", "design", "\u6784\u601D", "\u4F18\u5316", "\u6539\u8FDB"],
+      strategic: ["\u7B56\u7565", "\u8BA1\u5212", "\u51B3\u7B56", "\u9009\u62E9", "strategy", "plan", "decision", "\u65B9\u6848", "\u5EFA\u8BAE", "\u89C4\u5212"],
+      programming: ["\u4EE3\u7801", "\u7F16\u7A0B", "\u7B97\u6CD5", "\u7A0B\u5E8F", "code", "algorithm", "function", "\u5B9E\u73B0", "\u5F00\u53D1", "\u8C03\u8BD5"],
+      problem_solving: ["\u95EE\u9898", "\u89E3\u51B3", "\u65B9\u6CD5", "\u6B65\u9AA4", "problem", "solve", "solution", "\u601D\u8DEF", "\u6D41\u7A0B"]
+    };
+    for (const [type, words] of Object.entries(keywords)) {
+      const matchedWords = [];
+      const matchCount = words.filter((word) => {
+        if (prompt.toLowerCase().includes(word.toLowerCase())) {
+          matchedWords.push(word);
+          return true;
+        }
+        return false;
+      }).length;
+      if (matchCount > 0) {
+        return type;
+      }
+    }
+    if (this.requiresComplexReasoning(prompt)) {
+      return "logical";
+    }
+    return false;
+  }
+  /**
+   * 判断是否需要复杂推理
+   */
+  requiresComplexReasoning(prompt) {
+    const complexityIndicators = [
+      "\u6B65\u9AA4",
+      "\u6D41\u7A0B",
+      "\u8FC7\u7A0B",
+      "\u65B9\u6CD5",
+      "\u601D\u8DEF",
+      "\u8BE6\u7EC6",
+      "\u89E3\u91CA",
+      "\u4E3A\u4EC0\u4E48",
+      "\u5982\u4F55",
+      "\u600E\u6837",
+      "\u5982\u679C",
+      "\u90A3\u4E48",
+      "\u9996\u5148",
+      "\u5176\u6B21",
+      "\u6700\u540E",
+      "\u6BD4\u8F83",
+      "\u5BF9\u6BD4",
+      "\u9009\u62E9",
+      "\u5224\u65AD",
+      "\u8003\u8651",
+      "\u7EFC\u5408",
+      "\u603B\u7ED3"
+    ];
+    return complexityIndicators.some(
+      (indicator) => prompt.toLowerCase().includes(indicator.toLowerCase())
+    );
+  }
+  /**
+   * 获取用户消息内容
+   */
+  getUserMessage(request) {
+    const messages = request.messages || [];
+    const lastMessage = messages[messages.length - 1];
+    if (!lastMessage || lastMessage.role !== "user") {
+      return "";
+    }
+    if (Array.isArray(lastMessage.content)) {
+      return lastMessage.content.filter((item) => item.type === "text").map((item) => item.text || "").join("\n");
+    }
+    return lastMessage.content || "";
+  }
+  /**
+   * 转换请求输入 - 添加thinking参数
+   */
+  async transformRequestIn(request) {
+    if (!this.enabled) return request;
+    try {
+      const { thinking, ...requestWithoutThinking } = request;
+      const userMessage = this.getUserMessage(requestWithoutThinking);
+      if (this.enabled) {
+        const thinkingType = this.detectThinkingType(userMessage);
+        if (thinkingType) {
+          console.log(`\u{1F4A1} GLM\u601D\u8003\u4E2D... \u542F\u7528${thinkingType}\u7C7B\u578B\u601D\u7EF4\u6A21\u5F0F`);
+          return {
+            ...requestWithoutThinking,
+            thinking: {
+              type: "enabled",
+              category: thinkingType
+            }
+          };
+        }
+      }
+      return requestWithoutThinking;
+    } catch (error) {
+      console.error("\u8F6C\u6362\u8BF7\u6C42\u65F6\u53D1\u751F\u9519\u8BEF", {
+        error: error.message,
+        stack: error.stack
+      });
+      return request;
+    }
+  }
+  /**
+   * 转换响应输出 - 处理thinking响应
+   * 目前暂未实现，预留接口
+   */
+  async transformResponseOut(response) {
+    return response;
+  }
+};
+module.exports = GLMThinkingTransformer;

package/dist/transformers/index.js

@@ -0,0 +1,167 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/transformers/glm-thinking.ts
+var require_glm_thinking = __commonJS({
+  "src/transformers/glm-thinking.ts"(exports2, module2) {
+    "use strict";
+    var GLMThinkingTransformer = class {
+      name;
+      enabled;
+      debug;
+      constructor(options = {}) {
+        this.name = "glm-thinking";
+        this.enabled = options.enabled !== "false" && options.enabled !== false;
+        this.debug = options.debug !== "false" && options.debug !== false || false;
+        console.log("\u{1F4A1}GLM\u601D\u8003\u6A21\u5F0F\u8F6C\u6362\u5668\u5DF2\u6FC0\u6D3B", { enabled: this.enabled });
+      }
+      /**
+       * 检测思维链类型
+       */
+      detectThinkingType(prompt) {
+        const keywords = {
+          mathematical: ["\u8BA1\u7B97", "\u6570\u5B66", "\u516C\u5F0F", "\u65B9\u7A0B", "\u51E0\u4F55", "\u4EE3\u6570", "calculate", "math", "formula", "\u6C42\u89E3", "\u51FD\u6570", "\u79EF\u5206", "\u5BFC\u6570", "\u6781\u9650", "\u8BC1\u660E\u9898"],
+          logical: ["\u903B\u8F91", "\u63A8\u7406", "\u8BC1\u660E", "\u6F14\u7ECE", "\u5F52\u7EB3", "logic", "reasoning", "proof", "\u63A8\u65AD", "\u5047\u8BBE", "\u7ED3\u8BBA"],
+          causal: ["\u539F\u56E0", "\u7ED3\u679C", "\u56E0\u679C", "\u5F71\u54CD", "\u5BFC\u81F4", "cause", "effect", "impact", "\u5206\u6790", "\u9884\u6D4B", "\u5173\u7CFB"],
+          analytical: ["\u5206\u6790", "\u5206\u89E3", "\u8BC4\u4F30", "\u5224\u65AD", "analyze", "evaluate", "assess", "\u6BD4\u8F83", "\u603B\u7ED3", "\u4F18\u7F3A\u70B9"],
+          creative: ["\u521B\u610F", "\u521B\u65B0", "\u60F3\u8C61", "\u8BBE\u8BA1", "creative", "innovative", "design", "\u6784\u601D", "\u4F18\u5316", "\u6539\u8FDB"],
+          strategic: ["\u7B56\u7565", "\u8BA1\u5212", "\u51B3\u7B56", "\u9009\u62E9", "strategy", "plan", "decision", "\u65B9\u6848", "\u5EFA\u8BAE", "\u89C4\u5212"],
+          programming: ["\u4EE3\u7801", "\u7F16\u7A0B", "\u7B97\u6CD5", "\u7A0B\u5E8F", "code", "algorithm", "function", "\u5B9E\u73B0", "\u5F00\u53D1", "\u8C03\u8BD5"],
+          problem_solving: ["\u95EE\u9898", "\u89E3\u51B3", "\u65B9\u6CD5", "\u6B65\u9AA4", "problem", "solve", "solution", "\u601D\u8DEF", "\u6D41\u7A0B"]
+        };
+        for (const [type, words] of Object.entries(keywords)) {
+          const matchedWords = [];
+          const matchCount = words.filter((word) => {
+            if (prompt.toLowerCase().includes(word.toLowerCase())) {
+              matchedWords.push(word);
+              return true;
+            }
+            return false;
+          }).length;
+          if (matchCount > 0) {
+            return type;
+          }
+        }
+        if (this.requiresComplexReasoning(prompt)) {
+          return "logical";
+        }
+        return false;
+      }
+      /**
+       * 判断是否需要复杂推理
+       */
+      requiresComplexReasoning(prompt) {
+        const complexityIndicators = [
+          "\u6B65\u9AA4",
+          "\u6D41\u7A0B",
+          "\u8FC7\u7A0B",
+          "\u65B9\u6CD5",
+          "\u601D\u8DEF",
+          "\u8BE6\u7EC6",
+          "\u89E3\u91CA",
+          "\u4E3A\u4EC0\u4E48",
+          "\u5982\u4F55",
+          "\u600E\u6837",
+          "\u5982\u679C",
+          "\u90A3\u4E48",
+          "\u9996\u5148",
+          "\u5176\u6B21",
+          "\u6700\u540E",
+          "\u6BD4\u8F83",
+          "\u5BF9\u6BD4",
+          "\u9009\u62E9",
+          "\u5224\u65AD",
+          "\u8003\u8651",
+          "\u7EFC\u5408",
+          "\u603B\u7ED3"
+        ];
+        return complexityIndicators.some(
+          (indicator) => prompt.toLowerCase().includes(indicator.toLowerCase())
+        );
+      }
+      /**
+       * 获取用户消息内容
+       */
+      getUserMessage(request) {
+        const messages = request.messages || [];
+        const lastMessage = messages[messages.length - 1];
+        if (!lastMessage || lastMessage.role !== "user") {
+          return "";
+        }
+        if (Array.isArray(lastMessage.content)) {
+          return lastMessage.content.filter((item) => item.type === "text").map((item) => item.text || "").join("\n");
+        }
+        return lastMessage.content || "";
+      }
+      /**
+       * 转换请求输入 - 添加thinking参数
+       */
+      async transformRequestIn(request) {
+        if (!this.enabled) return request;
+        try {
+          const { thinking, ...requestWithoutThinking } = request;
+          const userMessage = this.getUserMessage(requestWithoutThinking);
+          if (this.enabled) {
+            const thinkingType = this.detectThinkingType(userMessage);
+            if (thinkingType) {
+              console.log(`\u{1F4A1} GLM\u601D\u8003\u4E2D... \u542F\u7528${thinkingType}\u7C7B\u578B\u601D\u7EF4\u6A21\u5F0F`);
+              return {
+                ...requestWithoutThinking,
+                thinking: {
+                  type: "enabled",
+                  category: thinkingType
+                }
+              };
+            }
+          }
+          return requestWithoutThinking;
+        } catch (error) {
+          console.error("\u8F6C\u6362\u8BF7\u6C42\u65F6\u53D1\u751F\u9519\u8BEF", {
+            error: error.message,
+            stack: error.stack
+          });
+          return request;
+        }
+      }
+      /**
+       * 转换响应输出 - 处理thinking响应
+       * 目前暂未实现，预留接口
+       */
+      async transformResponseOut(response) {
+        return response;
+      }
+    };
+    module2.exports = GLMThinkingTransformer;
+  }
+});
+
+// src/transformers/index.ts
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, __toESM(require_glm_thinking()), module.exports);

package/examples/README-External-Rules.md

@@ -0,0 +1,166 @@
+# 外部规则功能说明
+
+## 概述
+
+统一路由引擎支持通过 `externalFunction` 条件类型加载外部 JavaScript 文件中的自定义规则。这使得路由系统更加灵活，可以动态加载和执行复杂的业务逻辑。
+
+## 功能特点
+
+1. **动态加载**：运行时动态导入外部 JS 文件
+2. **函数执行**：支持调用外部文件中的指定函数
+3. **错误处理**：完善的错误捕获和日志记录
+4. **安全检查**：验证函数类型和返回值
+
+## 使用方法
+
+### 1. 定义外部规则
+
+在配置文件中，使用 `externalFunction` 条件类型：
+
+```json
+{
+  "name": "规则名称",
+  "condition": {
+    "type": "externalFunction",
+    "externalFunction": {
+      "path": "./path/to/external/rule.js",
+      "functionName": "functionName"
+    }
+  },
+  "action": {
+    "route": "target-route"
+  }
+}
+```
+
+### 2. 外部规则文件格式
+
+外部 JS 文件需要导出一个或多个函数：
+
+```javascript
+// single-function-export.js
+function myCondition(context) {
+  // 实现你的逻辑
+  return true; // 返回布尔值
+}
+
+module.exports = {
+  myCondition
+};
+```
+
+或使用 ES6 模块语法：
+
+```javascript
+// multi-function-export.js
+export function condition1(context) {
+  return context.tokenCount > 1000;
+}
+
+export function condition2(context) {
+  return context.req?.headers?.['x-premium'] === 'true';
+}
+```
+
+### 3. 上下文参数
+
+外部函数接收一个 `RouteContext` 对象，包含：
+
+- `tokenCount`: Token 数量
+- `messages`: 消息数组
+- `system`: 系统消息
+- `tools`: 工具数组
+- `sessionId`: 会话 ID
+- `lastUsage`: 上次使用记录
+- `log`: 日志对象
+- `event`: 事件对象
+- `req`: 完整请求对象
+
+## 示例规则
+
+### 1. 用户偏好路由
+
+根据用户邮箱或ID路由到偏好模型：
+
+```javascript
+// user-preference.js
+const userPreferences = {
+  'user@example.com': { provider: 'openai', model: 'gpt-4' },
+  'admin@example.com': { provider: 'anthropic', model: 'claude-3' }
+};
+
+function checkUserPreference(context) {
+  const userEmail = extractUserEmail(context);
+  const preference = userPreferences[userEmail];
+  return preference !== undefined;
+}
+```
+
+### 2. 时间路由
+
+根据当前时间路由到不同模型：
+
+```javascript
+// time-based.js
+function isBusinessHours(context) {
+  const hour = new Date().getHours();
+  const isWeekday = [1,2,3,4,5].includes(new Date().getDay());
+  return isWeekday && hour >= 9 && hour < 18;
+}
+```
+
+### 3. 复杂条件路由
+
+组合多个条件进行决策：
+
+```javascript
+// complex-routing.js
+function evaluateComplexCondition(context) {
+  const hasCodeTools = checkForCodeTools(context.tools);
+  const isComplexTask = analyzeComplexity(context.messages);
+  const hasLongContext = context.tokenCount > 10000;
+
+  return hasCodeTools && isComplexTask && hasLongContext;
+}
+```
+
+## 最佳实践
+
+1. **错误处理**：始终使用 try-catch 包装可能出错的代码
+2. **日志记录**：使用 `console.log` 记录调试信息
+3. **返回值**：确保返回布尔值，路由系统会自动转换
+4. **模块化**：将相关逻辑分组到不同文件
+5. **测试**：在生产环境使用前充分测试
+
+## 安全考虑
+
+1. **路径验证**：系统会验证文件路径的合法性
+2. **函数检查**：确保导出的是有效函数
+3. **执行隔离**：外部函数错误不会影响主路由系统
+4. **日志审计**：所有执行都会被记录
+
+## 加载机制
+
+1. 系统在评估规则时动态 `import()` 外部模块
+2. 支持相对路径（相对于配置文件）
+3. 缓存机制：导入的模块会被 Node.js 缓存
+4. 异步支持：外部函数可以是异步的
+
+## 调试技巧
+
+在配置中启用调试模式可以看到详细的外部函数执行日志：
+
+```json
+{
+  "debug": {
+    "enabled": true,
+    "logLevel": "debug"
+  }
+}
+```
+
+日志会显示：
+- 外部函数路径
+- 执行参数
+- 返回结果
+- 任何错误信息

package/examples/config-with-external-rules.json

@@ -0,0 +1,82 @@
+{
+  "engine": "unified",
+  "defaultRoute": "gpt-4,openai",
+  "rules": [
+    {
+      "name": "userPreferenceRouting",
+      "priority": 100,
+      "enabled": true,
+      "condition": {
+        "type": "externalFunction",
+        "externalFunction": {
+          "path": "./external-rules/user-preference.js",
+          "functionName": "checkUserPreference"
+        }
+      },
+      "action": {
+        "route": "gpt-4,openai"
+      }
+    },
+    {
+      "name": "timeBasedRouting",
+      "priority": 90,
+      "enabled": true,
+      "condition": {
+        "type": "externalFunction",
+        "externalFunction": {
+          "path": "./external-rules/time-based.js",
+          "functionName": "isBusinessHours"
+        }
+      },
+      "action": {
+        "route": "claude-3-opus,anthropic"
+      }
+    },
+    {
+      "name": "peakHoursRouting",
+      "priority": 85,
+      "enabled": true,
+      "condition": {
+        "type": "externalFunction",
+        "externalFunction": {
+          "path": "./external-rules/time-based.js",
+          "functionName": "isPeakHours"
+        }
+      },
+      "action": {
+        "route": "gemini-pro,google"
+      }
+    },
+    {
+      "name": "complexRouting",
+      "priority": 80,
+      "enabled": true,
+      "condition": {
+        "type": "externalFunction",
+        "externalFunction": {
+          "path": "./external-rules/complex-routing.js",
+          "functionName": "evaluateComplexCondition"
+        }
+      },
+      "action": {
+        "route": "claude-3-sonnet,anthropic"
+      }
+    }
+  ],
+  "cache": {
+    "enabled": true,
+    "maxSize": 1000,
+    "ttl": 300000
+  },
+  "debug": {
+    "enabled": true,
+    "logLevel": "debug",
+    "logToFile": true,
+    "logToConsole": true,
+    "logDir": "./logs"
+  },
+  "contextThreshold": {
+    "default": 1000,
+    "longContext": 60000
+  }
+}