tt-help-cli-ycl 1.4.140 → 1.4.144

package/src/watchdog/client-error-monitor.js

@@ -0,0 +1,131 @@
+/**
+ * 客户端异常监控模块 — 看门狗侧
+ *
+ * 职责：
+ *   1. 定时拉取 watch 服务端 /api/client-errors
+ *   2. 按 hostname 过滤出本机条目（异常条目由业务进程上报时携带 hostname）
+ *   3. 逐条过独立检测函数，命中 → onAlert(本机全部条目, 命中条目)
+ *   4. 提供 removeErrors 删除接口（处理完成后的清理）
+ *
+ * 检测函数第一版：reportCount > 8 且最近一次上报在 2 分钟内。
+ */
+
+import os from "os";
+
+/** 检测阈值：累计上报次数 > 8 */
+export const DETECT_REPORT_COUNT_THRESHOLD = 8;
+/** 检测窗口：最近一次上报距今 < 2 分钟 */
+export const DETECT_FRESH_MS = 2 * 60 * 1000;
+
+/**
+ * 独立检测函数（第一版）
+ * @param {object} err - /api/client-errors 返回的单条异常
+ * @param {number} [now] - 当前时间戳（测试注入用）
+ * @returns {boolean}
+ */
+export function detectClientError(err, now = Date.now()) {
+  if (!err || typeof err.reportCount !== "number") return false;
+  const fresh = now - err.timestamp < DETECT_FRESH_MS;
+  return err.reportCount > DETECT_REPORT_COUNT_THRESHOLD && fresh;
+}
+
+/**
+ * 客户端异常监控器
+ */
+export class ClientErrorMonitor {
+  /**
+   * @param {object} opts
+   * @param {string} opts.serverUrl - watch 服务端地址（~/.tt-help.json 的 server）
+   * @param {string} [opts.hostname] - 本机 hostname（默认 os.hostname()）
+   * @param {number} [opts.intervalMs] - 拉取周期，默认 60s
+   * @param {(err: object, now: number) => boolean} [opts.detect] - 检测函数，默认 detectClientError
+   * @param {(mine: Array, hit: Array) => Promise|void} [opts.onAlert] - 命中回调
+   */
+  constructor({ serverUrl, hostname, intervalMs = 60_000, detect, onAlert }) {
+    this.serverUrl = serverUrl ? String(serverUrl).replace(/\/+$/, "") : "";
+    this.hostname = hostname || os.hostname();
+    this.intervalMs = intervalMs;
+    this.detect = detect || detectClientError;
+    this.onAlert = onAlert || null;
+    this.timer = null;
+    this.running = false;
+    this._polling = false; // 防重入
+  }
+
+  /** 启动轮询（立即拉一次，之后按周期） */
+  start() {
+    if (this.running || !this.serverUrl) return;
+    this.running = true;
+    this.timer = setInterval(
+      () => this._poll().catch(() => {}),
+      this.intervalMs,
+    );
+    this._poll().catch(() => {});
+  }
+
+  stop() {
+    this.running = false;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+  }
+
+  /**
+   * 拉取一次并评估
+   * @returns {Promise<Array|null>} 本机命中的条目；无可评估内容时返回 null
+   */
+  async _poll() {
+    if (this._polling) return null;
+    this._polling = true;
+    try {
+      const resp = await fetch(`${this.serverUrl}/api/client-errors`, {
+        signal: AbortSignal.timeout(10000),
+      });
+      if (!resp.ok) return null;
+      const data = await resp.json();
+      const clients = Array.isArray(data.clients) ? data.clients : [];
+      // hostname 为空的旧条目（升级前上报）不参与本机关联
+      const mine = clients.filter(
+        (c) => c.hostname && c.hostname === this.hostname,
+      );
+      if (mine.length === 0) return null;
+      const now = Date.now();
+      const hit = mine.filter((c) => this.detect(c, now));
+      if (hit.length > 0 && this.onAlert) {
+        try {
+          await this.onAlert(mine, hit);
+        } catch {
+          /* 回调异常不中断轮询 */
+        }
+      }
+      return hit;
+    } catch {
+      return null; // 网络/解析失败下轮重试
+    } finally {
+      this._polling = false;
+    }
+  }
+
+  /**
+   * 删除指定异常条目（处理完成后的清理）
+   * @param {Array<{userId:string}>} errors
+   * @returns {Promise<number>} 成功删除条数
+   */
+  async removeErrors(errors) {
+    let removed = 0;
+    for (const e of errors || []) {
+      if (!e || !e.userId) continue;
+      try {
+        const resp = await fetch(
+          `${this.serverUrl}/api/client-error/${encodeURIComponent(e.userId)}`,
+          { method: "DELETE", signal: AbortSignal.timeout(10000) },
+        );
+        if (resp.ok) removed++;
+      } catch {
+        /* 单条失败不影响其余 */
+      }
+    }
+    return removed;
+  }
+}

