tt-help-cli-ycl 1.4.139 → 1.4.142

package/src/lib/constants.js

@@ -291,7 +291,7 @@ const HELP_TEXT = [
   "      --proxy <地址>         HTTP 代理（如 127.0.0.1:7897）",
   "      --rate <请求/秒>       对 TikTok 的全局请求速率限制，默认 3（0=不限制）",
   "                            （限速突发容量自动跟随 --pool-size，无需单独设置）",
-  "      --cooldown <秒>        CDN 限流自动冷却时长：首次限流后冷却，到期仍限流则单次重启，默认 180",
+  "      --cooldown <秒>        CDN 限流自动冷却时长，默认 100（冷却→探活→最多2次重启→自动切 Clash 节点）",
   "      --log                   显示 API 成功日志（默认不显示，错误日志始终输出）",
   "      --notify [地址]         验证码通知，默认 http://117.71.53.99:17301",
   "    API:",

package/src/lib/parse-ssr.mjs

@@ -1,5 +1,5 @@
 /**
- * CDN 限流错误（Akamai Access Denied）
+ * CDN 限流错误（Akamai Access Denied / HTTP 非 2xx 风控）
  */
 export class CDNBlockedError extends Error {
   constructor(message = "CDN限流 (Access Denied)", reference) {
@@ -9,6 +9,18 @@ export class CDNBlockedError extends Error {
   }
 }
 
+/**
+ * TikTok 明确 HTTP 状态码错误（goto 阶段被非 2xx 拒绝，如 404 视频/用户不存在）。
+ * 与 CDNBlockedError 区分：业务结果而非风控，webserver 返回 200 + statusCode。
+ */
+export class TikTokStatusError extends Error {
+  constructor(statusCode, message) {
+    super(message || `TikTok HTTP ${statusCode}`);
+    this.name = "TikTokStatusError";
+    this.statusCode = statusCode;
+  }
+}
+
 /**
  * 检测 HTML 是否为 CDN Access Denied
  * 返回 { isBlocked: true, reference: "xxx" } 或 null

package/src/lib/port.js

@@ -0,0 +1,72 @@
+/**
+ * 端口占用清理：webserver 启动前检查目标端口，若被占用直接杀掉占用进程。
+ * Windows 走 netstat -ano + taskkill；macOS/Linux 走 lsof + SIGKILL。
+ */
+import { execSync } from "node:child_process";
+import { parseNetstatListeningPids } from "./browser/cdp.js";
+
+const KILL_WAIT_MS = 500; // 杀完等端口释放（Windows 进程退出有延迟，立即 listen 仍可能 EADDRINUSE）
+
+function delay(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+/** 返回监听指定端口的 PID 列表（字符串数组） */
+export function findListeningPids(port) {
+  if (process.platform === "win32") {
+    try {
+      const out = execSync("netstat -ano -p TCP", {
+        encoding: "utf-8",
+        timeout: 5000,
+        windowsHide: true,
+      });
+      return parseNetstatListeningPids(out, port);
+    } catch (e) {
+      console.error(`[port] netstat 查询失败: ${e.message}`);
+      return [];
+    }
+  }
+  // POSIX：lsof 找不到监听时退出码非 0 且无输出，属正常情况
+  try {
+    const out = execSync(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`, {
+      encoding: "utf-8",
+      timeout: 5000,
+    });
+    return out
+      .split(/\r?\n/)
+      .map((s) => s.trim())
+      .filter((s) => /^\d+$/.test(s));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * 杀掉监听指定端口的全部进程（排除自身 PID），供启动前清理端口占用。
+ * 不区分进程类型：谁占谁死（用户拍板）。
+ */
+export async function killListeningOnPort(port) {
+  const pids = findListeningPids(port).filter((p) => p !== String(process.pid));
+  if (!pids.length) return;
+  console.error(
+    `[webserver] 端口 ${port} 被占用，直接清理进程 PID: ${pids.join(", ")}`,
+  );
+  for (const pid of pids) {
+    try {
+      if (process.platform === "win32") {
+        execSync(`taskkill /F /T /PID ${pid}`, {
+          encoding: "buffer",
+          timeout: 15000,
+          windowsHide: true,
+        });
+      } else {
+        process.kill(parseInt(pid, 10), "SIGKILL");
+      }
+      console.error(`[webserver] 已杀 PID ${pid}`);
+    } catch (e) {
+      console.error(`[webserver] 杀 PID ${pid} 失败: ${e.message}`);
+    }
+  }
+  // 等待端口释放，避免立即 listen 仍 EADDRINUSE
+  await delay(KILL_WAIT_MS);
+}

package/src/lib/tiktok-scraper.mjs

@@ -5,6 +5,7 @@ import {
   parseVideoInfo,
   isRetryableFailure,
   CDNBlockedError,
+  TikTokStatusError,
   detectAccessDenied,
 } from "./parse-ssr.mjs";
 
@@ -58,6 +59,30 @@ class PageSlot {
   }
 }
 
+/**
+ * 对 page.goto 抛出的错误做分类（goto 阶段失败时拿不到 HTML，
+ * detectAccessDenied 无法执行，必须在这里拦截风控类错误）。
+ * status 为导航期间捕获的最后一个 tiktok 响应状态码（可能为 null）：
+ * - 404 → TikTokStatusError（视频/用户不存在，业务结果）
+ * - 403/429/未知 → CDNBlockedError，由 webserver 走 CDN 冷却自愈链路
+ *   （503 + 冷却 + 躺平 + nginx failover），而不是 consecutiveErrors
+ *   浏览器重启链——重启对 IP/节点风控无效，只会形成死亡螺旋。
+ * - 其余（ERR_ABORTED / Target closed 等重启竞态产物）→ 返回 null，
+ *   原样冒泡交由 webserver 分类（503 retryable 且不计连续错误）。
+ */
+export function classifyGotoError(message, status) {
+  if (typeof message !== "string") return null;
+  if (message.includes("ERR_HTTP_RESPONSE_CODE_FAILURE")) {
+    if (status === 404) {
+      return new TikTokStatusError(404, "TikTok HTTP 404 (视频/用户不存在)");
+    }
+    return new CDNBlockedError(
+      `goto 非2xx (疑似 IP/节点风控, status=${status ?? "unknown"}): ${message.split("\n")[0]}`,
+    );
+  }
+  return null;
+}
+
 class PromiseQueue {
   constructor() {
     this._queue = [];
@@ -110,9 +135,14 @@ export class TikTokScraper {
     this.slotIdx = 0;
     this.lastWarmTime = 0;
     this.warmPromise = null;
+    // 关闭中标记：restart 时旧实例先 close，在途请求凭此立即失败（503），
+    // 而不是打到已销毁的 context 上报 "Cannot read properties of null"。
+    this.closing = false;
   }
 
   async init() {
+    // restart() = close() + init()：重建后恢复可用状态
+    this.closing = false;
     const executablePath = detectBrowser();
     if (!executablePath) {
       throw new Error(
@@ -143,6 +173,8 @@ export class TikTokScraper {
   }
 
   async close() {
+    // 先置关闭标记：在途请求的入口检查会立即失败，避免与关闭流程竞态
+    this.closing = true;
     if (this.browser) {
       const browser = this.browser;
       let closeTimedOut = false;
@@ -213,6 +245,10 @@ export class TikTokScraper {
   }
 
   async _ensurePage(slot) {
+    // 实例正在关闭/已关闭（restart 竞态）→ 抛可识别错误，webserver 返回 503 且不计连续错误
+    if (this.closing || !this.context) {
+      throw new Error("Server is shutting down");
+    }
     try {
       if (
         !slot.page.isClosed() &&
@@ -234,10 +270,32 @@ export class TikTokScraper {
 
     const page = await this._ensurePage(slot);
 
-    await page.goto("view-source:" + url, {
-      waitUntil: "domcontentloaded",
-      timeout: 15000,
-    });
+    // 捕获导航期间最后一个 tiktok 响应的真实状态码：
+    // Chromium 的 ERR_HTTP_RESPONSE_CODE_FAILURE 不携带状态码，
+    // 通过 response 事件补齐，用于区分 403/429 风控与 404 不存在。
+    let lastStatus = null;
+    const onResponse = (resp) => {
+      try {
+        if (resp.url().includes("tiktok.com")) lastStatus = resp.status();
+      } catch {}
+    };
+    page.on("response", onResponse);
+
+    try {
+      await page.goto("view-source:" + url, {
+        waitUntil: "domcontentloaded",
+        timeout: 15000,
+      });
+    } catch (e) {
+      // goto 阶段失败（HTTP 非 2xx 等）拿不到 HTML，detectAccessDenied 没机会执行。
+      // 分类后抛出：风控类 → CDNBlockedError（走 webserver 冷却自愈而非浏览器重启）；
+      // 404 → TikTokStatusError（业务结果）；其余（ERR_ABORTED 等竞态）→ 原样冒泡。
+      const classified = classifyGotoError(e?.message, lastStatus);
+      if (classified) throw classified;
+      throw e;
+    } finally {
+      page.off("response", onResponse);
+    }
 
     const content = await page.evaluate(() => {
       const rows = document.querySelectorAll("tr");

package/src/watch/data-store.js

@@ -2477,10 +2477,12 @@ export function createStore(filePath, options = {}) {
     username,
     stage,
     errorStack,
+    hostname,
   ) {
     const existing = clientErrors.get(userId);
     if (existing) {
       existing.timestamp = Date.now();
+      if (hostname) existing.hostname = hostname;
       if (errorType === "captcha") {
         existing.captchaCount = (existing.captchaCount || 0) + 1;
         if (!existing.captchaStage) existing.captchaStage = stage || "";
@@ -2498,6 +2500,7 @@ export function createStore(filePath, options = {}) {
     } else {
       clientErrors.set(userId, {
         userId,
+        hostname: hostname || "",
         errorType,
         errorMessage: errorMessage || "",
         errorStack: errorStack || "",