@seamnet/client 0.12.7 → 0.13.1

package/lib/plugins/im/index.cjs

@@ -134,6 +134,37 @@ function createImPlugin() {
   // userId → nick 缓存；null 表示已查过但无 nick，避免反复拉
   const displayNameCache = new Map();
 
+  // ===== Supervisor 状态（SDK 僵尸时自动重建 chat 实例）=====
+  let credentialsRef = null;
+  // 状态机：scheduled（待启动）/ rebuilding（进行中）；期间又来信号标记 requestedAgain
+  let rebuildScheduled = false;
+  let rebuilding = false;
+  let rebuildRequestedAgain = false;
+  let lastRebuildSuccessAt = 0;
+  let chatGeneration = 0;  // chat 实例代数，每次 create 递增；listener 校验代数，老代事件忽略
+  let keepaliveTimer = null;
+  let processRejectionHandler = null;
+  const REBUILD_COOLDOWN_MS = 10_000;
+  const REBUILD_DEBOUNCE_MS = 3_000;
+  const REBUILD_WATCHDOG_MS = 30_000;      // 整个重建最多 30s，超时强制失败
+  const SDK_CALL_TIMEOUT_MS = 10_000;      // 单个 SDK 调用超时
+  const LOGOUT_TIMEOUT_MS = 5_000;
+  const LOGIN_TIMEOUT_MS = 15_000;
+  const KEEPALIVE_INTERVAL_MS = 3 * 60 * 1000;
+  const KEEPALIVE_TIMEOUT_MS = 10_000;
+  // SDK 错误 code 需要触发 rebuild（2801=PING 超时，WebSocket 应用层僵尸）
+  const SDK_REBUILD_ERROR_CODES = new Set([2801]);
+
+  function withTimeout(promise, ms, name) {
+    let tid = null;
+    const timeoutP = new Promise((_, reject) => {
+      tid = setTimeout(() => reject(new Error(`${name} timeout ${ms}ms`)), ms);
+    });
+    return Promise.race([promise, timeoutP]).finally(() => {
+      if (tid) clearTimeout(tid);
+    });
+  }
+
   async function prefetchDisplayName(userId) {
     if (!chat || !userId || displayNameCache.has(userId)) return;
     displayNameCache.set(userId, null);
@@ -326,6 +357,296 @@ function createImPlugin() {
     return { ok: true };
   }
 
+  // ===== 事件 handler 工厂（每次 setupAllListeners 时绑定当前 generation）=====
+  // handler 校验 generation，老实例晚到的事件直接忽略，避免污染新状态
+
+  function makeHandlers(gen) {
+    return {
+      onSdkReady: () => {
+        if (gen !== chatGeneration) return;
+        sdkReady = true;
+        log.info('sdk_ready', { userId: myUserId, gen });
+      },
+      onSdkNotReady: () => {
+        if (gen !== chatGeneration) return;
+        sdkReady = false;
+        log.warn('sdk_not_ready', { gen });
+      },
+      onSdkError: (event) => {
+        if (gen !== chatGeneration) return;
+        const err = event?.data || event;
+        const code = err?.code;
+        log.warn('sdk_error', {
+          code,
+          message: err?.message || String(err).slice(0, 200),
+          gen,
+        });
+        if (SDK_REBUILD_ERROR_CODES.has(code)) {
+          scheduleRebuild(`sdk_error:${code}`);
+        }
+      },
+      onKickedOut: (event) => {
+        if (gen !== chatGeneration) return;
+        log.warn('sdk_kicked_out', {
+          type: event?.data?.type,
+          message: event?.data?.message,
+          gen,
+        });
+        sdkReady = false;
+        scheduleRebuild('kicked_out');
+      },
+      onNetStateChange: (event) => {
+        if (gen !== chatGeneration) return;
+        log.info('sdk_net_state', { state: event?.data?.state, gen });
+      },
+      onFriendListUpdated: () => {
+        if (gen !== chatGeneration) return;
+        refreshContactsFromFriendList().catch((err) => {
+          log.warn('refresh_contacts_on_update_failed', { message: err.message });
+        });
+      },
+      onMessageReceived: (event) => {
+        if (gen !== chatGeneration) return;
+        handleMessageEvent(event);
+      },
+    };
+  }
+
+  function handleMessageEvent(event) {
+    for (const msg of event.data) {
+      if (msg.from === myUserId) continue;
+
+      const isGroup = msg.conversationType === TencentCloudChat.TYPES.CONV_GROUP;
+      const sender = msg.from;
+      if (!msg.nick && !displayNameCache.has(sender)) {
+        prefetchDisplayName(sender).catch(() => {});
+      }
+      const senderDisplay = formatSenderDisplay(msg);
+      const groupId = isGroup ? msg.to : null;
+      const ts = new Date().toTimeString().slice(0, 5);
+      const conversationType = msg.conversationType;
+      const replyTool = isGroup ? 'seam msg group' : 'seam msg send';
+
+      // 图片消息
+      if (msg.type === TencentCloudChat.TYPES.MSG_IMAGE) {
+        const inbox = hub.service('inbox');
+        const imgInfo =
+          msg.payload?.imageInfoArray?.find((i) => i.sizeType === 3) ||
+          msg.payload?.imageInfoArray?.[0];
+        if (imgInfo?.url && inbox) {
+          (async () => {
+            try {
+              const resp = await fetch(imgInfo.url);
+              if (!resp.ok) throw new Error(`http ${resp.status}`);
+              const buf = Buffer.from(await resp.arrayBuffer());
+              const p = inbox.save(buf, { ext: 'jpg', src: 'im' });
+              log.info('im_image_saved', { sender, bytes: buf.length, path: p });
+              const prefix = isGroup
+                ? `💬 [Seam群图片 ${ts} ${groupId} → ${replyTool}]`
+                : `💬 [Seam图片 ${ts} → ${replyTool}]`;
+              hub.inject(`${prefix} ${senderDisplay} → ${p}`);
+            } catch (e) {
+              log.error('im_image_download_failed', e, { sender });
+              hub.inject(`💬 [Seam ${ts} → ${replyTool}] ${senderDisplay}: [图片下载失败: ${e.message}]`);
+            }
+          })();
+        }
+        continue;
+      }
+
+      // 文件消息
+      if (msg.type === TencentCloudChat.TYPES.MSG_FILE) {
+        const inbox = hub.service('inbox');
+        const fileUrl = msg.payload?.fileUrl;
+        const fileName = msg.payload?.fileName || `file_${Date.now()}.bin`;
+        const ext = path.extname(fileName).replace(/^\./, '') || 'bin';
+        if (fileUrl && inbox) {
+          (async () => {
+            try {
+              const resp = await fetch(fileUrl);
+              if (!resp.ok) throw new Error(`http ${resp.status}`);
+              const buf = Buffer.from(await resp.arrayBuffer());
+              const p = inbox.save(buf, { ext, src: 'im' });
+              log.info('im_file_saved', { sender, bytes: buf.length, path: p });
+              const prefix = isGroup
+                ? `💬 [Seam群文件 ${ts} ${groupId} → ${replyTool}]`
+                : `💬 [Seam文件 ${ts} → ${replyTool}]`;
+              hub.inject(
+                `${prefix} ${senderDisplay} → ${p} (原名: ${fileName}, ${buf.length} bytes)`
+              );
+            } catch (e) {
+              log.error('im_file_download_failed', e, { sender });
+              hub.inject(`💬 [Seam ${ts} → ${replyTool}] ${sender}: [文件下载失败: ${e.message}]`);
+            }
+          })();
+        }
+        continue;
+      }
+
+      // 文本消息
+      let text = '';
+      if (msg.type === TencentCloudChat.TYPES.MSG_TEXT) {
+        text = msg.payload.text;
+      } else {
+        text = `[${msg.type}]`;
+      }
+      if (!text) continue;
+
+      log.info('message_received', { from: msg.from, isGroup, textLength: text.length });
+
+      const bufferKey = isGroup ? `im:group:${msg.to}:${msg.from}` : `im:${msg.from}`;
+      const makePrefix = (ts2) =>
+        isGroup
+          ? `💬 [Seam群 ${ts2} ${groupId} → ${replyTool}]`
+          : `💬 [Seam ${ts2} → ${replyTool}]`;
+
+      if (messageBuffer) {
+        messageBuffer.queueText(
+          bufferKey,
+          text,
+          (items) => {
+            const tsNow = new Date().toTimeString().slice(0, 5);
+            const prefix = makePrefix(tsNow);
+            const joined = items.map((i) => i.content).join('\n');
+            if (items.length === 1) {
+              hub.inject(`${prefix} ${senderDisplay}: ${joined}`);
+            } else {
+              hub.inject(`${prefix} ${senderDisplay}:\n${joined}`);
+            }
+            if (eventBus) {
+              eventBus.emit('im.message', { from: sender, text: joined, isGroup, groupId, conversationType });
+            }
+          },
+          { delay: 5000, maxDelay: 15000 }
+        );
+      } else {
+        const tsNow = new Date().toTimeString().slice(0, 5);
+        hub.inject(`${makePrefix(tsNow)} ${senderDisplay}: ${text}`);
+        if (eventBus) {
+          eventBus.emit('im.message', { from: sender, text, isGroup, groupId, conversationType });
+        }
+      }
+    }
+  }
+
+  function setupAllListeners() {
+    const h = makeHandlers(chatGeneration);
+    chat.on(TencentCloudChat.EVENT.SDK_READY, h.onSdkReady);
+    chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, h.onSdkNotReady);
+    chat.on(TencentCloudChat.EVENT.ERROR, h.onSdkError);
+    chat.on(TencentCloudChat.EVENT.KICKED_OUT, h.onKickedOut);
+    chat.on(TencentCloudChat.EVENT.NET_STATE_CHANGE, h.onNetStateChange);
+    chat.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, h.onMessageReceived);
+    try {
+      chat.on(TencentCloudChat.EVENT.FRIEND_LIST_UPDATED, h.onFriendListUpdated);
+    } catch (err) {
+      log.warn('friend_list_listener_register_failed', { message: err.message });
+    }
+  }
+
+  // ===== 重建 chat 实例（SDK 僵尸时用）=====
+
+  async function createAndLoginChat() {
+    // 每次 create 递增 generation，让老实例的 handler 自动失效
+    chatGeneration += 1;
+    // 清理 globals 让 setupSdkGlobals 能重新设置 window 等
+    delete global.window;
+    global._imSdkGlobalsSet = false;
+    chat = TencentCloudChat.create({ SDKAppID: Number(credentialsRef.sdkAppId) });
+    setupSdkGlobals();
+    try {
+      const TIMUploadPlugin = require('tim-upload-plugin');
+      chat.registerPlugin({ 'tim-upload-plugin': TIMUploadPlugin });
+    } catch {}
+    chat.setLogLevel(4);
+    setupAllListeners();
+    await withTimeout(
+      chat.login({ userID: myUserId, userSig: credentialsRef.userSig }),
+      LOGIN_TIMEOUT_MS,
+      'chat.login'
+    );
+    // 等 SDK_READY（最多 10s）——sdkReady 可能已被 handler 置 true
+    await new Promise((resolve) => {
+      if (sdkReady) return resolve();
+      const timer = setTimeout(() => resolve(), 10000);
+      const once = () => { clearTimeout(timer); resolve(); };
+      chat.on(TencentCloudChat.EVENT.SDK_READY, once);
+    });
+  }
+
+  async function rebuildChat(reason) {
+    log.warn('chat_rebuild_start', { reason, prevGen: chatGeneration });
+    sdkReady = false;
+    // 每步都 timeout：老 chat 僵尸可能让 logout 永不 resolve
+    const oldChat = chat;
+    try {
+      await withTimeout(oldChat.logout().catch(() => {}), LOGOUT_TIMEOUT_MS, 'logout');
+    } catch (e) {
+      log.warn('logout_timeout', { message: e.message });
+    }
+    try { oldChat.destroy && oldChat.destroy(); } catch {}
+    // createAndLoginChat 自身会递增 chatGeneration，老 listener 自动失效
+    await createAndLoginChat();
+    try {
+      await withTimeout(refreshContactsFromFriendList(), SDK_CALL_TIMEOUT_MS, 'refresh_contacts');
+    } catch (e) {
+      log.warn('refresh_contacts_after_rebuild_timeout', { message: e.message });
+    }
+    log.info('chat_rebuild_done', { reason, newGen: chatGeneration });
+  }
+
+  async function doRebuild(reason) {
+    rebuildScheduled = false;
+    rebuilding = true;
+    try {
+      await withTimeout(rebuildChat(reason), REBUILD_WATCHDOG_MS, 'rebuild_watchdog');
+      lastRebuildSuccessAt = Date.now();
+    } catch (e) {
+      log.error('chat_rebuild_failed', e, { reason, message: e.message });
+      // 注意：lastRebuildSuccessAt 不更新，允许立即重试（不被 cooldown 拦）
+    } finally {
+      rebuilding = false;
+      if (rebuildRequestedAgain) {
+        rebuildRequestedAgain = false;
+        scheduleRebuild('trailing');
+      }
+    }
+  }
+
+  function scheduleRebuild(reason) {
+    // 已在重建中：标记 trailing，结束后再跑一轮
+    if (rebuilding) {
+      rebuildRequestedAgain = true;
+      log.info('chat_rebuild_queued_trailing', { reason });
+      return;
+    }
+    // 已在等待启动：合并（debounce）
+    if (rebuildScheduled) return;
+    // Cooldown 只针对上次"成功"的重建——失败后允许立即重试
+    const now = Date.now();
+    if (now - lastRebuildSuccessAt < REBUILD_COOLDOWN_MS) {
+      log.info('chat_rebuild_skipped_cooldown', { reason });
+      return;
+    }
+    // 立即降级：阻止发送路径继续用坏 chat
+    sdkReady = false;
+    rebuildScheduled = true;
+    setTimeout(() => { doRebuild(reason).catch(() => {}); }, REBUILD_DEBOUNCE_MS);
+  }
+
+  function startKeepalive() {
+    if (keepaliveTimer) return;
+    keepaliveTimer = setInterval(async () => {
+      if (!sdkReady || rebuilding || rebuildScheduled) return;
+      try {
+        await withTimeout(chat.getMyProfile(), KEEPALIVE_TIMEOUT_MS, 'keepalive');
+      } catch (e) {
+        log.warn('keepalive_failed', { message: e.message });
+        scheduleRebuild(`keepalive:${e.message}`);
+      }
+    }, KEEPALIVE_INTERVAL_MS);
+  }
+
   async function init(h) {
     hub = h;
     log = hub.logger('im');
@@ -345,10 +666,12 @@ function createImPlugin() {
     }
 
     myUserId = credentials.userId;
+    credentialsRef = credentials;
 
     // 先 delete window 让 SDK 走 node 路径
     delete global.window;
     TencentCloudChat = require('@tencentcloud/chat');
+    chatGeneration += 1;  // 首次也是 gen 1（listener 校验需要）
     chat = TencentCloudChat.create({ SDKAppID: Number(credentials.sdkAppId) });
 
     // 然后补上 SDK 运行所需的 window/document 等全局
@@ -364,171 +687,8 @@ function createImPlugin() {
 
     chat.setLogLevel(4);
 
-    chat.on(TencentCloudChat.EVENT.SDK_READY, () => {
-      sdkReady = true;
-      log.info('sdk_ready', { userId: myUserId });
-    });
-
-    chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, () => {
-      sdkReady = false;
-      log.warn('sdk_not_ready');
-    });
-
-    // SDK 错误事件：记录但不 throw，避免 guardian 整个 crash
-    chat.on(TencentCloudChat.EVENT.ERROR, (event) => {
-      const err = event?.data || event;
-      log.warn('sdk_error', {
-        code: err?.code,
-        message: err?.message || String(err).slice(0, 200),
-      });
-    });
-
-    // 被踢下线（2801 等多端登录场景）：记录，SDK 会自动重连
-    chat.on(TencentCloudChat.EVENT.KICKED_OUT, (event) => {
-      log.warn('sdk_kicked_out', {
-        type: event?.data?.type,
-        message: event?.data?.message,
-      });
-      sdkReady = false;
-    });
-
-    // 网络状态变化：断线/重连都只记日志，不干扰主流程
-    chat.on(TencentCloudChat.EVENT.NET_STATE_CHANGE, (event) => {
-      log.info('sdk_net_state', { state: event?.data?.state });
-    });
-
-    chat.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, (event) => {
-      for (const msg of event.data) {
-        if (msg.from === myUserId) continue;
-
-        const isGroup = msg.conversationType === TencentCloudChat.TYPES.CONV_GROUP;
-        // sender 用于 event-bus（保持 userId 原始值）；senderDisplay 用于注入终端（name · userId）
-        const sender = msg.from;
-        // 若无 msg.nick 且未缓存，异步拉 profile（下次消息就能用）
-        if (!msg.nick && !displayNameCache.has(sender)) {
-          prefetchDisplayName(sender).catch(() => {});
-        }
-        const senderDisplay = formatSenderDisplay(msg);
-        const groupId = isGroup ? msg.to : null;
-        const ts = new Date().toTimeString().slice(0, 5);
-        const conversationType = msg.conversationType;
-
-        const replyTool = isGroup ? 'seam msg group' : 'seam msg send';
-
-        // 图片消息：下载 URL 存 inbox
-        if (msg.type === TencentCloudChat.TYPES.MSG_IMAGE) {
-          const inbox = hub.service('inbox');
-          const imgInfo =
-            msg.payload?.imageInfoArray?.find((i) => i.sizeType === 3) ||
-            msg.payload?.imageInfoArray?.[0];
-          if (imgInfo?.url && inbox) {
-            (async () => {
-              try {
-                const resp = await fetch(imgInfo.url);
-                if (!resp.ok) throw new Error(`http ${resp.status}`);
-                const buf = Buffer.from(await resp.arrayBuffer());
-                const p = inbox.save(buf, { ext: 'jpg', src: 'im' });
-                log.info('im_image_saved', { sender, bytes: buf.length, path: p });
-                const prefix = isGroup
-                  ? `💬 [Seam群图片 ${ts} ${groupId} → ${replyTool}]`
-                  : `💬 [Seam图片 ${ts} → ${replyTool}]`;
-                hub.inject(`${prefix} ${senderDisplay} → ${p}`);
-              } catch (e) {
-                log.error('im_image_download_failed', e, { sender });
-                hub.inject(`💬 [Seam ${ts} → ${replyTool}] ${senderDisplay}: [图片下载失败: ${e.message}]`);
-              }
-            })();
-          }
-          continue;
-        }
-
-        // 文件消息
-        if (msg.type === TencentCloudChat.TYPES.MSG_FILE) {
-          const inbox = hub.service('inbox');
-          const fileUrl = msg.payload?.fileUrl;
-          const fileName = msg.payload?.fileName || `file_${Date.now()}.bin`;
-          const ext = path.extname(fileName).replace(/^\./, '') || 'bin';
-          if (fileUrl && inbox) {
-            (async () => {
-              try {
-                const resp = await fetch(fileUrl);
-                if (!resp.ok) throw new Error(`http ${resp.status}`);
-                const buf = Buffer.from(await resp.arrayBuffer());
-                const p = inbox.save(buf, { ext, src: 'im' });
-                log.info('im_file_saved', { sender, bytes: buf.length, path: p });
-                const prefix = isGroup
-                  ? `💬 [Seam群文件 ${ts} ${groupId} → ${replyTool}]`
-                  : `💬 [Seam文件 ${ts} → ${replyTool}]`;
-                hub.inject(
-                  `${prefix} ${senderDisplay} → ${p} (原名: ${fileName}, ${buf.length} bytes)`
-                );
-              } catch (e) {
-                log.error('im_file_download_failed', e, { sender });
-                hub.inject(`💬 [Seam ${ts} → ${replyTool}] ${sender}: [文件下载失败: ${e.message}]`);
-              }
-            })();
-          }
-          continue;
-        }
-
-        // 文本消息（含其他未处理类型用占位）
-        let text = '';
-        if (msg.type === TencentCloudChat.TYPES.MSG_TEXT) {
-          text = msg.payload.text;
-        } else {
-          text = `[${msg.type}]`;
-        }
-        if (!text) continue;
-
-        log.info('message_received', {
-          from: msg.from,
-          isGroup,
-          textLength: text.length,
-        });
-
-        const bufferKey = isGroup
-          ? `im:group:${msg.to}:${msg.from}`
-          : `im:${msg.from}`;
-
-        const makePrefix = (ts2) =>
-          isGroup
-            ? `💬 [Seam群 ${ts2} ${groupId} → ${replyTool}]`
-            : `💬 [Seam ${ts2} → ${replyTool}]`;
-
-        if (messageBuffer) {
-          messageBuffer.queueText(
-            bufferKey,
-            text,
-            (items) => {
-              const ts = new Date().toTimeString().slice(0, 5);
-              const prefix = makePrefix(ts);
-              const joined = items.map((i) => i.content).join('\n');
-              if (items.length === 1) {
-                hub.inject(`${prefix} ${senderDisplay}: ${joined}`);
-              } else {
-                hub.inject(`${prefix} ${senderDisplay}:\n${joined}`);
-              }
-              if (eventBus) {
-                eventBus.emit('im.message', {
-                  from: sender,
-                  text: joined,
-                  isGroup,
-                  groupId,
-                  conversationType,
-                });
-              }
-            },
-            { delay: 5000, maxDelay: 15000 }
-          );
-        } else {
-          const ts = new Date().toTimeString().slice(0, 5);
-          hub.inject(`${makePrefix(ts)} ${senderDisplay}: ${text}`);
-          if (eventBus) {
-            eventBus.emit('im.message', { from: sender, text, isGroup, groupId, conversationType });
-          }
-        }
-      }
-    });
+    // 所有事件监听通过 setupAllListeners 统一注册（便于 rebuild 时重注册）
+    setupAllListeners();
 
     try {
       await chat.login({ userID: myUserId, userSig: credentials.userSig });
@@ -556,20 +716,10 @@ function createImPlugin() {
     });
 
     // 拉一次好友列表建立关系表 contacts.json
