foliko 1.0.85 → 1.0.87

package/examples/test-chat-debug.js

@@ -0,0 +1,102 @@
+/**
+ * chat() 持续聊天调试测试
+ * 专门测试 chat 方法为什么不返回数据
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== chat() 持续聊天调试测试 ===\n');
+
+  // 创建框架
+  const framework = new Framework({ debug: true });
+
+  // 使用 MiniMax (Agent SDK)
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+
+  // 注册一个简单的测试工具
+  const { z } = require('zod');
+  framework.registerTool({
+    name: 'test_tool',
+    description: '测试工具，返回传入的参数',
+    inputSchema: z.object({
+      msg: z.string().describe('要返回的消息'),
+    }),
+    execute: async (args) => {
+      console.log('[DEBUG] test_tool called with:', args);
+      return `工具收到: ${args.msg}`;
+    },
+  });
+
+  console.log('[Framework] Ready!');
+  console.log('[Tools]', framework.getTools().map((t) => t.name));
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'DebugAgent',
+    systemPrompt: '你是一个有帮助的助手。如果用户要求使用工具，请使用工具。',
+  });
+
+  // 监听所有事件
+  agent.on('tool-call', (tool) => {
+    console.log('[Event] tool-call:', tool.name, tool.args);
+  });
+
+  agent.on('tool-result', (result) => {
+    console.log('[Event] tool-result:', result.name, '->', JSON.stringify(result.result).substring(0, 200));
+  });
+
+  agent.on('error', (err) => {
+    console.error('[Event] error:', err.error);
+  });
+
+  // 测试函数
+  const testChat = async (question, round) => {
+    console.log(`\n========== Round ${round} ==========`);
+    console.log(`[User] ${question}`);
+
+    try {
+      // 打印 result 的完整结构
+      const result = await agent.chat(question);
+      console.log(`\n[DEBUG] result keys:`, Object.keys(result));
+      console.log(`[DEBUG] result:`, JSON.stringify(result, null, 2).substring(0, 500));
+
+      if (result.message) {
+        console.log(`\n[Agent] ${result.message}`);
+      } else {
+        console.log(`\n[WARNING] result.message is empty!`);
+      }
+
+      // 打印当前消息历史长度
+      const chatHandler = agent._chatHandler;
+      if (chatHandler) {
+        console.log(`[DEBUG] _messages.length:`, chatHandler._messages.length);
+        console.log(`[DEBUG] compression count:`, chatHandler._compressionCount);
+      }
+    } catch (err) {
+      console.error(`\n[Error]`, err.message);
+      console.error(err.stack);
+    }
+  };
+
+  // 执行多轮测试
+  await testChat('你好，介绍一下你自己', 1);
+  await testChat('请用 test_tool 工具返回 "hello world"', 2);
+  await testChat('今天天气不错，你觉得呢？', 3);
+  await testChat('帮我计算 123 + 456 等于多少', 4);
+  await testChat('再说一次你的名字', 5);
+
+  console.log('\n========== 测试完成 ==========');
+
+  await framework.destroy();
+}
+
+main().catch(console.error);

package/examples/test-chat-result.js

@@ -0,0 +1,76 @@
+/**
+ * 测试 chat() 返回值的完整结构
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== 测试 chat() 返回值结构 ===\n');
+
+  const framework = new Framework({ debug: true });
+
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+
+  const { z } = require('zod');
+  framework.registerTool({
+    name: 'echo',
+    description: '返回输入的内容',
+    inputSchema: z.object({
+      msg: z.string().describe('要返回的消息'),
+    }),
+    execute: async (args) => {
+      return `工具收到: ${args.msg}`;
+    },
+  });
+
+  console.log('[Framework] Ready!');
+
+  const agent = framework.createAgent({
+    name: 'TestAgent',
+    systemPrompt: '你是一个有帮助的助手。',
+  });
+
+  // 测试 1：简单对话
+  console.log('\n--- 测试 1：简单对话 ---');
+  try {
+    const result = await agent.chat('你好');
+    console.log('[DEBUG] result:', JSON.stringify(result, null, 2));
+    console.log('[DEBUG] result 顶层 keys:', Object.keys(result));
+  } catch (err) {
+    console.error('[Error]', err.message);
+  }
+
+  // 测试 2：触发工具调用
+  console.log('\n--- 测试 2：触发工具调用 ---');
+  try {
+    const result = await agent.chat('请用 echo 工具返回 "hello"');
+    console.log('[DEBUG] result:', JSON.stringify(result, null, 2));
+    console.log('[DEBUG] result 顶层 keys:', Object.keys(result));
+  } catch (err) {
+    console.error('[Error]', err.message);
+  }
+
+  // 测试 3：多次对话（累积上下文）
+  console.log('\n--- 测试 3：多次对话 ---');
+  try {
+    await agent.chat('你好');
+    await agent.chat('今天天气不错');
+    const result = await agent.chat('我刚才说什么了？');
+    console.log('[DEBUG] result:', JSON.stringify(result, null, 2));
+  } catch (err) {
+    console.error('[Error]', err.message);
+  }
+
+  await framework.destroy();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);

package/examples/test-chat-stream-diff.js

@@ -0,0 +1,63 @@
+/**
+ * 测试 chat 和 chatStream 的差异
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+const SessionPlugin = require('../plugins/session-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== 测试 chat vs chatStream 差异 ===\n');
+
+  const framework = new Framework({ debug: false });
+
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+  await framework.loadPlugin(new SessionPlugin());
+
+  const systemPrompt = `你是一个有帮助的助手。`;
+
+  const agent = framework.createAgent({
+    name: 'TestAgent',
+    systemPrompt: systemPrompt,
+  });
+
+  const sessionId = 'test_session';
+  const sessionPlugin = framework.pluginManager.get('session');
+  sessionPlugin.getOrCreateSession(sessionId, { metadata: {} });
+
+  // 测试 chat
+  console.log('--- Test 1: chat() ---');
+  const result1 = await agent.chat('你好，介绍一下自己', { sessionId });
+  console.log('chat result.message length:', result1.message?.length);
+  console.log('chat result.message:', result1.message?.substring(0, 100));
+
+  // 测试 chatStream
+  console.log('\n--- Test 2: chatStream() ---');
+  let streamText = '';
+  for await (const chunk of agent.chatStream('今天天气怎么样？', { sessionId })) {
+    if (chunk.type === 'text') {
+      streamText += chunk.text;
+    }
+  }
+  console.log('chatStream full text length:', streamText.length);
+  console.log('chatStream full text:', streamText.substring(0, 100));
+
+  // 测试更多轮对话后的 chat
+  console.log('\n--- Test 3: 多轮后 chat() ---');
+  await agent.chat('再说一次你的名字', { sessionId });
+  const result3 = await agent.chat('我叫什么？', { sessionId });
+  console.log('chat result.message length:', result3.message?.length);
+  console.log('chat result.message:', result3.message?.substring(0, 100));
+
+  await framework.destroy();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);

package/examples/test-concurrent-chat.js

@@ -0,0 +1,60 @@
+/**
+ * 测试并发 chat 调用
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+const SessionPlugin = require('../plugins/session-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== 测试并发 chat 调用 ===\n');
+
+  const framework = new Framework({ debug: false });
+
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+  await framework.loadPlugin(new SessionPlugin());
+
+  const systemPrompt = `你是一个微信助手。`;
+
+  // 创建一个 agent（模拟单个用户）
+  const agent = framework.createAgent({
+    name: 'WeixinAgent',
+    systemPrompt: systemPrompt,
+  });
+
+  const sessionId = 'weixin_test_user';
+  const sessionPlugin = framework.pluginManager.get('session');
+  sessionPlugin.getOrCreateSession(sessionId, { metadata: { platform: 'weixin' } });
+
+  // 模拟 3 个并发 chat 调用
+  console.log('\n--- 并发发送 3 条消息 ---');
+
+  const results = await Promise.all([
+    agent.chat('你好', { sessionId }),
+    agent.chat('今天天气怎么样？', { sessionId }),
+    agent.chat('帮我查一下天气', { sessionId }),
+  ]);
+
+  console.log('\n--- 结果 ---');
+  for (let i = 0; i < results.length; i++) {
+    const r = results[i];
+    console.log(`[${i}] message length: ${r.message?.length || 'EMPTY'}`);
+    console.log(`[${i}] message: ${r.message?.substring(0, 50) || 'EMPTY'}...`);
+  }
+
+  // 检查 _messages 状态
+  const chatHandler = agent._chatHandler;
+  console.log(`\n[DEBUG] _messages count: ${chatHandler?._messages.length}`);
+
+  await framework.destroy();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);

package/examples/test-long-chat.js

@@ -0,0 +1,77 @@
+/**
+ * 测试长对话压缩场景
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+const SessionPlugin = require('../plugins/session-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== 测试长对话压缩场景 ===\n');
+
+  const framework = new Framework({ debug: false });
+
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+  await framework.loadPlugin(new SessionPlugin());
+
+  const systemPrompt = `你是一个有帮助的助手。`;
+
+  const agent = framework.createAgent({
+    name: 'TestAgent',
+    systemPrompt: systemPrompt,
+  });
+
+  const sessionId = 'test_session';
+  const sessionPlugin = framework.pluginManager.get('session');
+  sessionPlugin.getOrCreateSession(sessionId, { metadata: {} });
+
+  // 发送多条长消息来触发压缩
+  const longContent = `请详细描述以下内容：人工智能的发展历史、现状和未来趋势。包括机器学习、深度学习、自然语言处理等核心技术的发展历程，以及在各个行业中的应用场景。同时分析当前面临的挑战，如数据隐私、算法偏见、能源消耗等问题。`;
+
+  console.log('--- 发送 15 条长消息 ---');
+  for (let i = 1; i <= 15; i++) {
+    try {
+      const result = await agent.chat(`${longContent}\n\n[消息 ${i}]`, { sessionId });
+      const msgLen = result.message?.length || 0;
+      console.log(`[${i}] message length: ${msgLen}, success: ${result.success}`);
+
+      if (!result.message) {
+        console.log(`[ERROR] message is empty!`);
+        console.log(`[DEBUG] result:`, JSON.stringify(result, null, 2));
+        break;
+      }
+    } catch (err) {
+      console.error(`[${i}] Error:`, err.message);
+    }
+  }
+
+  // 检查压缩统计
+  const chatHandler = agent._chatHandler;
+  console.log(`\n[DEBUG] compression count: ${chatHandler?._compressionCount}`);
+  console.log(`[DEBUG] _messages count: ${chatHandler?._messages.length}`);
+
+  // 压缩后再发一条
+  console.log('\n--- 压缩后发送测试 ---');
+  try {
+    const result = await agent.chat('你好，压缩后你还认识我吗？', { sessionId });
+    console.log(`message length: ${result.message?.length || 0}`);
+    console.log(`message: ${result.message?.substring(0, 100)}`);
+    if (!result.message) {
+      console.log(`[ERROR] message is empty after compression!`);
+    }
+  } catch (err) {
+    console.error(`Error:`, err.message);
+  }
+
+  await framework.destroy();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);

package/examples/test-session-chat.js

@@ -0,0 +1,93 @@
+/**
+ * 模拟微信持续聊天场景
+ * 测试多轮对话后 result.message 是否为空
+ */
+
+const { Framework } = require('../src');
+const AIPlugin = require('../plugins/ai-plugin');
+const SessionPlugin = require('../plugins/session-plugin');
+require('dotenv').config();
+
+async function main() {
+  console.log('=== 模拟微信持续聊天场景 ===\n');
+
+  const framework = new Framework({ debug: false });
+
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      apiKey: process.env.MINIMAX_API_KEY || 'your-api-key',
+    })
+  );
+
+  // 加载 session 插件
+  await framework.loadPlugin(new SessionPlugin());
+
+  // 模拟微信的 system prompt
+  const systemPrompt = `你是一个微信助手。`;
+
+  // 创建 Agent（模拟 _getSessionAgent）
+  const agent = framework.createAgent({
+    name: 'WeixinAgent',
+    systemPrompt: systemPrompt,
+  });
+
+  // 模拟 session
+  const sessionPlugin = framework.pluginManager.get('session');
+  const sessionId = 'weixin_test_user';
+
+  // 初始化 session
+  sessionPlugin.getOrCreateSession(sessionId, {
+    metadata: { platform: 'weixin', userId: 'test_user' },
+  });
+
+  // 模拟微信的 _processChat
+  const processChat = async (userId, text) => {
+    console.log(`\n[User] ${text}`);
+
+    try {
+      const result = await agent.chat(text, { sessionId: `weixin_${userId}` });
+      const message = result.message || '';
+
+      if (message) {
+        console.log(`[Agent] ${message.substring(0, 100)}${message.length > 100 ? '...' : ''}`);
+        console.log(`[OK] message length: ${message.length}`);
+      } else {
+        console.log(`[WARNING] result.message is empty!`);
+        console.log(`[DEBUG] result:`, JSON.stringify(result, null, 2).substring(0, 500));
+      }
+
+      // 检查 _messages 状态
+      const chatHandler = agent._chatHandler;
+      if (chatHandler) {
+        console.log(`[DEBUG] _messages count: ${chatHandler._messages.length}`);
+      }
+
+      return message;
+    } catch (err) {
+      console.error(`[Error]`, err.message);
+      return '';
+    }
+  };
+
+  // 模拟多轮对话
+  await processChat('user1', '你好');
+  await processChat('user1', '今天天气怎么样？');
+  await processChat('user1', '帮我查一下北京的人口');
+  await processChat('user1', '再说一次北京的人口');
+
+  console.log('\n--- 测试压缩场景 ---');
+  // 发送更多消息触发压缩
+  for (let i = 0; i < 5; i++) {
+    await processChat('user1', `这是第 ${i + 1} 条测试消息`);
+  }
+
+  // 压缩后再发送一条
+  await processChat('user1', '你好，你还记得我吗？');
+
+  console.log('\n[Done]');
+  await framework.destroy();
+}
+
+main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.85",
+  "version": "1.0.87",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",
@@ -53,7 +53,7 @@
     "@ai-sdk/openai": "^3.0.41",
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@anthropic-ai/sdk": "^0.39.0",
-    "@chnak/weixin-bot": "^1.2.1",
+    "@chnak/weixin-bot": "^1.2.7",
     "@chnak/zod-to-markdown": "^1.0.1",
     "@hono/node-server": "^1.19.11",
     "@larksuiteoapi/node-sdk": "^1.59.0",

