tt-help-cli-ycl 1.3.11 → 1.3.13

package/README.md

@@ -1,17 +1,17 @@
-# tt-help
-
-TikTok user & video data scraper — extract ttSeller, verified, locationCreated from HTML source.
-
-## Install
-
-```bash
-npm i -g tt-help
-```
-
-## Usage
-
-```bash
-tt-help [options] <urls...>
-```
-
-示例、代理配置、和更多用法请查看仓库或 `src/main.mjs` 中的帮助文本。
+# tt-help
+
+TikTok user & video data scraper — extract ttSeller, verified, locationCreated from HTML source.
+
+## Install
+
+```bash
+npm i -g tt-help
+```
+
+## Usage
+
+```bash
+tt-help [options] <urls...>
+```
+
+示例、代理配置、和更多用法请查看仓库或 `src/main.mjs` 中的帮助文本。

package/cli.js

@@ -1,9 +1,9 @@
-#!/usr/bin/env node
-import { fileURLToPath } from 'url';
-import { dirname, resolve } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const mainPath = resolve(__dirname, 'src', 'main.mjs');
-await import(`file://${mainPath}`);
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const mainPath = resolve(__dirname, 'src', 'main.js');
+await import(`file://${mainPath}`);

package/package.json

@@ -1,46 +1,45 @@
-{
-  "name": "tt-help-cli-ycl",
-  "version": "1.3.11",
-  "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
-  "type": "module",
-  "bin": {
-    "tt-help": "cli.js"
-  },
-  "main": "src/main.mjs",
-  "files": [
-    "cli.js",
-    "src/",
-    "bat/"
-  ],
-  "scripts": {
-    "start": "node src/main.mjs"
-  },
-  "keywords": [
-    "tiktok",
-    "scraper",
-    "cli",
-    "seller",
-    "ttSeller"
-  ],
-  "author": "jsjhycl",
-  "license": "ISC",
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/jsjhycl/tt-help-cli.git"
-  },
-  "bugs": {
-    "url": "https://github.com/jsjhycl/tt-help-cli/issues"
-  },
-  "homepage": "https://github.com/jsjhycl/tt-help-cli#readme",
-  "dependencies": {
-    "playwright": "^1.59.1",
-    "tt-help-cli-ycl": "^1.3.2",
-    "undici": "^8.1.0"
-  }
-}
+{
+  "name": "tt-help-cli-ycl",
+  "version": "1.3.13",
+  "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
+  "type": "module",
+  "bin": {
+    "tt-help": "cli.js"
+  },
+  "main": "src/main.js",
+  "files": [
+    "cli.js",
+    "src/",
+    "scripts/"
+  ],
+  "scripts": {
+    "start": "node src/main.js"
+  },
+  "keywords": [
+    "tiktok",
+    "scraper",
+    "cli",
+    "seller",
+    "ttSeller"
+  ],
+  "author": "jsjhycl",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsjhycl/tt-help-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jsjhycl/tt-help-cli/issues"
+  },
+  "homepage": "https://github.com/jsjhycl/tt-help-cli#readme",
+  "dependencies": {
+    "playwright": "^1.59.1",
+    "undici": "^8.1.0"
+  }
+}

package/{bat → scripts}/run-explore.bat

