@seamnet/client 0.13.3 → 0.13.5

package/lib/guardian.js

@@ -130,6 +130,19 @@ export async function guardianRun() {
     process.exit(1);
   }
 
+  // 单例保证：检查 PID 文件，如已有别的活进程则退出
+  const existingPid = readGuardianPid();
+  if (existingPid !== null && existingPid !== process.pid && isPidAlive(existingPid)) {
+    console.error(`Guardian already running (pid: ${existingPid}). Exiting.`);
+    process.exit(0);
+  }
+  // 写 PID（覆盖 guardianStart 写的 child.pid），退出时清理
+  writeFileSync(PID_PATH, String(process.pid));
+  const cleanPid = () => { try { if (existsSync(PID_PATH)) unlinkSync(PID_PATH); } catch {} };
+  process.on('exit', cleanPid);
+  process.on('SIGTERM', () => { cleanPid(); process.exit(0); });
+  process.on('SIGINT', () => { cleanPid(); process.exit(0); });
+
   const credentials = JSON.parse(readFileSync(CREDENTIALS_PATH, 'utf8'));
   const ccSession = process.env.SEAM_CC_SESSION || '';
   const ccSocket = process.env.SEAM_CC_SOCKET || resolveTmuxSocketPath() || '';

package/lib/plugins/im/index.cjs

@@ -74,6 +74,19 @@ const { validatePayload } = require('../../contracts/actions.cjs');
   }
 })();
 