+    // FRIEND_LIST_UPDATED 监听已在 setupAllListeners 里注册
     seedDisplayNameFromContacts();
     await refreshContactsFromFriendList();
 
-    // 监听好友列表变化（加/删好友触发），自动更新 contacts.json
-    try {
-      chat.on(TencentCloudChat.EVENT.FRIEND_LIST_UPDATED, () => {
-        refreshContactsFromFriendList().catch((err) => {
-          log.warn('refresh_contacts_on_update_failed', { message: err.message });
-        });
-      });
-    } catch (err) {
-      log.warn('friend_list_listener_register_failed', { message: err.message });
-    }
-
     // 首次入网：给邀请人发一条上线消息（仅一次，用 state 记录）
     if (
       stateScope
@@ -586,6 +736,21 @@ function createImPlugin() {
         log.warn('announce_to_inviter_failed', { message: err.message });
       }
     }
+
+    // ===== 启动 Supervisor：keepalive + unhandled_rejection 监听 =====
+    startKeepalive();
+
+    processRejectionHandler = (reason) => {
+      const code = reason?.code;
+      if (code && SDK_REBUILD_ERROR_CODES.has(code)) {
+        scheduleRebuild(`unhandledRejection:${code}`);
+      }
+    };
+    process.on('unhandledRejection', processRejectionHandler);
+    log.info('supervisor_started', {
+      keepalive_ms: KEEPALIVE_INTERVAL_MS,
+      rebuild_codes: [...SDK_REBUILD_ERROR_CODES],
+    });
   }
 
   async function handleRequest(req) {
@@ -621,6 +786,14 @@ function createImPlugin() {
   }
 
   async function destroy() {
+    if (keepaliveTimer) {
+      clearInterval(keepaliveTimer);
+      keepaliveTimer = null;
+    }
+    if (processRejectionHandler) {
+      try { process.off('unhandledRejection', processRejectionHandler); } catch {}
+      processRejectionHandler = null;
+    }
     if (chat) {
       try {
         await chat.logout();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamnet/client",
-  "version": "0.12.7",
+  "version": "0.13.1",
   "description": "One command to join Seam — the network where people and AI stay in sync.",
   "bin": {
     "seam-client": "bin/cli.js",