@@ -1,68 +1,68 @@
-@ECHO OFF
-SETLOCAL
-
-SET "PACKAGENAME=tt-help-cli-ycl"
-SET "TARGET_SERVER=http://117.71.53.99:17301"
-SET "CONFIG_PATH=%USERPROFILE%\.tt-help.json"
-
-ECHO ========================================
-ECHO   tt-help-cli-ycl one-click launcher (Windows CMD)
-ECHO ========================================
-
-REM ---------- 1. Check/install latest version ----------
-FOR /F "delims=" %%V IN ('npm view %PACKAGENAME% version 2^>nul') DO SET "LATEST_VERSION=%%V"
-
-IF NOT DEFINED LATEST_VERSION (
-    ECHO [ERROR] Cannot get latest version from npm
-    EXIT /B 1
-)
-
-FOR /F "tokens=2 delims=@" %%V IN ('npm list -g %PACKAGENAME% --depth=0 2^>nul ^| findstr /i "%PACKAGENAME%"') DO SET "INSTALLED_VERSION=%%V"
-
-IF NOT DEFINED INSTALLED_VERSION (
-    ECHO [INFO] %PACKAGENAME% not installed, installing latest...
-    CALL npm install -g %PACKAGENAME%
-    IF %ERRORLEVEL% EQU 0 (
-        ECHO [OK] Installed: %LATEST_VERSION%
-    ) ELSE (
-        ECHO [ERROR] Install failed, run manually: npm install -g %PACKAGENAME%
-        EXIT /B 1
-    )
-) ELSE IF "%INSTALLED_VERSION%"=="%LATEST_VERSION%" (
-    ECHO [OK] %PACKAGENAME% is up to date: %LATEST_VERSION%
-) ELSE (
-    ECHO [INFO] Current: %INSTALLED_VERSION%, Latest: %LATEST_VERSION%
-    ECHO [INFO] Upgrading to latest...
-    CALL npm install -g %PACKAGENAME%
-    IF %ERRORLEVEL% EQU 0 (
-        ECHO [OK] Upgraded: %LATEST_VERSION%
-    ) ELSE (
-        ECHO [WARN] Upgrade failed, run manually: npm install -g %PACKAGENAME%
-    )
-)
-
-REM ---------- 2. Check/set server config ----------
-SET "CURRENT_SERVER="
-IF EXIST "%CONFIG_PATH%" (
-    FOR /F "delims=" %%S IN ('node -e "try{const c=JSON.parse(require('fs').readFileSync('%CONFIG_PATH%','utf-8'));console.log(c.server||'')}catch(e){}" 2^>nul') DO SET "CURRENT_SERVER=%%S"
-)
-
-IF "%CURRENT_SERVER%"=="%TARGET_SERVER%" (
-    ECHO [OK] Server config is correct: %TARGET_SERVER%
-) ELSE (
-    IF "%CURRENT_SERVER%"=="" (
-        ECHO [INFO] Current server: not set, target: %TARGET_SERVER%
-    ) ELSE (
-        ECHO [INFO] Current server: %CURRENT_SERVER%, target: %TARGET_SERVER%
-    )
-    ECHO [INFO] Setting server config...
-    node -e "const fs=require('fs'),path=require('path');const p=path.join(require('os').homedir(),'.tt-help.json');let c={};try{c=JSON.parse(fs.readFileSync(p,'utf-8'))}catch(e){}c.server='%TARGET_SERVER%';fs.writeFileSync(p,JSON.stringify(c,null,2),'utf-8');console.log('  Written to: '+p);"
-    ECHO [OK] Server config set
-)
-
-REM ---------- 3. Start tt-help explore ----------
-ECHO.
-ECHO ========================================
-ECHO   Starting tt-help explore
-ECHO ========================================
-tt-help explore
+@ECHO OFF
+SETLOCAL
+
+SET "PACKAGENAME=tt-help-cli-ycl"
+SET "TARGET_SERVER=http://117.71.53.99:17301"
+SET "CONFIG_PATH=%USERPROFILE%\.tt-help.json"
+
+ECHO ========================================
+ECHO   tt-help-cli-ycl one-click launcher (Windows CMD)
+ECHO ========================================
+
+REM ---------- 1. Check/install latest version ----------
+FOR /F "delims=" %%V IN ('npm view %PACKAGENAME% version 2^>nul') DO SET "LATEST_VERSION=%%V"
+
+IF NOT DEFINED LATEST_VERSION (
+    ECHO [ERROR] Cannot get latest version from npm
+    EXIT /B 1
+)
+
+FOR /F "tokens=2 delims=@" %%V IN ('npm list -g %PACKAGENAME% --depth=0 2^>nul ^| findstr /i "%PACKAGENAME%"') DO SET "INSTALLED_VERSION=%%V"
+
+IF NOT DEFINED INSTALLED_VERSION (
+    ECHO [INFO] %PACKAGENAME% not installed, installing latest...
+    CALL npm install -g %PACKAGENAME%
+    IF %ERRORLEVEL% EQU 0 (
+        ECHO [OK] Installed: %LATEST_VERSION%
+    ) ELSE (
+        ECHO [ERROR] Install failed, run manually: npm install -g %PACKAGENAME%
+        EXIT /B 1
+    )
+) ELSE IF "%INSTALLED_VERSION%"=="%LATEST_VERSION%" (
+    ECHO [OK] %PACKAGENAME% is up to date: %LATEST_VERSION%
+) ELSE (
+    ECHO [INFO] Current: %INSTALLED_VERSION%, Latest: %LATEST_VERSION%
+    ECHO [INFO] Upgrading to latest...
+    CALL npm install -g %PACKAGENAME%
+    IF %ERRORLEVEL% EQU 0 (
+        ECHO [OK] Upgraded: %LATEST_VERSION%
+    ) ELSE (
+        ECHO [WARN] Upgrade failed, run manually: npm install -g %PACKAGENAME%
+    )
+)
+
+REM ---------- 2. Check/set server config ----------
+SET "CURRENT_SERVER="
+IF EXIST "%CONFIG_PATH%" (
+    FOR /F "delims=" %%S IN ('node -e "try{const c=JSON.parse(require('fs').readFileSync('%CONFIG_PATH%','utf-8'));console.log(c.server||'')}catch(e){}" 2^>nul') DO SET "CURRENT_SERVER=%%S"
+)
+
+IF "%CURRENT_SERVER%"=="%TARGET_SERVER%" (
+    ECHO [OK] Server config is correct: %TARGET_SERVER%
+) ELSE (
+    IF "%CURRENT_SERVER%"=="" (
+        ECHO [INFO] Current server: not set, target: %TARGET_SERVER%
+    ) ELSE (
+        ECHO [INFO] Current server: %CURRENT_SERVER%, target: %TARGET_SERVER%
+    )
+    ECHO [INFO] Setting server config...
+    node -e "const fs=require('fs'),path=require('path');const p=path.join(require('os').homedir(),'.tt-help.json');let c={};try{c=JSON.parse(fs.readFileSync(p,'utf-8'))}catch(e){}c.server='%TARGET_SERVER%';fs.writeFileSync(p,JSON.stringify(c,null,2),'utf-8');console.log('  Written to: '+p);"
+    ECHO [OK] Server config set
+)
+
+REM ---------- 3. Start tt-help explore ----------
+ECHO.
+ECHO ========================================
+ECHO   Starting tt-help explore
+ECHO ========================================
+tt-help explore

