tt-help-cli-ycl 1.3.61 → 1.3.63

package/src/lib/args.js

@@ -180,6 +180,7 @@ function parseExploreArgs(args) {
   let explorePortCount = null;
   let exploreUserId = null;
   let exploreMaxVideos = 16;
+  let exploreProxy = null;
 
   const positional = [];
   const PRESETS = ["fast", "normal", "slow", "stealth"];
@@ -218,6 +219,8 @@ function parseExploreArgs(args) {
       exploreUserId = args[++i];
     } else if (arg === "--max-videos") {
       exploreMaxVideos = parseInt(args[++i]) || 16;
+    } else if (arg === "--proxy") {
+      exploreProxy = args[++i];
     } else {
       positional.push(arg);
     }
@@ -258,6 +261,7 @@ function parseExploreArgs(args) {
     explorePortCount,
     exploreUserId,
     exploreMaxVideos,
+    exploreProxy,
     urls: [],
     outputFormat: "json",
     exploreCount: 0,
@@ -439,39 +443,77 @@ function parseDbImportArgs(args) {
 function parseRefreshArgs(args) {
   let serverUrl = defaultServer;
   let explorePreset = "normal";
-  let exploreMaxComments = 10;
-  let exploreMaxGuess = 0;
+  let exploreInterval = 30;
+  let exploreEnableFollow = true;
+  let exploreMaxFollowing = 100;
+  let exploreMaxFollowers = 100;
+  let exploreLocation = DEFAULT_TARGET_LOCATIONS_CSV;
+  let exploreMaxUsers = 0;
   let explorePort = null;
+  let exploreBasePort = null;
+  let explorePortCount = null;
   let exploreProfile = null;
   let exploreUserId = null;
+  let exploreMaxVideos = 16;
+  let exploreRedoMaxAge = 0;
+  let exploreProxy = null;
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--server") {
       serverUrl = args[++i];
-    } else if (arg === "--comments") {
-      exploreMaxComments = parseInt(args[++i]) || 10;
-    } else if (arg === "--guess") {
-      exploreMaxGuess = parseInt(args[++i]) || 0;
     } else if (arg === "--preset") {
       explorePreset = args[++i];
+    } else if (arg === "-i" || arg === "--interval") {
+      exploreInterval = parseInt(args[++i], 10) || 30;
     } else if (arg === "--port") {
       explorePort = parseInt(args[++i]) || 9222;
+    } else if (arg === "--base-port") {
+      exploreBasePort = parseInt(args[++i]) || 9222;
+    } else if (arg === "--port-count") {
+      explorePortCount = parseInt(args[++i]) || 10;
     } else if (arg === "--profile") {
       exploreProfile = args[++i];
     } else if (arg === "--user-id") {
       exploreUserId = args[++i];
+    } else if (arg === "--max-videos") {
+      exploreMaxVideos = parseInt(args[++i]) || 16;
+    } else if (arg === "--max-following") {
+      exploreMaxFollowing = parseInt(args[++i]) || 100;
+    } else if (arg === "--max-followers") {
+      exploreMaxFollowers = parseInt(args[++i]) || 100;
+    } else if (arg === "--max-age") {
+      exploreRedoMaxAge = parseInt(args[++i]) || 43200;
+    } else if (arg === "--proxy") {
+      exploreProxy = args[++i];
+    } else if (arg === "--location") {
+      exploreLocation = args[++i];
+    } else if (arg === "--enable-follow") {
+      exploreEnableFollow = true;
+    } else if (arg === "--disable-follow") {
+      exploreEnableFollow = false;
+    } else if (arg === "--max-users") {
+      exploreMaxUsers = parseInt(args[++i]) || 0;
     }
   }
 
   return {
     subcommand: "refresh",
     explorePreset,
-    exploreMaxComments,
-    exploreMaxGuess,
+    exploreInterval,
+    exploreEnableFollow,
+    exploreMaxFollowing,
+    exploreMaxFollowers,
+    exploreLocation,
+    exploreMaxUsers,
     explorePort,
+    exploreBasePort,
+    explorePortCount,
     exploreProfile,
     exploreUserId,
+    exploreMaxVideos,
+    exploreRedoMaxAge,
+    exploreProxy,
     serverUrl,
     urls: [],
     outputFormat: "json",
@@ -721,6 +763,10 @@ export function parseArgs() {
     return parseDbImportArgs(args.slice(1));
   }
 
+  if (args.length > 0 && args[0] === "refresh") {
+    return parseRefreshArgs(args.slice(1));
+  }
+
   const urls = [];
   let inputFile = null;
   let outputFile = null;

package/src/lib/browser/cdp.js

@@ -143,7 +143,7 @@ function killEdgeProcesses(targetDir) {
   });
 }
 
-function launchEdgeWithCDP(port, userDataDir) {
+function launchEdgeWithCDP(port, userDataDir, proxyServer) {
   return new Promise((resolve, reject) => {
     const platform = os.platform();
     const edgePath = getEdgePath();
@@ -162,14 +162,19 @@ function launchEdgeWithCDP(port, userDataDir) {
       "--disable-breakpad",
       "--disable-background-networking",
       "--disable-sync",
-    ].join(" ");
+    ];
+    if (proxyServer) {
+      extraArgs.push(`--proxy-server="${proxyServer}"`);
+    }
+
+    const argsStr = extraArgs.join(" ");
 
     if (platform === "darwin") {
-      command = `open -a ${edgePath} --new --args ${extraArgs}`;
+      command = `open -a ${edgePath} --new --args ${argsStr}`;
     } else if (platform === "win32") {
-      command = `start msedge ${extraArgs}`;
+      command = `start msedge ${argsStr}`;
     } else {
-      command = `msedge ${extraArgs} &`;
+      command = `msedge ${argsStr} &`;
     }
 
     exec(command, (err) => {
@@ -194,6 +199,7 @@ export { killEdgeProcesses };
 export async function ensureBrowserReady(options = {}) {
   const port = options.port || DEFAULT_CDP_PORT;
   const userDataDir = options.userDataDir || DEFAULT_USER_DATA_DIR;
+  const proxyServer = options.proxyServer || null;
   const isCustom = port !== DEFAULT_CDP_PORT || !!options.userDataDir;
 
   const isReady = await checkCDPPort(port);

package/src/lib/browser/page.js

@@ -104,30 +104,54 @@ export async function isLoggedIn(page) {
 
 /**
  * 通过 DOM 元素判断登录状态（验真方案）
+ * 使用 locator API + state: 'attached' 来避免 CDP 连接下 waitForSelector 的可见性问题
  * @returns {boolean|null} true=已登录, false=明确未登录, null=无法判断
  */
 export async function isLoggedInByDom(page) {
-  // 先等客户端渲染完成：登录态元素或登录按钮，哪个先出现就停止等待
-  const loginOrLoggedInSelector = [
-    '[class*="DivProfileContainer"]',
-    '[class*="DivUserContainer"]',
-    '[class*="UserMenu"]',
-    '[class*="CurrentUserInfo"]',
-    'button:has-text("登录")',
-    'button:has-text("Log in")',
-    'button:has-text("Sign in")',
-  ].join(", ");
-
-  const selectorFound = await page
-    .waitForSelector(loginOrLoggedInSelector, { timeout: DOM_CHECK_TIMEOUT })
-    .then(() => true)
-    .catch(() => false);
-
-  if (!selectorFound) {
-    // 等待超时，DOM 无法判断
-    return null;
+  // 使用 Promise.race 等待：已登录元素 或 登录按钮，哪个先出现就停止
+  const loggedInLocators = [
+    page.locator('[class*="DivProfileContainer"]'),
+    page.locator('[class*="DivUserContainer"]'),
+    page.locator('[class*="UserMenu"]'),
+    page.locator('[class*="CurrentUserInfo"]'),
+  ];
+
+  const loginButtonLocators = [
+    page.getByText("登录", { exact: true }),
+    page.getByText("Log in", { exact: true }),
+    page.getByText("Sign in", { exact: true }),
+  ];
+
+  // 并发等待：已登录元素 vs 登录按钮
+  const waitForLoggedIn = Promise.any(
+    loggedInLocators.map((loc) =>
+      loc.first().waitFor({ state: "attached", timeout: DOM_CHECK_TIMEOUT }),
+    ),
+  )
+    .then(() => "loggedIn")
+    .catch(() => null);
+
+  const waitForLoginButton = Promise.any(
+    loginButtonLocators.map((loc) =>
+      loc.first().waitFor({ state: "attached", timeout: DOM_CHECK_TIMEOUT }),
+    ),
+  )
+    .then(() => "loginButton")
+    .catch(() => null);
+
+  // 哪个先完成就返回哪个结果
+  const result = await Promise.race([waitForLoggedIn, waitForLoginButton]);
+
+  if (result === "loginButton") {
+    // 明确看到登录按钮 → 未登录
+    return false;
+  }
+  if (result === "loggedIn") {
+    // 看到已登录元素 → 已登录
+    return true;
   }
 
+  // 都超时了，回退到 evaluate 做最终判断
   return page.evaluate(() => {
     const hasProfileContainer = !!document.querySelector(
       '[class*="DivProfileContainer"], [class*="DivUserContainer"]',
@@ -143,7 +167,7 @@ export async function isLoggedInByDom(page) {
     if (hasLoginButton) return false;
     // 看到已登录元素 → 已登录
     if (hasProfileContainer || hasUserMenu) return true;
-    // 元素已出现但都不是登录/未登录标志 → 无法判断
+    // 都无法判断
     return null;
   });
 }

package/src/lib/constants.js

@@ -131,12 +131,33 @@ const HELP_TEXT = [
   "      --disable-follow          禁用关注/粉丝提取",
   "      --max-following <数量>    最大获取关注数，默认 50",
   "      --max-followers <数量>    最大获取粉丝数，默认 50",
-  "      --max-users <数量>        最大处理用户数，默认无限制",
-  "      -i, --interval <秒数>     无任务时轮询间隔，默认 10 秒",
-  "      --port <端口号>           固定 CDP 端口（调试用，关闭自动轮换）",
-  "      --base-port <端口号>      起始端口，默认 9222",
-  "      --port-count <数量>       端口数量（账户数），默认 10",
-  "      --user-id <编号>          客户端编号（设备ID），默认自动生成",
+      "      --max-users <数量>        最大处理用户数，默认无限制",
+      "      -i, --interval <秒数>     无任务时轮询间隔，默认 10 秒",
+      "      --port <端口号>           固定 CDP 端口（调试用，关闭自动轮换）",
+      "      --base-port <端口号>      起始端口，默认 9222",
+      "      --port-count <数量>       端口数量（账户数），默认 10",
+      "      --user-id <编号>          客户端编号（设备ID），默认自动生成",
+      "      --proxy <地址>            浏览器代理（如 socks5://127.0.0.1:1080）",
+      "",
+      "  tt-help refresh [选项]",
+      "    对目标商家用户进行轮回刷新，重新采集视频 + 关注 + 粉丝",
+      "    筛选条件: tt_seller=1, verified=0, 目标国家",
+      "    选项:",
+      "      --server <URL>            服务端地址，默认 http://127.0.0.1:3001",
+      `      --location <国家代码>     国家筛选，逗号分隔，默认 ${DEFAULT_TARGET_LOCATIONS_CSV}`,
+      "      --max-videos <数量>       每用户最大视频数，默认 16",
+      "      --enable-follow           启用关注/粉丝提取（默认启用）",
+      "      --disable-follow          禁用关注/粉丝提取",
+      "      --max-following <数量>    最大获取关注数，默认 100",
+      "      --max-followers <数量>    最大获取粉丝数，默认 100",
+      "      --max-users <数量>        最大处理用户数，默认无限制",
+      "      -i, --interval <秒数>     无任务时轮询间隔，默认 30 秒",
+      "      --max-age <秒数>          最小刷新间隔，默认 43200（12小时）",
+      "      --port <端口号>           固定 CDP 端口（调试用，关闭自动轮换）",
+      "      --base-port <端口号>      起始端口，默认 9222",
+      "      --port-count <数量>       端口数量（账户数），默认 10",
+      "      --user-id <编号>          客户端编号（设备ID），默认自动生成",
+      "      --proxy <地址>            浏览器代理（如 socks5://127.0.0.1:1080）",
   "",
   "  tt-help info <URL> [URL2 ...] [--onlyvideo]",
   "    获取用户/视频信息，支持多个 URL",
@@ -196,9 +217,10 @@ const HELP_TEXT = [
   "    -h, --help                显示帮助",
   "    --version                 显示版本号",
   "",
-  "  示例: tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@adidas",
-  "        tt-help explore qiqi23280 fast --location ES --max-comments 50",
-  "        tt-help config set server http://127.0.0.1:3001",
+      "  示例: tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@adidas",
+      "        tt-help explore qiqi23280 fast --location ES --max-comments 50",
+      "        tt-help refresh --server http://127.0.0.1:3001 --port 9222",
+      "        tt-help config set server http://127.0.0.1:3001",
   "        tt-help attach -p 5 -i 10",
   "        tt-help watch -o data/result.db",
   "        tt-help videostats data/result.db -p 3",

package/src/main.js

@@ -10,6 +10,7 @@ import { handleComments } from "./cli/comments.js";
 import { handleVideoStats } from "./cli/videostats.js";
 import { handleDbImport } from "./cli/db-import.js";
 import { handleWebserver } from "./cli/webserver.js";
+import { handleRefresh } from "./cli/refresh.js";
 
 async function main() {
   const parsed = parseArgs();
@@ -33,6 +34,8 @@ async function main() {
       return handleVideoStats(parsed);
     case "db-import":
       return handleDbImport(parsed);
+    case "refresh":
+      return handleRefresh(parsed);
   }
 
   const {

package/src/npm-main.js

@@ -6,6 +6,7 @@ import { handleAttach } from "./cli/attach.js";
 import { handleConfig, showConfig, showUsage, version } from "./cli/config.js";
 import { handleOpen } from "./cli/open.js";
 import { handleComments } from "./cli/comments.js";
+import { handleRefresh } from "./cli/refresh.js";
 
 function exitUnsupportedCommand(command) {
   console.error(
@@ -33,6 +34,8 @@ async function main() {
       return handleOpen(parsed);
     case "comments":
       return handleComments(parsed);
+    case "refresh":
+      return handleRefresh(parsed);
   }
 
   const {

package/src/watch/data-store.js

@@ -2786,9 +2786,10 @@ export function createStore(filePath) {
     return { saved: true, pinned: user.pinned };
   }
 
-  function getNextRedoJob(userId) {
+  function getNextRedoJob(userId, maxAgeSeconds = 43200) {
     if (db) {
       const now = Date.now();
+      const threshold = now - maxAgeSeconds * 1000;
       const defaultTime = new Date("2016-01-01T00:00:00Z").getTime();
       const targetLocations = [
         "CZ",
@@ -2813,11 +2814,12 @@ export function createStore(filePath) {
           WHERE tt_seller = 1
             AND verified = 0
             AND location_created IN (${placeholders})
+            AND COALESCE(refresh_time, ?) < ?
           ORDER BY COALESCE(refresh_time, ?) ASC
           LIMIT 1
         `,
         )
-        .get(...targetLocations, defaultTime);
+        .get(...targetLocations, defaultTime, threshold, defaultTime);
       if (!row) return null;
       db.prepare(
         "UPDATE jobs SET refresh_time = ?, updated_at = ? WHERE unique_id = ?",
@@ -2830,6 +2832,7 @@ export function createStore(filePath) {
     }
 
     const now = Date.now();
+    const threshold = now - maxAgeSeconds * 1000;
     const defaultTime = new Date("2016-01-01T00:00:00Z").getTime();
 
     // 筛选目标国家用户，按 refreshTime 升序取最远的（没有则默认 2016-01-01）
@@ -2855,13 +2858,19 @@ export function createStore(filePath) {
     );
     if (targetUsers.length === 0) return null;
 
-    targetUsers.sort((a, b) => {
+    const recentEnough = targetUsers.filter((u) => {
+      const rt = u.refreshTime || defaultTime;
+      return rt < threshold;
+    });
+    if (recentEnough.length === 0) return null;
+
+    recentEnough.sort((a, b) => {
       const ta = a.refreshTime || defaultTime;
       const tb = b.refreshTime || defaultTime;
       return ta - tb;
     });
 
-    const next = targetUsers[0];
+    const next = recentEnough[0];
     next.refreshTime = now;
     save();
     return {
@@ -2889,9 +2898,10 @@ export function createStore(filePath) {
           }
         }
       }
+      const newUsers = processDiscoveredUsers(result);
       const ret = updateJobInfo(uniqueId, user, false);
       if (ret.error) return { saved: false, error: ret.error };
-      return { saved: true };
+      return { saved: true, newUsers };
     }
 
     const user = getUser(uniqueId);
@@ -2908,8 +2918,8 @@ export function createStore(filePath) {
         }
       }
     }
-
-    return { saved: true };
+    const newUsers = processDiscoveredUsers(result);
+    return { saved: true, newUsers };
   }
 
   function reportClientError(

package/src/watch/public/app.js

@@ -368,6 +368,10 @@ function renderTable(users) {
       }
       const claimTime = u.claimedAt ? formatTime(u.claimedAt) : "-";
       const procTime = u.processedAt ? formatTime(u.processedAt) : "-";
+      const refreshTime =
+        u.ttSeller && !u.verified && u.refreshTime
+          ? formatTime(u.refreshTime)
+          : "-";
       const statusCodeDisplay =
         u.statusCode != null && u.statusCode !== 0
           ? `<span class="tag error" style="font-size:10px">${u.statusCode}</span>`
@@ -378,6 +382,7 @@ function renderTable(users) {
       <td data-label="粉丝">${fans}</td>
       <td data-label="视频">${videos}</td>
       <td data-label="国家">${loc}</td>
+      <td data-label="最近刷新" style="font-size:11px;color:#888">${refreshTime}</td>
       <td data-label="最近发布" style="font-size:11px;color:#888">${latestVideo}</td>
       <td data-label="猜测国家">${guessedLoc}</td>
       <td data-label="来源">${sources || "-"}</td>

package/src/watch/public/index.html

@@ -125,6 +125,7 @@
               <th>粉丝</th>
               <th>视频</th>
               <th>国家</th>
+              <th class="sortable" data-sort="refreshTime">最近刷新 <span class="sort-icon">↕</span></th>
               <th class="sortable" data-sort="latestVideoTime">最近发布 <span class="sort-icon">↕</span></th>
               <th>猜测国家</th>
               <th>来源</th>

package/src/watch/server.js

@@ -356,7 +356,8 @@ export function startWatchServer(dataAnchor, port = 3000, existingStore) {
 
       if (req.method === "GET" && routePath === "/api/redo-job") {
         const userId = params.userId || "";
-        const job = store.getNextRedoJob(userId);
+        const maxAge = parseInt(params.maxAge) || 43200;
+        const job = store.getNextRedoJob(userId, maxAge);
         if (job) {
           logJob("REDO-CLAIM", { user: job.uniqueId, clientId: userId });
           sendJSON(res, 200, { hasJob: true, user: job });
@@ -683,6 +684,7 @@ export function startWatchServer(dataAnchor, port = 3000, existingStore) {
             followerCount: u.followerCount,
             locationCreated: u.locationCreated,
             latestVideoTime: u.latestVideoTime,
+            refreshTime: u.refreshTime,
             guessedLocation: u.guessedLocation,
             pinned: u.pinned,
             processedAt: u.processedAt,

package/src/scraper/refresh-core.js

@@ -1,213 +0,0 @@
-import {
-  delay,
-  retryWithBackoff,
-  detectPageError,
-  assertPageUrl,
-} from "./modules/page-helpers.js";
-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;
-
-  const result = {
-    userInfo: null,
-    discoveredVideoAuthors: [],
-    discoveredFollowing: [],
-    discoveredFollowers: [],
-    newUsersAdded: 0,
-    collectedVideos: 0,
-    error: null,
-  };
-
-  try {
-    log(`  访问 @${username} 主页...`);
-    const homeUrl = `https://www.tiktok.com/@${username}`;
-    await retryWithBackoff(
-      async () => {
-        await page.goto(homeUrl, {
-          waitUntil: "domcontentloaded",
-          timeout: 30000,
-        });
-        assertPageUrl(page, `@${username}`);
-      },
-      { log },
-    );
-    await page
-      .waitForSelector('[class*="DivVideoList"]', { timeout: 10000 })
-      .catch(() => {});
-    await delay(1000, 2000);
-
-    log("  获取用户信息...");
-    const info = await getUserInfo(page);
-    if (info) {
-      result.userInfo = info;
-      log(
-        `  用户: ${info.nickname || username} | 粉丝: ${info.followerCount || "-"} | 视频: ${info.videoCount || "-"}`,
-      );
-    }
-
-    const captcha = await detectCaptcha(page);
-    if (captcha && captcha.visible) {
-      log(`[验证码] @${username} 页面出现验证码`);
-      result.captchaDetected = true;
-      result.captchaStage = result.captchaStage || "video-page";
-      result.captchaMessage = result.captchaMessage || "视频页出现验证码";
-    }
-
-    // 采集视频
-    log(`  采集视频 (最多 ${maxVideos} 个)...`);
-    const videoList = await collectVideos(page, username, maxVideos, log);
-    const videoArray = videoList ? [...videoList.values()] : [];
-    result.collectedVideos = videoArray.length;
-    result.discoveredVideoAuthors = videoArray.map((v) => v.author);
-
-    if (videoArray.length <= 0) {
-      result.noVideo = true;
-      const pageError = await detectPageError(page);
-      if (pageError) {
-        result.restricted = true;
-        log(`  @${username} 页面受限（${pageError}），标记跳过`);
-      }
-      return result;
-    }
-
-    // 采集关注和粉丝
-    log(`  采集关注 (最多 ${maxFollowing}) + 粉丝 (最多 ${maxFollowers})...`);
-    try {
-      const followResult = await extractFollowAndFollowers(page, {
-        maxFollowing,
-        maxFollowers,
-      });
-      result.discoveredFollowing = followResult.following || [];
-      result.discoveredFollowers = followResult.followers || [];
-      log(
-        `  关注: ${result.discoveredFollowing.length}, 粉丝: ${result.discoveredFollowers.length}`,
-      );
-    } catch (e) {
-      log(`  [关注/粉丝采集失败] ${e.message}`);
-      result.discoveredFollowing = [];
-      result.discoveredFollowers = [];
-    }
-
-    // 处理新发现的用户（关注 + 粉丝），循环执行完整 explore
-    // follow-extractor 返回 [handle, displayName] 数组
-    const allDiscovered = [
-      ...result.discoveredFollowing.map((h) => ({
-        handle: Array.isArray(h) ? h[0] : h,
-        source: "refresh-following",
-      })),
-      ...result.discoveredFollowers.map((h) => ({
-        handle: Array.isArray(h) ? h[0] : h,
-        source: "refresh-follower",
-      })),
-    ];
-
-    for (const { handle, source } of allDiscovered) {
-      const uniqueId = handle.replace("@", "");
-
-      // 检查用户是否已存在
-      const existsResp = await fetch(
-        `${serverUrl}/api/user-exists/${encodeURIComponent(uniqueId)}`,
-      );
-      const existsData = await existsResp.json();
-
-      if (existsData.exists) {
-        continue;
-      }
-
-      log(`  [新用户] @${uniqueId} 不存在，开始探索 (来源: ${source})...`);
-      await delay(1000, 2000);
-
-      // 对新用户做完整 explore（与 explore 命令逻辑一致）
-      const exploreResult = await processExplore(
-        page,
-        uniqueId,
-        {
-          maxComments: 10,
-          maxGuess: 0,
-          enableFollow: true,
-          maxFollowing: 5,
-          maxFollowers: 5,
-          location: DEFAULT_TARGET_LOCATIONS_CSV,
-        },
-        log,
-      );
-
-      // 提交 explore 结果到服务端（和 explore 命令的 commitJob 一致）
-      if (exploreResult.userInfo) {
-        const guessedLocation = exploreResult.locationCreated || null;
-
-        const payload = {
-          userInfo: exploreResult.userInfo || {},
-          discoveredVideoAuthors: (
-            exploreResult.discoveredVideoAuthors || []
-          ).map((item) =>
-            typeof item === "object" ? { ...item, guessedLocation } : item,
-          ),
-          discoveredCommentAuthors: (
-            exploreResult.discoveredCommentAuthors || []
-          ).map((author) => ({ author, guessedLocation })),
-          discoveredGuessAuthors: (
-            exploreResult.discoveredGuessAuthors || []
-          ).map((author) => ({ author, guessedLocation })),
-          discoveredFollowing: (exploreResult.discoveredFollowing || []).map(
-            (f) => ({
-              handle: Array.isArray(f) ? f[0] : f,
-              displayName: Array.isArray(f) ? f[1] : null,
-              guessedLocation,
-            }),
-          ),
-          discoveredFollowers: (exploreResult.discoveredFollowers || []).map(
-            (f) => ({
-              handle: Array.isArray(f) ? f[0] : f,
-              displayName: Array.isArray(f) ? f[1] : null,
-              guessedLocation,
-            }),
-          ),
-          processed: exploreResult.processed,
-          hasFollowData: exploreResult.hasFollowData,
-          keepFollow: exploreResult.keepFollow,
-          locationCreated: exploreResult.locationCreated,
-          noVideo: exploreResult.noVideo,
-          restricted: exploreResult.restricted,
-          error: exploreResult.error,
-        };
-
-        const addResp = await fetch(
-          `${serverUrl}/api/explore-new/${uniqueId}`,
-          {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(payload),
-          },
-        );
-        const addResult = await addResp.json();
-
-        if (!addResult.saved) {
-          log(`  [跳过] @${uniqueId} 提交失败`);
-          continue;
-        }
-
-        result.newUsersAdded++;
-        if (exploreResult.captchaDetected) {
-          result.captchaDetected = true;
-        }
-        log(
-          `  [已提交] @${uniqueId} ${addResult.created ? "(新用户)" : "(已存在)"} | 发现: ${addResult.newUsers?.length || 0} 个`,
-        );
-      }
-
-      await delay(2000, 4000);
-    }
-  } catch (e) {
-    log(`  [错误] ${e.message}`);
-    result.error = e.message;
-    result.errorStack = e.stack || "";
-  }
-
-  return result;
-}