myagent-ai 1.20.3 → 1.20.4

package/chatbot/manager.py

@@ -37,6 +37,10 @@ class ChatBotManager:
         self._bots: Dict[str, BaseChatBot] = {}
         self._session_map: Dict[str, str] = {}  # session_id -> last_message
 
+    def get_bot(self, key: str):
+        """根据 key (id 或 platform 名) 获取 bot 实例"""
+        return self._bots.get(key)
+
     def setup_platforms(
         self,
         platform_configs: List[ChatPlatformConfig],
@@ -111,6 +115,8 @@ class ChatBotManager:
         elif platform == "wechat":
             from chatbot.wechat_bot import WeChatBot
             return WeChatBot(
+                app_id=config.app_id,
+                app_secret=config.app_secret,
                 token=config.token,
                 allowed_users=config.allowed_users,
                 message_handler=message_handler,

package/chatbot/whatsapp_bot.py

@@ -2,7 +2,7 @@
 chatbot/whatsapp_bot.py - WhatsApp 机器人
 ===========================================
 使用 whatsapp-web.js 或 Baileys 库接入 WhatsApp。
-支持二维码绑定。
+支持二维码绑定（通过 Node.js Baileys bridge）。
 纯 Python 实现，异步运行。
 """
 from __future__ import annotations
@@ -10,6 +10,9 @@ from __future__ import annotations
 import asyncio
 import json
 import time
+import os
+import subprocess
+from pathlib import Path
 from typing import Optional, List
 
 from chatbot.base import BaseChatBot, ChatMessage, ChatResponse
@@ -25,17 +28,19 @@ class WhatsAppBot(BaseChatBot):
     """
     WhatsApp 机器人适配器。
 
-    配置要求:
+    配置要求 (Cloud API 模式):
       - token: Access Token (从 Meta Developer Portal 获取)
-      - app_id: App ID
-      - app_secret: App Secret
-      - webhook_url: Webhook URL (可选，用于接收消息)
       - phone_number_id: Phone Number ID (从 Meta 获取)
       - verify_token: Webhook 验证 Token (自动生成)
 
+    配置要求 (QR 码绑定模式):
+      - 无需 token / phone_number_id
+      - 需要 Node.js 环境 + Baileys 依赖
+      - 首次运行会生成 QR 码，扫码后自动保存会话
+
     支持两种模式:
       1. Cloud API 模式: 使用 Meta WhatsApp Business API
-      2. 二维码绑定模式: 通过 QR Code 绑定（需要 Baileys 库）
+      2. Baileys 模式: 通过 QR Code 绑定 (推荐个人使用)
     """
 
     platform_name = "whatsapp"
@@ -47,35 +52,161 @@ class WhatsAppBot(BaseChatBot):
         self._phone_number_id = self.config.get("phone_number_id", "")
         self._verify_token = self.config.get("verify_token", "")
         self._webhook_base = self.config.get("webhook_base", "")
-        self._qrcode_callback = self.config.get("qrcode_callback", None)
         self._qr_code = ""
         self._connected = False
+        self._bridge_process: Optional[subprocess.Popen] = None
+        self._bridge_mode = not self._phone_number_id  # 没有 phone_number_id 则使用 bridge
+        self._session_dir = str(Path(__file__).parent / "whatsapp_bridge" / "session")
 
     async def start(self):
         """启动 WhatsApp 机器人"""
+        if self._bridge_mode:
+            await self._start_bridge_mode()
+        else:
+            await self._start_cloud_mode()
+
+    async def _start_cloud_mode(self):
+        """Meta Cloud API 模式"""
         if not self.token:
             self.logger.error("WhatsApp Access Token 未配置")
             return
+        if not self._phone_number_id:
+            self.logger.error("Cloud API 模式需要配置 phone_number_id")
+            return
 
-        # Meta Cloud API 模式
-        if self._phone_number_id:
-            self.logger.info("WhatsApp Cloud API 模式启动")
-            self._connected = True
-            # Cloud API 模式通过 Webhook 接收消息，不需要主动轮询
-            # 保持运行
-            while self._running:
-                await asyncio.sleep(1)
-        else:
-            self.logger.warning(
-                "WhatsApp 需要配置 phone_number_id 才能使用 Cloud API 模式。"
-                "请访问 Meta Developer Portal 获取 WhatsApp Business API 凭据。"
+        self.logger.info("WhatsApp Cloud API 模式启动")
+        self._connected = True
+        while self._running:
+            await asyncio.sleep(1)
+
+    async def _start_bridge_mode(self):
+        """Baileys Bridge 模式 (QR 码绑定)"""
+        bridge_dir = Path(__file__).parent / "whatsapp_bridge"
+        bridge_script = bridge_dir / "bridge.mjs"
+
+        if not bridge_script.exists():
+            self.logger.error(f"Bridge 脚本不存在: {bridge_script}")
+            self.logger.error("请运行: cd chatbot/whatsapp_bridge && npm install @whiskeysockets/baileys qrcode-terminal")
+            return
+
+        # 检查是否已安装依赖
+        node_modules = bridge_dir / "node_modules"
+        if not node_modules.exists():
+            self.logger.info("正在安装 Baileys 依赖...")
+            try:
+                proc = await asyncio.create_subprocess_exec(
+                    "npm", "install", "--production",
+                    cwd=str(bridge_dir),
+                    stdout=asyncio.subprocess.PIPE,
+                    stderr=asyncio.subprocess.PIPE,
+                )
+                stdout, stderr = await asyncio.wait_for(proc.communicate(), timeout=120)
+                if proc.returncode != 0:
+                    self.logger.error(f"Baileys 安装失败: {stderr.decode()[:500]}")
+                    return
+                self.logger.info("Baileys 依赖安装完成")
+            except Exception as e:
+                self.logger.error(f"Baileys 安装异常: {e}")
+                return
+
+        env = os.environ.copy()
+        env["SESSION_DIR"] = self._session_dir
+
+        try:
+            self._bridge_process = await asyncio.create_subprocess_exec(
+                "node", str(bridge_script),
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE,
+                env=env,
+                cwd=str(bridge_dir),
             )
-            self._connected = False
+            self.logger.info("WhatsApp Bridge 进程已启动")
+
+            # 启动消息读取循环
+            asyncio.create_task(self._read_bridge_output())
+        except Exception as e:
+            self.logger.error(f"Bridge 启动失败: {e}")
+
+        while self._running:
+            await asyncio.sleep(1)
+
+    async def _read_bridge_output(self):
+        """读取 Bridge 进程的 stdout (JSON 协议)"""
+        if not self._bridge_process or not self._bridge_process.stdout:
+            return
+
+        try:
+            reader = self._bridge_process.stdout
+            while self._running and self._bridge_process.returncode is None:
+                line = await reader.readline()
+                if not line:
+                    break
+                line = line.decode('utf-8', errors='replace').strip()
+                if not line:
+                    continue
+                try:
+                    msg = json.loads(line)
+                    msg_type = msg.get("type", "")
+
+                    if msg_type == "qr":
+                        self._qr_code = msg.get("qr", "")
+                        self.logger.info("QR 码已生成，等待扫码...")
+
+                    elif msg_type == "connected":
+                        self._connected = True
+                        phone = msg.get("phone", "")
+                        name = msg.get("name", "")
+                        self.logger.info(f"WhatsApp 已连接: {name} ({phone})")
+                        # 更新配置中的连接状态
+                        self.config["connection_status"] = "connected"
+                        self.config["connected_phone"] = phone
+
+                    elif msg_type == "disconnected":
+                        self._connected = False
+                        reason = msg.get("reason", "unknown")
+                        self.logger.warning(f"WhatsApp 已断开: {reason}")
+                        self.config["connection_status"] = "disconnected"
+
+                    elif msg_type == "message":
+                        from_id = msg.get("from", "")
+                        text = msg.get("text", "")
+                        push_name = msg.get("pushName", "")
+                        if from_id and text:
+                            chat_msg = ChatMessage(
+                                platform=self.platform_name,
+                                chat_id=from_id,
+                                user_id=from_id,
+                                username=push_name or from_id.split('@')[0],
+                                text=text,
+                                is_group='@g.us' in from_id,
+                                raw_data=msg,
+                            )
+                            await self._handle_message(chat_msg)
+
+                    elif msg_type == "error":
+                        error = msg.get("error", "")
+                        self.logger.error(f"Bridge 错误: {error}")
+
+                except json.JSONDecodeError:
+                    self.logger.debug(f"非 JSON 输出: {line[:100]}")
+        except Exception as e:
+            self.logger.error(f"Bridge 输出读取异常: {e}")
 
     async def stop(self):
         """停止 WhatsApp 机器人"""
         self._running = False
         self._connected = False
+
+        if self._bridge_process:
+            try:
+                self._bridge_process.terminate()
+                await asyncio.sleep(1)
+                if self._bridge_process.returncode is None:
+                    self._bridge_process.kill()
+            except Exception:
+                pass
+            self._bridge_process = None
+
         self.logger.info("WhatsApp 机器人已停止")
 
     async def send_message(self, response: ChatResponse) -> bool:
@@ -83,36 +214,56 @@ class WhatsAppBot(BaseChatBot):
         if not self._connected or not response.chat_id:
             return False
 
+        if self._bridge_mode:
+            return await self._send_via_bridge(response.chat_id, response.text)
+        else:
+            return await self._send_via_cloud_api(response.chat_id, response.text)
+
+    async def _send_via_bridge(self, chat_id: str, text: str) -> bool:
+        """通过 Bridge 发送消息"""
+        if not self._bridge_process or not self._bridge_process.stdin:
+            return False
         try:
-            if not HAS_AIOHTTP:
-                self.logger.error("请安装 aiohttp: pip install aiohttp")
-                return False
-
-            url = f"https://graph.facebook.com/v18.0/{self._phone_number_id}/messages"
-            headers = {
-                "Authorization": f"Bearer {self.token}",
-                "Content-Type": "application/json",
-            }
-            payload = {
-                "messaging_product": "whatsapp",
-                "to": response.chat_id,
-                "type": "text",
-                "text": {"body": response.text[:4096]},
-            }
+            msg = json.dumps({"action": "send", "to": chat_id, "text": text}) + "\n"
+            self._bridge_process.stdin.write(msg.encode('utf-8'))
+            await self._bridge_process.stdin.drain()
+            return True
+        except Exception as e:
+            self.logger.error(f"Bridge 发送失败: {e}")
+            return False
+
+    async def _send_via_cloud_api(self, chat_id: str, text: str) -> bool:
+        """通过 Cloud API 发送消息"""
+        if not HAS_AIOHTTP:
+            self.logger.error("请安装 aiohttp: pip install aiohttp")
+            return False
+
+        url = f"https://graph.facebook.com/v18.0/{self._phone_number_id}/messages"
+        headers = {
+            "Authorization": f"Bearer {self.token}",
+            "Content-Type": "application/json",
+        }
+        payload = {
+            "messaging_product": "whatsapp",
+            "to": chat_id,
+            "type": "text",
+            "text": {"body": text[:4096]},
+        }
 
+        try:
             async with aiohttp.ClientSession() as session:
                 async with session.post(url, headers=headers, json=payload) as resp:
                     if resp.status == 200:
                         return True
                     error_text = await resp.text()
-                    self.logger.error(f"WhatsApp 发送失败 ({resp.status}): {error_text}")
+                    self.logger.error(f"WhatsApp 发送失败 ({resp.status}): {error_text[:200]}")
                     return False
         except Exception as e:
-            self.logger.error(f"发送消息失败: {e}")
+            self.logger.error(f"Cloud API 发送失败: {e}")
             return False
 
     # ==========================================================================
-    # Webhook 处理
+    # Webhook 处理 (Cloud API 模式)
     # ==========================================================================
 
     def verify_webhook(self, mode: str, token: str, challenge: str) -> Optional[str]:
@@ -122,7 +273,7 @@ class WhatsAppBot(BaseChatBot):
         return None
 
     async def handle_webhook_event(self, event_data: dict):
-        """处理 Webhook 事件"""
+        """处理 Webhook 事件 (Cloud API 模式)"""
         try:
             for entry in event_data.get("entry", []):
                 for change in entry.get("changes", []):
@@ -130,7 +281,6 @@ class WhatsAppBot(BaseChatBot):
                     messages = value.get("messages", [])
                     contacts = value.get("contacts", [])
 
-                    # 构建联系人映射
                     contact_map = {}
                     for c in contacts:
                         wa_id = c.get("wa_id", "")
@@ -146,7 +296,6 @@ class WhatsAppBot(BaseChatBot):
                         text_body = msg.get("text", {}).get("body", "")
                         msg_id = msg.get("id", "")
                         timestamp = msg.get("timestamp", "")
-
                         username = contact_map.get(from_id, from_id)
 
                         message = ChatMessage(
@@ -164,16 +313,31 @@ class WhatsAppBot(BaseChatBot):
             self.logger.error(f"处理 Webhook 事件失败: {e}")
 
     # ==========================================================================
-    # 二维码绑定
+    # QR 码绑定
     # ==========================================================================
 
     def get_qr_code(self) -> str:
-        """获取当前 QR Code（用于绑定模式）"""
+        """获取当前 QR Code（base64 PNG 图片）"""
         return self._qr_code
 
     async def generate_qr_code(self) -> str:
-        """生成绑定二维码"""
-        # Cloud API 模式不需要 QR Code
-        # 如需 Baileys 模式，需额外安装 node.js 依赖
-        self.logger.info("WhatsApp Cloud API 模式不需要 QR Code 绑定，使用 Webhook 接收消息")
+        """请求生成 QR 码。Bridge 模式下，首次启动会自动生成。"""
+        if self._bridge_mode:
+            # 如果 bridge 已在运行且有 QR 码，直接返回
+            if self._qr_code:
+                return self._qr_code
+            # 如果 bridge 未运行，尝试启动
+            if not self._bridge_process or self._bridge_process.returncode is not None:
+                asyncio.create_task(self._start_bridge_mode())
+                # 等待 QR 码生成（最多 30 秒）
+                for _ in range(60):
+                    await asyncio.sleep(0.5)
+                    if self._qr_code:
+                        return self._qr_code
+                    if self._connected:
+                        return ""  # 已连接，不需要 QR
+            return self._qr_code
+
+        # Cloud API 模式不需要 QR
+        self.logger.info("Cloud API 模式不需要 QR Code")
         return ""

package/chatbot/whatsapp_bridge/bridge.mjs

@@ -0,0 +1,192 @@
+/**
+ * WhatsApp Baileys Bridge
+ * ======================
+ * Provides QR code generation for WhatsApp Web binding.
+ * Communicates with Python via stdin/stdout JSON messages.
+ *
+ * Protocol:
+ *   Python → Node: {"action": "start"} or {"action": "send", "to": "xxx", "text": "yyy"}
+ *   Node → Python: {"type": "qr", "qr": "base64..."} | {"type": "connected", "phone": "xxx"} | {"type": "message", "from": "xxx", "text": "yyy"} | {"type": "error", "error": "..."}
+ */
+
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+
+let makeWASocket, useMultiFileAuthState, fetchLatestBaileysVersion, DisconnectReason;
+let qrCodeToString;
+
+// Try to load Baileys
+try {
+  const baileys = require('@whiskeysockets/baileys');
+  makeWASocket = baileks.default.makeWASocket;
+  useMultiFileAuthState = baileks.default.useMultiFileAuthState;
+  fetchLatestBaileysVersion = baileks.default.fetchLatestBaileysVersion;
+  DisconnectReason = baileks.default.DisconnectReason;
+  qrCodeToString = require('qrcode-terminal').default;
+} catch (e) {
+  // Try alternative import
+  try {
+    const baileys = require('@adiwajshing/baileys');
+    makeWASocket = baileys.makeWASocket;
+    useMultiFileAuthState = baileys.useMultiFileAuthState;
+    fetchLatestBaileysVersion = baileys.fetchLatestBaileysVersion;
+    DisconnectReason = baileys.DisconnectReason;
+  } catch (e2) {
+    console.error(JSON.stringify({type: 'error', error: 'Baileys not installed. Run: cd chatbot/whatsapp_bridge && npm install @whiskeysockets/baileys qrcode-terminal'}));
+    process.exit(1);
+  }
+}
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SESSION_DIR = process.env.SESSION_DIR || join(__dirname, 'session');
+
+let sock = null;
+let isConnected = false;
+let currentQR = '';
+
+function send(msg) {
+  try {
+    process.stdout.write(JSON.stringify(msg) + '\n');
+  } catch (e) {
+    // ignore
+  }
+}
+
+async function startWhatsApp() {
+  if (!existsSync(SESSION_DIR)) {
+    mkdirSync(SESSION_DIR, { recursive: true });
+  }
+
+  const { state, saveCreds } = await useMultiFileAuthState(SESSION_DIR);
+
+  const { version } = await fetchLatestBaileysVersion();
+
+  sock = makeWASocket({
+    version,
+    auth: {
+      creds: state,
+      keys: state,
+    },
+    printQRInTerminal: false,
+    logger: { level: 'silent' },
+    shouldIgnoreJid: () => false,
+  });
+
+  sock.ev.on('creds.update', saveCreds);
+
+  sock.ev.on('connection.update', (update) => {
+    const { connection, lastDisconnect, qr } = update;
+
+    if (qr) {
+      // Convert QR to base64 image
+      currentQR = qr.toString('base64');
+      send({ type: 'qr', qr: currentQR });
+      // Also log to stderr (not stdout, which is for JSON protocol)
+      process.stderr.write('[WhatsApp] QR Code generated, waiting for scan...\n');
+    }
+
+    if (connection === 'open') {
+      isConnected = true;
+      const me = sock.user;
+      send({ type: 'connected', phone: me?.id?.replace(/:.*@/, '') || '', name: me?.name || '' });
+      process.stderr.write(`[WhatsApp] Connected as ${me?.name || me?.id}\n`);
+    }
+
+    if (connection === 'close') {
+      isConnected = false;
+      const statusCode = lastDisconnect?.error?.output?.statusCode;
+      if (statusCode === DisconnectReason.loggedOut) {
+        send({ type: 'disconnected', reason: 'logged_out' });
+        process.stderr.write('[WhatsApp] Logged out, need to re-scan QR\n');
+      } else if (statusCode === DisconnectReason.connectionClosed) {
+        send({ type: 'disconnected', reason: 'connection_closed' });
+        process.stderr.write('[WhatsApp] Connection closed\n');
+      } else {
+        send({ type: 'disconnected', reason: 'unknown', code: statusCode });
+        process.stderr.write(`[WhatsApp] Disconnected: ${statusCode}\n`);
+      }
+      // Auto-reconnect after 5 seconds (except logged out)
+      if (statusCode !== DisconnectReason.loggedOut) {
+        setTimeout(() => startWhatsApp(), 5000);
+      }
+    }
+  });
+
+  sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+      if (msg.key.fromMe) continue;
+      if (msg.message?.conversation) {
+        send({
+          type: 'message',
+          from: msg.key.remoteJid,
+          fromMe: msg.key.fromMe,
+          text: msg.message.conversation,
+          id: msg.key.id,
+          pushName: msg.pushName || '',
+        });
+      } else if (msg.message?.extendedTextMessage) {
+        send({
+          type: 'message',
+          from: msg.key.remoteJid,
+          fromMe: msg.key.fromMe,
+          text: msg.message.extendedTextMessage.text,
+          id: msg.key.id,
+          pushName: msg.pushName || '',
+        });
+      }
+    }
+  });
+}
+
+async function sendMessage(to, text) {
+  if (!sock || !isConnected) {
+    return { success: false, error: 'Not connected' };
+  }
+  try {
+    const jid = to.includes('@') ? to : to + '@s.whatsapp.net';
+    await sock.sendMessage(jid, { text: text.substring(0, 4096) });
+    return { success: true };
+  } catch (e) {
+    return { success: false, error: e.message };
+  }
+}
+
+// Handle stdin messages from Python
+process.stdin.setEncoding('utf8');
+let buffer = '';
+process.stdin.on('data', (chunk) => {
+  buffer += chunk;
+  const lines = buffer.split('\n');
+  buffer = lines.pop(); // keep incomplete line in buffer
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    try {
+      const msg = JSON.parse(line);
+      if (msg.action === 'start') {
+        startWhatsApp().catch(e => {
+          send({ type: 'error', error: e.message });
+        });
+      } else if (msg.action === 'send') {
+        sendMessage(msg.to, msg.text).then(result => {
+          send({ type: 'send_result', ...result });
+        });
+      } else if (msg.action === 'status') {
+        send({ type: 'status', connected: isConnected, hasQR: !!currentQR });
+      } else if (msg.action === 'get_qr') {
+        if (currentQR) {
+          send({ type: 'qr', qr: currentQR });
+        } else {
+          send({ type: 'qr', qr: '' });
+        }
+      }
+    } catch (e) {
+      process.stderr.write(`[Bridge] Failed to parse message: ${e.message}\n`);
+    }
+  }
+});
+
+process.stderr.write('[WhatsApp Bridge] Ready, waiting for commands...\n');

package/chatbot/whatsapp_bridge/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "myagent-whatsapp-bridge",
+  "version": "1.0.0",
+  "private": true,
+  "description": "WhatsApp Baileys bridge for MyAgent QR code binding",
+  "main": "bridge.mjs",
+  "type": "module",
+  "scripts": {
+    "start": "node bridge.mjs"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.20.3",
+  "version": "1.20.4",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/web/api_server.py

@@ -332,6 +332,8 @@ class ApiServer:
         r.add_post("/api/platforms/{name}/toggle", self.handle_toggle_platform)
         r.add_post("/api/platforms/{name}/restart", self.handle_restart_platform)
         r.add_get("/api/platforms/{name}/agents", self.handle_platform_agents)
+        r.add_get("/api/platforms/{name}/qr", self.handle_get_platform_qr)
+        r.add_post("/api/platforms/{name}/qr", self.handle_start_platform_qr)
         # ── 模型库 CRUD ──
         r.add_get("/api/models", self.handle_list_models)
         r.add_post("/api/models", self.handle_add_model)
@@ -3126,6 +3128,87 @@ window.toggleFullscreen = function() {{
         # TODO: 实现平台 Bot 热重启
         return web.json_response({"ok": True, "message": f"平台 {display} 重启请求已发送（重启需服务端支持）"})
 
+    # [v1.20.3] QR 码绑定相关
+    async def handle_get_platform_qr(self, request):
+        """GET /api/platforms/{name}/qr - 获取平台当前 QR 码和连接状态"""
+        name = request.match_info["name"]
+        cp = self.core.config_mgr.get_chat_platform_by_id(name)
+        if not cp:
+            cp = self.core.config_mgr.get_chat_platform(name)
+        if not cp:
+            return web.json_response({"error": "平台不存在"}, status=404)
+
+        qr_code = ""
+        connected = False
+        status = "unknown"
+
+        # 从 bot 实例获取 QR 码
+        bot = self.core.chatbot_manager.get_bot(cp.id or cp.platform)
+        if bot and hasattr(bot, 'get_qr_code'):
+            qr_code = bot.get_qr_code() or ""
+        if bot and hasattr(bot, '_connected'):
+            connected = bot._connected
+
+        # 从 extra 读取持久化的连接状态
+        conn_status = cp.extra.get("connection_status", "")
+        if connected:
+            status = "connected"
+        elif qr_code:
+            status = "waiting_scan"
+        elif conn_status:
+            status = conn_status
+        else:
+            status = "not_started"
+
+        return web.json_response({
+            "platform": cp.platform,
+            "id": cp.id,
+            "status": status,
+            "connected": connected,
+            "qr_code": qr_code,
+        })
+
+    async def handle_start_platform_qr(self, request):
+        """POST /api/platforms/{name}/qr - 请求生成 QR 码（开始绑定流程）"""
+        name = request.match_info["name"]
+        cp = self.core.config_mgr.get_chat_platform_by_id(name)
+        if not cp:
+            cp = self.core.config_mgr.get_chat_platform(name)
+        if not cp:
+            return web.json_response({"error": "平台不存在"}, status=404)
+
+        if cp.platform not in ("whatsapp", "wechat"):
+            return web.json_response({"error": f"{cp.platform} 不支持 QR 码绑定"}, status=400)
+
+        bot = self.core.chatbot_manager.get_bot(cp.id or cp.platform)
+        if not bot:
+            return web.json_response({"error": "Bot 实例未创建"}, status=400)
+
+        if not hasattr(bot, 'generate_qr_code'):
+            return web.json_response({"error": "该 Bot 不支持 QR 码绑定"}, status=400)
+
+        try:
+            qr_code = await bot.generate_qr_code()
+            if qr_code:
+                # 保存 QR 码到 extra
+                cp.extra["connection_status"] = "waiting_scan"
+                self.core.config_mgr.save()
+                return web.json_response({
+                    "ok": True,
+                    "qr_code": qr_code,
+                    "status": "waiting_scan",
+                    "message": "QR 码已生成，请使用手机扫码",
+                })
+            else:
+                return web.json_response({
+                    "ok": False,
+                    "status": "failed",
+                    "error": "QR 码生成失败，请检查配置",
+                })
+        except Exception as e:
+            logger.error(f"QR 码生成异常 ({name}): {e}")
+            return web.json_response({"error": f"QR 码生成异常: {e}"}, status=500)
+
     async def handle_platform_agents(self, request):
         """获取绑定到指定平台的所有 Agent"""
         name = request.match_info["name"]

package/web/ui/index.html

@@ -1251,8 +1251,8 @@ async function renderPlatforms(){
     <div class="mt-8 flex gap-8">
       <button class="btn btn-sm ${p.enabled?'btn-danger':'btn-success'}" onclick="togglePlatform('${escHtml(pid)}',${!p.enabled})">${p.enabled?'停用':'启用'}</button>
       <button class="btn btn-sm btn-ghost" onclick="showEditPlatformModal('${escHtml(pid)}')">配置</button>
+      ${supportsQR?'<button class="btn btn-sm btn-primary" onclick="showPlatformQRModal(\''+escHtml(pid)+'\')">📱 QR绑定</button>':''}
     </div></div>`;
-  }
   html+='</div>';$('content').innerHTML=html;
 }
 async function togglePlatform(id,enable){await api(`/api/platforms/${id}`,{method:'PUT',body:JSON.stringify({enabled})});renderPlatforms()}
@@ -1336,6 +1336,52 @@ async function doDeletePlatform(id){
   });
 }
 
+// [v1.20.3] QR 码绑定模态框
+let _qrPollTimer=null;
+async function showPlatformQRModal(platformId){
+  if(_qrPollTimer){clearInterval(_qrPollTimer);_qrPollTimer=null}
+  $('modalContainer').innerHTML='<div class="modal-overlay" onclick="closeModal();if(_qrPollTimer){clearInterval(_qrPollTimer);_qrPollTimer=null}"><div class="modal" onclick="event.stopPropagation()" style="max-width:420px;text-align:center"><h3>📱 QR 码绑定</h3><p style="font-size:13px;color:var(--text2);margin:8px 0">使用手机扫描下方二维码以绑定账号</p><div id="qrStatus" style="margin:12px 0;padding:12px;border-radius:var(--radius-sm);background:var(--bg3);font-size:13px;color:var(--text2)">正在请求 QR 码...</div><div id="qrCodeContainer" style="display:flex;justify-content:center;padding:16px 0"><div id="qrCodeImg" style="width:256px;height:256px;border:1px solid var(--bg4);border-radius:8px;display:flex;align-items:center;justify-content:center;color:var(--text3);font-size:13px">加载中...</div></div><div id="qrActions" style="display:none;margin-top:12px"><button class="btn btn-sm btn-ghost" onclick="requestNewQR(\''+escHtml(platformId)+'\')">🔄 刷新 QR 码</button></div><div class="flex gap-8 mt-16"><button class="btn btn-ghost" onclick="closeModal();if(_qrPollTimer){clearInterval(_qrPollTimer);_qrPollTimer=null}">关闭</button></div></div></div>';
+  var r=await api('/api/platforms/'+encodeURIComponent(platformId)+'/qr',{method:'POST'});
+  if(r.error){$('qrStatus').textContent='错误: '+escHtml(r.error);return}
+  if(r.qr_code){
+    $('qrCodeImg').innerHTML='<img src="data:image/png;base64,'+r.qr_code+'" style="width:256px;height:256px;border-radius:8px" alt="QR Code">';
+    $('qrStatus').innerHTML='<span style="color:var(--warn)">⏳ 等待扫码...</span>';
+    $('qrActions').style.display='block';
+  }else if(r.status==='connected'){
+    $('qrStatus').innerHTML='<span style="color:var(--success)">✅ 已连接</span>';
+    $('qrCodeImg').innerHTML='<div style="color:var(--success);font-size:24px;padding:40px">✅<br><span style="font-size:14px">已成功连接</span></div>';
+  }else{$('qrStatus').textContent=r.error||'QR 码生成失败，请检查平台配置';}
+  _qrPollTimer=setInterval(async()=>{
+    try{
+      var s=await api('/api/platforms/'+encodeURIComponent(platformId)+'/qr');
+      if(s.status==='connected'){
+        $('qrStatus').innerHTML='<span style="color:var(--success)">✅ 已连接</span>';
+        $('qrCodeImg').innerHTML='<div style="color:var(--success);font-size:24px;padding:40px">✅<br><span style="font-size:14px">已成功连接</span></div>';
+        $('qrActions').style.display='none';
+        clearInterval(_qrPollTimer);_qrPollTimer=null;
+        showToast('QR 绑定成功！','success');renderPlatforms();
+      }else if(s.status==='waiting_scan'&&s.qr_code){
+        $('qrCodeImg').innerHTML='<img src="data:image/png;base64,'+s.qr_code+'" style="width:256px;height:256px;border-radius:8px" alt="QR Code">';
+        $('qrStatus').innerHTML='<span style="color:var(--warn)">⏳ 等待扫码...</span>';
+        $('qrActions').style.display='block';
+      }else if(s.status==='disconnected'){
+        $('qrStatus').innerHTML='<span style="color:var(--danger)">❌ 已断开</span>';
+        $('qrActions').style.display='block';
+      }
+    }catch(e){}
+  },3000);
+}
+async function requestNewQR(platformId){
+  $('qrStatus').textContent='正在刷新 QR 码...';
+  $('qrCodeImg').innerHTML='加载中...';
+  var r=await api('/api/platforms/'+encodeURIComponent(platformId)+'/qr',{method:'POST'});
+  if(r.error){$('qrStatus').textContent='错误: '+escHtml(r.error);return}
+  if(r.qr_code){
+    $('qrCodeImg').innerHTML='<img src="data:image/png;base64,'+r.qr_code+'" style="width:256px;height:256px;border-radius:8px" alt="QR Code">';
+    $('qrStatus').innerHTML='<span style="color:var(--warn)">⏳ 等待扫码...</span>';
+  }
+}
+
 // Agent 选择器（从部门树选择 Agent）
 async function showAgentSelectorForPlatform(inputId,containerId){
   try{