From d91a309419d26288d615e86c3837eff7b7e4c8eb Mon Sep 17 00:00:00 2001
From: stswangzhiping <59632378+stswangzhiping@users.noreply.github.com>
Date: Fri, 15 May 2026 18:02:51 +0800
Subject: [PATCH] docs: clarify url vs code fields in qrcode event

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 lib/channel/weixin.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/channel/weixin.js b/lib/channel/weixin.js
index b8e20e3..bbc316b 100644
--- a/lib/channel/weixin.js
+++ b/lib/channel/weixin.js
@@ -312,6 +312,8 @@ async function _runLogin({ callId, timeoutMs, botType, emit, isAborted }) {
     emit({
       action: 'event',
       event:  'qrcode',
+      // url  = qrcode_img_content: the WeChat URL encoded inside the QR image (use this for QR rendering)
+      // code = qrcode: the polling ticket used by _pollQRStatus (NOT for QR rendering)
       data:   { url: activeLogin.qrcodeUrl, code: activeLogin.qrcode, expire: 30, index: qrRefreshCount },
     });
     log.info('weixin', `callId=${callId} qrcode emitted index=${qrRefreshCount}`);