tt-help-cli-ycl 1.3.48 → 1.3.50

package/src/cli/comments.js

@@ -1,620 +1,620 @@
-import { chromium } from "playwright";
-import { fetchUserCommentsAPI } from "../lib/api-interceptor-comment.js";
-import { closeCommentPanel } from "../lib/browser/page.js";
-import { server as defaultServer } from "../lib/constants.js";
-import {
-  DEFAULT_TARGET_LOCATIONS,
-  isLocationInList,
-  normalizeLocation,
-} from "../lib/target-locations.js";
-
-async function waitForPageReady(page, timeout = 30000) {
-  const startTime = Date.now();
-  while (Date.now() - startTime < timeout) {
-    try {
-      const ready = await page.evaluate(() => {
-        return document.querySelectorAll('[class*="tabbar-item"]').length > 0;
-      });
-      if (ready) return true;
-    } catch {
-      // Page may have navigated, retry
-    }
-    await new Promise((r) => setTimeout(r, 1000));
-  }
-  return false;
-}
-
-async function safeEvaluate(page, fn) {
-  try {
-    return await page.evaluate(fn);
-  } catch {
-    return null;
-  }
-}
-
-async function withRetry(label, fn, maxRetries = 3) {
-  let backoff = 2000;
-  for (let i = 0; i < maxRetries; i++) {
-    try {
-      return await fn();
-    } catch (err) {
-      if (i < maxRetries - 1) {
-        console.error(
-          `  [${label}] 失败: ${err.message}，${backoff / 1000}s 后重试...`,
-        );
-        await new Promise((r) => setTimeout(r, backoff));
-        backoff *= 2;
-      } else {
-        throw err;
-      }
-    }
-  }
-}
-
-async function apiPost(url, body) {
-  return withRetry(`POST ${url}`, async () => {
-    const res = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body),
-    });
-    if (!res.ok) {
-      const errText = await res.text();
-      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
-    }
-    return res.json();
-  });
-}
-
-async function apiPut(url) {
-  return withRetry(`PUT ${url}`, async () => {
-    const res = await fetch(url, {
-      method: "PUT",
-      headers: { "Content-Type": "application/json" },
-    });
-    if (!res.ok) {
-      const errText = await res.text();
-      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
-    }
-    return res.json();
-  });
-}
-
-async function apiGet(url) {
-  return withRetry(`GET ${url}`, async () => {
-    const res = await fetch(url);
-    if (!res.ok) {
-      const errText = await res.text();
-      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
-    }
-    return res.json();
-  });
-}
-
-function isBrowserClosedError(err) {
-  if (!err) return false;
-  const msg = err.message || err.toString() || "";
-  return (
-    (msg.includes("Target") && msg.includes("closed")) ||
-    (msg.includes("Session") && msg.includes("deleted")) ||
-    (msg.includes("Session") && msg.includes("not found")) ||
-    (msg.includes("Browser") && msg.includes("closed")) ||
-    msg.includes("Execution context was destroyed") ||
-    msg.includes("Protocol error") ||
-    msg.includes("Cannot find context")
-  );
-}
-
-/**
- * 自动模式：循环从服务端取视频任务，抓评论，提交
- */
-async function runAutoMode(options) {
-  const { serverUrl, parallel, interval, maxComments } = options;
-  const actualParallel = Math.max(1, parallel || 1);
-  const actualInterval = interval || 10;
-  const actualMaxComments = maxComments || 200;
-  let shuttingDown = false;
-
-  console.error(
-    `\n[Comments Auto] 并行: ${actualParallel}, 间隔: ${actualInterval}s, 评论数: ${actualMaxComments}`,
-  );
-  console.error(`服务器: ${serverUrl}`);
-  console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
-  console.error(`开始循环接收任务...\n`);
-
-  let browser;
-  let browserRestartCount = 0;
-  let processedCount = 0;
-  let skippedCount = 0;
-  let errorCount = 0;
-  let consecutiveErrors = 0;
-
-  const shutdown = async (signal) => {
-    if (shuttingDown) return;
-    shuttingDown = true;
-    console.error(`\n[Comments Auto] 收到 ${signal}，正在关闭浏览器...`);
-    await browser?.close().catch(() => {});
-    console.error("[Comments Auto] 已退出");
-    process.exit(0);
-  };
-
-  const onSigint = () => {
-    void shutdown("SIGINT");
-  };
-  const onSigterm = () => {
-    void shutdown("SIGTERM");
-  };
-
-  process.once("SIGINT", onSigint);
-  process.once("SIGTERM", onSigterm);
-
-  async function ensureBrowser() {
-    if (browser) {
-      try {
-        await browser.contexts()[0]?.pages()[0]?.url();
-        return browser;
-      } catch {
-        try {
-          await browser.close();
-        } catch {}
-        browser = null;
-      }
-    }
-    browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
-    return browser;
-  }
-
-  async function getPage(browser) {
-    const contexts = browser.contexts();
-    if (contexts.length > 0) {
-      const pages = contexts[0].pages();
-      if (pages.length > 0) return pages[0];
-    }
-    return null;
-  }
-
-  try {
-    while (!shuttingDown) {
-      let page;
-      try {
-        browser = await ensureBrowser();
-        page = await getPage(browser);
-        if (!page) {
-          console.error("[Comments Auto] 未找到可用页面，等待中...");
-          await new Promise((r) => setTimeout(r, actualInterval * 1000));
-          continue;
-        }
-
-        // 获取任务
-        let tasks;
-        try {
-          const resp = await apiGet(
-            `${serverUrl}/api/comment-tasks?limit=${actualParallel}`,
-          );
-          tasks = resp.tasks || [];
-        } catch (err) {
-          console.error(`[Comments Auto] 获取任务失败: ${err.message}`);
-          consecutiveErrors++;
-          if (consecutiveErrors > 10) {
-            console.error("[Comments Auto] 连续获取失败超过10次，请检查服务端");
-            process.exit(1);
-          }
-          await new Promise((r) => setTimeout(r, actualInterval * 1000));
-          continue;
-        }
-        consecutiveErrors = 0;
-
-        if (tasks.length === 0) {
-          console.error(
-            `[Comments Auto] 暂无任务，${actualInterval}s 后重试...`,
-          );
-          await new Promise((r) => setTimeout(r, actualInterval * 1000));
-          continue;
-        }
-
-        console.error(`[Comments Auto] 获取 ${tasks.length} 个任务`);
-
-        for (const task of tasks) {
-          try {
-            const { id, href, locationCreated, ttSeller } = task;
-            const loc = normalizeLocation(locationCreated);
-
-            // 检查目标国家
-            if (loc && !isLocationInList(loc, DEFAULT_TARGET_LOCATIONS)) {
-              // 非目标国家，直接 commit 跳过
-              await apiPut(`${serverUrl}/api/comment-task/${id}`);
-              skippedCount++;
-              console.error(
-                `  [跳过] ${id.substring(0, 15)}... 国家: ${loc} (非目标)`,
-              );
-              continue;
-            }
-
-            console.error(
-              `  [处理] ${id.substring(0, 15)}... 国家: ${loc || "?"} ttSeller: ${ttSeller} -> ${href}`,
-            );
-
-            // 确保浏览器可用
-            browser = await ensureBrowser();
-            page = await getPage(browser);
-            if (!page) {
-              throw new Error("未找到可用页面");
-            }
-
-            // 导航到视频页
-            await page.goto(href, {
-              waitUntil: "domcontentloaded",
-              timeout: 30000,
-            });
-            const ready = await waitForPageReady(page, 30000);
-            if (!ready) {
-              throw new Error("页面加载超时");
-            }
-
-            // 关闭弹窗
-            await safeEvaluate(page, () => {
-              document
-                .querySelectorAll('[id*="modal-overlay"]')
-                .forEach((o) => o.click());
-            });
-            await page.keyboard.press("Escape");
-            await new Promise((r) => setTimeout(r, 1000));
-
-            // 如果评论面板已打开，先关闭
-            const panelOpen = await safeEvaluate(page, () => {
-              return !!document.querySelector('[class*="RightPanelContainer"]');
-            });
-            if (panelOpen) {
-              await closeCommentPanel(page);
-              await new Promise((r) => setTimeout(r, 800));
-            }
-
-            // 获取评论
-            const result = await fetchUserCommentsAPI(page, {
-              maxComments: actualMaxComments,
-              log: () => {},
-            });
-
-            // 关闭评论面板
-            await closeCommentPanel(page);
-
-            if (
-              result.error ||
-              !result.comments ||
-              result.comments.length === 0
-            ) {
-              console.error(`    [无评论] ${result.error || "未获取到评论"}`);
-            } else {
-              // 提取去重作者
-              const authors = [
-                ...new Set(
-                  result.comments
-                    .map((c) => c.user?.unique_id)
-                    .filter(Boolean)
-                    .map((u) => u.replace(/^@/, "")),
-                ),
-              ];
-
-              if (authors.length > 0) {
-                // 提交作者
-                const saveResult = await apiPost(`${serverUrl}/api/users`, {
-                  usernames: authors.map((a) => "@" + a),
-                  sources: ["comment"],
-                  guessedLocation: loc || null,
-                });
-                console.error(
-                  `    [提交] ${saveResult.added} 新增, ${saveResult.skipped} 跳过`,
-                );
-              } else {
-                console.error(
-                  `    [无作者] 获取了 ${result.comments.length} 条评论但无作者信息`,
-                );
-              }
-            }
-
-            // commit 任务
-            await apiPut(`${serverUrl}/api/comment-task/${id}`);
-            processedCount++;
-            console.error(`    [完成] 累计 ${processedCount} 个视频`);
-          } catch (err) {
-            errorCount++;
-            const isBrowserClosed = isBrowserClosedError(err);
-            if (isBrowserClosed) {
-              console.error(`    [浏览器异常] ${err.message}，将重启浏览器`);
-              try {
-                await browser.close();
-              } catch {}
-              browser = null;
-              browserRestartCount++;
-            } else {
-              console.error(`    [错误] ${err.message}`);
-            }
-            continue;
-          }
-        }
-      } catch (err) {
-        errorCount++;
-        const isBrowserClosed = isBrowserClosedError(err);
-        if (isBrowserClosed) {
-          console.error(
-            `[Comments Auto] 浏览器异常 (${++browserRestartCount})，正在重启...`,
-          );
-          try {
-            await browser.close();
-          } catch {}
-          browser = null;
-        } else {
-          console.error(`[Comments Auto] 异常: ${err.message}`);
-        }
-      }
-
-      // 等待间隔
-      await new Promise((r) => setTimeout(r, actualInterval * 1000));
-    }
-  } finally {
-    process.removeListener("SIGINT", onSigint);
-    process.removeListener("SIGTERM", onSigterm);
-    await browser?.close().catch(() => {});
-  }
-}
-
-export async function handleComments(options) {
-  const {
-    commentsUrl,
-    commentsMax,
-    commentsSave,
-    commentsParallel,
-    commentsInterval,
-    commentsServer,
-  } = options;
-
-  // 自动模式：无URL且传了 -s/--server 参数（或任何参数）
-  if (!commentsUrl && process.argv.length > 3) {
-    return runAutoMode({
-      serverUrl: commentsServer,
-      parallel: commentsParallel,
-      interval: commentsInterval,
-      maxComments: commentsMax || 200,
-    });
-  }
-
-  // 手动模式（需要 URL）
-  if (!commentsUrl) {
-    console.error("用法: tt-help comments <视频URL> [最大评论数] [--save]");
-    console.error(
-      "      tt-help comments [-p N] [-i N] [-s server] [-m maxComments]",
-    );
-    console.error("");
-    console.error("手动模式: tt-help comments <URL> [N] [--save]");
-    console.error("自动模式: tt-help comments -p 1 -i 10 -m 200 -s <server>");
-    console.error("");
-    console.error(
-      "选项: --save           去重后保存到服务端，来源标记为 comment",
-    );
-    console.error("      -p, --parallel   并行数 (默认 1)");
-    console.error("      -i, --interval   空闲间隔秒 (默认 10)");
-    console.error("      -s, --server     服务端地址");
-    console.error("      -m, --max-comments 每视频最大评论数 (默认 200)");
-    process.exit(1);
-  }
-
-  if (commentsSave) {
-    // 手动模式 --save
-    let browser;
-    try {
-      browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
-      const contexts = browser.contexts();
-      let page;
-
-      if (contexts.length > 0) {
-        const pages = contexts[0].pages();
-        if (pages.length > 0) {
-          page = pages[0];
-        }
-      }
-
-      if (!page) {
-        console.error("未找到可用页面");
-        process.exit(1);
-      }
-
-      console.error(`正在打开: ${commentsUrl}`);
-      await page.goto(commentsUrl, {
-        waitUntil: "domcontentloaded",
-        timeout: 30000,
-      });
-      const ready = await waitForPageReady(page, 30000);
-      if (!ready) {
-        console.error("页面加载超时，tab 未出现");
-        process.exit(1);
-      }
-
-      await safeEvaluate(page, () => {
-        document
-          .querySelectorAll('[id*="modal-overlay"]')
-          .forEach((o) => o.click());
-      });
-      await page.keyboard.press("Escape");
-      await new Promise((r) => setTimeout(r, 1000));
-
-      const videoInfo = await safeEvaluate(page, () => {
-        const result = {};
-        const m = window.location.href.match(/@([^/]+)\/video/);
-        result.author = m ? "@" + m[1] : "未知";
-        const html = document.documentElement.outerHTML;
-        const locMatch = html.match(/"locationCreated":"([^"]*)/);
-        result.locationCreated = locMatch ? locMatch[1] : null;
-        return result;
-      });
-
-      const panelOpen = await safeEvaluate(page, () => {
-        return !!document.querySelector('[class*="RightPanelContainer"]');
-      });
-      if (panelOpen) {
-        await closeCommentPanel(page);
-        await new Promise((r) => setTimeout(r, 800));
-      }
-
-      const result = await fetchUserCommentsAPI(page, {
-        maxComments: commentsMax,
-        log: () => {},
-      });
-
-      await closeCommentPanel(page);
-
-      if (result.error || !result.comments || result.comments.length === 0) {
-        console.error(`获取评论失败: ${result.error || "未获取到评论"}`);
-        process.exit(1);
-      }
-
-      const authors = [
-        ...new Set(
-          result.comments
-            .map((c) => c.user?.unique_id)
-            .filter(Boolean)
-            .map((u) => u.replace(/^@/, "")),
-        ),
-      ];
-
-      const guessedLocation = normalizeLocation(videoInfo?.locationCreated);
-      const serverUrl = commentsServer || defaultServer;
-
-      if (
-        guessedLocation &&
-        !isLocationInList(guessedLocation, DEFAULT_TARGET_LOCATIONS)
-      ) {
-        console.error(`\n猜测国家: ${guessedLocation}，非目标国家，跳过保存`);
-        console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
-      } else {
-        console.error(`\n正在提交 ${authors.length} 个评论作者到服务端...`);
-        console.error(`服务端: ${serverUrl}`);
-        if (guessedLocation) console.error(`猜测国家: ${guessedLocation}`);
-
-        try {
-          const saveResult = await apiPost(`${serverUrl}/api/users`, {
-            usernames: authors.map((a) => "@" + a),
-            sources: ["comment"],
-            guessedLocation: guessedLocation || null,
-          });
-          console.error(
-            `\n提交结果: ${saveResult.added} 个新增, ${saveResult.skipped} 个跳过`,
-          );
-        } catch (err) {
-          console.error(`\n提交失败: ${err.message}`);
-          process.exit(1);
-        }
-      }
-    } catch (err) {
-      console.error(`获取评论失败: ${err.message}`);
-      process.exit(1);
-    } finally {
-      if (browser) await browser.close().catch(() => {});
-    }
-    return;
-  }
-
-  // 手动模式：打印到控制台
-  let browser;
-  try {
-    browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
-    const contexts = browser.contexts();
-    let page;
-
-    if (contexts.length > 0) {
-      const pages = contexts[0].pages();
-      if (pages.length > 0) {
-        page = pages[0];
-      }
-    }
-
-    if (!page) {
-      console.error("未找到可用页面");
-      process.exit(1);
-    }
-
-    console.error(`正在打开: ${commentsUrl}`);
-    await page.goto(commentsUrl, {
-      waitUntil: "domcontentloaded",
-      timeout: 30000,
-    });
-    const ready = await waitForPageReady(page, 30000);
-    if (!ready) {
-      console.error("页面加载超时，tab 未出现");
-      process.exit(1);
-    }
-
-    await safeEvaluate(page, () => {
-      document
-        .querySelectorAll('[id*="modal-overlay"]')
-        .forEach((o) => o.click());
-    });
-    await page.keyboard.press("Escape");
-    await new Promise((r) => setTimeout(r, 1000));
-
-    const videoInfo = await safeEvaluate(page, () => {
-      const result = {};
-      const m = window.location.href.match(/@([^/]+)\/video/);
-      result.author = m ? "@" + m[1] : "未知";
-      const html = document.documentElement.outerHTML;
-      const locMatch = html.match(/"locationCreated":"([^"]*)/);
-      result.locationCreated = locMatch ? locMatch[1] : null;
-      return result;
-    });
-
-    const panelOpen = await safeEvaluate(page, () => {
-      return !!document.querySelector('[class*="RightPanelContainer"]');
-    });
-    if (panelOpen) {
-      await closeCommentPanel(page);
-      await new Promise((r) => setTimeout(r, 800));
-    }
-
-    const result = await fetchUserCommentsAPI(page, {
-      maxComments: commentsMax,
-      log: () => {},
-    });
-
-    await closeCommentPanel(page);
-
-    if (result.error || !result.comments || result.comments.length === 0) {
-      console.error(`获取评论失败: ${result.error || "未获取到评论"}`);
-      process.exit(1);
-    }
-
-    const authors = [
-      ...new Set(
-        result.comments
-          .map((c) => c.user?.unique_id)
-          .filter(Boolean)
-          .map((u) => u.replace(/^@/, "")),
-      ),
-    ];
-
-    console.log(`视频: ${commentsUrl}`);
-    console.log(`作者: ${videoInfo?.author || "未知"}`);
-    if (videoInfo?.locationCreated)
-      console.log(`猜测国家: ${videoInfo.locationCreated}`);
-    console.log(`评论数: ${result.comments.length}`);
-    console.log(`评论作者: ${authors.length}`);
-    console.log("");
-
-    result.comments.forEach((c, i) => {
-      const author = c.user?.unique_id
-        ? "@" + c.user.unique_id
-        : c.user?.nickname || "未知";
-      const text = c.text || "";
-      const likes = c.digg_count || 0;
-      console.log(`${i + 1}. [${author}] ${text} (\u2764 ${likes})`);
-    });
-
-    console.log("");
-    console.log(
-      `共 ${result.comments.length} 条评论, ${authors.length} 个唯一作者`,
-    );
-  } catch (err) {
-    console.error(`获取评论失败: ${err.message}`);
-    process.exit(1);
-  } finally {
-    if (browser) await browser.close().catch(() => {});
-  }
-}
+import { chromium } from "playwright";
+import { fetchUserCommentsAPI } from "../lib/api-interceptor-comment.js";
+import { closeCommentPanel } from "../lib/browser/page.js";
+import { server as defaultServer } from "../lib/constants.js";
+import {
+  DEFAULT_TARGET_LOCATIONS,
+  isLocationInList,
+  normalizeLocation,
+} from "../lib/target-locations.js";
+
+async function waitForPageReady(page, timeout = 30000) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeout) {
+    try {
+      const ready = await page.evaluate(() => {
+        return document.querySelectorAll('[class*="tabbar-item"]').length > 0;
+      });
+      if (ready) return true;
+    } catch {
+      // Page may have navigated, retry
+    }
+    await new Promise((r) => setTimeout(r, 1000));
+  }
+  return false;
+}
+
+async function safeEvaluate(page, fn) {
+  try {
+    return await page.evaluate(fn);
+  } catch {
+    return null;
+  }
+}
+
+async function withRetry(label, fn, maxRetries = 3) {
+  let backoff = 2000;
+  for (let i = 0; i < maxRetries; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (i < maxRetries - 1) {
+        console.error(
+          `  [${label}] 失败: ${err.message}，${backoff / 1000}s 后重试...`,
+        );
+        await new Promise((r) => setTimeout(r, backoff));
+        backoff *= 2;
+      } else {
+        throw err;
+      }
+    }
+  }
+}
+
+async function apiPost(url, body) {
+  return withRetry(`POST ${url}`, async () => {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+      const errText = await res.text();
+      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
+    }
+    return res.json();
+  });
+}
+
+async function apiPut(url) {
+  return withRetry(`PUT ${url}`, async () => {
+    const res = await fetch(url, {
+      method: "PUT",
+      headers: { "Content-Type": "application/json" },
+    });
+    if (!res.ok) {
+      const errText = await res.text();
+      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
+    }
+    return res.json();
+  });
+}
+
+async function apiGet(url) {
+  return withRetry(`GET ${url}`, async () => {
+    const res = await fetch(url);
+    if (!res.ok) {
+      const errText = await res.text();
+      throw new Error(`HTTP ${res.status}: ${errText.substring(0, 200)}`);
+    }
+    return res.json();
+  });
+}
+
+function isBrowserClosedError(err) {
+  if (!err) return false;
+  const msg = err.message || err.toString() || "";
+  return (
+    (msg.includes("Target") && msg.includes("closed")) ||
+    (msg.includes("Session") && msg.includes("deleted")) ||
+    (msg.includes("Session") && msg.includes("not found")) ||
+    (msg.includes("Browser") && msg.includes("closed")) ||
+    msg.includes("Execution context was destroyed") ||
+    msg.includes("Protocol error") ||
+    msg.includes("Cannot find context")
+  );
+}
+
+/**
+ * 自动模式：循环从服务端取视频任务，抓评论，提交
+ */
+async function runAutoMode(options) {
+  const { serverUrl, parallel, interval, maxComments } = options;
+  const actualParallel = Math.max(1, parallel || 1);
+  const actualInterval = interval || 10;
+  const actualMaxComments = maxComments || 200;
+  let shuttingDown = false;
+
+  console.error(
+    `\n[Comments Auto] 并行: ${actualParallel}, 间隔: ${actualInterval}s, 评论数: ${actualMaxComments}`,
+  );
+  console.error(`服务器: ${serverUrl}`);
+  console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
+  console.error(`开始循环接收任务...\n`);
+
+  let browser;
+  let browserRestartCount = 0;
+  let processedCount = 0;
+  let skippedCount = 0;
+  let errorCount = 0;
+  let consecutiveErrors = 0;
+
+  const shutdown = async (signal) => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    console.error(`\n[Comments Auto] 收到 ${signal}，正在关闭浏览器...`);
+    await browser?.close().catch(() => {});
+    console.error("[Comments Auto] 已退出");
+    process.exit(0);
+  };
+
+  const onSigint = () => {
+    void shutdown("SIGINT");
+  };
+  const onSigterm = () => {
+    void shutdown("SIGTERM");
+  };
+
+  process.once("SIGINT", onSigint);
+  process.once("SIGTERM", onSigterm);
+
+  async function ensureBrowser() {
+    if (browser) {
+      try {
+        await browser.contexts()[0]?.pages()[0]?.url();
+        return browser;
+      } catch {
+        try {
+          await browser.close();
+        } catch {}
+        browser = null;
+      }
+    }
+    browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
+    return browser;
+  }
+
+  async function getPage(browser) {
+    const contexts = browser.contexts();
+    if (contexts.length > 0) {
+      const pages = contexts[0].pages();
+      if (pages.length > 0) return pages[0];
+    }
+    return null;
+  }
+
+  try {
+    while (!shuttingDown) {
+      let page;
+      try {
+        browser = await ensureBrowser();
+        page = await getPage(browser);
+        if (!page) {
+          console.error("[Comments Auto] 未找到可用页面，等待中...");
+          await new Promise((r) => setTimeout(r, actualInterval * 1000));
+          continue;
+        }
+
+        // 获取任务
+        let tasks;
+        try {
+          const resp = await apiGet(
+            `${serverUrl}/api/comment-tasks?limit=${actualParallel}`,
+          );
+          tasks = resp.tasks || [];
+        } catch (err) {
+          console.error(`[Comments Auto] 获取任务失败: ${err.message}`);
+          consecutiveErrors++;
+          if (consecutiveErrors > 10) {
+            console.error("[Comments Auto] 连续获取失败超过10次，请检查服务端");
+            process.exit(1);
+          }
+          await new Promise((r) => setTimeout(r, actualInterval * 1000));
+          continue;
+        }
+        consecutiveErrors = 0;
+
+        if (tasks.length === 0) {
+          console.error(
+            `[Comments Auto] 暂无任务，${actualInterval}s 后重试...`,
+          );
+          await new Promise((r) => setTimeout(r, actualInterval * 1000));
+          continue;
+        }
+
+        console.error(`[Comments Auto] 获取 ${tasks.length} 个任务`);
+
+        for (const task of tasks) {
+          try {
+            const { id, href, locationCreated, ttSeller } = task;
+            const loc = normalizeLocation(locationCreated);
+
+            // 检查目标国家
+            if (loc && !isLocationInList(loc, DEFAULT_TARGET_LOCATIONS)) {
+              // 非目标国家，直接 commit 跳过
+              await apiPut(`${serverUrl}/api/comment-task/${id}`);
+              skippedCount++;
+              console.error(
+                `  [跳过] ${id.substring(0, 15)}... 国家: ${loc} (非目标)`,
+              );
+              continue;
+            }
+
+            console.error(
+              `  [处理] ${id.substring(0, 15)}... 国家: ${loc || "?"} ttSeller: ${ttSeller} -> ${href}`,
+            );
+
+            // 确保浏览器可用
+            browser = await ensureBrowser();
+            page = await getPage(browser);
+            if (!page) {
+              throw new Error("未找到可用页面");
+            }
+
+            // 导航到视频页
+            await page.goto(href, {
+              waitUntil: "domcontentloaded",
+              timeout: 30000,
+            });
+            const ready = await waitForPageReady(page, 30000);
+            if (!ready) {
+              throw new Error("页面加载超时");
+            }
+
+            // 关闭弹窗
+            await safeEvaluate(page, () => {
+              document
+                .querySelectorAll('[id*="modal-overlay"]')
+                .forEach((o) => o.click());
+            });
+            await page.keyboard.press("Escape");
+            await new Promise((r) => setTimeout(r, 1000));
+
+            // 如果评论面板已打开，先关闭
+            const panelOpen = await safeEvaluate(page, () => {
+              return !!document.querySelector('[class*="RightPanelContainer"]');
+            });
+            if (panelOpen) {
+              await closeCommentPanel(page);
+              await new Promise((r) => setTimeout(r, 800));
+            }
+
+            // 获取评论
+            const result = await fetchUserCommentsAPI(page, {
+              maxComments: actualMaxComments,
+              log: () => {},
+            });
+
+            // 关闭评论面板
+            await closeCommentPanel(page);
+
+            if (
+              result.error ||
+              !result.comments ||
+              result.comments.length === 0
+            ) {
+              console.error(`    [无评论] ${result.error || "未获取到评论"}`);
+            } else {
+              // 提取去重作者
+              const authors = [
+                ...new Set(
+                  result.comments
+                    .map((c) => c.user?.unique_id)
+                    .filter(Boolean)
+                    .map((u) => u.replace(/^@/, "")),
+                ),
+              ];
+
+              if (authors.length > 0) {
+                // 提交作者
+                const saveResult = await apiPost(`${serverUrl}/api/users`, {
+                  usernames: authors.map((a) => "@" + a),
+                  sources: ["comment"],
+                  guessedLocation: loc || null,
+                });
+                console.error(
+                  `    [提交] ${saveResult.added} 新增, ${saveResult.skipped} 跳过`,
+                );
+              } else {
+                console.error(
+                  `    [无作者] 获取了 ${result.comments.length} 条评论但无作者信息`,
+                );
+              }
+            }
+
+            // commit 任务
+            await apiPut(`${serverUrl}/api/comment-task/${id}`);
+            processedCount++;
+            console.error(`    [完成] 累计 ${processedCount} 个视频`);
+          } catch (err) {
+            errorCount++;
+            const isBrowserClosed = isBrowserClosedError(err);
+            if (isBrowserClosed) {
+              console.error(`    [浏览器异常] ${err.message}，将重启浏览器`);
+              try {
+                await browser.close();
+              } catch {}
+              browser = null;
+              browserRestartCount++;
+            } else {
+              console.error(`    [错误] ${err.message}`);
+            }
+            continue;
+          }
+        }
+      } catch (err) {
+        errorCount++;
+        const isBrowserClosed = isBrowserClosedError(err);
+        if (isBrowserClosed) {
+          console.error(
+            `[Comments Auto] 浏览器异常 (${++browserRestartCount})，正在重启...`,
+          );
+          try {
+            await browser.close();
+          } catch {}
+          browser = null;
+        } else {
+          console.error(`[Comments Auto] 异常: ${err.message}`);
+        }
+      }
+
+      // 等待间隔
+      await new Promise((r) => setTimeout(r, actualInterval * 1000));
+    }
+  } finally {
+    process.removeListener("SIGINT", onSigint);
+    process.removeListener("SIGTERM", onSigterm);
+    await browser?.close().catch(() => {});
+  }
+}
+
+export async function handleComments(options) {
+  const {
+    commentsUrl,
+    commentsMax,
+    commentsSave,
+    commentsParallel,
+    commentsInterval,
+    commentsServer,
+  } = options;
+
+  // 自动模式：无URL且传了 -s/--server 参数（或任何参数）
+  if (!commentsUrl && process.argv.length > 3) {
+    return runAutoMode({
+      serverUrl: commentsServer,
+      parallel: commentsParallel,
+      interval: commentsInterval,
+      maxComments: commentsMax || 200,
+    });
+  }
+
+  // 手动模式（需要 URL）
+  if (!commentsUrl) {
+    console.error("用法: tt-help comments <视频URL> [最大评论数] [--save]");
+    console.error(
+      "      tt-help comments [-p N] [-i N] [-s server] [-m maxComments]",
+    );
+    console.error("");
+    console.error("手动模式: tt-help comments <URL> [N] [--save]");
+    console.error("自动模式: tt-help comments -p 1 -i 10 -m 200 -s <server>");
+    console.error("");
+    console.error(
+      "选项: --save           去重后保存到服务端，来源标记为 comment",
+    );
+    console.error("      -p, --parallel   并行数 (默认 1)");
+    console.error("      -i, --interval   空闲间隔秒 (默认 10)");
+    console.error("      -s, --server     服务端地址");
+    console.error("      -m, --max-comments 每视频最大评论数 (默认 200)");
+    process.exit(1);
+  }
+
+  if (commentsSave) {
+    // 手动模式 --save
+    let browser;
+    try {
+      browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
+      const contexts = browser.contexts();
+      let page;
+
+      if (contexts.length > 0) {
+        const pages = contexts[0].pages();
+        if (pages.length > 0) {
+          page = pages[0];
+        }
+      }
+
+      if (!page) {
+        console.error("未找到可用页面");
+        process.exit(1);
+      }
+
+      console.error(`正在打开: ${commentsUrl}`);
+      await page.goto(commentsUrl, {
+        waitUntil: "domcontentloaded",
+        timeout: 30000,
+      });
+      const ready = await waitForPageReady(page, 30000);
+      if (!ready) {
+        console.error("页面加载超时，tab 未出现");
+        process.exit(1);
+      }
+
+      await safeEvaluate(page, () => {
+        document
+          .querySelectorAll('[id*="modal-overlay"]')
+          .forEach((o) => o.click());
+      });
+      await page.keyboard.press("Escape");
+      await new Promise((r) => setTimeout(r, 1000));
+
+      const videoInfo = await safeEvaluate(page, () => {
+        const result = {};
+        const m = window.location.href.match(/@([^/]+)\/video/);
+        result.author = m ? "@" + m[1] : "未知";
+        const html = document.documentElement.outerHTML;
+        const locMatch = html.match(/"locationCreated":"([^"]*)/);
+        result.locationCreated = locMatch ? locMatch[1] : null;
+        return result;
+      });
+
+      const panelOpen = await safeEvaluate(page, () => {
+        return !!document.querySelector('[class*="RightPanelContainer"]');
+      });
+      if (panelOpen) {
+        await closeCommentPanel(page);
+        await new Promise((r) => setTimeout(r, 800));
+      }
+
+      const result = await fetchUserCommentsAPI(page, {
+        maxComments: commentsMax,
+        log: () => {},
+      });
+
+      await closeCommentPanel(page);
+
+      if (result.error || !result.comments || result.comments.length === 0) {
+        console.error(`获取评论失败: ${result.error || "未获取到评论"}`);
+        process.exit(1);
+      }
+
+      const authors = [
+        ...new Set(
+          result.comments
+            .map((c) => c.user?.unique_id)
+            .filter(Boolean)
+            .map((u) => u.replace(/^@/, "")),
+        ),
+      ];
+
+      const guessedLocation = normalizeLocation(videoInfo?.locationCreated);
+      const serverUrl = commentsServer || defaultServer;
+
+      if (
+        guessedLocation &&
+        !isLocationInList(guessedLocation, DEFAULT_TARGET_LOCATIONS)
+      ) {
+        console.error(`\n猜测国家: ${guessedLocation}，非目标国家，跳过保存`);
+        console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
+      } else {
+        console.error(`\n正在提交 ${authors.length} 个评论作者到服务端...`);
+        console.error(`服务端: ${serverUrl}`);
+        if (guessedLocation) console.error(`猜测国家: ${guessedLocation}`);
+
+        try {
+          const saveResult = await apiPost(`${serverUrl}/api/users`, {
+            usernames: authors.map((a) => "@" + a),
+            sources: ["comment"],
+            guessedLocation: guessedLocation || null,
+          });
+          console.error(
+            `\n提交结果: ${saveResult.added} 个新增, ${saveResult.skipped} 个跳过`,
+          );
+        } catch (err) {
+          console.error(`\n提交失败: ${err.message}`);
+          process.exit(1);
+        }
+      }
+    } catch (err) {
+      console.error(`获取评论失败: ${err.message}`);
+      process.exit(1);
+    } finally {
+      if (browser) await browser.close().catch(() => {});
+    }
+    return;
+  }
+
+  // 手动模式：打印到控制台
+  let browser;
+  try {
+    browser = await chromium.connectOverCDP("http://127.0.0.1:9222");
+    const contexts = browser.contexts();
+    let page;
+
+    if (contexts.length > 0) {
+      const pages = contexts[0].pages();
+      if (pages.length > 0) {
+        page = pages[0];
+      }
+    }
+
+    if (!page) {
+      console.error("未找到可用页面");
+      process.exit(1);
+    }
+
+    console.error(`正在打开: ${commentsUrl}`);
+    await page.goto(commentsUrl, {
+      waitUntil: "domcontentloaded",
+      timeout: 30000,
+    });
+    const ready = await waitForPageReady(page, 30000);
+    if (!ready) {
+      console.error("页面加载超时，tab 未出现");
+      process.exit(1);
+    }
+
+    await safeEvaluate(page, () => {
+      document
+        .querySelectorAll('[id*="modal-overlay"]')
+        .forEach((o) => o.click());
+    });
+    await page.keyboard.press("Escape");
+    await new Promise((r) => setTimeout(r, 1000));
+
+    const videoInfo = await safeEvaluate(page, () => {
+      const result = {};
+      const m = window.location.href.match(/@([^/]+)\/video/);
+      result.author = m ? "@" + m[1] : "未知";
+      const html = document.documentElement.outerHTML;
+      const locMatch = html.match(/"locationCreated":"([^"]*)/);
+      result.locationCreated = locMatch ? locMatch[1] : null;
+      return result;
+    });
+
+    const panelOpen = await safeEvaluate(page, () => {
+      return !!document.querySelector('[class*="RightPanelContainer"]');
+    });
+    if (panelOpen) {
+      await closeCommentPanel(page);
+      await new Promise((r) => setTimeout(r, 800));
+    }
+
+    const result = await fetchUserCommentsAPI(page, {
+      maxComments: commentsMax,
+      log: () => {},
+    });
+
+    await closeCommentPanel(page);
+
+    if (result.error || !result.comments || result.comments.length === 0) {
+      console.error(`获取评论失败: ${result.error || "未获取到评论"}`);
+      process.exit(1);
+    }
+
+    const authors = [
+      ...new Set(
+        result.comments
+          .map((c) => c.user?.unique_id)
+          .filter(Boolean)
+          .map((u) => u.replace(/^@/, "")),
+      ),
+    ];
+
+    console.log(`视频: ${commentsUrl}`);
+    console.log(`作者: ${videoInfo?.author || "未知"}`);
+    if (videoInfo?.locationCreated)
+      console.log(`猜测国家: ${videoInfo.locationCreated}`);
+    console.log(`评论数: ${result.comments.length}`);
+    console.log(`评论作者: ${authors.length}`);
+    console.log("");
+
+    result.comments.forEach((c, i) => {
+      const author = c.user?.unique_id
+        ? "@" + c.user.unique_id
+        : c.user?.nickname || "未知";
+      const text = c.text || "";
+      const likes = c.digg_count || 0;
+      console.log(`${i + 1}. [${author}] ${text} (\u2764 ${likes})`);
+    });
+
+    console.log("");
+    console.log(
+      `共 ${result.comments.length} 条评论, ${authors.length} 个唯一作者`,
+    );
+  } catch (err) {
+    console.error(`获取评论失败: ${err.message}`);
+    process.exit(1);
+  } finally {
+    if (browser) await browser.close().catch(() => {});
+  }
+}