foliko 1.0.13 → 1.0.15

package/.claude/settings.local.json

@@ -37,7 +37,17 @@
       "Bash(node -c plugins/default-plugins.js && echo \"Syntax OK\")",
       "Bash(node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
       "Bash(node -c plugins/telegram-plugin.js && node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")"
+      "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")",
+      "WebSearch",
+      "Bash(npm ls:*)",
+      "Bash(cd node_modules/@pinixai/weixin-bot && npm run build 2>&1)",
+      "Bash(cd node_modules/@pinixai/weixin-bot && npx tsc 2>&1)",
+      "Bash(npm install:*)",
+      "Bash(cd node_modules/@pinixai/weixin-bot && npx typescript --version && npx tsc 2>&1)",
+      "Bash(npx tsc:*)",
+      "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js 2>&1)",
+      "Bash(node --check /d/Code/vb-agent/plugins/telegram-plugin.js && node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
+      "Bash(node --check /d/Code/vb-agent/cli/src/ui/chat-ui.js && echo \"OK\")"
     ]
   }
 }

package/cli/src/ui/chat-ui.js

@@ -8,10 +8,25 @@ const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../utils
 const { renderLine } = require('../utils/markdown')
 
 class ChatUI {
-  constructor(agent) {
+  constructor(agent, options = {}) {
     this.agent = agent
     this.rl = null
     this.lines = []  // 多行输入的累积
+
+    // 会话管理
+    this.sessionId = options.sessionId || 'cli_default'
+    this.sessionPlugin = null
+
+    // 如果 agent 有 framework，获取 SessionPlugin
+    if (agent.framework) {
+      this.sessionPlugin = agent.framework.pluginManager.get('session')
+      // 确保会话存在
+      if (this.sessionPlugin) {
+        this.sessionPlugin.getOrCreateSession(this.sessionId, {
+          metadata: { platform: 'cli' }
+        })
+      }
+    }
   }
 
   /**
@@ -106,6 +121,11 @@ class ChatUI {
   async sendMessage(message) {
     console.log()
 
+    // 添加用户消息到会话历史
+    if (this.sessionPlugin) {
+      this.sessionPlugin.addMessage(this.sessionId, { role: 'user', content: message })
+    }
+
     // 用于打断的标志
     let interrupted = false
 
@@ -120,6 +140,8 @@ class ChatUI {
     // 监听 Ctrl+C
     process.on('SIGINT', interruptHandler)
 
+    let fullResponse = ''
+
     try {
       let lineBuffer = ''
       const renderState = { inThink: false, inCodeBlock: false }
@@ -127,10 +149,11 @@ class ChatUI {
       console.log(colored('Agent:', GREEN))
       console.log()
 
-      for await (const chunk of this.agent.chatStream(message)) {
+      for await (const chunk of this.agent.chatStream(message, { sessionId: this.sessionId })) {
         if (interrupted) break
 
         if (chunk.type === 'text') {
+          fullResponse += chunk.text
           lineBuffer += chunk.text
 
           while (lineBuffer.includes('\n')) {
@@ -159,6 +182,11 @@ class ChatUI {
       }
     } finally {
       process.removeListener('SIGINT', interruptHandler)
+
+      // 添加助手回复到会话历史
+      if (this.sessionPlugin && fullResponse) {
+        this.sessionPlugin.addMessage(this.sessionId, { role: 'assistant', content: fullResponse })
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -26,6 +26,7 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@anthropic-ai/sdk": "^0.39.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@pinixai/weixin-bot": "^1.2.0",
     "ai": "^6.0.116",
     "dotenv": "^17.3.1",
     "imap": "^0.8.19",
@@ -35,6 +36,10 @@
     "node-cron": "^4.2.1",
     "node-telegram-bot-api": "^0.67.0",
     "nodemailer": "^6.10.0",
+    "qrcode-terminal": "^0.12.0",
     "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
   }
 }

package/plugins/default-plugins.js

@@ -71,17 +71,36 @@ function loadAgentConfig(agentDir = '.agent') {
     }
   }
 
-  // 加载 plugins.json
+  // 加载 plugins.json (支持 telegram, weixin 等插件配置)
   const pluginsFile = path.join(resolvedDir, 'plugins.json')
   if (fs.existsSync(pluginsFile)) {
     try {
       const content = fs.readFileSync(pluginsFile, 'utf-8')
-      config.plugins = JSON.parse(content)
+      const pluginsConfig = JSON.parse(content)
+      // telegram 配置
+      if (pluginsConfig.telegram) {
+        config.telegram = pluginsConfig.telegram
+      }
+      // weixin 配置
+      if (pluginsConfig.weixin) {
+        config.weixin = pluginsConfig.weixin
+      }
     } catch (err) {
       console.error(`[AgentConfig] Failed to load plugins.json:`, err.message)
     }
   }
 
+  // 加载 weixin.json (如果存在)
+  const weixinFile = path.join(resolvedDir, 'weixin.json')
+  if (fs.existsSync(weixinFile)) {
+    try {
+      const content = fs.readFileSync(weixinFile, 'utf-8')
+      config.weixin = { ...config.weixin, ...JSON.parse(content) }
+    } catch (err) {
+      console.error(`[AgentConfig] Failed to load weixin.json:`, err.message)
+    }
+  }
+
   // 加载 mcp_config.json
   const mcpFile = path.join(resolvedDir, 'mcp_config.json')
   if (fs.existsSync(mcpFile)) {
@@ -187,7 +206,7 @@ async function bootstrapDefaults(framework, config = {}) {
     'install', 'ai', 'storage', 'tools', 'workflow', 'skill-manager',
     'mcp-executor', 'shell-executor', 'python-executor', 'session',
     'audit', 'rules', 'scheduler', 'file-system', 'think',
-    'python-plugin-loader', 'telegram'
+    'python-plugin-loader', 'telegram', 'weixin'
   ])
 
   // 辅助函数：检查插件是否应该加载（核心插件不能禁用）
@@ -375,6 +394,24 @@ async function bootstrapDefaults(framework, config = {}) {
     }
   }
 
+  // 12.7 WeChat 插件（始终加载，由配置控制是否扫码）
+  if (shouldLoad('weixin')) {
+    try {
+      const { Plugin } = require('../src/core/plugin-base')
+      const createWeixinPlugin = require('./weixin-plugin')
+      const WeixinPlugin = createWeixinPlugin(Plugin)
+      const weixinConfig = {
+        forceLogin: agentConfig.weixin?.forceLogin || false,
+        qrcodeTerminal: agentConfig.weixin?.qrcodeTerminal !== false,
+        allowedUsers: agentConfig.weixin?.allowedUsers || []
+      }
+      await framework.loadPlugin(new WeixinPlugin(weixinConfig))
+      console.log('[Bootstrap] WeChat Plugin loaded')
+    } catch (err) {
+      console.warn('[Bootstrap] WeChat Plugin not available:', err.message)
+    }
+  }
+
   // 13. 加载自定义插件
   await loadCustomPlugins(framework, agentConfig)
 

package/plugins/scheduler-plugin.js

@@ -277,7 +277,9 @@ class SchedulerPlugin extends Plugin {
           nextRun: t.nextRun || t.runAt,
           runCount: t.runCount,
           lastRun: t.lastRun,
-          cronExpression: t.cronExpression
+          cronExpression: t.cronExpression,
+          llm: t.llm,
+          sessionId: t.sessionId
         }))
 
         return {
@@ -412,11 +414,26 @@ class SchedulerPlugin extends Plugin {
 
         this._taskStats.completed++
 
+        // 获取 LLM 返回的消息
+        let responseText = ''
         if (result && result.message) {
-          console.log(`\n🔔 [定时提醒] ${result.message}\n`)
+          responseText = result.message
         } else if (result && result.text) {
-          console.log(`\n🔔 [定时提醒] ${result.text}\n`)
+          responseText = result.text
         }
+
+        if (responseText) {
+          console.log(`\n🔔 [定时提醒] ${responseText}\n`)
+        }
+
+        // 发送事件，让其他插件（如 telegram）发送提醒
+        this._framework.emit('scheduler:reminder', {
+          taskId: task.id,
+          taskName: task.name,
+          message: responseText || task.message,
+          sessionId: task.sessionId,
+          llm: true
+        })
       } else {
         // 直接显示模式：只显示提醒，不发 LLM
         console.log(`\n🔔 [定时提醒] ${task.message}\n`)

package/plugins/telegram-plugin.js

@@ -38,8 +38,8 @@ module.exports = function(Plugin) {
 
       this._framework = null
       this._bot = null
-      this._sessions = new Map() // chatId -> { agent, history, lastActive }
-      this._streamingMessages = new Map() // chatId -> messageId
+      this._sessionPlugin = null
+      this._agentsCache = new Map() // chatId -> agent (保留 agent 引用)
     }
 
     install(framework) {
@@ -53,6 +53,9 @@ module.exports = function(Plugin) {
         return this
       }
 
+      // 获取 SessionPlugin 引用
+      this._sessionPlugin = framework.pluginManager.get('session')
+
       this._initBot()
       return this
     }
@@ -140,21 +143,22 @@ module.exports = function(Plugin) {
       }
 
       // 其他情况（包括 null 或其他 sessionId），发送到最近的 Telegram 会话
-      if (this._sessions.size > 0) {
-        // 按最后活跃时间排序
-        const sortedSessions = Array.from(this._sessions.entries())
-          .sort((a, b) => {
-            const aTime = a[1].lastActive ? new Date(a[1].lastActive).getTime() : 0
-            const bTime = b[1].lastActive ? new Date(b[1].lastActive).getTime() : 0
-            return bTime - aTime
-          })
-
-        const [chatId] = sortedSessions[0]
-        try {
-          await this._bot.sendMessage(chatId, reminderText)
-          console.log(`[Telegram] Reminder sent to chat ${chatId}`)
-        } catch (err) {
-          console.error(`[Telegram] Failed to send reminder to ${chatId}:`, err.message)
+      if (this._sessionPlugin) {
+        const allSessions = this._sessionPlugin.listSessions()
+        const telegramSessions = allSessions
+          .filter(s => s.id.startsWith('telegram_'))
+          .sort((a, b) => new Date(b.lastActive).getTime() - new Date(a.lastActive).getTime())
+
+        if (telegramSessions.length > 0) {
+          const chatId = telegramSessions[0].id.replace('telegram_', '')
+          try {
+            await this._bot.sendMessage(chatId, reminderText)
+            console.log(`[Telegram] Reminder sent to chat ${chatId}`)
+          } catch (err) {
+            console.error(`[Telegram] Failed to send reminder to ${chatId}:`, err.message)
+          }
+        } else {
+          console.log('[Telegram] No active Telegram sessions to send reminder')
         }
       } else {
         console.log('[Telegram] No active Telegram sessions to send reminder')
@@ -181,30 +185,35 @@ module.exports = function(Plugin) {
 
     /**
      * 获取或创建会话Agent
+     * 使用 SessionPlugin 统一管理会话历史
      */
     _getSessionAgent(chatId) {
       console.log('[Telegram] _getSessionAgent called for chatId:', chatId)
-      let session = this._sessions.get(chatId)
 
-      if (!session) {
+      // 检查缓存的 agent 引用
+      let agent = this._agentsCache.get(chatId)
+      if (!agent) {
         const mainAgent = this._getMainAgent()
         console.log('[Telegram] mainAgent:', !!mainAgent, mainAgent?.name)
         if (!mainAgent) {
           console.log('[Telegram] ERROR: mainAgent is null!')
           return null
         }
+        agent = mainAgent
+        this._agentsCache.set(chatId, agent)
+      }
 
-        // 创建会话Agent（复用主Agent的配置）
-        session = {
-          agent: mainAgent,
-          history: [], // 对话历史
-          lastActive: new Date()
-        }
-        this._sessions.set(chatId, session)
-        console.log(`[Telegram] New session created for: ${chatId}`)
+      // 使用 SessionPlugin 管理会话历史
+      if (this._sessionPlugin) {
+        const sessionId = `telegram_${chatId}`
+        // 确保会话存在（不会重复创建）
+        this._sessionPlugin.getOrCreateSession(sessionId, {
+          metadata: { platform: 'telegram', chatId }
+        })
       }
 
-      return session
+      console.log(`[Telegram] Session ready for chatId: ${chatId}`)
+      return { agent, sessionId: `telegram_${chatId}` }
     }
 
     /**
@@ -280,12 +289,19 @@ module.exports = function(Plugin) {
           break
 
         case 'history':
-          const session = this._sessions.get(chatId)
-          await this._sendMessage(chatId,
-            `📊 当前状态\n\n会话数：${this._sessions.size}\n` +
-            `历史消息：${session?.history.length || 0}\n` +
-            `最后活跃：${session?.lastActive?.toLocaleString() || '无'}`,
-            msg.message_id)
+          if (this._sessionPlugin) {
+            const sessionId = `telegram_${chatId}`
+            const session = this._sessionPlugin.getSession(sessionId)
+            const allSessions = this._sessionPlugin.listSessions()
+            const telegramSessionCount = allSessions.filter(s => s.id.startsWith('telegram_')).length
+            await this._sendMessage(chatId,
+              `📊 当前状态\n\n会话数：${telegramSessionCount}\n` +
+              `历史消息：${session?.messages.length || 0}\n` +
+              `最后活跃：${session?.lastActive?.toLocaleString() || '无'}`,
+              msg.message_id)
+          } else {
+            await this._sendMessage(chatId, '❌ 会话服务不可用', msg.message_id)
+          }
           break
 
         default:
@@ -299,16 +315,19 @@ module.exports = function(Plugin) {
      */
     async _processChat(chatId, text, replyToMessageId) {
       console.log('[Telegram] _processChat called, chatId:', chatId, 'text:', text.substring(0, 50))
-      const session = this._getSessionAgent(chatId)
-      console.log('[Telegram] session:', !!session)
-      if (!session) {
+      const sessionInfo = this._getSessionAgent(chatId)
+      console.log('[Telegram] session:', !!sessionInfo)
+      if (!sessionInfo) {
         await this._sendMessage(chatId, '❌ AI 服务未初始化', replyToMessageId)
         return
       }
 
-      // 添加用户消息到历史
-      session.history.push({ role: 'user', content: text })
-      session.lastActive = new Date()
+      const { agent, sessionId } = sessionInfo
+
+      // 使用 SessionPlugin 添加用户消息到历史
+      if (this._sessionPlugin) {
+        this._sessionPlugin.addMessage(sessionId, { role: 'user', content: text })
+      }
 
       // 发送思考中消息
       let thinkingMsg
@@ -323,11 +342,10 @@ module.exports = function(Plugin) {
 
       try {
         let fullResponse = ''
-        const chatIdStr = `telegram_${chatId}`
 
         // 使用流式响应
-        for await (const chunk of session.agent.chatStream(text, {
-          sessionId: chatIdStr
+        for await (const chunk of agent.chatStream(text, {
+          sessionId: sessionId
         })) {
           // chatStream 返回 { type: 'text', text } 或 { type: 'tool-call', toolName, args }
           if (chunk.type === 'text' && chunk.text) {
@@ -347,8 +365,10 @@ module.exports = function(Plugin) {
           }
         }
 
-        // 保存助手回复到历史
-        session.history.push({ role: 'assistant', content: fullResponse })
+        // 保存助手回复到历史（使用 SessionPlugin）
+        if (this._sessionPlugin) {
+          this._sessionPlugin.addMessage(sessionId, { role: 'assistant', content: fullResponse })
+        }
 
         // 发送最终回复（转义 Markdown 特殊字符）
         const safeResponse = escapeMarkdown(fullResponse) || '抱歉，我没有收到有效的回复。'
@@ -501,11 +521,13 @@ module.exports = function(Plugin) {
      * 清除会话
      */
     _clearSession(chatId) {
-      const session = this._sessions.get(chatId)
-      if (session && session.agent) {
-        session.agent.clearHistory?.()
+      // 清除 SessionPlugin 中的会话
+      if (this._sessionPlugin) {
+        const sessionId = `telegram_${chatId}`
+        this._sessionPlugin.deleteSession(sessionId)
       }
-      this._sessions.delete(chatId)
+      // 清除 agent 缓存
+      this._agentsCache.delete(chatId)
     }
 
     /**
@@ -522,14 +544,23 @@ module.exports = function(Plugin) {
      * 获取插件状态
      */
     getStatus() {
+      // 从 SessionPlugin 获取 Telegram 相关会话
+      let sessions = []
+      if (this._sessionPlugin) {
+        const allSessions = this._sessionPlugin.listSessions()
+        sessions = allSessions
+          .filter(s => s.id.startsWith('telegram_'))
+          .map(s => ({
+            chatId: s.id.replace('telegram_', ''),
+            historyLength: s.messageCount,
+            lastActive: s.lastActive
+          }))
+      }
+
       return {
         connected: !!this._bot,
-        sessionCount: this._sessions.size,
-        sessions: Array.from(this._sessions.entries()).map(([chatId, session]) => ({
-          chatId,
-          historyLength: session.history.length,
-          lastActive: session.lastActive
-        })),
+        sessionCount: sessions.length,
+        sessions,
         config: {
           groupMode: this.config.groupMode,
           prefix: this.config.prefix,
@@ -568,7 +599,8 @@ module.exports = function(Plugin) {
 
     uninstall(framework) {
       this.stopBot()
-      this._sessions.clear()
+      this._agentsCache.clear()
+      this._sessionPlugin = null
       this._framework = null
     }
   }

package/plugins/weixin-plugin.js

@@ -0,0 +1,351 @@
+/**
+ * WeChat 插件
+ * 使用 @pinixai/weixin-bot 实现微信对话
+ *
+ * 配置：
+ * - forceLogin: 是否强制重新扫码登录
+ * - qrcodeTerminal: 是否在终端渲染二维码 (默认 true)
+ */
+
+const { Plugin } = require('../src/core/plugin-base')
+const { z } = require('zod')
+const path = require('path')
+const fs = require('fs')
+
+module.exports = function(Plugin) {
+  return class WeixinPlugin extends Plugin {
+    constructor(config = {}) {
+      super()
+      this.name = 'weixin'
+      this.version = '1.0.0'
+      this.description = '微信对话插件，使用微信网页账号进行对话'
+      this.priority = 80
+
+      this.config = {
+        forceLogin: config.forceLogin || process.env.WEIXIN_FORCE_LOGIN === 'true',
+        qrcodeTerminal: config.qrcodeTerminal !== false && process.env.WEIXIN_QRCODE_TERMINAL !== 'false',
+        systemPrompt: config.systemPrompt || '你是一个有帮助的AI助手。',
+        allowedUsers: config.allowedUsers || []
+      }
+
+      this._framework = null
+      this._bot = null
+      this._sessionPlugin = null
+      this._agentsCache = new Map() // userId -> agent
+      this._qrcodeTerminal = null
+      this._origStderrWrite = null
+      this._initialized = false
+    }
+
+    install(framework) {
+      this._framework = framework
+      return this
+    }
+
+    async start(framework) {
+      // 防止重复初始化
+      if (this._initialized) return this
+      this._initialized = true
+
+      // 获取 SessionPlugin 引用
+      this._sessionPlugin = framework.pluginManager.get('session')
+
+      // 异步初始化 Bot
+      this._initBotAsync().catch(err => {
+        console.error('[WeChat] Failed to initialize bot:', err.message)
+      })
+      return this
+    }
+
+    async _checkAndBuild() {
+      // 检查 dist 目录是否存在
+      const weixinBotPkg = path.join(__dirname, '..', '..', 'node_modules', '@pinixai', 'weixin-bot', 'package.json')
+      const pkgDir = path.dirname(weixinBotPkg)
+      const distPath = path.join(pkgDir, 'dist', 'index.js')
+
+      if (!fs.existsSync(distPath)) {
+        console.log('[WeChat] Building @pinixai/weixin-bot...')
+        const { execSync } = require('child_process')
+        try {
+          execSync('npx tsc', {
+            cwd: pkgDir,
+            stdio: 'inherit',
+            timeout: 60000
+          })
+          console.log('[WeChat] Build complete')
+        } catch (err) {
+          console.warn('[WeChat] Build failed:', err.message)
+        }
+      }
+    }
+
+    async _initBotAsync() {
+      await this._checkAndBuild()
+
+      let WeixinBot
+      try {
+        const module = await import('@pinixai/weixin-bot')
+        WeixinBot = module.WeixinBot
+      } catch (err) {
+        console.warn('[WeChat] Failed to load @pinixai/weixin-bot:', err.message)
+        console.warn('[WeChat] Make sure @pinixai/weixin-bot is installed: npm install @pinixai/weixin-bot qrcode-terminal')
+        return
+      }
+
+      // 如果启用终端二维码渲染
+      if (this.config.qrcodeTerminal) {
+        try {
+          this._qrcodeTerminal = require('qrcode-terminal')
+          this._interceptQRCode()
+        } catch (err) {
+          console.warn('[WeChat] qrcode-terminal not installed:', err.message)
+        }
+      }
+
+      this._bot = new WeixinBot({
+        onError: (err) => {
+          console.error('[WeChat] Error:', err instanceof Error ? err.stack ?? err.message : String(err))
+        },
+      })
+
+      const loginOptions = { force: this.config.forceLogin }
+      console.log('[WeChat]', this.config.forceLogin ? '强制重新扫码登录...' : '正在登录（已有凭证则自动跳过扫码）...')
+
+      const creds = await this._bot.login(loginOptions)
+      console.log('[WeChat] 登录成功 — Bot ID:', creds.accountId)
+      console.log('[WeChat] 关联用户:', creds.userId)
+      console.log('[WeChat] API 地址:', creds.baseUrl)
+
+      // 注册消息处理
+      this._bot.onMessage(async (msg) => {
+        await this._handleMessage(msg)
+      })
+
+      // 启动Bot
+      await this._bot.run()
+      console.log('[WeChat] 开始接收微信消息')
+    }
+
+    /**
+     * 拦截 SDK 的 stderr 输出，渲染二维码到终端
+     */
+    _interceptQRCode() {
+      if (!this._qrcodeTerminal) return
+
+      this._origStderrWrite = process.stderr.write.bind(process.stderr)
+      process.stderr.write = ((chunk, ...args) => {
+        const str = typeof chunk === 'string' ? chunk : chunk.toString()
+        // 检测到登录 URL，渲染二维码
+        if (str.startsWith('https://') && str.includes('qrcode=')) {
+          const url = str.trim()
+          this._qrcodeTerminal.generate(url, { small: true }, (qr) => {
+            this._origStderrWrite(qr + '\n')
+          })
+        }
+        return this._origStderrWrite(chunk, ...args)
+      })
+    }
+
+    /**
+     * 获取主Agent
+     */
+    _getMainAgent() {
+      if (this._framework._mainAgent) {
+        return this._framework._mainAgent
+      }
+      const agents = this._framework._agents || []
+      return agents.length > 0 ? agents[agents.length - 1] : null
+    }
+
+    /**
+     * 获取或创建会话Agent
+     * 使用 SessionPlugin 统一管理会话历史
+     */
+    _getSessionAgent(userId) {
+      // 检查缓存的 agent 引用
+      let agent = this._agentsCache.get(userId)
+      if (!agent) {
+        const mainAgent = this._getMainAgent()
+        if (!mainAgent) {
+          console.log('[WeChat] ERROR: mainAgent is null!')
+          return null
+        }
+        agent = mainAgent
+        this._agentsCache.set(userId, agent)
+      }
+
+      // 使用 SessionPlugin 管理会话历史
+      if (this._sessionPlugin) {
+        const sessionId = `weixin_${userId}`
+        this._sessionPlugin.getOrCreateSession(sessionId, {
+          metadata: { platform: 'weixin', userId }
+        })
+      }
+
+      console.log(`[WeChat] Session ready for user: ${userId}`)
+      return { agent, sessionId: `weixin_${userId}` }
+    }
+
+    /**
+     * 处理消息
+     */
+    async _handleMessage(msg) {
+      if (!msg || !msg.userId) return
+
+      const userId = msg.userId
+      // 从 SessionPlugin 获取历史消息数量
+      let messageCount = 0
+      if (this._sessionPlugin) {
+        const session = this._sessionPlugin.getSession(`weixin_${userId}`)
+        messageCount = session?.messages?.length || 0
+      }
+
+      console.log(`[WeChat] #${messageCount + 1} | 类型: ${msg.type} | 用户: ${userId}`)
+      console.log(`[WeChat] 内容: ${msg.text}`)
+
+      // 非文本消息暂不处理
+      if (msg.type !== 'text' || !msg.text) {
+        console.log('[WeChat] Unsupported message type or no text')
+        return
+      }
+
+      const text = msg.text.trim()
+      await this._processChat(userId, text, msg)
+    }
+
+    /**
+     * 处理对话
+     */
+    async _processChat(userId, text, originalMsg) {
+      const sessionInfo = this._getSessionAgent(userId)
+      if (!sessionInfo) {
+        console.error('[WeChat] No session agent available')
+        return
+      }
+
+      const { agent, sessionId } = sessionInfo
+
+      // 使用 SessionPlugin 添加用户消息到历史
+      if (this._sessionPlugin) {
+        this._sessionPlugin.addMessage(sessionId, { role: 'user', content: text })
+      }
+
+      // 发送正在输入状态
+      try {
+        await this._bot.sendTyping(userId)
+      } catch { /* typing 失败不影响回复 */ }
+
+      await new Promise((resolve) => setTimeout(resolve, 1000))
+
+      try {
+        let fullResponse = ''
+
+        // 使用流式响应
+        for await (const chunk of agent.chatStream(text, {
+          sessionId: sessionId
+        })) {
+          if (chunk.type === 'text' && chunk.text) {
+            fullResponse += chunk.text
+          }
+        }
+
+        // 保存助手回复到历史（使用 SessionPlugin）
+        if (this._sessionPlugin) {
+          this._sessionPlugin.addMessage(sessionId, { role: 'assistant', content: fullResponse })
+        }
+
+        // 发送回复
+        if (fullResponse) {
+          await this._bot.reply(originalMsg, fullResponse)
+          console.log(`[WeChat] 回复成功 (${fullResponse.length} 字符)`)
+        } else {
+          await this._bot.reply(originalMsg, '抱歉，我没有收到有效的回复。')
+        }
+
+      } catch (err) {
+        console.error('[WeChat] Chat error:', err)
+        await this._bot.reply(originalMsg, `发生错误：${err.message}`)
+      }
+    }
+
+    /**
+     * 权限检查
+     */
+    _checkPermission(userId) {
+      if (!this.config.allowedUsers || this.config.allowedUsers.length === 0) {
+        return true
+      }
+      return this.config.allowedUsers.includes(userId)
+    }
+
+    /**
+     * 清除会话
+     */
+    _clearSession(userId) {
+      // 清除 SessionPlugin 中的会话
+      if (this._sessionPlugin) {
+        const sessionId = `weixin_${userId}`
+        this._sessionPlugin.deleteSession(sessionId)
+      }
+      // 清除 agent 缓存
+      this._agentsCache.delete(userId)
+    }
+
+    /**
+     * 获取插件状态
+     */
+    getStatus() {
+      // 从 SessionPlugin 获取 WeChat 相关会话
+      let sessions = []
+      if (this._sessionPlugin) {
+        const allSessions = this._sessionPlugin.listSessions()
+        sessions = allSessions
+          .filter(s => s.id.startsWith('weixin_'))
+          .map(s => ({
+            userId: s.id.replace('weixin_', ''),
+            historyLength: s.messageCount,
+            lastActive: s.lastActive
+          }))
+      }
+
+      return {
+        connected: !!this._bot,
+        sessionCount: sessions.length,
+        sessions,
+        config: {
+          forceLogin: this.config.forceLogin,
+          qrcodeTerminal: this.config.qrcodeTerminal
+        }
+      }
+    }
+
+    /**
+     * 停止 Bot
+     */
+    stopBot() {
+      if (this._bot) {
+        this._bot.stop()
+        this._bot = null
+        console.log('[WeChat] Bot stopped')
+      }
+    }
+
+    reload(framework) {
+      this._framework = framework
+      this._initialized = false
+      this.stopBot()
+      this.start(framework)
+    }
+
+    uninstall(framework) {
+      this.stopBot()
+      this._agentsCache.clear()
+      this._sessionPlugin = null
+      this._framework = null
+      // 恢复 stderr
+      if (this._origStderrWrite) {
+        process.stderr.write = this._origStderrWrite
+      }
+    }
+  }
+}