package/plugins/ambient-agent/EventWatcher.js

@@ -53,17 +53,17 @@ class EventWatcher {
    */
   _handleEvent(type, data) {
     const activeGoals = this._goalManager.getActiveGoals()
-    log.info(`_handleEvent: type=${type}, activeGoals=${activeGoals.length}`)
+    // log.info(`_handleEvent: type=${type}, activeGoals=${activeGoals.length}`)
 
     for (const goal of activeGoals) {
       // 检查目标条件是否匹配此事件
       const isRelevant = this._isRelevantToGoal(goal, type, data)
-      log.info(`goal=${goal.id}, isRelevant=${isRelevant}, conditions=${JSON.stringify(goal.conditions)}`)
+      // log.info(`goal=${goal.id}, isRelevant=${isRelevant}, conditions=${JSON.stringify(goal.conditions)}`)
 
       if (isRelevant) {
         // 将 data 展平到事件对象中，方便通过 {{_event.xxx}} 访问
         this._goalManager.addEventToGoal(goal.id, { type, ...data })
-        log.info(`Event added to goal ${goal.id}`)
+        // log.info(`Event added to goal ${goal.id}`)
       }
     }
 
@@ -75,7 +75,7 @@ class EventWatcher {
         this._goalManager.activateGoal(goal.id)
         // 添加事件
         this._goalManager.addEventToGoal(goal.id, { type, ...data })
-        log.info(`事件触发激活目标: ${goal.id} (事件: ${type})`)
+        // log.info(`事件触发激活目标: ${goal.id} (事件: ${type})`)
       }
     }
   }

