tt-help-cli-ycl 1.3.29 → 1.3.31

package/src/lib/browser/cdp.js

@@ -1,93 +1,113 @@
-import { exec } from 'child_process';
-import { execSync } from 'child_process';
-import fs from 'fs';
-import http from 'http';
-import os from 'os';
-import path from 'path';
-import { chromium } from 'playwright';
+import { exec } from "child_process";
+import { execSync } from "child_process";
+import fs from "fs";
+import http from "http";
+import os from "os";
+import path from "path";
+import { chromium } from "playwright";
 
 const DEFAULT_CDP_PORT = 9222;
-const DEFAULT_USER_DATA_DIR = path.join(os.homedir(), 'Library', 'Application Support', 'Microsoft Edge For Testing');
+const DEFAULT_USER_DATA_DIR = path.join(
+  os.homedir(),
+  "Library",
+  "Application Support",
+  "Microsoft Edge For Testing",
+);
 
 function getEdgePath() {
   const platform = os.platform();
-  if (platform === 'darwin') return '"Microsoft Edge"';
-  if (platform === 'win32') return 'msedge.exe';
-  return 'msedge';
+  if (platform === "darwin") return '"Microsoft Edge"';
+  if (platform === "win32") return "msedge.exe";
+  return "msedge";
 }
 
 function isEdgeRunning() {
-  return new Promise(resolve => {
+  return new Promise((resolve) => {
     const platform = os.platform();
     let command;
-    if (platform === 'darwin') {
-      command = 'ps aux | grep -q "[M]icrosoft Edge.app/Contents/MacOS/Microsoft Edge" 2>/dev/null';
-    } else if (platform === 'win32') {
-      command = 'tasklist /FI "IMAGENAME eq msedge.exe" 2>nul | findstr /I msedge';
+    if (platform === "darwin") {
+      command =
+        'ps aux | grep -q "[M]icrosoft Edge.app/Contents/MacOS/Microsoft Edge" 2>/dev/null';
+    } else if (platform === "win32") {
+      command =
+        'tasklist /FI "IMAGENAME eq msedge.exe" 2>nul | findstr /I msedge';
     } else {
-      command = 'pgrep -f msedge > /dev/null 2>&1';
+      command = "pgrep -f msedge > /dev/null 2>&1";
     }
     exec(command, (err) => resolve(!err));
   });
 }
 
 function checkCDPPort(port) {
-  return new Promise(resolve => {
-    const req = http.get(`http://127.0.0.1:${port}/json`, res => {
-      res.on('data', () => {});
-      res.on('end', () => resolve(res.statusCode === 200));
+  return new Promise((resolve) => {
+    const req = http.get(`http://127.0.0.1:${port}/json`, (res) => {
+      res.on("data", () => {});
+      res.on("end", () => resolve(res.statusCode === 200));
+    });
+    req.on("error", () => resolve(false));
+    req.setTimeout(3000, () => {
+      resolve(false);
+      req.destroy();
     });
-    req.on('error', () => resolve(false));
-    req.setTimeout(3000, () => { resolve(false); req.destroy(); });
   });
 }
 
 function checkEdgeArgs() {
-  return new Promise(resolve => {
+  return new Promise((resolve) => {
     const platform = os.platform();
     let command;
-    if (platform === 'darwin') {
-      command = 'ps aux | grep "[M]icrosoft Edge" | grep -v "Helper\\|crashpad" | grep "user-data-dir"';
-    } else if (platform === 'win32') {
-      command = 'wmic process where "name like \\"%msedge%\\"" get commandline | findstr "user-data-dir"';
+    if (platform === "darwin") {
+      command =
+        'ps aux | grep "[M]icrosoft Edge" | grep -v "Helper\\|crashpad" | grep "user-data-dir"';
+    } else if (platform === "win32") {
+      command =
+        'wmic process where "name like \\"%msedge%\\"" get commandline | findstr "user-data-dir"';
     } else {
-      command = 'ps aux | grep "[m]sedge" | grep -v "Helper\\|crashpad" | grep "user-data-dir"';
+      command =
+        'ps aux | grep "[m]sedge" | grep -v "Helper\\|crashpad" | grep "user-data-dir"';
     }
     exec(command, (err, stdout) => resolve(!err && stdout.trim().length > 0));
   });
 }
 
 function killEdgeProcesses(targetDir) {
-  return new Promise(resolve => {
+  return new Promise((resolve) => {
     const platform = os.platform();
     let command;
-    if (platform === 'darwin') {
+    if (platform === "darwin") {
       if (targetDir) {
-        let pids = '';
+        let pids = "";
         try {
           // ps aux 输出中 --user-data-dir= 后面没有引号
           // 用路径精确匹配，结尾加空格或行尾避免子串误杀
-          const escapedDir = targetDir.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+          const escapedDir = targetDir.replace(
+            /[-\/\\^$*+?.()|[\]{}]/g,
+            "\\$&",
+          );
           pids = execSync(
-            `ps aux | grep "[M]icrosoft Edge" | grep -v "Helper\\|crashpad" | grep -E -- '--user-data-dir=${escapedDir}($|[^A-Za-z0-9_])' | awk '{print $2}'`
-          ).toString().trim();
+            `ps aux | grep "[M]icrosoft Edge" | grep -v "Helper\\|crashpad" | grep -E -- '--user-data-dir=${escapedDir}($|[^A-Za-z0-9_])' | awk '{print $2}'`,
+          )
+            .toString()
+            .trim();
         } catch (e) {
-          pids = '';
+          pids = "";
         }
         if (pids) {
           command = `kill -9 ${pids} 2>/dev/null; rm -f ~/Library/Caches/Microsoft\\ Edge/Singleton*; true`;
         } else {
-          command = 'true';
+          command = "true";
         }
       } else {
-        command = 'killall -9 "Microsoft Edge" 2>/dev/null; rm -f ~/Library/Caches/Microsoft\\ Edge/Singleton*; true';
+        command =
+          'killall -9 "Microsoft Edge" 2>/dev/null; rm -f ~/Library/Caches/Microsoft\\ Edge/Singleton*; true';
       }
-    } else if (platform === 'win32') {
+    } else if (platform === "win32") {
       if (targetDir) {
         try {
           const ps1Path = path.join(os.tmpdir(), `kill-edge-${Date.now()}.ps1`);
           const escapedDir = targetDir.replace(/'/g, "''");
-          const ps1Content = `$procs = Get-CimInstance Win32_Process -Filter "Name='msedge.exe'" 2>$null; ` +
+          const ps1Content =
+            `$procs = Get-CimInstance Win32_Process -Filter "Name='msedge.exe'" 2>$null; ` +
             `$count = 0; ` +
             `foreach ($p in $procs) { ` +
             `  if ($p.CommandLine -and $p.CommandLine -like "*${escapedDir}*") { ` +
@@ -99,22 +119,24 @@ function killEdgeProcesses(targetDir) {
             `Write-Output $count`;
           fs.writeFileSync(ps1Path, ps1Content);
           const result = execSync(
-            `powershell.exe -ExecutionPolicy Bypass -File "${ps1Path}"`
-          ).toString().trim();
+            `powershell.exe -ExecutionPolicy Bypass -File "${ps1Path}"`,
+          )
+            .toString()
+            .trim();
           fs.unlinkSync(ps1Path);
-          command = 'exit 0';
+          command = "exit 0";
         } catch {
-          command = 'taskkill /F /IM msedge.exe 2>nul || exit 0';
+          command = "taskkill /F /IM msedge.exe 2>nul || exit 0";
         }
       } else {
-        command = 'taskkill /F /IM msedge.exe 2>nul || exit 0';
+        command = "taskkill /F /IM msedge.exe 2>nul || exit 0";
       }
     } else {
       if (targetDir) {
-        const escapedDir = targetDir.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
+        const escapedDir = targetDir.replace(/[-\/\\^$*+?.()|[\]{}]/g, "\\$&");
         command = `ps aux | grep msedge | grep -v Helper | grep -E -- '--user-data-dir=${escapedDir}($|[^A-Za-z0-9_])' | awk '{print $2}' | xargs -r kill -9 2>/dev/null; true`;
       } else {
-        command = 'pkill -9 -f msedge 2>/dev/null; true';
+        command = "pkill -9 -f msedge 2>/dev/null; true";
       }
     }
     exec(command, () => resolve());
@@ -130,21 +152,21 @@ function launchEdgeWithCDP(port, userDataDir) {
     const extraArgs = [
       `--remote-debugging-port=${port}`,
       `--user-data-dir="${userDataDir}"`,
-      '--disable-blink-features=AutomationControlled',
-      '--no-first-run',
-      '--no-default-browser-check',
-      '--password-store=basic',
-      '--disable-background-mode',
-      '--disable-component-update',
-      '--disable-crash-reporter',
-      '--disable-breakpad',
-      '--disable-background-networking',
-      '--disable-sync',
-    ].join(' ');
-
-    if (platform === 'darwin') {
+      "--disable-blink-features=AutomationControlled",
+      "--no-first-run",
+      "--no-default-browser-check",
+      "--password-store=basic",
+      "--disable-background-mode",
+      "--disable-component-update",
+      "--disable-crash-reporter",
+      "--disable-breakpad",
+      "--disable-background-networking",
+      "--disable-sync",
+    ].join(" ");
+
+    if (platform === "darwin") {
       command = `open -a ${edgePath} --new --args ${extraArgs}`;
-    } else if (platform === 'win32') {
+    } else if (platform === "win32") {
       command = `start msedge ${extraArgs}`;
     } else {
       command = `msedge ${extraArgs} &`;
@@ -162,7 +184,7 @@ async function waitForCDP(port, timeout = 30000, interval = 1000) {
   while (Date.now() - start < timeout) {
     const ready = await checkCDPPort(port);
     if (ready) return true;
-    await new Promise(r => setTimeout(r, interval));
+    await new Promise((r) => setTimeout(r, interval));
   }
   return false;
 }
@@ -183,7 +205,7 @@ export async function ensureBrowserReady(options = {}) {
       if (!edgeArgsValid) {
         console.error(`Edge 已运行但启动参数不完整，正在重启端口 ${port}...`);
         await killEdgeProcesses(userDataDir);
-        await new Promise(r => setTimeout(r, 3000));
+        await new Promise((r) => setTimeout(r, 3000));
         needLaunch = true;
       }
     }
@@ -197,22 +219,22 @@ export async function ensureBrowserReady(options = {}) {
       if (edgeRunning) {
         console.error(`Edge 已运行但 CDP 端口 ${port} 未启用，正在重启...`);
         await killEdgeProcesses(userDataDir);
-        await new Promise(r => setTimeout(r, 3000));
+        await new Promise((r) => setTimeout(r, 3000));
       } else {
         console.error(`CDP 端口 ${port} 未就绪，正在启动 Edge 浏览器...`);
       }
     }
     await launchEdgeWithCDP(port, userDataDir);
 
-    console.error('等待浏览器启动...');
+    console.error("等待浏览器启动...");
     const launched = await waitForCDP(port);
     if (!launched) {
       throw new Error(
         `等待 CDP 端口 ${port} 超时。请确认 Edge 浏览器已安装，\n` +
-        `或手动启动: Microsoft Edge --remote-debugging-port=${port} [参见 cdp.js extraArgs]`
+          `或手动启动: Microsoft Edge --remote-debugging-port=${port} [参见 cdp.js extraArgs]`,
       );
     }
-    console.error('浏览器启动成功');
+    console.error("浏览器启动成功");
   }
 
   const browser = await chromium.connectOverCDP(`http://127.0.0.1:${port}`);
@@ -221,9 +243,11 @@ export async function ensureBrowserReady(options = {}) {
 
 export async function switchAccount(oldAccount, newAccount) {
   console.error(`\n[账户切换] 从端口 ${oldAccount.port} -> ${newAccount.port}`);
+  console.error(`  [账户切换] 等待 30 秒，请完成当前操作后自动切换...`);
+  await new Promise((r) => setTimeout(r, 30000));
 
   await killEdgeProcesses(oldAccount.userDataDir);
-  await new Promise(r => setTimeout(r, 3000));
+  await new Promise((r) => setTimeout(r, 3000));
 
   const newCdpOptions = {};
   newCdpOptions.port = newAccount.port;
@@ -231,7 +255,7 @@ export async function switchAccount(oldAccount, newAccount) {
 
   const browser = await ensureBrowserReady(newCdpOptions);
 
-  await new Promise(r => setTimeout(r, 10000));
+  await new Promise((r) => setTimeout(r, 10000));
 
   return browser;
 }

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

@@ -2,16 +2,19 @@ import os from "os";
 import path from "path";
 import { execSync } from "child_process";
 
-const TOTAL_ACCOUNTS = 10;
-const BASE_PORT = 9222;
-const MEMORY_THRESHOLD = 0.9;
-const ROTATE_INTERVAL_MS = 1 * 60 * 60 * 1000; // 1小时
+const DEFAULT_BASE_PORT = 9222;
+const DEFAULT_TOTAL_ACCOUNTS = 10;
+const MEMORY_THRESHOLD = 0.95;
+const ROTATE_INTERVAL_MS = 0.8 * 60 * 60 * 1000;
 
 class HealthChecker {
-  constructor() {
+  constructor(options = {}) {
+    const basePort = options.basePort ?? DEFAULT_BASE_PORT;
+    const totalAccounts = options.totalAccounts ?? DEFAULT_TOTAL_ACCOUNTS;
+
     this.accounts = [];
-    for (let i = 0; i < TOTAL_ACCOUNTS; i++) {
-      const port = BASE_PORT + i;
+    for (let i = 0; i < totalAccounts; i++) {
+      const port = basePort + i;
       const profile = `p${port}`;
       this.accounts.push({
         port,
@@ -33,7 +36,7 @@ class HealthChecker {
   }
 
   getNextAccount() {
-    this.currentIndex = (this.currentIndex + 1) % TOTAL_ACCOUNTS;
+    this.currentIndex = (this.currentIndex + 1) % this.accounts.length;
     this.startTime = Date.now(); // 切换后重置运行时间
     return this.accounts[this.currentIndex];
   }
@@ -78,23 +81,32 @@ class HealthChecker {
     const memPercent = (memUsage * 100).toFixed(1);
 
     if (memUsage >= MEMORY_THRESHOLD) {
-      return { shouldSwitch: true, reason: `系统内存 ${memPercent}%` };
+      const currentPort = this.accounts[this.currentIndex].port;
+      return {
+        shouldSwitch: true,
+        reason: `端口 ${currentPort} | 系统内存 ${memPercent}%`,
+      };
     }
 
     const elapsed = Date.now() - this.startTime;
     if (elapsed >= ROTATE_INTERVAL_MS) {
       const mins = Math.round(elapsed / 60000);
-      return { shouldSwitch: true, reason: `运行 ${mins} 分钟` };
+      const currentPort = this.accounts[this.currentIndex].port;
+      return {
+        shouldSwitch: true,
+        reason: `端口 ${currentPort} | 运行 ${mins} 分钟`,
+      };
     }
 
     // 计算预计切换时间
     const remainingMs = ROTATE_INTERVAL_MS - elapsed;
     const remainingMins = Math.round(remainingMs / 60000);
     const memHeadroom = ((MEMORY_THRESHOLD - memUsage) * 100).toFixed(1);
+    const currentPort = this.accounts[this.currentIndex].port;
 
     return {
       shouldSwitch: false,
-      info: `内存 ${memPercent}% (余量 ${memHeadroom}%) | 定时轮换 ${remainingMins} 分钟后`,
+      info: `端口 ${currentPort} | 内存 ${memPercent}% (余量 ${memHeadroom}%) | 定时轮换 ${remainingMins} 分钟后`,
     };
   }
 }

package/src/lib/browser/page.js

@@ -1,25 +1,30 @@
-import os from 'os';
-import path from 'path';
-import { delay } from '../delay.js';
-import { retryWithBackoff } from '../retry.js';
-import { getDelayConfig } from '../delay.js';
-import { ensureBrowserReady, killEdgeProcesses } from './cdp.js';
-
-const DEFAULT_USER_DATA_DIR = path.join(os.homedir(), 'Library', 'Application Support', 'Microsoft Edge For Testing');
+import os from "os";
+import path from "path";
+import { delay } from "../delay.js";
+import { retryWithBackoff } from "../retry.js";
+import { getDelayConfig } from "../delay.js";
+import { ensureBrowserReady, killEdgeProcesses } from "./cdp.js";
+
+const DEFAULT_USER_DATA_DIR = path.join(
+  os.homedir(),
+  "Library",
+  "Application Support",
+  "Microsoft Edge For Testing",
+);
 
 const BROWSER_CLOSED_PATTERNS = [
-  'Target page, context or browser has been closed',
-  'Target closed',
-  'Browser has been closed',
-  'Protocol error',
-  'Connection closed',
-  'net::ERR_CONNECTION',
+  "Target page, context or browser has been closed",
+  "Target closed",
+  "Browser has been closed",
+  "Protocol error",
+  "Connection closed",
+  "net::ERR_CONNECTION",
 ];
 
 export function isBrowserClosedError(error) {
   if (!error) return false;
-  const msg = error.message || error.toString() || '';
-  return BROWSER_CLOSED_PATTERNS.some(p => msg.includes(p));
+  const msg = error.message || error.toString() || "";
+  return BROWSER_CLOSED_PATTERNS.some((p) => msg.includes(p));
 }
 
 export async function relaunchBrowser(cdpOptions, port) {
@@ -27,25 +32,25 @@ export async function relaunchBrowser(cdpOptions, port) {
   const targetDir = cdpOptions.userDataDir || DEFAULT_USER_DATA_DIR;
   // kill 并清理 Singleton 锁文件，确保 Edge 能启动新实例
   await killEdgeProcesses(targetDir);
-  await new Promise(r => setTimeout(r, 3000));
+  await new Promise((r) => setTimeout(r, 3000));
   // 确保端口已释放后再启动
   let retries = 0;
   while (retries < 5) {
     try {
       return await ensureBrowserReady(cdpOptions);
     } catch (e) {
-      if (e.message && e.message.includes('setDownloadBehavior')) {
+      if (e.message && e.message.includes("setDownloadBehavior")) {
         retries++;
         console.error(`  [浏览器] CDP 连接异常，重试 ${retries}/5...`);
-        await new Promise(r => setTimeout(r, 3000));
+        await new Promise((r) => setTimeout(r, 3000));
         await killEdgeProcesses(targetDir);
-        await new Promise(r => setTimeout(r, 5000));
+        await new Promise((r) => setTimeout(r, 5000));
         continue;
       }
       throw e;
     }
   }
-  throw new Error('浏览器重启失败，CDP 连接异常');
+  throw new Error("浏览器重启失败，CDP 连接异常");
 }
 
 export async function withBrowserRecovery(fn, browser, page, cdpOptions, port) {
@@ -61,7 +66,22 @@ export async function withBrowserRecovery(fn, browser, page, cdpOptions, port) {
   }
 }
 
+/**
+ * 通过 Cookie 判断登录状态（推荐，最可靠）
+ * 已登录：存在 sessionid Cookie
+ * 未登录：不存在 sessionid Cookie
+ */
 export async function isLoggedIn(page) {
+  const cookies = await page.context().cookies("https://www.tiktok.com");
+  return cookies.some((c) => c.name === "sessionid");
+}
+
+/**
+ * 通过 DOM 元素判断登录状态（备用方案）
+ * 依赖页面渲染完成，可能存在误判
+ * @deprecated 推荐使用 isLoggedIn（基于 Cookie）
+ */
+export async function isLoggedInByDom(page) {
   // 先等客户端渲染完成：登录态元素或登录按钮，哪个先出现就停止等待
   const loginOrLoggedInSelector = [
     '[class*="DivProfileContainer"]',
@@ -71,19 +91,22 @@ export async function isLoggedIn(page) {
     'button:has-text("登录")',
     'button:has-text("Log in")',
     'button:has-text("Sign in")',
-  ].join(', ');
+  ].join(", ");
 
-  await page.waitForSelector(loginOrLoggedInSelector, { timeout: 10000 }).catch(() => {});
+  await page
+    .waitForSelector(loginOrLoggedInSelector, { timeout: 10000 })
+    .catch(() => {});
 
   return page.evaluate(() => {
     const hasProfileContainer = !!document.querySelector(
-      '[class*="DivProfileContainer"], [class*="DivUserContainer"]'
+      '[class*="DivProfileContainer"], [class*="DivUserContainer"]',
     );
     const hasUserMenu = !!document.querySelector(
-      '[class*="UserMenu"], [class*="user-menu"], [class*="CurrentUserInfo"]'
+      '[class*="UserMenu"], [class*="user-menu"], [class*="CurrentUserInfo"]',
     );
-    const hasLoginButton = Array.from(document.querySelectorAll('button, [role="button"]'))
-      .some(el => /^(登录|Log in|Sign in)$/i.test(el.textContent.trim()));
+    const hasLoginButton = Array.from(
+      document.querySelectorAll('button, [role="button"]'),
+    ).some((el) => /^(登录|Log in|Sign in)$/i.test(el.textContent.trim()));
 
     return (hasProfileContainer || hasUserMenu) && !hasLoginButton;
   });
@@ -95,7 +118,7 @@ export async function closeCommentPanel(page) {
     if (rightPanel) {
       const tabContainer = rightPanel.querySelector('[class*="TabContainer"]');
       if (tabContainer) {
-        const closeOverlay = tabContainer.querySelector('div:last-child');
+        const closeOverlay = tabContainer.querySelector("div:last-child");
         if (closeOverlay) closeOverlay.click();
       }
     }
@@ -108,7 +131,7 @@ export async function ensureTikTokPage(browser, url) {
 
   for (const ctx of contexts) {
     for (const p of ctx.pages()) {
-      if (p.url().includes('tiktok.com')) {
+      if (p.url().includes("tiktok.com")) {
         page = p;
         break;
       }
@@ -117,13 +140,15 @@ export async function ensureTikTokPage(browser, url) {
   }
 
   if (!page) {
-    console.error('未找到 TikTok 页面，正在打开...');
+    console.error("未找到 TikTok 页面，正在打开...");
     const defaultCtx = browser.contexts()[0];
     page = await defaultCtx.newPage();
-    await retryWithBackoff(() => page.goto(url, { waitUntil: 'load', timeout: 30000 }));
+    await retryWithBackoff(() =>
+      page.goto(url, { waitUntil: "load", timeout: 30000 }),
+    );
     const config = getDelayConfig();
     await delay(Math.round(config.switchMax * 0.5), config.switchMax);
-    console.error('TikTok 页面已打开');
+    console.error("TikTok 页面已打开");
   }
 
   return page;
@@ -133,7 +158,7 @@ export async function findTikTokPage(browser) {
   const contexts = browser.contexts();
   for (const ctx of contexts) {
     for (const p of ctx.pages()) {
-      if (p.url().includes('tiktok.com')) return p;
+      if (p.url().includes("tiktok.com")) return p;
     }
   }
   return null;
@@ -142,7 +167,7 @@ export async function findTikTokPage(browser) {
 export async function getOrCreatePage(browser) {
   let page = await findTikTokPage(browser);
   if (!page) {
-    const defaultCtx = browser.contexts()[0] || await browser.newContext();
+    const defaultCtx = browser.contexts()[0] || (await browser.newContext());
     page = await defaultCtx.newPage();
   }
   return page;
@@ -151,6 +176,8 @@ export async function getOrCreatePage(browser) {
 export function assertPageUrl(page, expectedPath) {
   const actual = page.url();
   if (!actual.includes(expectedPath)) {
-    throw new Error(`[代理错误] 预期访问 ${expectedPath}，实际跳转到了 ${actual}`);
+    throw new Error(
+      `[代理错误] 预期访问 ${expectedPath}，实际跳转到了 ${actual}`,
+    );
   }
 }

package/src/lib/constants.js

@@ -143,6 +143,12 @@ const HELP_TEXT = [
   '    示例: tt-help open 9222',
   '          tt-help open --list',
   '',
+  '  videostats  <文件路径> -p <并发数>',
+  '    批量刷新视频统计数据（playCount, diggCount, commentCount, shareCount, collectCount）',
+  '    读取视频文件，通过 getVideoInfo 获取最新数据，更新后写回原文件',
+  '    -p, --parallel <N>       并发数（默认: 3）',
+  '    示例: tt-help videostats data/result-videos.json -p 3',
+  '',
   '  config  [show|set|reset]',
   '    config                    查看当前配置',
     '    config set <key> <value>  设置配置（key: proxy, server, browser, userId, maxFollowing, maxFollowers, maxVideos, maxComments）',
@@ -156,6 +162,7 @@ const HELP_TEXT = [
   '        tt-help explore qiqi23280 fast --location ES --max-comments 50',
   '        tt-help config set server http://127.0.0.1:3001',
   '        tt-help attach -p 5 -i 10',
+  '        tt-help videostats data/result-videos.json -p 3',
 ];
 
 function getConfigText() {

package/src/main.js

@@ -6,16 +6,20 @@ import { handleAttach } from './cli/attach.js';
 import { handleWatch } from './cli/watch.js';
 import { handleConfig, showConfig, showUsage, version } from './cli/config.js';
 import { handleOpen } from './cli/open.js';
+import { handleComments } from './cli/comments.js';
+import { handleVideoStats } from './cli/videostats.js';
 
 async function main() {
   const parsed = parseArgs();
 
   switch (parsed.subcommand) {
-    case 'explore': return handleExplore(parsed);
-    case 'info':    return handleInfo(parsed);
-    case 'attach':  return handleAttach(parsed);
-    case 'watch':   return handleWatch(parsed);
-    case 'open':    return handleOpen(parsed);
+    case 'explore':    return handleExplore(parsed);
+    case 'info':       return handleInfo(parsed);
+    case 'attach':     return handleAttach(parsed);
+    case 'watch':      return handleWatch(parsed);
+    case 'open':       return handleOpen(parsed);
+    case 'comments':   return handleComments(parsed);
+    case 'videostats': return handleVideoStats(parsed);
   }
 
   const { urls, outputFile, outputFormat, exploreCount, showConfig: showCfg, showHelp, showVersion, customProxy, configAction, configKey, configValue } = parsed;