package/{bat → scripts}/run-explore.ps1

@@ -1,81 +1,81 @@
-$packageName = "tt-help-cli-ycl"
-$targetServer = "http://117.71.53.99:17301"
-$configPath = Join-Path $env:USERPROFILE ".tt-help.json"
-
-Write-Host "========================================"
-Write-Host "  tt-help-cli-ycl 一键启动脚本 (Windows)"
-Write-Host "========================================"
-
-# ---------- 1. 检查/安装最新版本 ----------
-$latestVersion = npm view $packageName version 2>$null
-
-if (-not $latestVersion) {
-    Write-Host "[错误] 无法从 npm 获取最新版本信息"
-    exit 1
-}
-
-$installedVersion = ""
-$output = npm list -g $packageName --depth=0 2>$null
-if ($output -match "$packageName@([\d.]+)") {
-    $installedVersion = $matches[1]
-}
-
-if (-not $installedVersion) {
-    Write-Host "[提示] tt-help-cli-ycl 未安装，正在安装最新版本..."
-    npm install -g $packageName 2>$null
-    if ($LASTEXITCODE -eq 0) {
-        Write-Host "[OK] 安装完成: $latestVersion"
-    } else {
-        Write-Host "[错误] 安装失败，请手动执行: npm install -g $packageName"
-        exit 1
-    }
-} elseif ($installedVersion -eq $latestVersion) {
-    Write-Host "[OK] tt-help-cli-ycl 已是最新版本: $latestVersion"
-} else {
-    Write-Host "[提示] 当前版本: $installedVersion, 最新版本: $latestVersion"
-    Write-Host "[执行] 正在升级最新版本..."
-    npm install -g $packageName 2>$null
-    if ($LASTEXITCODE -eq 0) {
-        Write-Host "[OK] 升级完成: $latestVersion"
-    } else {
-        Write-Host "[警告] 升级失败，请手动执行: npm install -g $packageName"
-    }
-}
-
-# ---------- 2. 检查/设置 server 配置 ----------
-$currentServer = ""
-if (Test-Path $configPath) {
-    try {
-        $config = Get-Content $configPath -Raw | ConvertFrom-Json
-        $currentServer = $config.server
-    } catch {
-        $currentServer = ""
-    }
-}
-
-if ($currentServer -eq $targetServer) {
-    Write-Host "[OK] Server 配置正确: $targetServer"
-} else {
-    $currentDisplay = if ($currentServer) { $currentServer } else { "未设置" }
-    Write-Host "[提示] 当前 server: $currentDisplay, 目标: $targetServer"
-    Write-Host "[执行] 正在设置 server 配置..."
-
-    node -e "
-const fs = require('fs');
-const path = require('path');
-const configPath = path.join(require('os').homedir(), '.tt-help.json');
-let cfg = {};
-try { cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch(e) {}
-cfg.server = '$targetServer';
-fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), 'utf-8');
-console.log('  已写入: ' + configPath);
-"
-    Write-Host "[OK] Server 配置已设置"
-}
-
-# ---------- 3. 启动 tt-help explore ----------
-Write-Host ""
-Write-Host "========================================"
-Write-Host "  启动 tt-help explore"
-Write-Host "========================================"
-tt-help explore
+$packageName = "tt-help-cli-ycl"
+$targetServer = "http://117.71.53.99:17301"
+$configPath = Join-Path $env:USERPROFILE ".tt-help.json"
+
+Write-Host "========================================"
+Write-Host "  tt-help-cli-ycl 一键启动脚本 (Windows)"
+Write-Host "========================================"
+
+# ---------- 1. 检查/安装最新版本 ----------
+$latestVersion = npm view $packageName version 2>$null
+
+if (-not $latestVersion) {
+    Write-Host "[错误] 无法从 npm 获取最新版本信息"
+    exit 1
+}
+
+$installedVersion = ""
+$output = npm list -g $packageName --depth=0 2>$null
+if ($output -match "$packageName@([\d.]+)") {
+    $installedVersion = $matches[1]
+}
+
+if (-not $installedVersion) {
+    Write-Host "[提示] tt-help-cli-ycl 未安装，正在安装最新版本..."
+    npm install -g $packageName 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "[OK] 安装完成: $latestVersion"
+    } else {
+        Write-Host "[错误] 安装失败，请手动执行: npm install -g $packageName"
+        exit 1
+    }
+} elseif ($installedVersion -eq $latestVersion) {
+    Write-Host "[OK] tt-help-cli-ycl 已是最新版本: $latestVersion"
+} else {
+    Write-Host "[提示] 当前版本: $installedVersion, 最新版本: $latestVersion"
+    Write-Host "[执行] 正在升级最新版本..."
+    npm install -g $packageName 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "[OK] 升级完成: $latestVersion"
+    } else {
+        Write-Host "[警告] 升级失败，请手动执行: npm install -g $packageName"
+    }
+}
+
+# ---------- 2. 检查/设置 server 配置 ----------
+$currentServer = ""
+if (Test-Path $configPath) {
+    try {
+        $config = Get-Content $configPath -Raw | ConvertFrom-Json
+        $currentServer = $config.server
+    } catch {
+        $currentServer = ""
+    }
+}
+
+if ($currentServer -eq $targetServer) {
+    Write-Host "[OK] Server 配置正确: $targetServer"
+} else {
+    $currentDisplay = if ($currentServer) { $currentServer } else { "未设置" }
+    Write-Host "[提示] 当前 server: $currentDisplay, 目标: $targetServer"
+    Write-Host "[执行] 正在设置 server 配置..."
+
+    node -e "
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(require('os').homedir(), '.tt-help.json');
+let cfg = {};
+try { cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch(e) {}
+cfg.server = '$targetServer';
+fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), 'utf-8');
+console.log('  已写入: ' + configPath);
+"
+    Write-Host "[OK] Server 配置已设置"
+}
+
+# ---------- 3. 启动 tt-help explore ----------
+Write-Host ""
+Write-Host "========================================"
+Write-Host "  启动 tt-help explore"
+Write-Host "========================================"
+tt-help explore

