@seamnet/client 0.12.6 → 0.13.0

package/lib/guardian.js

@@ -240,6 +240,24 @@ export async function guardianRun() {
   };
   process.on('SIGTERM', () => shutdown('SIGTERM'));
   process.on('SIGINT', () => shutdown('SIGINT'));
+
+  // 最后防线：未捕获异常/Promise 只记录不退出，防止 SDK 一个错误把整个 guardian 炸了
+  process.on('uncaughtException', (err) => {
+    try {
+      hub.logger('guardian').error('uncaught_exception', err, {
+        message: err?.message?.slice(0, 300),
+        code: err?.code,
+      });
+    } catch {}
+  });
+  process.on('unhandledRejection', (reason) => {
+    try {
+      hub.logger('guardian').error('unhandled_rejection', reason, {
+        message: reason?.message?.slice(0, 300) || String(reason).slice(0, 300),
+        code: reason?.code,
+      });
+    } catch {}
+  });
 }
 
 export async function guardianStop() {

package/lib/plugins/im/index.cjs

@@ -134,6 +134,19 @@ function createImPlugin() {
   // userId → nick 缓存；null 表示已查过但无 nick，避免反复拉
   const displayNameCache = new Map();
 
+  // ===== Supervisor 状态（SDK 僵尸时自动重建 chat 实例）=====
+  let credentialsRef = null;
+  let rebuildInProgress = false;
+  let lastRebuildAt = 0;
+  let keepaliveTimer = null;
+  let processRejectionHandler = null;
+  const REBUILD_COOLDOWN_MS = 10_000;
+  const REBUILD_DEBOUNCE_MS = 3_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]);
+
   async function prefetchDisplayName(userId) {
     if (!chat || !userId || displayNameCache.has(userId)) return;
     displayNameCache.set(userId, null);
@@ -326,6 +339,255 @@ function createImPlugin() {
     return { ok: true };
   }
 
+  // ===== 事件 handler（独立函数，便于 rebuild 时重新注册）=====
+
+  function onSdkReady() {
+    sdkReady = true;
+    log.info('sdk_ready', { userId: myUserId });
+  }
+
+  function onSdkNotReady() {
+    sdkReady = false;
+    log.warn('sdk_not_ready');
+  }
+
+  function onSdkError(event) {
+    const err = event?.data || event;
+    const code = err?.code;
+    log.warn('sdk_error', {
+      code,
+      message: err?.message || String(err).slice(0, 200),
+    });
+    if (SDK_REBUILD_ERROR_CODES.has(code)) {
+      scheduleRebuild(`sdk_error:${code}`);
+    }
+  }
+
+  function onKickedOut(event) {
+    log.warn('sdk_kicked_out', {
+      type: event?.data?.type,
+      message: event?.data?.message,
+    });
+    sdkReady = false;
+    scheduleRebuild('kicked_out');
+  }
+
+  function onNetStateChange(event) {
+    log.info('sdk_net_state', { state: event?.data?.state });
+  }
+
+  function onFriendListUpdated() {
+    refreshContactsFromFriendList().catch((err) => {
+      log.warn('refresh_contacts_on_update_failed', { message: err.message });
+    });
+  }
+
+  function onMessageReceived(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() {
+    chat.on(TencentCloudChat.EVENT.SDK_READY, onSdkReady);
+    chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, onSdkNotReady);
+    chat.on(TencentCloudChat.EVENT.ERROR, onSdkError);
+    chat.on(TencentCloudChat.EVENT.KICKED_OUT, onKickedOut);
+    chat.on(TencentCloudChat.EVENT.NET_STATE_CHANGE, onNetStateChange);
+    chat.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, onMessageReceived);
+    try {
+      chat.on(TencentCloudChat.EVENT.FRIEND_LIST_UPDATED, onFriendListUpdated);
+    } catch (err) {
+      log.warn('friend_list_listener_register_failed', { message: err.message });
+    }
+  }
+
+  // ===== 重建 chat 实例（SDK 僵尸时用）=====
+
+  async function createAndLoginChat() {
+    delete global.window;
+    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 chat.login({
+      userID: myUserId,
+      userSig: credentialsRef.userSig,
+    });
+    // 等 SDK_READY（最多 10s）
+    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 });
+    sdkReady = false;
+    try { await chat.logout(); } catch {}
+    try { chat.destroy && chat.destroy(); } catch {}
+    try {
+      await createAndLoginChat();
+      try { await refreshContactsFromFriendList(); } catch {}
+      log.info('chat_rebuild_done', { reason });
+    } catch (e) {
+      log.error('chat_rebuild_failed', e, { reason });
+    }
+  }
+
+  function scheduleRebuild(reason) {
+    if (rebuildInProgress) return;
+    const now = Date.now();
+    if (now - lastRebuildAt < REBUILD_COOLDOWN_MS) {
+      log.info('chat_rebuild_skipped_cooldown', { reason });
+      return;
+    }
+    rebuildInProgress = true;
+    setTimeout(async () => {
+      try {
+        await rebuildChat(reason);
+        lastRebuildAt = Date.now();
+      } finally {
+        rebuildInProgress = false;
+      }
+    }, REBUILD_DEBOUNCE_MS);
+  }
+
+  function startKeepalive() {
+    if (keepaliveTimer) return;
+    keepaliveTimer = setInterval(async () => {
+      if (!sdkReady || rebuildInProgress) return;
+      try {
+        await Promise.race([
+          chat.getMyProfile(),
+          new Promise((_, reject) =>
+            setTimeout(() => reject(new Error('keepalive timeout')), KEEPALIVE_TIMEOUT_MS)
+          ),
+        ]);
+      } 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,6 +607,7 @@ function createImPlugin() {
     }
 
     myUserId = credentials.userId;
+    credentialsRef = credentials;
 
     // 先 delete window 让 SDK 走 node 路径
     delete global.window;
@@ -364,148 +627,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');
-    });
-
-    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 });
@@ -533,20 +656,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
@@ -563,6 +676,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) {
@@ -598,6 +726,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.6",
+  "version": "0.13.0",
   "description": "One command to join Seam — the network where people and AI stay in sync.",
   "bin": {
     "seam-client": "bin/cli.js",