package/plugins/extension-executor-plugin.js

@@ -31,6 +31,11 @@ class ExtensionExecutorPlugin extends Plugin {
       this._scanPluginTools(plugin);
     });
 
+    // 监听插件重载事件，重新扫描工具
+    framework.on('plugin:reloaded', (plugin) => {
+      this._rescanPluginTools(plugin);
+    });
+
     return this;
   }
 
@@ -72,6 +77,34 @@ class ExtensionExecutorPlugin extends Plugin {
     }
   }
 
+  /**
+   * 重新扫描插件的工具（用于热重载）
+   */
+  _rescanPluginTools(plugin) {
+    if (!plugin || !plugin.tools || typeof plugin.tools !== 'object') {
+      return;
+    }
+
+    const pluginName = plugin.name;
+    if (!pluginName) return;
+
+    // 先移除旧工具
+    if (this._extensions.has(pluginName)) {
+      const ext = this._extensions.get(pluginName);
+      for (const tool of ext.tools || []) {
+        // 从 toolRouter 移除
+        if (this._framework?.toolRouter) {
+          this._framework.toolRouter.unregister(`ext_${tool.name}`);
+        }
+      }
+      this._extensions.delete(pluginName);
+    }
+
+    // 重新扫描工具
+    this._scanPluginTools(plugin);
+    log.info(` Rescanned tools from plugin '${pluginName}'`);
+  }
+
   async start(framework) {
     // 扫描所有已加载插件的 tools
     const plugins = framework.pluginManager.getAll();
@@ -217,7 +250,17 @@ class ExtensionExecutorPlugin extends Plugin {
     }
 
     const ext = this._extensions.get(pluginName);
-    if (!ext.tools.find((t) => t.name === toolDef.name)) {
+    const existingIdx = ext.tools.findIndex((t) => t.name === toolDef.name);
+    if (existingIdx >= 0) {
+      // 更新已存在的工具
+      ext.tools[existingIdx] = {
+        name: toolDef.name,
+        description: toolDef.description || '',
+        inputSchema: toolDef.inputSchema,
+        execute: toolDef.execute,
+      };
+    } else {
+      // 添加新工具
       ext.tools.push({
         name: toolDef.name,
         description: toolDef.description || '',

package/plugins/file-system-plugin.js

@@ -154,11 +154,10 @@ class FileSystemPlugin extends Plugin {
     // 写入文件
     framework.registerTool({
       name: 'write_file',
-      description: `创建或写入文件内容。
-      
-    注意：
-    - 对于大文件（>100MB），建议分多次调用 append_to_file
-    - 支持覆盖写入和追加写入`,
+      description: `创建或写入文件内容（仅适用于小文件，建议小于10KB）。
+
+重要：大文件必须使用 append_to_file 分多次写入，每次追加一部分内容。
+禁止将大段内容作为 content 参数传入，这会导致工具调用失败。`,
       inputSchema: z.object({
         path: z.string().describe('文件路径'),
         content: z.string().describe('文件内容'),
@@ -225,6 +224,46 @@ class FileSystemPlugin extends Plugin {
       }
     })
 
+    // 追加文件内容（用于大文件分段写入）
+    framework.registerTool({
+      name: 'append_to_file',
+      description: `追加内容到文件末尾。适用于大文件写入，每次最多追加约64KB内容。
+
+使用方式：
+1. 先用 write_file 创建新文件（或清空现有文件）
+2. 多次调用 append_to_file 追加内容，每次 content 不超过 64KB
+3. 追加顺序很重要，content 应该按文件顺序排列`,
+      inputSchema: z.object({
+        path: z.string().describe('文件路径'),
+        content: z.string().describe('要追加的内容（建议不超过64KB）')
+      }),
+      execute: async (args, framework) => {
+        const { path: filePath, content } = args
+
+        const pathCheck = validatePath(filePath)
+        if (!pathCheck.valid) {
+          return { success: false, error: pathCheck.error }
+        }
+
+        try {
+          // 如果文件不存在，返回错误（应该先用 write_file 创建）
+          if (!fs.existsSync(pathCheck.resolved)) {
+            return { success: false, error: '文件不存在，请先用 write_file 创建文件' }
+          }
+
+          fs.appendFileSync(pathCheck.resolved, content, 'utf8')
+          return {
+            success: true,
+            message: `已追加内容到: ${pathCheck.resolved}`,
+            filePath: pathCheck.resolved,
+            appendedSize: content.length
+          }
+        } catch (error) {
+          return { success: false, error: error.message }
+        }
+      }
+    })
+
     // 删除文件
     framework.registerTool({
       name: 'delete_file',

package/plugins/session-plugin.js

@@ -335,6 +335,11 @@ class SessionPlugin extends Plugin {
   addMessage(sessionId, message) {
     const session = this.getSession(sessionId)
     if (session) {
+      // 基础消息验证
+      if (!message || !message.role || !message.content) {
+        log.warn('Invalid message format, skipping:', { sessionId, message });
+        return session;
+      }
       session.messages.push(message)
       session.lastActive = new Date()
 
@@ -349,6 +354,22 @@ class SessionPlugin extends Plugin {
     return session
   }
 
+  /**
+   * 整体替换会话消息（用于压缩后同步）
+   * @param {string} sessionId - 会话 ID
+   * @param {Array} messages - 新的消息数组
+   */
+  replaceMessages(sessionId, messages) {
+    const session = this.getSession(sessionId)
+    if (session) {
+      session.messages = messages || []
+      session.lastActive = new Date()
+      // 持久化到 storage
+      this._saveToStorage(session)
+    }
+    return session
+  }
+
   /**
    * 获取会话历史
    */