package/{bat → scripts}/run-explore.sh

@@ -1,73 +1,73 @@
-#!/bin/bash
-
-PACKAGENAME="tt-help-cli-ycl"
-TARGET_SERVER="http://117.71.53.99:17301"
-CONFIG_PATH="$HOME/.tt-help.json"
-
-echo "========================================"
-echo "  tt-help-cli-ycl 一键启动脚本 (macOS)"
-echo "========================================"
-
-# ---------- 1. 检查/安装最新版本 ----------
-LATEST_VERSION=$(npm view "$PACKAGENAME" version 2>/dev/null)
-
-if [ -z "$LATEST_VERSION" ]; then
-  echo "[错误] 无法从 npm 获取最新版本信息"
-  exit 1
-fi
-
-INSTALLED_VERSION=$(npm list -g "$PACKAGENAME" --depth=0 2>/dev/null | grep "$PACKAGENAME@" | head -1 | sed 's/.*@//' | sed 's/[) ].*//')
-
-if [ -z "$INSTALLED_VERSION" ]; then
-  echo "[提示] tt-help-cli-ycl 未安装，正在安装最新版本..."
-  npm install -g "$PACKAGENAME"
-  if [ $? -eq 0 ]; then
-    echo "[OK] 安装完成: $LATEST_VERSION"
-  else
-    echo "[错误] 安装失败，请手动执行: npm install -g $PACKAGENAME"
-    exit 1
-  fi
-elif [ "$INSTALLED_VERSION" = "$LATEST_VERSION" ]; then
-  echo "[OK] tt-help-cli-ycl 已是最新版本: $LATEST_VERSION"
-else
-  echo "[提示] 当前版本: $INSTALLED_VERSION, 最新版本: $LATEST_VERSION"
-  echo "[执行] 正在升级最新版本..."
-  npm install -g "$PACKAGENAME" 2>/dev/null
-  if [ $? -eq 0 ]; then
-    echo "[OK] 安装完成: $LATEST_VERSION"
-  else
-    echo "[警告] 自动安装失败，尝试手动更新..."
-    npm update -g "$PACKAGENAME"
-  fi
-fi
-
-# ---------- 2. 检查/设置 server 配置 ----------
-CURRENT_SERVER=""
-if [ -f "$CONFIG_PATH" ]; then
-  CURRENT_SERVER=$(node -e "try{const c=JSON.parse(require('fs').readFileSync('$CONFIG_PATH','utf-8'));console.log(c.server||'')}catch(e){}" 2>/dev/null)
-fi
-
-if [ "$CURRENT_SERVER" = "$TARGET_SERVER" ]; then
-  echo "[OK] Server 配置正确: $TARGET_SERVER"
-else
-  echo "[提示] 当前 server: ${CURRENT_SERVER:-未设置}, 目标: $TARGET_SERVER"
-  echo "[执行] 正在设置 server 配置..."
-  node -e "
-const fs = require('fs');
-const path = require('path');
-const configPath = path.join(require('os').homedir(), '.tt-help.json');
-let cfg = {};
-try { cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch(e) {}
-cfg.server = '$TARGET_SERVER';
-fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), 'utf-8');
-console.log('  已写入: ' + configPath);
-"
-  echo "[OK] Server 配置已设置"
-fi
-
-# ---------- 3. 启动 tt-help explore ----------
-echo ""
-echo "========================================"
-echo "  启动 tt-help explore"
-echo "========================================"
-tt-help explore
+#!/bin/bash
+
+PACKAGENAME="tt-help-cli-ycl"
+TARGET_SERVER="http://117.71.53.99:17301"
+CONFIG_PATH="$HOME/.tt-help.json"
+
+echo "========================================"
+echo "  tt-help-cli-ycl 一键启动脚本 (macOS)"
+echo "========================================"
+
+# ---------- 1. 检查/安装最新版本 ----------
+LATEST_VERSION=$(npm view "$PACKAGENAME" version 2>/dev/null)
+
+if [ -z "$LATEST_VERSION" ]; then
+  echo "[错误] 无法从 npm 获取最新版本信息"
+  exit 1
+fi
+
+INSTALLED_VERSION=$(npm list -g "$PACKAGENAME" --depth=0 2>/dev/null | grep "$PACKAGENAME@" | head -1 | sed 's/.*@//' | sed 's/[) ].*//')
+
+if [ -z "$INSTALLED_VERSION" ]; then
+  echo "[提示] tt-help-cli-ycl 未安装，正在安装最新版本..."
+  npm install -g "$PACKAGENAME"
+  if [ $? -eq 0 ]; then
+    echo "[OK] 安装完成: $LATEST_VERSION"
+  else
+    echo "[错误] 安装失败，请手动执行: npm install -g $PACKAGENAME"
+    exit 1
+  fi
+elif [ "$INSTALLED_VERSION" = "$LATEST_VERSION" ]; then
+  echo "[OK] tt-help-cli-ycl 已是最新版本: $LATEST_VERSION"
+else
+  echo "[提示] 当前版本: $INSTALLED_VERSION, 最新版本: $LATEST_VERSION"
+  echo "[执行] 正在升级最新版本..."
+  npm install -g "$PACKAGENAME" 2>/dev/null
+  if [ $? -eq 0 ]; then
+    echo "[OK] 安装完成: $LATEST_VERSION"
+  else
+    echo "[警告] 自动安装失败，尝试手动更新..."
+    npm update -g "$PACKAGENAME"
+  fi
+fi
+
+# ---------- 2. 检查/设置 server 配置 ----------
+CURRENT_SERVER=""
+if [ -f "$CONFIG_PATH" ]; then
+  CURRENT_SERVER=$(node -e "try{const c=JSON.parse(require('fs').readFileSync('$CONFIG_PATH','utf-8'));console.log(c.server||'')}catch(e){}" 2>/dev/null)
+fi
+
+if [ "$CURRENT_SERVER" = "$TARGET_SERVER" ]; then
+  echo "[OK] Server 配置正确: $TARGET_SERVER"
+else
+  echo "[提示] 当前 server: ${CURRENT_SERVER:-未设置}, 目标: $TARGET_SERVER"
+  echo "[执行] 正在设置 server 配置..."
+  node -e "
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(require('os').homedir(), '.tt-help.json');
+let cfg = {};
+try { cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8')); } catch(e) {}
+cfg.server = '$TARGET_SERVER';
+fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), 'utf-8');
+console.log('  已写入: ' + configPath);
+"
+  echo "[OK] Server 配置已设置"
+fi
+
+# ---------- 3. 启动 tt-help explore ----------
+echo ""
+echo "========================================"
+echo "  启动 tt-help explore"
+echo "========================================"
+tt-help explore

