tt-help-cli-ycl 1.3.41 → 1.3.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-help-cli-ycl",
-  "version": "1.3.41",
+  "version": "1.3.44",
   "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
   "type": "module",
   "bin": {

package/scripts/run-explore.bat

@@ -127,6 +127,8 @@ CALL ECHO   User ID: %%USER_ID%%
 CALL ECHO   Base port: %%BASE_PORT%%
 CALL ECHO   Port count: %%PORT_COUNT%%
 IF NOT "%JOB_LOCATIONS%"=="" ECHO   Job locations: %JOB_LOCATIONS%
+ECHO   Max following: 5
+ECHO   Max followers: 5
 ECHO   Speed: stealth (slowest)
 ECHO ========================================
-CALL tt-help explore stealth --user-id %%USER_ID%% --base-port %%BASE_PORT%% --port-count %%PORT_COUNT%% %%JOB_LOC_ARGS%%
+CALL tt-help explore stealth --user-id %%USER_ID%% --base-port %%BASE_PORT%% --port-count %%PORT_COUNT%% --max-following 5 --max-followers 5 %%JOB_LOC_ARGS%%

package/scripts/run-explore.ps1

@@ -152,6 +152,8 @@ Write-Host "  用户编号: $userId"
 Write-Host "  起始端口: $basePort"
 Write-Host "  端口数量: $portCount"
 if ($inputJobLocations) { Write-Host "  任务国家: $inputJobLocations" }
+Write-Host "  最大关注: 5"
+Write-Host "  最大粉丝: 5"
 Write-Host "  速度: stealth (最慢)"
 Write-Host "========================================"
-tt-help explore stealth --user-id $userId --base-port $basePort --port-count $portCount $jobLocationsArg
+tt-help explore stealth --user-id $userId --base-port $basePort --port-count $portCount --max-following 5 --max-followers 5 $jobLocationsArg

package/scripts/run-explore.sh

@@ -112,8 +112,10 @@ echo "  用户编号: $USER_ID"
 echo "  起始端口: $BASE_PORT"
 echo "  端口数量: $PORT_COUNT"
 if [ -n "$INPUT_JOB_LOCATIONS" ]; then echo "  任务国家: $INPUT_JOB_LOCATIONS"; fi
+echo "  最大关注: 5"
+echo "  最大粉丝: 5"
 echo "  速度: stealth (最慢)"
 echo "========================================"
 JOB_LOC_ARGS=""
 if [ -n "$INPUT_JOB_LOCATIONS" ]; then JOB_LOC_ARGS="--job-locations $INPUT_JOB_LOCATIONS"; fi
-tt-help explore stealth --user-id "$USER_ID" --base-port "$BASE_PORT" --port-count "$PORT_COUNT" $JOB_LOC_ARGS
+tt-help explore stealth --user-id "$USER_ID" --base-port "$BASE_PORT" --port-count "$PORT_COUNT" --max-following 5 --max-followers 5 $JOB_LOC_ARGS

package/src/cli/comments.js

@@ -2,22 +2,11 @@ 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";
-
-const TARGET_LOCATIONS = [
-  "CZ",
-  "GR",
-  "HU",
-  "PT",
-  "ES",
-  "PL",
-  "NL",
-  "BE",
-  "DE",
-  "FR",
-  "IT",
-  "IE",
-  "AT",
-];
+import {
+  DEFAULT_TARGET_LOCATIONS,
+  isLocationInList,
+  normalizeLocation,
+} from "../lib/target-locations.js";
 
 async function waitForPageReady(page, timeout = 30000) {
   const startTime = Date.now();
@@ -130,7 +119,7 @@ async function runAutoMode(options) {
     `\n[Comments Auto] 并行: ${actualParallel}, 间隔: ${actualInterval}s, 评论数: ${actualMaxComments}`,
   );
   console.error(`服务器: ${serverUrl}`);
-  console.error(`目标国家: ${TARGET_LOCATIONS.join(", ")}`);
+  console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
   console.error(`开始循环接收任务...\n`);
 
   let browser;
@@ -228,10 +217,10 @@ async function runAutoMode(options) {
         for (const task of tasks) {
           try {
             const { id, href, locationCreated, ttSeller } = task;
-            const loc = (locationCreated || "").toUpperCase();
+            const loc = normalizeLocation(locationCreated);
 
             // 检查目标国家
-            if (loc && !TARGET_LOCATIONS.includes(loc)) {
+            if (loc && !isLocationInList(loc, DEFAULT_TARGET_LOCATIONS)) {
               // 非目标国家，直接 commit 跳过
               await apiPut(`${serverUrl}/api/comment-task/${id}`);
               skippedCount++;
@@ -487,12 +476,15 @@ export async function handleComments(options) {
         ),
       ];
 
-      const guessedLocation = (videoInfo?.locationCreated || "").toUpperCase();
+      const guessedLocation = normalizeLocation(videoInfo?.locationCreated);
       const serverUrl = commentsServer || defaultServer;
 
-      if (guessedLocation && !TARGET_LOCATIONS.includes(guessedLocation)) {
+      if (
+        guessedLocation &&
+        !isLocationInList(guessedLocation, DEFAULT_TARGET_LOCATIONS)
+      ) {
         console.error(`\n猜测国家: ${guessedLocation}，非目标国家，跳过保存`);
-        console.error(`目标国家: ${TARGET_LOCATIONS.join(", ")}`);
+        console.error(`目标国家: ${DEFAULT_TARGET_LOCATIONS.join(", ")}`);
       } else {
         console.error(`\n正在提交 ${authors.length} 个评论作者到服务端...`);
         console.error(`服务端: ${serverUrl}`);

package/src/cli/explore.js

@@ -24,6 +24,7 @@ import path from "path";
 import os from "os";
 
 const MAX_RETRY_WAIT = 5 * 60 * 1000;
+const STARTUP_TIKTOK_URL = "https://www.tiktok.com/@ycl5007";
 
 async function withRetry(label, fn) {
   let backoff = 1000;
@@ -164,8 +165,8 @@ export async function handleExplore(options) {
 
     const page = await getOrCreatePage(browser);
 
-    // 先导航到 TikTok 首页，再检测登录状态
-    await page.goto("https://www.tiktok.com", {
+    // 先导航到 TikTok 页面，再检测登录状态
+    await page.goto(STARTUP_TIKTOK_URL, {
       waitUntil: "domcontentloaded",
     });
 
@@ -214,8 +215,8 @@ export async function handleExplore(options) {
         userDataDir: nextAccount.userDataDir,
       });
       console.error(`[健康检查] 已切换到端口 ${nextAccount.port}`);
-      // 切换账户后先导航到 TikTok，再重新检测登录状态
-      await page.goto("https://www.tiktok.com", {
+      // 切换账户后先导航到 TikTok 页面，再重新检测登录状态
+      await page.goto(STARTUP_TIKTOK_URL, {
         waitUntil: "domcontentloaded",
       });
       loggedIn = await isLoggedIn(page);

package/src/lib/args.js

@@ -1,5 +1,6 @@
 import { readFileSync } from "fs";
 import { server as defaultServer } from "./constants.js";
+import { DEFAULT_TARGET_LOCATIONS_CSV } from "./target-locations.js";
 
 const PRESETS = ["fast", "normal", "slow", "stealth"];
 
@@ -171,7 +172,7 @@ function parseExploreArgs(args) {
   let exploreEnableFollow = true;
   let exploreMaxFollowing = 50;
   let exploreMaxFollowers = 50;
-  let exploreLocation = "CZ,GR,HU,PT,PL,NL,BE,DE,FR,IT,ES,IE,AT";
+  let exploreLocation = DEFAULT_TARGET_LOCATIONS_CSV;
   let exploreJobLocations = null;
   let exploreMaxUsers = 0;
   let explorePort = null;
@@ -203,7 +204,7 @@ function parseExploreArgs(args) {
       exploreEnableFollow = false;
     } else if (arg === "--max-following") {
       exploreMaxFollowing = parseInt(args[++i]) || 50;
-
+    } else if (arg === "--max-followers") {
       exploreMaxFollowers = parseInt(args[++i]) || 50;
     } else if (arg === "--max-users") {
       exploreMaxUsers = parseInt(args[++i]) || 0;

package/src/lib/browser/page.js

@@ -67,19 +67,20 @@ export async function withBrowserRecovery(fn, browser, page, cdpOptions, port) {
 }
 
 /**
- * 通过 Cookie 判断登录状态（推荐，最可靠）
- * 已登录：存在 sessionid Cookie
- * 未登录：不存在 sessionid Cookie
+ * 稳定判断登录状态：先检查 sessionid Cookie，再用页面 DOM 做验真。
+ * 仅有 sessionid 不足以说明会话仍然有效，因此需要二次确认。
  */
 export async function isLoggedIn(page) {
   const cookies = await page.context().cookies("https://www.tiktok.com");
-  return cookies.some((c) => c.name === "sessionid");
+  const hasSessionId = cookies.some((c) => c.name === "sessionid");
+  if (!hasSessionId) return false;
+
+  return await isLoggedInByDom(page);
 }
 
 /**
- * 通过 DOM 元素判断登录状态（备用方案）
- * 依赖页面渲染完成，可能存在误判
- * @deprecated 推荐使用 isLoggedIn（基于 Cookie）
+ * 通过 DOM 元素判断登录状态（验真方案）
+ * 依赖页面渲染完成，因此不单独作为主判断，而是和 Cookie 组合使用。
  */
 export async function isLoggedInByDom(page) {
   // 先等客户端渲染完成：登录态元素或登录按钮，哪个先出现就停止等待

package/src/lib/constants.js

@@ -1,6 +1,7 @@
 import { join, dirname } from "path";
 import { readFileSync, writeFileSync, existsSync } from "fs";
 import { fileURLToPath } from "url";
+import { DEFAULT_TARGET_LOCATIONS_CSV } from "./target-locations.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -121,14 +122,14 @@ const HELP_TEXT = [
   "    预设: fast, normal（默认）, slow, stealth",
   "    选项:",
   "      --server <URL>            服务端地址，默认 http://127.0.0.1:3001",
-  "      --location <国家代码>     国家筛选，逗号分隔，默认 CZ,GR,HU,PT,PL,NL,BE,DE,FR,IT,ES,IE,AT",
+  `      --location <国家代码>     国家筛选，逗号分隔，默认 ${DEFAULT_TARGET_LOCATIONS_CSV}`,
   "      --job-locations <国家>    任务国家筛选，逗号分隔（仅筛选服务端任务）",
   "      --max-comments <数量>     每视频最大评论数，默认 10",
   "      --max-guess <数量>        每视频最大猜你喜欢数，默认 0",
   "      --max-videos <数量>       每用户最大视频数，默认 16",
   "      --enable-follow           启用关注/粉丝提取（默认启用）",
   "      --disable-follow          禁用关注/粉丝提取",
-  "      --max-following <数量>    最大获取关注数，默认 50（同时设置粉丝数）",
+  "      --max-following <数量>    最大获取关注数，默认 50",
   "      --max-followers <数量>    最大获取粉丝数，默认 50",
   "      --max-users <数量>        最大处理用户数，默认无限制",
   "      -i, --interval <秒数>     无任务时轮询间隔，默认 10 秒",

package/src/lib/target-locations.js

@@ -0,0 +1,61 @@
+const DEFAULT_TARGET_LOCATIONS = [
+  "CZ",
+  "GR",
+  "HU",
+  "PT",
+  "ES",
+  "PL",
+  "NL",
+  "BE",
+  "DE",
+  "FR",
+  "IT",
+  "IE",
+  "AT",
+];
+
+const DEFAULT_TARGET_LOCATIONS_CSV = DEFAULT_TARGET_LOCATIONS.join(",");
+
+function normalizeLocation(location) {
+  if (location == null) return null;
+  const normalized = String(location).trim().toUpperCase();
+  return normalized || null;
+}
+
+function normalizeLocationList(locations, fallback = DEFAULT_TARGET_LOCATIONS) {
+  const source = Array.isArray(locations)
+    ? locations
+    : String(locations == null ? "" : locations).split(",");
+  const normalized = source
+    .map((location) => normalizeLocation(location))
+    .filter(Boolean);
+  return normalized.length > 0 ? [...new Set(normalized)] : [...fallback];
+}
+
+function isLocationInList(location, locations) {
+  const normalizedLocation = normalizeLocation(location);
+  if (!normalizedLocation) return false;
+  return normalizeLocationList(locations).includes(normalizedLocation);
+}
+
+function findFirstMatchingLocation(
+  locations,
+  targetLocations = DEFAULT_TARGET_LOCATIONS,
+) {
+  const normalizedTargetLocations = normalizeLocationList(targetLocations);
+  const normalizedLocations = normalizeLocationList(locations, []);
+  return (
+    normalizedLocations.find((location) =>
+      normalizedTargetLocations.includes(location),
+    ) || null
+  );
+}
+
+export {
+  DEFAULT_TARGET_LOCATIONS,
+  DEFAULT_TARGET_LOCATIONS_CSV,
+  findFirstMatchingLocation,
+  isLocationInList,
+  normalizeLocation,
+  normalizeLocationList,
+};

package/src/scraper/core.js

@@ -10,13 +10,18 @@ import {
 } from "./modules/page-helpers.js";
 import { extractCommentAuthors } from "./modules/comment-extractor.js";
 import { extractGuessVideos } from "./modules/guess-extractor.js";
+import {
+  DEFAULT_TARGET_LOCATIONS_CSV,
+  isLocationInList,
+  normalizeLocationList,
+} from "../lib/target-locations.js";
 
 async function scrapeSingleVideo(
   page,
   maxComments,
   maxGuess,
   log,
-  location = "CZ,GR,HU,PT,PL,NL,BE,DE,FR,IT,ES,IE",
+  location = DEFAULT_TARGET_LOCATIONS_CSV,
 ) {
   const config = getDelayConfig();
 
@@ -52,14 +57,8 @@ async function scrapeSingleVideo(
   let captchaStage = "";
   let captchaMessage = "";
 
-  const locationList = (location || "ES")
-    .split(",")
-    .map((s) => s.trim().toUpperCase());
-  if (
-    locationList.includes(
-      userData.locationCreated?.toUpperCase?.() || userData.locationCreated,
-    )
-  ) {
+  const locationList = normalizeLocationList(location);
+  if (isLocationInList(userData.locationCreated, locationList)) {
     if (maxGuess > 0) {
       guessVideos = await extractGuessVideos(page, maxGuess);
     }

package/src/scraper/explore-core.js

@@ -4,6 +4,12 @@ export { ensureBrowserReady };
 import { getUserInfo, collectVideos } from "../videos/core.js";
 import { extractFollowAndFollowers } from "./modules/follow-extractor.js";
 import { extractVideoLocation } from "../lib/scrape.js";
+import {
+  DEFAULT_TARGET_LOCATIONS_CSV,
+  findFirstMatchingLocation,
+  isLocationInList,
+  normalizeLocationList,
+} from "../lib/target-locations.js";
 import {
   maxFollowing as globalMaxFollowing,
   maxFollowers as globalMaxFollowers,
@@ -16,7 +22,7 @@ async function processExplore(page, username, options, log) {
     loggedIn = false, // 由外部传入登录状态，避免每次调用 isLoggedIn(page)
     maxFollowing = 50,
     maxFollowers = 50,
-    location = "CZ,GR,HU,PT,PL,NL,BE,DE,FR,IT,ES,IE",
+    location = DEFAULT_TARGET_LOCATIONS_CSV,
   } = options;
 
   const result = {
@@ -35,6 +41,8 @@ async function processExplore(page, username, options, log) {
     error: null,
   };
 
+  const locationList = normalizeLocationList(location);
+
   try {
     log(`  访问 @${username} 主页...`);
     const videoList = await collectVideos(page, username, maxVideos, log);
@@ -66,9 +74,11 @@ async function processExplore(page, username, options, log) {
       return result;
     }
 
-    // 从最多 5 个视频并发获取 locationCreated，取众数
+    // 从最多 5 个视频并发获取 locationCreated。
+    // 新规则：采样列表里只要有任一国家命中目标列表，就直接采用该国家；否则回退到众数。
     const SAMPLE_SIZE = 5;
     let locationCreated = null;
+    let locationDecision = null;
     const sampleVideos = videoArray.slice(0, SAMPLE_SIZE);
     if (sampleVideos.length > 0) {
       const sampleUrls = sampleVideos.map((v) =>
@@ -80,26 +90,34 @@ async function processExplore(page, username, options, log) {
       log(
         `  国家采样(${locations.length}个): [${locations.filter(Boolean).join(", ") || "无数据"}]`,
       );
+      const normalizedLocations = normalizeLocationList(locations, []);
+      const matchedTargetLocation = findFirstMatchingLocation(
+        normalizedLocations,
+        locationList,
+      );
       const freq = {};
-      for (const loc of locations) {
-        if (loc) {
-          const key = loc.toUpperCase();
-          freq[key] = (freq[key] || 0) + 1;
-        }
+      for (const key of normalizedLocations) {
+        freq[key] = (freq[key] || 0) + 1;
       }
       const entries = Object.entries(freq).sort((a, b) => b[1] - a[1]);
-      locationCreated = entries.length > 0 ? entries[0][0] : null;
+      if (matchedTargetLocation) {
+        locationCreated = matchedTargetLocation;
+        locationDecision = "命中目标国家";
+      } else if (entries.length > 0) {
+        locationCreated = entries[0][0];
+        locationDecision = "回退众数";
+      }
     }
 
     result.locationCreated = locationCreated || null;
-    log(`  国家: ${result.locationCreated || "未知"} (众数)`);
+    log(
+      `  国家: ${result.locationCreated || "未知"}${locationDecision ? ` (${locationDecision})` : ""}`,
+    );
 
     // 国家筛选
-    const locationList = (location || "ES")
-      .split(",")
-      .map((s) => s.trim().toUpperCase());
-    const isTargetLocation = locationList.includes(
-      result.locationCreated?.toUpperCase?.() || result.locationCreated,
+    const isTargetLocation = isLocationInList(
+      result.locationCreated,
+      locationList,
     );
 
     if (isTargetLocation) {

package/src/scraper/modules/follow-extractor.js

@@ -1,5 +1,6 @@
 import { delay, getDelayConfig } from "./page-helpers.js";
 import { scrollAndCollect } from "./scroll-collector.js";
+import { extractUniqueId, toProfileUrl } from "../../lib/url.js";
 
 const FILTER_WORDS = ["主页", "已关注", "粉丝", "推荐"];
 
@@ -48,7 +49,14 @@ async function waitForListContent(page, minChildren = 1, timeout = 15000) {
     .catch(() => {});
 }
 
-async function openFollowModal(page) {
+function getProfileUrlForRetry(page) {
+  const currentUrl = page.url();
+  const uniqueId = extractUniqueId(currentUrl);
+  if (uniqueId) return toProfileUrl(uniqueId);
+  return currentUrl;
+}
+
+async function openFollowModal(page, log = () => {}) {
   const tryOpen = async () =>
     page.evaluate((selectors) => {
       const clickTarget = (node) => {
@@ -83,7 +91,16 @@ async function openFollowModal(page) {
   for (let attempt = 1; attempt <= 3; attempt++) {
     await waitForFollowTrigger(page, attempt === 1 ? 15000 : 8000);
     opened = await tryOpen();
-    if (opened) break;
+    if (opened) {
+      if (attempt >= 2) {
+        log(`  [关注弹窗] 第 ${attempt} 次已点击关注入口: ${opened}`);
+      }
+      break;
+    }
+
+    if (attempt >= 2) {
+      log(`  [关注弹窗] 第 ${attempt} 次仍未找到可点击的关注入口`);
+    }
 
     await page
       .evaluate(() => {
@@ -94,6 +111,7 @@ async function openFollowModal(page) {
   }
 
   if (!opened) {
+    log("  [关注弹窗] 重试后仍未找到关注入口");
     throw new Error(
       "未找到关注入口元素，请确认当前页面为用户主页或页面结构已变化",
     );
@@ -107,20 +125,31 @@ async function openFollowModal(page) {
         timeout: 30000,
       });
       containerReady = true;
+      if (attempt >= 2) {
+        log(`  [关注弹窗] 第 ${attempt} 次等待后，关注列表容器已出现`);
+      }
       break;
     } catch (e) {
       if (attempt === 1) {
-        // 第一次超时，刷新页面重试
-        await page.reload({ waitUntil: "domcontentloaded" });
+        // 第一次超时，重新 goto 用户主页后重试
+        const retryUrl = getProfileUrlForRetry(page);
+        log(
+          `  [关注弹窗] 第 1 次等待列表超时，准备 goto 主页重试: ${retryUrl} | ${e.message}`,
+        );
+        await page.goto(retryUrl, { waitUntil: "domcontentloaded" });
         await delay(2000, 3000);
+        log("  [关注弹窗] 主页跳转完成，重新点击关注入口");
         // 重新点击 follow 入口
         opened = await tryOpen();
         if (!opened) {
+          log("  [关注弹窗] goto 主页后仍未找到关注入口");
           throw new Error(
-            "刷新后仍未找到关注入口元素，请确认当前页面为用户主页",
+            "goto 主页后仍未找到关注入口元素，请确认当前页面为用户主页",
           );
         }
+        log(`  [关注弹窗] goto 主页后已重新点击关注入口: ${opened}`);
       } else {
+        log(`  [关注弹窗] 第 2 次等待列表仍超时，结束本次提取: ${e.message}`);
         throw e;
       }
     }
@@ -200,7 +229,7 @@ async function extractUsersFromModal(page, maxUsers) {
 async function extractFollowAndFollowers(page, options = {}) {
   const { maxFollowing = 999, maxFollowers = 999, log = () => {} } = options;
 
-  await openFollowModal(page);
+  await openFollowModal(page, log);
 
   const following = await extractUsersFromModal(page, maxFollowing);
   log(`  已关注: ${following.length}`);

package/src/scraper/refresh-core.js

@@ -8,6 +8,7 @@ import { detectCaptcha } from "./modules/captcha-handler.js";
 import { getUserInfo, collectVideos } from "../videos/core.js";
 import { extractFollowAndFollowers } from "./modules/follow-extractor.js";
 import { processExplore } from "./explore-core.js";
+import { DEFAULT_TARGET_LOCATIONS_CSV } from "../lib/target-locations.js";
 
 export async function processRefresh(page, username, serverUrl, options, log) {
   const { maxFollowing = 100, maxFollowers = 100, maxVideos = 100 } = options;
@@ -131,7 +132,7 @@ export async function processRefresh(page, username, serverUrl, options, log) {
           enableFollow: true,
           maxFollowing: 5,
           maxFollowers: 5,
-          location: "CZ,GR,HU,PT,PL,NL,BE,DE,FR,IT,ES,IE",
+          location: DEFAULT_TARGET_LOCATIONS_CSV,
         },
         log,
       );