+// SDK 依赖 window.addEventListener("online") 触发内部 reConnect()。
+// 用真实 EventEmitter 让 SDK 注册的 listener 能被 emit 调用。
+const { EventEmitter: _PolyfillEmitter } = require('node:events');
+const _windowEvents = new _PolyfillEmitter();
+const _documentEvents = new _PolyfillEmitter();
+
+// SDK 的 NetMonitor 检查 previous !== current 才 reConnect。
+// 必须先 offline 再 online，否则 online→online 不触发。
+function emitNetworkRecovery() {
+  _windowEvents.emit('offline');
+  setImmediate(() => _windowEvents.emit('online'));
+}
+
 function setupSdkGlobals() {
   if (global._imSdkGlobalsSet) return;
   global._imSdkGlobalsSet = true;
@@ -84,8 +97,8 @@ function setupSdkGlobals() {
       host: 'localhost',
       hostname: 'localhost',
     },
-    addEventListener: () => {},
-    removeEventListener: () => {},
+    addEventListener: (type, fn) => _windowEvents.on(type, fn),
+    removeEventListener: (type, fn) => _windowEvents.off(type, fn),
     URL: Object.assign(
       function (...a) {
         return new (require('node:url').URL)(...a);
@@ -97,8 +110,8 @@ function setupSdkGlobals() {
     ),
   };
   global.document = {
-    addEventListener: () => {},
-    removeEventListener: () => {},
+    addEventListener: (type, fn) => _documentEvents.on(type, fn),
+    removeEventListener: (type, fn) => _documentEvents.off(type, fn),
     characterSet: 'UTF-8',
   };
   global.navigator = { userAgent: 'node', language: 'en', platform: 'linux' };
@@ -371,13 +384,17 @@ function createImPlugin() {
     return {
       onSdkReady: () => {
         if (gen !== chatGeneration) return;
-        // sdkReady 的置 true 统一在 rebuildChat/init 成功 swap 后做，handler 只记录
+        // SDK 自愈成功（reConnect 或 rebuild 后）
+        sdkReady = true;
+        clearNotReadyGrace();
         log.info('sdk_ready', { userId: myUserId, gen });
       },
       onSdkNotReady: () => {
         if (gen !== chatGeneration) return;
         sdkReady = false;
         log.warn('sdk_not_ready', { gen });
+        // 启动 grace timer：5 分钟没自愈就 rebuild
+        startNotReadyGrace();
       },
       onSdkError: (event) => {
         if (gen !== chatGeneration) return;
@@ -567,11 +584,12 @@ function createImPlugin() {
   // ===== 候选模式构建新 chat（失败则隔离销毁，不污染 active chat）=====
   async function buildChatCandidate() {
     const myGen = ++chatGeneration;
-    // 清 globals，让 setupSdkGlobals 重新铺 window 等
+    // 先铺 window（带真实 EventEmitter），再 create——
+    // SDK 在 create 时注册 window.addEventListener("online", reConnect)
     delete global.window;
     global._imSdkGlobalsSet = false;
-    const nextChat = TencentCloudChat.create({ SDKAppID: Number(credentialsRef.sdkAppId) });
     setupSdkGlobals();
+    const nextChat = TencentCloudChat.create({ SDKAppID: Number(credentialsRef.sdkAppId) });
     try {
       const TIMUploadPlugin = require('tim-upload-plugin');
       nextChat.registerPlugin({ 'tim-upload-plugin': TIMUploadPlugin });
@@ -690,15 +708,51 @@ function createImPlugin() {
     setTimeout(() => { doRebuild(reason).catch(() => {}); }, REBUILD_DEBOUNCE_MS);
   }
 
+  let keepaliveFailCount = 0;
+  let notReadyGraceTimer = null;
+  const NOT_READY_GRACE_MS = 5 * 60 * 1000; // SDK_NOT_READY 后 5 分钟没恢复就 rebuild
+
+  function startNotReadyGrace() {
+    if (notReadyGraceTimer) return;
+    notReadyGraceTimer = setTimeout(() => {
+      notReadyGraceTimer = null;
+      if (!sdkReady && !rebuilding && !rebuildScheduled) {
+        log.warn('not_ready_grace_expired');
+        scheduleRebuild('not_ready_grace_expired');
+      }
+    }, NOT_READY_GRACE_MS);
+  }
+
+  function clearNotReadyGrace() {
+    if (notReadyGraceTimer) { clearTimeout(notReadyGraceTimer); notReadyGraceTimer = null; }
+  }
+
   function startKeepalive() {
     if (keepaliveTimer) return;
     keepaliveTimer = setInterval(async () => {
-      if (!sdkReady || rebuilding || rebuildScheduled) return;
+      if (rebuilding || rebuildScheduled) return;
+      // sdkReady=false 时也检测（NOT_READY 后需要探测恢复）
+      if (!sdkReady) {
+        // 尝试 emit 网络恢复信号帮 SDK 重连
+        log.info('keepalive_nudge_not_ready');
+        emitNetworkRecovery();
+        return;
+      }
       try {
         await withTimeout(chat.getMyProfile(), KEEPALIVE_TIMEOUT_MS, 'keepalive');
+        keepaliveFailCount = 0;
       } catch (e) {
-        log.warn('keepalive_failed', { message: e.message });
-        scheduleRebuild(`keepalive:${e.message}`);
+        keepaliveFailCount += 1;
+        log.warn('keepalive_failed', { message: e.message, failCount: keepaliveFailCount });
+        if (keepaliveFailCount === 1) {
+          // 第一次失败：模拟断网恢复，让 SDK 内部 reConnect()
+          log.info('emitting_network_recovery');
+          emitNetworkRecovery();
+        } else {
+          // 连续失败：SDK 自愈没成功，升级到 rebuild
+          scheduleRebuild(`keepalive_consecutive:${keepaliveFailCount}`);
+          keepaliveFailCount = 0;
+        }
       }
     }, KEEPALIVE_INTERVAL_MS);
   }
@@ -827,6 +881,7 @@ function createImPlugin() {
       clearTimeout(rebuildRetryTimer);
       rebuildRetryTimer = null;
     }
+    clearNotReadyGrace();
     if (processRejectionHandler) {
       try { process.off('unhandledRejection', processRejectionHandler); } catch {}
       processRejectionHandler = null;

package/package.json

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