package/src/watchdog/process-manager.js

@@ -23,6 +23,7 @@ const MAX_RESTART = 3;
 const MAX_LOG_LINES = 500; // 每个进程最多保留的日志行数
 const IS_WIN = process.platform === "win32";
 const SPAWN_STAGGER_MS = 30000; // 批量启动时每个进程间隔 30 秒，避免抢网络
+const STOP_STAGGER_MS = 10000; // 强制重启时每个命令停止间隔 10 秒（杀 Edge/进程树会瞬时占资源，错峰释放）
 const STALE_LOG_TIMEOUT_MS = 15 * 60 * 1000; // 15 分钟无日志输出视为假死
 
 // === 控制台日志格式化（仅显示层增强，不影响任何功能链路） ===
@@ -718,10 +719,58 @@ export class ProcessManager extends EventEmitter {
     }
   }
 
+  /**
+   * 强制重启所有运行中的命令（先停全部，再错峰逐个重启）
+   * 用途：代理切换后强制所有业务命令重建连接、走新出口节点
+   * @param {string} [reason] - 重启原因（日志用）
+   * @returns {Promise<{restarted:number}>}
+   */
+  async restartAll(reason) {
+    const toRestart = [];
+    for (const [, info] of this.processes) {
+      if (!info.stopped && info.child && info.cmdDef) {
+        toRestart.push(info.cmdDef);
+      }
+    }
+    if (!toRestart.length) {
+      console.error(`[watchdog] ${reason}，无运行中的命令，跳过重启`);
+      return { restarted: 0 };
+    }
+    console.error(
+      `[watchdog] ${reason}，强制重启全部命令 (${toRestart.length}个)...`,
+    );
+    // 错峰停止：第一个立即停，之后每个间隔 STOP_STAGGER_MS（平滑释放资源，避免同时杀 N 个浏览器）
+    for (let i = 0; i < toRestart.length; i++) {
+      if (i > 0) await new Promise((r) => setTimeout(r, STOP_STAGGER_MS));
+      if (this.shutdown) {
+        console.error("[watchdog] 看门狗已停止，中止停止命令");
+        break;
+      }
+      this.stopCommand(toRestart[i].id);
+      console.error(
+        `[watchdog] 命令 ${toRestart[i].id} 已停止 (${i + 1}/${toRestart.length})`,
+      );
+    }
+    // 错峰逐个重启：第一个立即起，之后每个间隔 SPAWN_STAGGER_MS
+    for (let i = 0; i < toRestart.length; i++) {
+      if (i > 0) await new Promise((r) => setTimeout(r, SPAWN_STAGGER_MS));
+      if (this.shutdown) {
+        console.error("[watchdog] 看门狗已停止，中止重启命令");
+        break;
+      }
+      this.startCommand(toRestart[i]);
+      console.error(
+        `[watchdog] 命令 ${toRestart[i].id} 已重启 (${i + 1}/${toRestart.length})`,
+      );
+    }
+    return { restarted: toRestart.length };
+  }
+
   /**
    * 停止所有进程
    */
   stopAll() {
+    this.shutdown = true;
     console.error("[watchdog] 正在停止所有子进程...");
     for (const [cmdId] of this.processes) {
       this.stopCommand(cmdId);

package/src/webserver/server.mjs

@@ -741,6 +741,7 @@ async function notifyCaptchaToWatch(url, maxRetries = 3) {
             "TikTok Shop captcha detected, browser opened - manual intervention required",
           stage: "product_info",
           errorStack: url,
+          hostname: os.hostname(),
         }),
       });
       console.error("[webserver] Captcha alert sent to watch server");