package/scripts/test-captcha-lib.mjs

@@ -0,0 +1,68 @@
+import { chromium } from 'playwright';
+
+const URL = 'https://www.tiktok.com/@mariaelenasanchez607/video/7630110959650000150';
+
+async function main() {
+  const browser = await chromium.connectOverCDP('http://127.0.0.1:9222');
+  const page = browser.contexts()[0].pages()[0];
+
+  // 测试 detectCaptcha
+  console.error('=== 测试 detectCaptcha (无验证码) ===');
+  await page.goto(URL, { waitUntil: 'domcontentloaded', timeout: 30000 });
+  await page.waitForTimeout(3000);
+
+  const { detectCaptcha, closeCaptcha, handleCaptcha } = await import('../src/scraper/modules/captcha-handler.mjs');
+
+  const r1 = await detectCaptcha(page);
+  console.error('未点击评论:', JSON.stringify(r1));
+
+  // 点击评论触发验证码
+  await page.evaluate(() => {
+    const all = document.querySelectorAll('button');
+    for (const el of all) {
+      if (/^评论$/.test(el.textContent?.trim()) && el.offsetParent !== null && el.getBoundingClientRect().width > 0) {
+        el.click();
+        break;
+      }
+    }
+  });
+  await page.waitForTimeout(3000);
+
+  console.error('\n=== 测试 detectCaptcha (有验证码) ===');
+  const r2 = await detectCaptcha(page);
+  console.error('点击评论后:', JSON.stringify(r2));
+
+  console.error('\n=== 测试 closeCaptcha ===');
+  const r3 = await closeCaptcha(page);
+  await page.waitForTimeout(1000);
+  console.error('关闭结果:', JSON.stringify(r3));
+
+  const r4 = await detectCaptcha(page);
+  console.error('关闭后检测:', JSON.stringify(r4));
+
+  console.error('\n=== 测试 handleCaptcha (完整流程) ===');
+  // 重新触发
+  await page.goto(URL, { waitUntil: 'domcontentloaded', timeout: 30000 });
+  await page.waitForTimeout(3000);
+  await page.evaluate(() => {
+    const all = document.querySelectorAll('button');
+    for (const el of all) {
+      if (/^评论$/.test(el.textContent?.trim()) && el.offsetParent !== null && el.getBoundingClientRect().width > 0) {
+        el.click();
+        break;
+      }
+    }
+  });
+  await page.waitForTimeout(3000);
+
+  const r5 = await handleCaptcha(page);
+  console.error('handleCaptcha 结果:', JSON.stringify(r5));
+
+  await page.screenshot({ path: '/tmp/lib-test-final.png' });
+  console.error('\n最终截图: /tmp/lib-test-final.png');
+}
+
+main().catch(err => {
+  console.error('错误:', err);
+  process.exit(1);
+});