tt-help-cli-ycl 1.4.182 → 1.4.184

package/src/cli/explore.js

@@ -1,6 +1,7 @@
 import {
   getOrCreatePage,
   isBrowserClosedError,
+  isRetryableRestoreFailure,
   relaunchBrowser,
 } from "../lib/browser/page.js";
 import {
@@ -28,7 +29,6 @@ import {
 import { showResourceUsage } from "../utils/index.js";
 import {
   HealthChecker,
-  MEMORY_THRESHOLD,
   ROTATE_INTERVAL_MS,
 } from "../lib/browser/health-checker.js";
 import {
@@ -37,8 +37,12 @@ import {
   gotoTiktok,
   injectPoolAccount,
   ensurePoolLogin,
+  crashBackoffMs,
+  retryRestoreOnNavFailure,
 } from "../lib/login-pool-client.js";
+import { getClientConfig } from "../watchdog/reporter.js";
 import { createApiClient } from "../lib/api-client.js";
+import { createErrorReporter } from "../lib/error-report.js";
 import { createCDNHandler } from "../lib/cdn-handler.js";
 import { proxyPortOf, triggerProxySwitch } from "../clash/proxy-switch.js";
 import path from "path";
@@ -48,6 +52,7 @@ const MAX_RETRY_WAIT = 5 * 60 * 1000;
 const MAX_REBUILD_ATTEMPTS = 5; // 账户切换后导航恢复：连续重启浏览器超过该次数仍失败则上报并退出
 const STARTUP_TIKTOK_URL = "https://www.tiktok.com/@ycl5007";
 const PAGE_GOTO_TIMEOUT = 60000; // 页面导航超时 60 秒（账户切换后需要更长时间）
+const CRASH_BACKOFF_SLICE_MS = 1000; // 崩溃熔断/恢复重试等待的分片粒度（分片醒检 shuttingDown）
 
 // 换号原因受控 code（2026-10-30 定稿：服务端 switchStats 按账号聚合展示；
 // 只用这组固定值上报，不传自由文本；startup 首次取号不带 reason）
@@ -110,6 +115,21 @@ export async function handleExplore(options) {
   let poolClient = null; // 账号中心客户端
   let poolAccount = null; // 当前在手账号（含 cookies 与租约 id）
   let poolAccountSince = Date.now(); // 当前账号开始使用时刻（48min 换号计时）
+  // 崩溃熔断状态（F16 实录）：浏览器级注入失败轮数 + 退避窗口截止时刻（窗口内不取号）
+  let crashStreak = 0;
+  let crashBackoffUntil = 0;
+
+  /** 分片 sleep：每 CRASH_BACKOFF_SLICE_MS 醒检 shuttingDown，被中断返回 false */
+  const sleepSliced = async (totalMs) => {
+    let remaining = totalMs;
+    while (remaining > 0) {
+      if (shuttingDown) return false;
+      const slice = Math.min(CRASH_BACKOFF_SLICE_MS, remaining);
+      await new Promise((r) => setTimeout(r, slice));
+      remaining -= slice;
+    }
+    return !shuttingDown;
+  };
 
   const shutdown = async (signal) => {
     if (shuttingDown) return;
@@ -177,11 +197,14 @@ export async function handleExplore(options) {
 
     const poolMode = !exploreNoPool;
     const poolPort = explorePort || exploreBasePort || 9222;
+    // 内存阈值可配置覆盖（~/.tt-help.json memoryThreshold，默认 0.95）：F16 类 7G 双浏览器机可调低提前重启
+    const memoryThresholdConfig = getClientConfig().memoryThreshold;
     const healthChecker = poolMode
-      ? new HealthChecker({ basePort: poolPort, totalAccounts: 1 })
+      ? new HealthChecker({ basePort: poolPort, totalAccounts: 1, memoryThreshold: memoryThresholdConfig })
       : new HealthChecker({
           basePort: exploreBasePort,
           totalAccounts: explorePortCount,
+          memoryThreshold: memoryThresholdConfig,
         });
     let currentAccount = healthChecker.getCurrentAccount();
 
@@ -246,6 +269,15 @@ export async function handleExplore(options) {
       meta: { port: cdpOptions.port },
     });
 
+    // 客户端错误上报封装：自动附带 poolUsername（报错时在手池号）与 proxyNode（当前 clash 节点）
+    const errorReporter = createErrorReporter({
+      apiPost,
+      serverUrl,
+      userId,
+      proxyUrl: resolvedProxy,
+      getState: () => ({ poolUsername: poolAccount?.username || "" }),
+    });
+
     await apiGet(`${serverUrl}/api/stats`);
 
     if (exploreUsernames && exploreUsernames.length > 0) {
@@ -363,8 +395,16 @@ export async function handleExplore(options) {
      * @param code 受控换号原因（SWITCH_REASON，上报服务端 switchStats；可选）；
      *             首选按外层 call site 上报，候选注入失败后的再取号 = inject_fail
      */
-    async function switchPoolAccount(reason, code) {
+    async function switchPoolAccount(reason, code, opts = {}) {
       console.error(`\n[换号] ${reason}，从账号中心取新账号...`);
+      // 崩溃熔断：退避窗口内不取号（保护账号池），分片 sleep 响应 shuttingDown
+      const backoffWaitMs = Math.max(0, crashBackoffUntil - Date.now());
+      if (backoffWaitMs > 0) {
+        console.error(
+          `[浏览器] 崩溃熔断中，${Math.ceil(backoffWaitMs / 1000)}s 后再试（不取号，保护账号池）`,
+        );
+        if (!(await sleepSliced(backoffWaitMs))) return false;
+      }
       for (let attempt = 0; attempt < 5; attempt++) {
         let next = null;
         try {
@@ -379,6 +419,31 @@ export async function handleExplore(options) {
           verifyUsername: next.username,
         }).catch((e) => ({ ok: false, reason: e.message }));
         if (!r.ok) {
+          if (isBrowserClosedError(new Error(r.reason))) {
+            // 浏览器级崩溃：不怪账号，立即中止候选循环（不消耗 inject_fail/recover_fail 口径），
+            // 已取候选照常 release，转同号重启（与内存超限路径同语义）；按轮熔断退避
+            crashStreak++;
+            const backoffMs = crashBackoffMs(crashStreak);
+            crashBackoffUntil = Date.now() + backoffMs;
+            console.error(
+              `[换号] @${next.username} 注入失败为浏览器级崩溃（${r.reason}），中止候选循环（第 ${crashStreak} 轮，熔断 ${Math.round(backoffMs / 1000)}s），释放候选...`,
+            );
+            await poolClient.release(next).catch(() => {});
+            await errorReporter.report({
+              username: poolAccount ? poolAccount.username : "unknown",
+              errorType: "account_switch_failed",
+              errorMessage: `注入失败为浏览器级崩溃，中止候选循环转同号重启（第${crashStreak}轮，熔断${Math.round(backoffMs / 1000)}s）: ${r.reason}`,
+              stage: "account-switch",
+            }).catch(() => {});
+            if (opts.fromRecovery) {
+              // 恢复链中（重启后恢复失败触发的换号）不再递归重启，保留现场等熔断窗口
+              console.error(`[换号] 恢复链中不再递归重启浏览器，保留现场等待熔断窗口`);
+              return false;
+            }
+            return await restartPoolBrowser(
+              `注入验证遭遇浏览器级崩溃（${r.reason}）`,
+            );
+          }
           console.error(
             `[换号] @${next.username} 注入验证失败（${r.reason}），释放候选换下一个...`,
           );
@@ -391,6 +456,7 @@ export async function handleExplore(options) {
         poolAccountSince = Date.now();
         loggedIn = true;
         lastFollowSuccessTime = Date.now();
+        crashStreak = 0; // 注入验证成功即清零熔断轮数
         captchaCount = 0;
         blockedCount = 0;
         cdn.reset();
@@ -407,8 +473,7 @@ export async function handleExplore(options) {
         return true;
       }
       console.error(`[换号] 连续 5 个候选注入验证失败，保留现场等待下轮重试`);
-      await apiPost(`${serverUrl}/api/error-report`, {
-        userId,
+      await errorReporter.report({
         username: poolAccount ? poolAccount.username : "unknown",
         errorType: "account_switch_failed",
         errorMessage: "连续5个候选账号注入验证失败（详情见节点日志）",
@@ -420,21 +485,41 @@ export async function handleExplore(options) {
     /** 浏览器重建/重启后恢复登录态：磁盘态一致则免注入，否则用内存 cookies 补注入 */
     async function restorePoolLogin() {
       if (!poolAccount) return false;
-      const r = await ensurePoolLogin(page, poolAccount).catch((e) => ({
+      let r = await ensurePoolLogin(page, poolAccount).catch((e) => ({
         ok: false,
         reason: e.message,
       }));
+      if (!r.ok) {
+        // 导航类瞬态失败（net::ERR_* / 超时 / 崩溃）重试后再弃号，重试期间不弃号；
+        // 账号级失败（身份不符/会话过期）不重试直接走换号
+        r = await retryRestoreOnNavFailure(
+          () => ensurePoolLogin(page, poolAccount),
+          r.reason,
+          {
+            isRetryable: isRetryableRestoreFailure,
+            sleep: (ms) => sleepSliced(ms),
+            shouldAbort: () => shuttingDown,
+          },
+        );
+        if (r.aborted) return false;
+        if (!r.ok && r.attempts > 1) {
+          console.error(`[登录池] 登录态恢复重试 ${r.attempts} 次后仍失败`);
+        }
+      }
       if (r.ok) {
         loggedIn = true;
+        crashStreak = 0; // 恢复成功（含注入验证成功）即清零熔断轮数
         console.error(
           `[登录池] 登录态已恢复 @${poolAccount.username}${r.injected ? "（重新注入）" : "（磁盘态一致）"}`,
         );
         return true;
       }
       console.error(`[登录池] 登录态恢复失败（${r.reason}），转入换号流程`);
+      // 恢复链中的换号不再嵌套浏览器重启（fromRecovery）：崩溃则熔断退避，不烧池
       return await switchPoolAccount(
         `浏览器重启后无法恢复 @${poolAccount.username} 的登录态`,
         SWITCH_REASON.RECOVER_FAIL,
+        { fromRecovery: true },
       );
     }
 
@@ -450,9 +535,11 @@ export async function handleExplore(options) {
         Object.assign(page, rebuiltPage);
       } catch (e) {
         console.error(`[浏览器] 重启失败: ${e.message}，转入换号流程`);
+        // 恢复链中的换号不再嵌套浏览器重启（fromRecovery）：崩溃则熔断退避，不烧池
         return await switchPoolAccount(
           `浏览器重启失败（${e.message}）`,
           SWITCH_REASON.RECOVER_FAIL,
+          { fromRecovery: true },
         );
       }
       return await restorePoolLogin();
@@ -508,8 +595,7 @@ export async function handleExplore(options) {
               console.error(
                 `[致命] 账户切换后导航持续失败，已重启浏览器 ${rebuildCount - 1} 次仍无法恢复，上报后退出`,
               );
-              await apiPost(`${serverUrl}/api/error-report`, {
-                userId,
+              await errorReporter.report({
                 username: "account-switch",
                 errorType: "account_switch_failed",
                 errorMessage: `账户切换后导航持续失败: ${err.message}`,
@@ -570,8 +656,7 @@ export async function handleExplore(options) {
         }),
       reportError: (result, username) =>
         withRetry("report cdn-blocked", () =>
-          apiPost(`${serverUrl}/api/error-report`, {
-            userId,
+          errorReporter.report({
             username,
             errorType: "cdn_blocked",
             errorMessage: result.error || "CDN限流 (Access Denied)",
@@ -666,7 +751,7 @@ export async function handleExplore(options) {
           // 登录池模式：内存超限→同号重启浏览器；48min→换号（原地切号，不换端口）
           const memRatio = healthChecker.memoryUsage();
           const elapsedMs = Date.now() - poolAccountSince;
-          if (memRatio >= MEMORY_THRESHOLD) {
+          if (memRatio >= healthChecker.memoryThreshold) {
             await restartPoolBrowser(`系统内存 ${(memRatio * 100).toFixed(1)}% 超阈值`);
           } else if (elapsedMs >= ROTATE_INTERVAL_MS) {
             await handleAccountSwitch(
@@ -716,8 +801,7 @@ export async function handleExplore(options) {
 
           // 上报
           await withRetry("report captcha", () =>
-            apiPost(`${serverUrl}/api/error-report`, {
-              userId,
+            errorReporter.report({
               username: "unknown",
               errorType: "captcha",
               errorMessage: resolved
@@ -920,8 +1004,7 @@ export async function handleExplore(options) {
                 ? "network"
                 : "other";
             await withRetry("report error", () =>
-              apiPost(`${serverUrl}/api/error-report`, {
-                userId,
+              errorReporter.report({
                 username,
                 errorType,
                 errorMessage: result.error,
@@ -956,8 +1039,7 @@ export async function handleExplore(options) {
           console.error(`  [验证码] 累计 ${captchaCount} 次`);
 
           await withRetry("report captcha", () =>
-            apiPost(`${serverUrl}/api/error-report`, {
-              userId,
+            errorReporter.report({
               username,
               errorType: "captcha",
               errorMessage: result.captchaMessage || "页面出现验证码",

package/src/cli/search.js

@@ -26,6 +26,7 @@ import {
   getOrCreatePage,
   safeCheckLogin,
   isBrowserClosedError,
+  isRetryableRestoreFailure,
   relaunchBrowser,
 } from "../lib/browser/page.js";
 import { collectSearchAuthors } from "../lib/search-collector.js";
@@ -39,16 +40,19 @@ import {
   closeCaptcha,
 } from "../scraper/modules/captcha-handler.js";
 import { createApiClient } from "../lib/api-client.js";
+import { createErrorReporter } from "../lib/error-report.js";
 import {
   HealthChecker,
-  MEMORY_THRESHOLD,
   ROTATE_INTERVAL_MS,
 } from "../lib/browser/health-checker.js";
 import {
   createLoginPoolClient,
   injectPoolAccount,
   ensurePoolLogin,
+  crashBackoffMs,
+  retryRestoreOnNavFailure,
 } from "../lib/login-pool-client.js";
+import { getClientConfig } from "../watchdog/reporter.js";
 import {
   server as cfgServer,
   proxy as configuredProxy,
@@ -62,6 +66,7 @@ const STARTUP_TIKTOK_URL = "https://www.tiktok.com/@ycl5007";
 const PAGE_GOTO_TIMEOUT = 60000;
 const MAX_RETRY_WAIT = 5 * 60 * 1000;
 const MAX_REBUILD_ATTEMPTS = 5; // 账户切换后导航恢复：连续重启浏览器超过该次数仍失败则上报并退出
+const CRASH_BACKOFF_SLICE_MS = 1000; // 崩溃熔断/恢复重试等待的分片粒度（分片醒检 shuttingDown）
 
 async function withRetry(label, fn) {
   let backoff = 1000;
@@ -115,11 +120,14 @@ export async function handleSearch(parsed) {
   // ── 初始化 ──
   const baseUrl = serverUrl || DEFAULT_SERVER;
   const poolMode = !searchNoPool;
+  // 内存阈值可配置覆盖（~/.tt-help.json memoryThreshold，默认 0.95）：F16 类 7G 双浏览器机可调低提前重启
+  const memoryThresholdConfig = getClientConfig().memoryThreshold;
   const healthChecker = poolMode
-    ? new HealthChecker({ basePort, totalAccounts: 1 })
+    ? new HealthChecker({ basePort, totalAccounts: 1, memoryThreshold: memoryThresholdConfig })
     : new HealthChecker({
         basePort,
         totalAccounts: portCount,
+        memoryThreshold: memoryThresholdConfig,
       });
   let currentAccount = healthChecker.getCurrentAccount();
 
@@ -136,6 +144,21 @@ export async function handleSearch(parsed) {
   let poolClient = null;
   let poolAccount = null;
   let poolAccountSince = Date.now();
+  // 崩溃熔断状态（F16 实录）：浏览器级注入失败轮数 + 退避窗口截止时刻（窗口内不取号）
+  let crashStreak = 0;
+  let crashBackoffUntil = 0;
+
+  /** 分片 sleep：每 CRASH_BACKOFF_SLICE_MS 醒检 shuttingDown，被中断返回 false */
+  const sleepSliced = async (totalMs) => {
+    let remaining = totalMs;
+    while (remaining > 0) {
+      if (shuttingDown) return false;
+      const slice = Math.min(CRASH_BACKOFF_SLICE_MS, remaining);
+      await new Promise((r) => setTimeout(r, slice));
+      remaining -= slice;
+    }
+    return !shuttingDown;
+  };
 
   const cleanup = () => {
     if (shuttingDown) return;
@@ -167,6 +190,15 @@ export async function handleSearch(parsed) {
   }
   log(`[Search] 用户编号: ${userId}`);
 
+  // 客户端错误上报封装：自动附带 poolUsername（报错时在手池号）与 proxyNode（当前 clash 节点）
+  const errorReporter = createErrorReporter({
+    apiPost,
+    serverUrl: baseUrl,
+    userId,
+    proxyUrl: resolvedProxy,
+    getState: () => ({ poolUsername: poolAccount?.username || "" }),
+  });
+
   setDelayConfig("normal");
 
   try {
@@ -378,8 +410,7 @@ export async function handleSearch(parsed) {
               log(
                 `[致命] 账户切换后导航持续失败，已重启浏览器 ${rebuildCount - 1} 次仍无法恢复，上报后退出`,
               );
-              await apiPost(`${baseUrl}/api/error-report`, {
-                userId,
+              await errorReporter.report({
                 username: "account-switch",
                 errorType: "account_switch_failed",
                 errorMessage: `账户切换后导航持续失败: ${err.message}`,
@@ -435,8 +466,16 @@ export async function handleSearch(parsed) {
 
     // ── 登录池模式辅助 ──
 
-    async function switchPoolAccount(reason) {
+    async function switchPoolAccount(reason, opts = {}) {
       log(`\n[换号] ${reason}，从账号中心取新账号...`);
+      // 崩溃熔断：退避窗口内不取号（保护账号池），分片 sleep 响应 shuttingDown
+      const backoffWaitMs = Math.max(0, crashBackoffUntil - Date.now());
+      if (backoffWaitMs > 0) {
+        log(
+          `[浏览器] 崩溃熔断中，${Math.ceil(backoffWaitMs / 1000)}s 后再试（不取号，保护账号池）`,
+        );
+        if (!(await sleepSliced(backoffWaitMs))) return false;
+      }
       for (let attempt = 0; attempt < 5; attempt++) {
         let next = null;
         try {
@@ -451,7 +490,34 @@ export async function handleSearch(parsed) {
           verifyUsername: next.username,
         }).catch((e) => ({ ok: false, reason: e.message }));
         if (!r.ok) {
-          log(`[换号] @${next.username} 注入验证失败（${r.reason}），释放候选换下一个...`);
+          if (isBrowserClosedError(new Error(r.reason))) {
+            // 浏览器级崩溃：不怪账号，立即中止候选循环（不消耗 inject_fail 口径），
+            // 已取候选照常 release，转同号重启（与内存超限路径同语义）；按轮熔断退避
+            crashStreak++;
+            const backoffMs = crashBackoffMs(crashStreak);
+            crashBackoffUntil = Date.now() + backoffMs;
+            log(
+              `[换号] @${next.username} 注入失败为浏览器级崩溃（${r.reason}），中止候选循环（第 ${crashStreak} 轮，熔断 ${Math.round(backoffMs / 1000)}s），释放候选...`,
+            );
+            await poolClient.release(next).catch(() => {});
+            await errorReporter.report({
+              username: poolAccount ? poolAccount.username : "unknown",
+              errorType: "account_switch_failed",
+              errorMessage: `注入失败为浏览器级崩溃，中止候选循环转同号重启（第${crashStreak}轮，熔断${Math.round(backoffMs / 1000)}s）: ${r.reason}`,
+              stage: "account-switch",
+            }).catch(() => {});
+            if (opts.fromRecovery) {
+              // 恢复链中（重启后恢复失败触发的换号）不再递归重启，保留现场等熔断窗口
+              log(`[换号] 恢复链中不再递归重启浏览器，保留现场等待熔断窗口`);
+              return false;
+            }
+            return await restartPoolBrowser(
+              `注入验证遭遇浏览器级崩溃（${r.reason}）`,
+            );
+          }
+          log(
+            `[换号] @${next.username} 注入验证失败（${r.reason}），释放候选换下一个...`,
+          );
           await poolClient.release(next).catch(() => {});
           continue;
         }
@@ -459,6 +525,7 @@ export async function handleSearch(parsed) {
         poolAccount = next;
         poolAccountSince = Date.now();
         loggedIn = true;
+        crashStreak = 0; // 注入验证成功即清零熔断轮数
         captchaCount = 0;
         staleRounds = 0;
         consecutiveNetworkErrors = 0;
@@ -472,8 +539,7 @@ export async function handleSearch(parsed) {
         return true;
       }
       log(`[换号] 连续 5 个候选注入验证失败，保留现场等待下轮重试`);
-      await apiPost(`${baseUrl}/api/error-report`, {
-        userId,
+      await errorReporter.report({
         username: poolAccount ? poolAccount.username : "unknown",
         errorType: "account_switch_failed",
         errorMessage: "连续5个候选账号注入验证失败（详情见节点日志）",
@@ -485,17 +551,39 @@ export async function handleSearch(parsed) {
     /** 浏览器重建后恢复在手账号：磁盘态一致则免注入，否则用内存 cookies 补注入 */
     async function restorePoolLogin() {
       if (!poolAccount) return false;
-      const r = await ensurePoolLogin(page, poolAccount).catch((e) => ({
+      let r = await ensurePoolLogin(page, poolAccount).catch((e) => ({
         ok: false,
         reason: e.message,
       }));
+      if (!r.ok) {
+        // 导航类瞬态失败（net::ERR_* / 超时 / 崩溃）重试后再弃号，重试期间不弃号；
+        // 账号级失败（身份不符/会话过期）不重试直接走换号
+        r = await retryRestoreOnNavFailure(
+          () => ensurePoolLogin(page, poolAccount),
+          r.reason,
+          {
+            isRetryable: isRetryableRestoreFailure,
+            sleep: (ms) => sleepSliced(ms),
+            shouldAbort: () => shuttingDown,
+          },
+        );
+        if (r.aborted) return false;
+        if (!r.ok && r.attempts > 1) {
+          log(`[登录池] 登录态恢复重试 ${r.attempts} 次后仍失败`);
+        }
+      }
       if (r.ok) {
         loggedIn = true;
+        crashStreak = 0; // 恢复成功（含注入验证成功）即清零熔断轮数
         log(`[登录池] 登录态已恢复 @${poolAccount.username}`);
         return true;
       }
       log(`[登录池] 登录态恢复失败（${r.reason}），转入换号流程`);
-      return await switchPoolAccount(`浏览器重启后无法恢复 @${poolAccount.username} 的登录态`);
+      // 恢复链中的换号不再嵌套浏览器重启（fromRecovery）：崩溃则熔断退避，不烧池
+      return await switchPoolAccount(
+        `浏览器重启后无法恢复 @${poolAccount.username} 的登录态`,
+        { fromRecovery: true },
+      );
     }
 
     /** 内存超限：同号重启浏览器（不换号——内存是浏览器进程问题，不是账号问题） */
@@ -509,7 +597,10 @@ export async function handleSearch(parsed) {
         page = await setupNewPage(browser);
       } catch (e) {
         log(`[浏览器] 重启失败: ${e.message}，转入换号流程`);
-        return await switchPoolAccount(`浏览器重启失败（${e.message}）`);
+        // 恢复链中的换号不再嵌套浏览器重启（fromRecovery）：崩溃则熔断退避，不烧池
+        return await switchPoolAccount(`浏览器重启失败（${e.message}）`, {
+          fromRecovery: true,
+        });
       }
       return await restorePoolLogin();
     }
@@ -540,7 +631,7 @@ export async function handleSearch(parsed) {
           // 登录池模式：内存超限→同号重启浏览器；48min→换号（原地切号）
           const memRatio = healthChecker.memoryUsage();
           const elapsedMs = Date.now() - poolAccountSince;
-          if (memRatio >= MEMORY_THRESHOLD) {
+          if (memRatio >= healthChecker.memoryThreshold) {
             await restartPoolBrowser(`系统内存 ${(memRatio * 100).toFixed(1)}% 超阈值`);
           } else if (elapsedMs >= ROTATE_INTERVAL_MS) {
             await handleAccountSwitch(
@@ -582,7 +673,7 @@ export async function handleSearch(parsed) {
 
           // 上报
           await withRetry("report captcha", () =>
-            apiPost(`${baseUrl}/api/error-report`, {
+            errorReporter.report({
               userId: clientId,
               username: "unknown",
               errorType: "captcha",
@@ -739,7 +830,7 @@ export async function handleSearch(parsed) {
 
           const errorType = consecutiveNetworkErrors > 1 ? "network" : "other";
           await withRetry("report error", () =>
-            apiPost(`${baseUrl}/api/error-report`, {
+            errorReporter.report({
               userId: clientId,
               username: tag,
               errorType,
@@ -772,7 +863,7 @@ export async function handleSearch(parsed) {
           log(`  [验证码] 搜索后检测到验证码，累计 ${captchaCount} 次`);
 
           await withRetry("report captcha", () =>
-            apiPost(`${baseUrl}/api/error-report`, {
+            errorReporter.report({
               userId: clientId,
               username: tag,
               errorType: "captcha",

package/src/lib/browser/health-checker.js

@@ -5,12 +5,28 @@ import { execSync } from "child_process";
 const DEFAULT_BASE_PORT = 9222;
 const DEFAULT_TOTAL_ACCOUNTS = 10;
 const MEMORY_THRESHOLD = 0.95;
+// 配置覆盖（~/.tt-help.json memoryThreshold）钳制边界：过低误触发频繁重启，过高失去保护意义
+const MEMORY_THRESHOLD_MIN = 0.5;
+const MEMORY_THRESHOLD_MAX = 0.98;
 const ROTATE_INTERVAL_MS = 0.8 * 60 * 60 * 1000;
 
+/**
+ * 内存阈值解析：缺省/非法（null/undefined/空串/非数值）回退默认 0.95，
+ * 合法值钳制 [0.5, 0.98]。纯函数，供 HealthChecker 构造与单测使用。
+ */
+function resolveMemoryThreshold(raw) {
+  if (raw === null || raw === undefined || raw === "") return MEMORY_THRESHOLD;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return MEMORY_THRESHOLD;
+  return Math.min(MEMORY_THRESHOLD_MAX, Math.max(MEMORY_THRESHOLD_MIN, n));
+}
+
 class HealthChecker {
   constructor(options = {}) {
     const basePort = options.basePort ?? DEFAULT_BASE_PORT;
     const totalAccounts = options.totalAccounts ?? DEFAULT_TOTAL_ACCOUNTS;
+    // 内存阈值可配置覆盖（默认 0.95）：F16 类 7G 双浏览器机可调低提前重启（explore/search 构造时传入）
+    this.memoryThreshold = resolveMemoryThreshold(options.memoryThreshold);
 
     this.accounts = [];
     for (let i = 0; i < totalAccounts; i++) {
@@ -83,7 +99,7 @@ class HealthChecker {
     const memUsage = this.memoryUsage();
     const memPercent = (memUsage * 100).toFixed(1);
 
-    if (memUsage >= MEMORY_THRESHOLD) {
+    if (memUsage >= this.memoryThreshold) {
       const currentPort = this.accounts[this.currentIndex].port;
       return {
         shouldSwitch: true,
@@ -104,7 +120,7 @@ class HealthChecker {
     // 计算预计切换时间
     const remainingMs = ROTATE_INTERVAL_MS - elapsed;
     const remainingMins = Math.round(remainingMs / 60000);
-    const memHeadroom = ((MEMORY_THRESHOLD - memUsage) * 100).toFixed(1);
+    const memHeadroom = ((this.memoryThreshold - memUsage) * 100).toFixed(1);
     const currentPort = this.accounts[this.currentIndex].port;
 
     return {
@@ -114,4 +130,4 @@ class HealthChecker {
   }
 }
 
-export { HealthChecker, MEMORY_THRESHOLD, ROTATE_INTERVAL_MS };
+export { HealthChecker, MEMORY_THRESHOLD, MEMORY_THRESHOLD_MIN, MEMORY_THRESHOLD_MAX, resolveMemoryThreshold, ROTATE_INTERVAL_MS };

package/src/lib/browser/page.js

@@ -15,12 +15,20 @@ const DEFAULT_USER_DATA_DIR = path.join(
 const BROWSER_CLOSED_PATTERNS = [
   "Target page, context or browser has been closed",
   "Target closed",
+  "Target crashed",
+  "Page crashed",
   "Browser has been closed",
   "Protocol error",
   "Connection closed",
   "net::ERR_CONNECTION",
 ];
 
+/**
+ * 判定浏览器级故障：浏览器关闭**或渲染进程崩溃**。
+ * 渲染崩溃（Target/Target crashed / Page crashed）发生时 CDP 连接往往仍存活，
+ * 但页面已死，须与连接断开同语义处理：重建浏览器 + 重试。
+ * （F16 实录：崩溃曾被误判为「账号注入失败」驱动换号循环，单日烧 28 个账号）
+ */
 export function isBrowserClosedError(error) {
   if (!error) return false;
   const msg = error.message || error.toString() || "";
@@ -71,6 +79,21 @@ const DOM_CHECK_RETRIES = 3; // DOM 检测最大重试次数
 const SAFE_CHECK_ROUNDS = 2; // 安全登录检测轮数（首次检测 + 额外1轮确认）
 const SAFE_CHECK_INTERVAL = 5000; // 安全登录检测每轮间隔 5 秒
 
+/**
+ * 登录态恢复失败是否属导航类瞬态失败（可重试，重试期间不弃号）：
+ * - net::ERR_*（含 ERR_HTTP_RESPONSE_CODE_FAILURE / ERR_CONNECTION_* 等导航层错误）
+ * - 超时（Timeout ... exceeded / timed out）
+ * - 浏览器级关闭或渲染崩溃（isBrowserClosedError）
+ * 账号级失败（身份不符/会话过期/无账号数据等）不可重试，直接走换号流程。
+ */
+export function isRetryableRestoreFailure(reason) {
+  if (!reason) return false;
+  const msg = String(reason);
+  if (msg.includes("net::ERR_")) return true;
+  if (/timed?\s*out|timeout/i.test(msg)) return true;
+  return isBrowserClosedError(new Error(msg));
+}
+
 /**
  * 判断登录状态：Cookie 为主，DOM 验真为辅。
  * - 无 sessionid Cookie → 未登录