my-ai-chat-framework 1.0.2 → 1.1.0

package/dist/my-ai-chat-framework.browser.es.js

@@ -1,18 +1,14 @@
 class MessageFormatter {
   /**
-   * 将消息转换为标准格式（过滤掉自定义元数据）
+   * 将消息转换为标准格式（不再过滤自定义元数据，只确保必需字段）
    */
   static toStandardFormat(message) {
     const { role, content } = message;
     const standardMessage = { role, content };
-    if (message.reasoning_content) {
-      standardMessage.reasoning_content = message.reasoning_content;
-    }
-    if (message.tool_calls) {
-      standardMessage.tool_calls = message.tool_calls;
-    }
-    if (message.tool_call_id) {
-      standardMessage.tool_call_id = message.tool_call_id;
+    for (const [key, value] of Object.entries(message)) {
+      if (key !== "role" && key !== "content" && value !== void 0) {
+        standardMessage[key] = value;
+      }
     }
     return standardMessage;
   }
@@ -95,6 +91,17 @@ class MessageFormatter {
       }
     };
   }
+  /**
+   * 过滤消息以供API使用（只移除空content的消息，保留所有字段）
+   */
+  static filterForAPI(messages) {
+    return messages.filter((msg) => {
+      if (msg.role === "tool") {
+        return true;
+      }
+      return msg.content !== "" && msg.content !== void 0 && msg.content !== null;
+    });
+  }
 }
 class Messages {
   constructor() {
@@ -111,7 +118,7 @@ class Messages {
   /**
    * 添加消息（通用方法）
    * @param {string} role - 角色：user/assistant/system/tool
-   * @param {string} content - 消息内容
+   * @param {string} content - 消息内容（允许空字符串）
    * @param {object} metadata - 额外元数据
    * @returns {number} 新消息的索引
    */
@@ -125,12 +132,12 @@ class Messages {
         throw new Error("tool消息必须包含tool_call_id");
       }
     } else {
-      if (typeof content !== "string") {
-        throw new Error("消息内容必须是字符串");
-      }
       if (content === void 0 || content === null) {
         throw new Error("消息内容不能为undefined或null");
       }
+      if (typeof content !== "string") {
+        throw new Error("消息内容必须是字符串");
+      }
     }
     const message = {
       role,
@@ -248,16 +255,16 @@ class Messages {
   }
   // ========== 消息修改 ==========
   /**
-   * 更新消息内容
+   * 更新消息内容（允许空字符串）
    */
   updateMessage(index2, content) {
     if (!Number.isInteger(index2) || index2 < 0 || index2 >= this.messages.length) {
       throw new Error(`无效的消息索引: ${index2}`);
     }
-    if (typeof content !== "string" || !content.trim()) {
-      throw new Error("消息内容不能为空");
+    if (typeof content !== "string") {
+      throw new Error("消息内容必须是字符串");
     }
-    this.messages[index2].content = content.trim();
+    this.messages[index2].content = content;
     this.messages[index2].lastModified = /* @__PURE__ */ new Date();
     return this;
   }
@@ -281,6 +288,30 @@ class Messages {
     this.messages[index2].lastModified = /* @__PURE__ */ new Date();
     return this;
   }
+  /**
+   * 批量设置消息字段
+   */
+  setMessageFields(index2, fields) {
+    if (!Number.isInteger(index2) || index2 < 0 || index2 >= this.messages.length) {
+      throw new Error(`无效的消息索引: ${index2}`);
+    }
+    for (const [field, value] of Object.entries(fields)) {
+      if (value !== void 0 && value !== null) {
+        this.messages[index2][field] = value;
+      }
+    }
+    this.messages[index2].lastModified = /* @__PURE__ */ new Date();
+    return this;
+  }
+  /**
+   * 批量更新最后一条消息的字段
+   */
+  updateLastMessageFields(fields) {
+    if (this.messages.length === 0) {
+      throw new Error("没有消息可以修改");
+    }
+    return this.setMessageFields(this.messages.length - 1, fields);
+  }
   // ========== 消息删除 ==========
   /**
    * 删除消息
@@ -791,9 +822,10 @@ class RequestBuilder {
       baseRounds,
       cycleRounds
     );
+    const filteredMessages = MessageFormatter.filterForAPI(formattedMessages);
     const request = {
       model: this.model,
-      messages: formattedMessages,
+      messages: filteredMessages,
       ...this.config
     };
     let tools = [];
@@ -2052,8 +2084,8 @@ function requireAxios$1() {
   var Axios = requireAxios$2();
   var mergeConfig2 = requireMergeConfig();
   var defaults = requireDefaults();
-  function createInstance(defaultConfig) {
-    var context = new Axios(defaultConfig);
+  function createInstance(defaultConfig2) {
+    var context = new Axios(defaultConfig2);
     var instance = bind2(Axios.prototype.request, context);
     utils2.extend(instance, Axios.prototype, context);
     utils2.extend(instance, context);
@@ -2142,12 +2174,14 @@ class ApiClient extends EventEmitter {
       this.cancelTokenSource = null;
     }
   }
-  async strSend(body, onProgress = () => {
-  }, onDone = () => {
-  }) {
+  async strSend(body, onProgress, onDone) {
     this.isGenerating = true;
     this.cancelTokenSource = axios.CancelToken.source();
     try {
+      const safeOnProgress = typeof onProgress === "function" ? onProgress : () => {
+      };
+      const safeOnDone = typeof onDone === "function" ? onDone : () => {
+      };
       this.emit("stream-start", { body });
       const requestBody = this._buildRequestBody(body);
       const response = await fetch(this.url, {
@@ -2167,10 +2201,20 @@ class ApiClient extends EventEmitter {
       const decoder = new TextDecoder();
       let buffer = "";
       const message = {
+        // 基础信息（符合Messages格式）
+        role: "assistant",
         content: "",
         reasoning_content: "",
-        tool_calls: []
-        // 新增：收集工具调用
+        timestamp: /* @__PURE__ */ new Date(),
+        // 工具调用
+        tool_calls: [],
+        // 流式元数据
+        streamMetadata: {
+          chunkCount: 0,
+          firstChunkTime: Date.now(),
+          lastChunkTime: null,
+          isStreaming: true
+        }
       };
       while (true) {
         const { done, value } = await reader.read();
@@ -2183,12 +2227,14 @@ class ApiClient extends EventEmitter {
           if (!cleanChunk) continue;
           if (cleanChunk === "[DONE]") {
             this.emit("stream-done", { message });
-            onDone({ ...message });
+            safeOnDone({ ...message });
             return;
           }
           try {
             const obj = JSON.parse(cleanChunk);
             console.log("🔍 收到流式chunk:", obj);
+            message.streamMetadata.chunkCount++;
+            message.streamMetadata.lastChunkTime = Date.now();
             if (obj.choices?.[0]?.delta?.content) {
               message.content += obj.choices[0].delta.content;
             }
@@ -2217,8 +2263,12 @@ class ApiClient extends EventEmitter {
                 }
               });
             }
-            this.emit("stream-chunk", { chunk: obj, message });
-            onProgress({ ...message });
+            this.emit("stream-chunk", {
+              chunk: obj,
+              message: { ...message }
+              // 发送副本
+            });
+            safeOnProgress({ ...message });
           } catch (e) {
             console.error("🔍 解析chunk错误:", e, "原始数据:", cleanChunk);
           }
@@ -2227,8 +2277,10 @@ class ApiClient extends EventEmitter {
           break;
         }
       }
-      this.emit("stream-done", { message });
-      onDone({ ...message });
+      message.streamMetadata.isStreaming = false;
+      message.streamMetadata.completedAt = /* @__PURE__ */ new Date();
+      this.emit("stream-done", { message: { ...message } });
+      safeOnDone({ ...message });
     } catch (error) {
       if (error.name === "AbortError" || axios.isCancel(error)) {
         const cancelError = new Error("请求被中断");
@@ -2312,15 +2364,227 @@ class ApiClient extends EventEmitter {
     throw new Error("无法识别的聊天数据格式");
   }
 }
+class ConfigManager extends EventEmitter {
+  constructor(defaultConfig2 = {}) {
+    super();
+    this._config = JSON.parse(JSON.stringify(defaultConfig2));
+    this._handlers = /* @__PURE__ */ new Map();
+    this.config = this._createProxy(this._config);
+  }
+  /**
+   * 创建配置代理
+   */
+  _createProxy(target, path = "") {
+    return new Proxy(target, {
+      set: (obj, prop, value) => {
+        const oldValue = obj[prop];
+        const fullPath = path ? `${path}.${prop}` : prop;
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+          value = this._createProxy(value, fullPath);
+        }
+        obj[prop] = value;
+        this._triggerChange(fullPath, oldValue, value);
+        return true;
+      },
+      deleteProperty: (obj, prop) => {
+        const oldValue = obj[prop];
+        const fullPath = path ? `${path}.${prop}` : prop;
+        delete obj[prop];
+        this.emit("config-deleted", {
+          path: fullPath,
+          oldValue,
+          timestamp: /* @__PURE__ */ new Date()
+        });
+        return true;
+      }
+    });
+  }
+  /**
+   * 注册配置处理器
+   */
+  registerHandler(path, handler) {
+    if (!this._handlers.has(path)) {
+      this._handlers.set(path, []);
+    }
+    this._handlers.get(path).push(handler);
+    return this;
+  }
+  /**
+   * 移除配置处理器
+   */
+  removeHandler(path, handler) {
+    const handlers = this._handlers.get(path);
+    if (handlers) {
+      const index2 = handlers.indexOf(handler);
+      if (index2 > -1) {
+        handlers.splice(index2, 1);
+      }
+    }
+    return this;
+  }
+  /**
+   * 触发配置变更
+   */
+  _triggerChange(path, oldValue, newValue) {
+    this.emit("config-changed", {
+      path,
+      oldValue,
+      newValue,
+      timestamp: /* @__PURE__ */ new Date()
+    });
+    this.emit(`config-changed:${path}`, {
+      oldValue,
+      newValue,
+      timestamp: /* @__PURE__ */ new Date()
+    });
+    const handlers = this._handlers.get(path);
+    if (handlers) {
+      handlers.forEach((handler) => {
+        try {
+          handler(newValue, oldValue, path);
+        } catch (error) {
+          console.error(`配置处理器执行失败 (${path}):`, error);
+        }
+      });
+    }
+    const pathParts = path.split(".");
+    for (let i = pathParts.length - 1; i >= 0; i--) {
+      const parentPath = pathParts.slice(0, i).join(".");
+      const wildcardPath = parentPath ? `${parentPath}.*` : "*";
+      const parentHandlers = this._handlers.get(wildcardPath);
+      if (parentHandlers) {
+        parentHandlers.forEach((handler) => {
+          try {
+            handler(newValue, oldValue, path);
+          } catch (error) {
+            console.error(`通配符处理器执行失败 (${wildcardPath}):`, error);
+          }
+        });
+      }
+    }
+  }
+  /**
+   * 获取配置快照（非代理版本）
+   */
+  getSnapshot() {
+    return JSON.parse(JSON.stringify(this._config));
+  }
+  /**
+   * 批量更新配置
+   */
+  update(newConfig) {
+    Object.keys(newConfig).forEach((key) => {
+      this.config[key] = newConfig[key];
+    });
+    return this;
+  }
+  /**
+   * 重置为默认值
+   */
+  reset() {
+    const oldConfig = this.getSnapshot();
+    this._config = JSON.parse(JSON.stringify(this._defaultConfig));
+    this.config = this._createProxy(this._config);
+    this.emit("config-reset", {
+      oldConfig,
+      newConfig: this.getSnapshot(),
+      timestamp: /* @__PURE__ */ new Date()
+    });
+    return this;
+  }
+}
+const defaultConfig = {
+  api: {
+    key: "",
+    url: "https://api.deepseek.com/v1/chat/completions",
+    timeout: 3e4
+  },
+  model: {
+    name: "deepseek-chat",
+    temperature: 0.7,
+    // maxTokens: 2000,
+    stream: false,
+    reasoningEffort: "medium"
+  },
+  conversation: {
+    baseRounds: 10,
+    cycleRounds: 5
+  },
+  debug: false
+};
 class ChatService extends EventEmitter {
-  constructor(apiKey, model = "deepseek-chat", config = {}) {
+  constructor(options = {}) {
     super();
+    this.autoAddMessages = options.autoAddMessages ?? true;
+    this.configManager = new ConfigManager({
+      ...defaultConfig,
+      ...options
+    });
     this.messages = new Messages();
-    this.apiClient = new ApiClient(apiKey);
-    this.requestBuilder = new RequestBuilder(model, this.messages, config);
+    this.apiClient = new ApiClient(
+      this.configManager.config.api.key,
+      this.configManager.config.api.url
+    );
+    this.requestBuilder = new RequestBuilder(
+      this.configManager.config.model.name,
+      this.messages,
+      {
+        temperature: this.configManager.config.model.temperature,
+        max_tokens: this.configManager.config.model.maxTokens,
+        stream: this.configManager.config.model.stream,
+        reasoning_effort: this.configManager.config.model.reasoningEffort
+      }
+    );
     this.toolManager = new ToolManager();
+    this._setupConfigHandlers();
     this._setupDefaultListeners();
   }
+  /**
+   * 设置配置变更处理器
+   */
+  _setupConfigHandlers() {
+    this.configManager.registerHandler("api.key", (newValue) => {
+      this.apiClient.setApiKey(newValue);
+    });
+    this.configManager.registerHandler("api.url", (newValue) => {
+      this.apiClient.setApiUrl(newValue);
+    });
+    this.configManager.registerHandler("model.name", (newValue) => {
+      this.requestBuilder.model = newValue;
+    });
+    this.configManager.registerHandler("model.temperature", (newValue) => {
+      this.requestBuilder.config.temperature = newValue;
+    });
+    this.configManager.registerHandler("model.stream", (newValue) => {
+      this.requestBuilder.config.stream = newValue;
+    });
+    this.configManager.registerHandler("debug", (newValue) => {
+      if (newValue) {
+        console.log("🔧 调试模式已启用");
+      }
+    });
+    this.configManager.on("config-changed", (data) => {
+      this.emit("service-config-changed", data);
+    });
+  }
+  /**
+   * 便捷方法：快速设置 API
+   */
+  setApi(key, url) {
+    this.configManager.update({
+      api: { key, url }
+    });
+    return this;
+  }
+  /**
+   * 便捷方法：快速设置模型
+   */
+  setModel(name, temperature = 0.7) {
+    this.configManager.update({
+      model: { name, temperature }
+    });
+    return this;
+  }
   _setupDefaultListeners() {
     this.apiClient.on("request-start", (data) => {
       this.emit("request-start", data);
@@ -2360,7 +2624,8 @@ class ChatService extends EventEmitter {
       this.emit("sending", {
         role: "user",
         content: userMessage,
-        timestamp: /* @__PURE__ */ new Date()
+        timestamp: /* @__PURE__ */ new Date(),
+        eventType: "sending"
       });
       this.messages.addUserMessage(userMessage);
       const requestBody = this.requestBuilder.toJSON(
@@ -2372,7 +2637,8 @@ class ChatService extends EventEmitter {
       if (aiMessage.tool_calls && aiMessage.tool_calls.length > 0) {
         return await this._handleToolCalls(aiMessage);
       } else {
-        return await this._handleNormalResponse(aiMessage);
+        const eventData = await this._handleNormalResponse(aiMessage);
+        return eventData.content;
       }
     } catch (error) {
       this.emit("error", {
@@ -2387,12 +2653,10 @@ class ChatService extends EventEmitter {
    * 处理工具调用（支持循环调用）
    */
   async _handleToolCalls(aiMessage, maxIterations = 5) {
-    console.log("🔍 处理工具调用，aiMessage:", aiMessage);
     let iteration = 0;
     let currentMessage = aiMessage;
     while (iteration < maxIterations) {
       iteration++;
-      console.log(`🔄 工具调用迭代 ${iteration}/${maxIterations}`);
       this.messages.addAssistantMessage(currentMessage.content || "", {
         tool_calls: currentMessage.tool_calls,
         reasoning_content: currentMessage.reasoning_content || ""
@@ -2406,54 +2670,61 @@ class ChatService extends EventEmitter {
         iteration
       });
       const toolResults = await this.toolManager.executeToolCalls(currentMessage.tool_calls);
-      console.log("🔍 工具执行结果:", toolResults);
       for (const result of toolResults) {
-        console.log("🔍 添加工具消息，result:", result);
         this.messages.addToolMessage(
           result.result || result.error || "",
           result.tool_call_id
         );
       }
-      console.log("🔍 当前所有消息:", this.messages.getMessages());
       const requestBody = this.requestBuilder.toJSON();
-      console.log("🔍 第", iteration, "次请求体:", requestBody);
       const response = await this.apiClient.send(requestBody);
       currentMessage = response.choices[0].message;
       if (!currentMessage.tool_calls || currentMessage.tool_calls.length === 0) {
-        console.log("✅ 工具调用完成，AI给出最终回复");
         break;
       }
-      console.log("🔄 AI请求了新的工具调用，继续处理...");
     }
-    this.messages.addAssistantMessage(currentMessage.content || "", {
-      reasoning_content: currentMessage.reasoning_content || ""
-      // ✅ 新增：保存最终思考内容
+    const eventData = await this._handleAssistantResponse(currentMessage, {
+      toolIterations: iteration
     });
-    this.emit("message", {
+    return eventData.content;
+  }
+  /**
+   * 处理助手回复（统一方法，用于普通和流式请求）
+   */
+  async _handleAssistantResponse(aiMessage, options = {}) {
+    const { isStreaming = false, toolIterations = 0, skipAddMessage = false } = options;
+    const shouldAddMessage = this.autoAddMessages && !skipAddMessage;
+    if (shouldAddMessage) {
+      this.messages.addAssistantMessage(aiMessage.content || "", {
+        reasoning_content: aiMessage.reasoning_content
+      });
+    }
+    const eventData = {
+      // 基础字段（Messages格式）
       role: "assistant",
-      content: currentMessage.content,
-      reasoning_content: currentMessage.reasoning_content,
-      // ✅ 新增：包含思考内容
+      content: aiMessage.content || "",
       timestamp: /* @__PURE__ */ new Date(),
-      response: { choices: [{ message: currentMessage }] },
-      toolIterations: iteration
-    });
-    return currentMessage.content;
+      // 扩展字段
+      ...aiMessage.reasoning_content && { reasoning_content: aiMessage.reasoning_content },
+      ...aiMessage.tool_calls && { tool_calls: aiMessage.tool_calls },
+      ...aiMessage.tool_call_id && { tool_call_id: aiMessage.tool_call_id },
+      // 框架元数据
+      isStreaming,
+      toolIterations,
+      eventType: isStreaming ? "stream-complete" : "response-complete",
+      // 保留原始响应（只有普通请求有）
+      ...isStreaming ? {} : {
+        response: { choices: [{ message: aiMessage }] }
+      }
+    };
+    this.emit("message", eventData);
+    return eventData;
   }
   /**
    * 处理普通回复
    */
   async _handleNormalResponse(aiMessage) {
-    this.messages.addAssistantMessage(aiMessage.content || "", {
-      reasoning_content: aiMessage.reasoning_content
-    });
-    this.emit("message", {
-      role: "assistant",
-      content: aiMessage.content,
-      timestamp: /* @__PURE__ */ new Date(),
-      response: { choices: [{ message: aiMessage }] }
-    });
-    return aiMessage.content;
+    return await this._handleAssistantResponse(aiMessage);
   }
   /**
    * 流式发送消息（支持工具调用）
@@ -2463,7 +2734,8 @@ class ChatService extends EventEmitter {
       this.emit("sending", {
         role: "user",
         content: userMessage,
-        timestamp: /* @__PURE__ */ new Date()
+        timestamp: /* @__PURE__ */ new Date(),
+        eventType: "sending"
       });
       this.messages.addUserMessage(userMessage);
       const requestBuilder = new RequestBuilder(this.requestBuilder.model, this.messages, {
@@ -2477,19 +2749,31 @@ class ChatService extends EventEmitter {
       );
       const response = await this.apiClient.strSend(
         requestBody,
-        (chunk) => {
+        // 如果 onProgress 是函数就调用，否则用空函数
+        typeof onProgress === "function" ? (chunk) => {
           this.emit("stream-progress", chunk);
           onProgress(chunk);
+        } : (chunk) => {
+          this.emit("stream-progress", chunk);
         },
-        async (finalMessage) => {
+        typeof onDone === "function" ? async (finalMessage) => {
           if (finalMessage.tool_calls && finalMessage.tool_calls.length > 0) {
             await this._handleStreamToolCalls(finalMessage, onProgress, onDone);
           } else {
-            this.messages.addAssistantMessage(finalMessage.content || "", {
-              reasoning_content: finalMessage.reasoning_content
+            const eventData = await this._handleAssistantResponse(finalMessage, {
+              isStreaming: true,
+              skipAddMessage: true
+            });
+            onDone(eventData);
+          }
+        } : async (finalMessage) => {
+          if (finalMessage.tool_calls && finalMessage.tool_calls.length > 0) {
+            await this._handleStreamToolCalls(finalMessage);
+          } else {
+            await this._handleAssistantResponse(finalMessage, {
+              isStreaming: true,
+              skipAddMessage: true
             });
-            this.emit("stream-done", { message: finalMessage });
-            onDone(finalMessage);
           }
         }
       );
@@ -2531,9 +2815,11 @@ class ChatService extends EventEmitter {
       await new Promise((resolve, reject) => {
         this.apiClient.strSend(
           requestBody,
-          (chunk) => {
+          typeof onProgress === "function" ? (chunk) => {
             this.emit("stream-progress", chunk);
             onProgress(chunk);
+          } : (chunk) => {
+            this.emit("stream-progress", chunk);
           },
           (finalMessage) => {
             currentMessage = finalMessage;
@@ -2549,17 +2835,14 @@ class ChatService extends EventEmitter {
         break;
       }
     }
-    this.messages.addAssistantMessage(currentMessage.content, {
-      reasoning_content: currentMessage.reasoning_content || ""
-      // ✅ 新增：保存最终思考内容
+    const eventData = await this._handleAssistantResponse(currentMessage, {
+      isStreaming: true,
+      toolIterations: iteration,
+      skipAddMessage: true
     });
-    this.emit("stream-done", {
-      message: currentMessage,
-      reasoning_content: currentMessage.reasoning_content,
-      // ✅ 新增：包含思考内容
-      toolIterations: iteration
-    });
-    onDone(currentMessage);
+    if (typeof onDone === "function") {
+      onDone(eventData);
+    }
   }
   /**
    * 撤回消息
@@ -2615,7 +2898,8 @@ const index = {
   EventEmitter,
   MessageFormatter,
   ToolManager,
-  ChatService
+  ChatService,
+  defaultConfig
 };
 export {
   ApiClient,