tt-help-cli-ycl 1.3.52 → 1.3.55

package/package.json

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

package/scripts/test-html-analysis.mjs

@@ -0,0 +1,128 @@
+/**
+ * 测试工具：分析 TikTok view-source HTML 的三种情况
+ * 1. 正常用户（有 SSR 数据）
+ * 2. 空壳 HTML（11182 字节，无 SSR — 需要重试）
+ * 3. 异常用户（有 SSR 但 userInfo 为空，statusCode=10202 — 重试无效）
+ */
+
+import { TikTokScraper } from "../src/lib/tiktok-scraper.mjs";
+import fs from "fs";
+
+const testUsers = [
+  { id: "nike", type: "正常用户" },
+  { id: "galb508", type: "异常用户（可能被封/删除）" },
+  { id: "notexist_user_xxxxxx12345", type: "不存在的用户" },
+];
+
+async function analyzeUser(uniqueId, typeLabel) {
+  console.log(`\n${"=".repeat(60)}`);
+  console.log(`分析 @${uniqueId} (${typeLabel})`);
+  console.log("=".repeat(60));
+
+  const scraper = new TikTokScraper({ poolSize: 1 });
+  await scraper.init();
+  const slot = scraper._pickSlot();
+
+  // 多次采样
+  const samples = [];
+  for (let i = 0; i < 3; i++) {
+    const rawHtml = await scraper._fetchViewSource(
+      `https://www.tiktok.com/@${uniqueId}`,
+      slot,
+    );
+    const byteLen = Buffer.byteLength(rawHtml, "utf8");
+    const hasSSR = rawHtml.includes("__UNIVERSAL_DATA_FOR_REHYDRATION__");
+
+    let analysis = {
+      round: i + 1,
+      size: rawHtml.length,
+      byteLen,
+      hasSSR,
+    };
+
+    // 如果有 SSR 数据，进一步分析
+    if (hasSSR) {
+      try {
+        const idx = rawHtml.indexOf("__UNIVERSAL_DATA_FOR_REHYDRATION__");
+        const sIdx = rawHtml.indexOf(">", idx) + 1;
+        const eIdx = rawHtml.indexOf("</script>", sIdx);
+        const jsonStr = rawHtml.substring(sIdx, eIdx);
+        const data = JSON.parse(jsonStr);
+        const ud = data.__DEFAULT_SCOPE__?.["webapp.user-detail"];
+
+        analysis.scopeKeys = data.__DEFAULT_SCOPE__
+          ? Object.keys(data.__DEFAULT_SCOPE__)
+          : [];
+        analysis.hasUserInfo = !!(ud && ud.userInfo);
+        analysis.statusCode = ud?.statusCode;
+        analysis.statusMsg = ud?.statusMsg;
+        analysis.needFix = ud?.needFix;
+        analysis.udKeys = ud ? Object.keys(ud) : [];
+      } catch (e) {
+        analysis.parseError = e.message;
+      }
+    } else {
+      // 空壳 HTML，检查特征
+      analysis.hasEmptyTitle = rawHtml.includes(
+        '<title data-rh="true"></title>',
+      );
+      analysis.hasEmotionStyle = rawHtml.includes('data-emotion="tiktok"');
+    }
+
+    samples.push(analysis);
+    console.log(
+      `  第 ${i + 1} 次: ${rawHtml.length} 字符, ${byteLen} 字节, SSR: ${hasSSR ? "✓" : "✗"}`,
+    );
+    if (hasSSR && analysis.statusCode !== undefined) {
+      console.log(
+        `    statusCode: ${analysis.statusCode}, hasUserInfo: ${analysis.hasUserInfo}, udKeys: [${analysis.udKeys.join(", ")}]`,
+      );
+    }
+  }
+
+  // 总结
+  const shellCount = samples.filter((s) => !s.hasSSR).length;
+  const hasDataCount = samples.filter((s) => s.hasUserInfo).length;
+  const statusCode10202 = samples.filter((s) => s.statusCode === 10202).length;
+
+  console.log("\n  总结:");
+  console.log(`    空壳 HTML 次数: ${shellCount}/3`);
+  console.log(`    有 userInfo 次数: ${hasDataCount}/3`);
+  console.log(`    statusCode=10202 次数: ${statusCode10202}/3`);
+
+  // 判断类型
+  if (shellCount === 3) {
+    console.log("    → 判定: 持续空壳（可能是并发限流，重试可能有效）");
+  } else if (hasDataCount > 0) {
+    console.log("    → 判定: 正常用户（有完整数据）");
+  } else if (statusCode10202 > 0) {
+    console.log("    → 判定: 异常用户（statusCode=10202，重试无效）");
+  } else {
+    console.log("    → 判定: 无法确定");
+  }
+
+  await scraper.close();
+  return samples;
+}
+
+async function main() {
+  console.log("TikTok view-source HTML 分析工具");
+  console.log("测试三种情况的 HTML 特征差异\n");
+
+  const results = {};
+  for (const { id, type } of testUsers) {
+    results[id] = await analyzeUser(id, type);
+  }
+
+  // 保存结果
+  fs.writeFileSync(
+    "./test-html-analysis-result.json",
+    JSON.stringify(results, null, 2),
+  );
+  console.log("\n\n结果已保存到 test-html-analysis-result.json");
+}
+
+main().catch((err) => {
+  console.error("测试失败:", err);
+  process.exit(1);
+});

package/src/cli/attach.js

@@ -244,10 +244,16 @@ export async function handleAttach(options) {
             );
             failCount++;
           } else if (info) {
-            successTasks.push({ uniqueId, info });
+            // info 可能是 { error: true, statusCode: xxx } 表示 TikTok 给了明确响应
+            if (info.error) {
+              // 有 statusCode 说明 TikTok 已给出明确响应，提交到后端记录，不算错误
+              successTasks.push({ uniqueId, info });
+            } else {
+              successTasks.push({ uniqueId, info });
+            }
           } else {
-            attachLog(`  - @${uniqueId} 无用户信息`);
-            successTasks.push({ uniqueId, info: {} });
+            attachLog(`  ✗ @${uniqueId} 未获取到用户信息`);
+            failCount++;
           }
         } else {
           attachLog(
@@ -263,26 +269,32 @@ export async function handleAttach(options) {
           const batchRet = await apiPost(`${serverUrl}/api/user-info-batch`, {
             updates: successTasks,
           });
-          if (batchRet && batchRet.results) {
-            const nicknameMap = {};
-            for (const { uniqueId, info } of successTasks) {
-              if (info?.nickname) {
-                nicknameMap[uniqueId] = info.nickname;
-              }
-            }
+          if (batchRet && batchRet.results && Array.isArray(batchRet.results)) {
             for (const r of batchRet.results) {
               if (r.ok) {
                 successCount++;
-                const nickname = nicknameMap[r.uniqueId] || r.uniqueId;
-                attachLog(`  ✓ @${r.uniqueId} (${nickname}) 已提交更新`);
+                // 查找对应的 info 判断是否有 statusCode
+                const task = successTasks.find(
+                  (t) => t.uniqueId === r.uniqueId,
+                );
+                if (task && task.info && task.info.error) {
+                  attachLog(
+                    `  ⚠ @${r.uniqueId} 已记录 (statusCode=${task.info.statusCode})`,
+                  );
+                } else {
+                  attachLog(`  ✓ @${r.uniqueId} 已提交更新`);
+                }
               } else {
                 failCount++;
                 attachLog(`  ✗ @${r.uniqueId} 提交失败: ${r.error}`);
               }
             }
           } else {
+            // 后端返回格式异常，降级处理
+            attachLog(
+              `  ⚠ 后端响应格式异常 (batchRet=${JSON.stringify(batchRet).slice(0, 200)}), 降级为批量成功`,
+            );
             successCount = successTasks.length;
-            attachLog(`  ✓ 批量提交完成 (${successTasks.length} 条)`);
           }
         } catch (err) {
           failCount += successTasks.length;

package/src/cli/info.js

@@ -1,25 +1,38 @@
-import { TikTokScraper } from '../lib/tiktok-scraper.mjs';
-import { isProfileUrl, isVideoUrl, extractUniqueId, normalizeUsername } from '../lib/url.js';
+import { TikTokScraper } from "../lib/tiktok-scraper.mjs";
+import {
+  isProfileUrl,
+  isVideoUrl,
+  extractUniqueId,
+  normalizeUsername,
+} from "../lib/url.js";
 
 async function handleInfo(options) {
   const { infoUrls, infoOnlyVideo } = options;
 
   if (!infoUrls || infoUrls.length === 0) {
-    console.error('用法: tt-help info <URL> [URL2 URL3...] [--onlyvideo]');
-    console.error('');
-    console.error('参数:');
-    console.error('  <URL>              TikTok 主页或视频 URL，支持多个 URL 同时查询');
-    console.error('  --onlyvideo        只返回视频信息（不返回用户信息）');
-    console.error('');
-    console.error('默认行为:');
-    console.error('  主页 URL           → 返回用户信息（bio、region、粉丝数等）');
-    console.error('  视频 URL           → 返回用户信息 + 视频信息');
-    console.error('  视频 URL + --onlyvideo → 只返回视频信息');
-    console.error('');
-    console.error('示例:');
-    console.error('  tt-help info https://www.tiktok.com/@nike');
-    console.error('  tt-help info https://www.tiktok.com/@nike/video/7234567890');
-    console.error('  tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@apple');
+    console.error("用法: tt-help info <URL> [URL2 URL3...] [--onlyvideo]");
+    console.error("");
+    console.error("参数:");
+    console.error(
+      "  <URL>              TikTok 主页或视频 URL，支持多个 URL 同时查询",
+    );
+    console.error("  --onlyvideo        只返回视频信息（不返回用户信息）");
+    console.error("");
+    console.error("默认行为:");
+    console.error(
+      "  主页 URL           → 返回用户信息（bio、region、粉丝数等）",
+    );
+    console.error("  视频 URL           → 返回用户信息 + 视频信息");
+    console.error("  视频 URL + --onlyvideo → 只返回视频信息");
+    console.error("");
+    console.error("示例:");
+    console.error("  tt-help info https://www.tiktok.com/@nike");
+    console.error(
+      "  tt-help info https://www.tiktok.com/@nike/video/7234567890",
+    );
+    console.error(
+      "  tt-help info https://www.tiktok.com/@nike https://www.tiktok.com/@apple",
+    );
     process.exit(1);
   }
 
@@ -34,28 +47,35 @@ async function handleInfo(options) {
         const uniqueId = extractUniqueId(url);
         const normalized = normalizeUsername(uniqueId);
         const user = await scraper.getUserInfo(normalized);
-        if (user) {
-          result[normalized] = { user };
-          console.error(`用户: @${user.uniqueId} (${user.nickname})`);
+        if (!user || user.error) {
+          const code = user?.statusCode;
+          console.error(
+            `无法获取用户 @${uniqueId} 的信息${code !== undefined ? ` (statusCode=${code})` : ""}`,
+          );
+          continue;
         }
+        result[normalized] = { user };
+        console.error(`用户: @${user.uniqueId} (${user.nickname})`);
       } else if (isVideoUrl(url)) {
         const uniqueId = extractUniqueId(url);
         const normalized = normalizeUsername(uniqueId);
 
         if (infoOnlyVideo) {
           const video = await scraper.getVideoInfo(url);
-          if (video) {
-            const key = normalized + '/video/' + video.id;
-            result[key] = { video };
-            console.error(`视频: ${video.id}`);
+          if (!video) {
+            console.error(`无法获取视频信息: ${url}`);
+            continue;
           }
+          const key = normalized + "/video/" + video.id;
+          result[key] = { video };
+          console.error(`视频: ${video.id}`);
         } else {
           const [user, video] = await Promise.all([
             scraper.getUserInfo(normalized),
             scraper.getVideoInfo(url),
           ]);
           const entry = {};
-          if (user) {
+          if (user && !user.error) {
             entry.user = user;
             console.error(`用户: @${user.uniqueId} (${user.nickname})`);
           }
@@ -63,10 +83,12 @@ async function handleInfo(options) {
             entry.video = video;
             console.error(`视频: ${video.id}`);
           }
-          if (user || video) {
-            const key = normalized + '/video/' + (video ? video.id : 'unknown');
-            result[key] = entry;
+          if ((!user || user.error) && !video) {
+            console.error(`无法获取信息: ${url}`);
+            continue;
           }
+          const key = normalized + "/video/" + (video ? video.id : "unknown");
+          result[key] = entry;
         }
       } else {
         console.error(`无法识别 URL: ${url}`);

package/src/cli/open.js

@@ -33,13 +33,15 @@ export async function handleOpen(parsed) {
   if (!openPort) {
     console.error("用法: tt-help open <端口>");
     console.error("示例: tt-help open 9222");
-    console.error('运行 "tt-help open --list" 查看所有内置配置');
+    console.error("");
+    console.error("可用端口: 9222 - 9231 (共 10 个)");
+    console.error('运行 "tt-help open --list" 查看所有配置');
     process.exit(1);
   }
 
   const port = parseInt(openPort);
-  if (isNaN(port) || port < 1 || port > 65535) {
-    console.error(`端口 ${openPort} 无效，请输入 1-65535 之间的端口号`);
+  if (isNaN(port) || port < BASE_PORT || port >= BASE_PORT + TOTAL_ACCOUNTS) {
+    console.error(`端口 ${openPort} 不在有效范围内 (9222 - 9231)`);
     process.exit(1);
   }
 

package/src/lib/parse-ssr.mjs

@@ -1,20 +1,65 @@
+/**
+ * 判断失败是否可重试
+ * - 有 statusCode（无论值是多少）：TikTok 给了明确响应，不可重试
+ * - 没有 statusCode（空壳 HTML，无 SSR）：并发限流，可重试
+ */
+export function isRetryableFailure(rawHtml) {
+  if (!rawHtml || typeof rawHtml !== "string") return false;
+  // 没有 SSR 标记 = 空壳 HTML = 可重试
+  if (!rawHtml.includes("__UNIVERSAL_DATA_FOR_REHYDRATION__")) {
+    return true;
+  }
+  // 有 SSR 数据，检查是否有 statusCode
+  try {
+    const idx = rawHtml.indexOf("__UNIVERSAL_DATA_FOR_REHYDRATION__");
+    const sIdx = rawHtml.indexOf(">", idx) + 1;
+    const eIdx = rawHtml.indexOf("</script>", sIdx);
+    if (sIdx < 0 || eIdx < 0) return true;
+    const data = JSON.parse(rawHtml.substring(sIdx, eIdx));
+    const ud = data.__DEFAULT_SCOPE__?.["webapp.user-detail"];
+    // 有 statusCode 说明 TikTok 给了明确响应（0=成功，10202=被封，10221=不存在等），不可重试
+    if (ud && "statusCode" in ud) return false;
+  } catch {}
+  return true;
+}
+
 function parseSSR(rawHtml) {
-  if (!rawHtml.includes('__UNIVERSAL_DATA_FOR_REHYDRATION__')) return null;
-  const dataStart = rawHtml.indexOf('__UNIVERSAL_DATA_FOR_REHYDRATION__');
-  // 从该字符串后面找 <script 标签的 >，确保找到的是正确行的 >
-  const scriptStart = rawHtml.lastIndexOf('<script', dataStart);
-  const sIdx = (scriptStart >= 0 ? rawHtml.indexOf('>', scriptStart) : rawHtml.indexOf('>', dataStart)) + 1;
-  const eIdx = rawHtml.indexOf('</script>', sIdx);
-  if (sIdx < 0 || eIdx < 0) return null;
+  if (!rawHtml || typeof rawHtml !== "string") {
+    return null;
+  }
+  if (!rawHtml.includes("__UNIVERSAL_DATA_FOR_REHYDRATION__")) {
+    return null;
+  }
+  const dataStart = rawHtml.indexOf("__UNIVERSAL_DATA_FOR_REHYDRATION__");
+  const scriptStart = rawHtml.lastIndexOf("<script", dataStart);
+  const sIdx =
+    (scriptStart >= 0
+      ? rawHtml.indexOf(">", scriptStart)
+      : rawHtml.indexOf(">", dataStart)) + 1;
+  const eIdx = rawHtml.indexOf("</script>", sIdx);
+  if (sIdx < 0 || eIdx < 0) {
+    return null;
+  }
   const jsonStr = rawHtml.substring(sIdx, eIdx);
-  return JSON.parse(jsonStr);
+  try {
+    return JSON.parse(jsonStr);
+  } catch (e) {
+    return null;
+  }
 }
 
 export function parseUserInfo(rawHtml) {
   const data = parseSSR(rawHtml);
   if (!data) return null;
-  const ud = data.__DEFAULT_SCOPE__['webapp.user-detail'];
-  if (!ud || !ud.userInfo) return null;
+  const scopeKeys = data.__DEFAULT_SCOPE__
+    ? Object.keys(data.__DEFAULT_SCOPE__)
+    : [];
+  const ud =
+    data.__DEFAULT_SCOPE__ && data.__DEFAULT_SCOPE__["webapp.user-detail"];
+  if (!ud || !ud.userInfo) {
+    const code = ud?.statusCode;
+    return { error: true, statusCode: code };
+  }
   const u = ud.userInfo.user;
   const s = ud.userInfo.stats;
   return {
@@ -24,8 +69,8 @@ export function parseUserInfo(rawHtml) {
     verified: u.verified,
     privateAccount: u.privateAccount,
     language: u.language,
-    bio: u.signature || '',
-    avatar: u.avatarLarger || u.avatarMedium || u.avatarThumb || '',
+    bio: u.signature || "",
+    avatar: u.avatarLarger || u.avatarMedium || u.avatarThumb || "",
     followerCount: s.followerCount,
     followingCount: s.followingCount,
     heartCount: s.heartCount,
@@ -35,20 +80,30 @@ export function parseUserInfo(rawHtml) {
     secUid: u.secUid,
     ttSeller: u.ttSeller || false,
     locationCreated: u.locationCreated || null,
+    statusCode: 0,
   };
 }
 
 export function parseVideoInfo(rawHtml) {
   const data = parseSSR(rawHtml);
   if (!data) return null;
-  const vd = data.__DEFAULT_SCOPE__['webapp.video-detail'];
-  if (!vd || !vd.itemInfo || !vd.itemInfo.itemStruct) return null;
+  const scopeKeys = data.__DEFAULT_SCOPE__
+    ? Object.keys(data.__DEFAULT_SCOPE__)
+    : [];
+  const vd =
+    data.__DEFAULT_SCOPE__ && data.__DEFAULT_SCOPE__["webapp.video-detail"];
+  if (!vd || !vd.itemInfo || !vd.itemInfo.itemStruct) {
+    console.error(
+      `[parseVideoInfo] webapp.video-detail 不存在, scope keys: ${JSON.stringify(scopeKeys)}`,
+    );
+    return null;
+  }
   const item = vd.itemInfo.itemStruct;
   const author = item.author || {};
   const stats = item.stats || {};
   return {
     id: item.id,
-    desc: item.desc || '',
+    desc: item.desc || "",
     createTime: item.createTime || null,
     locationCreated: item.locationCreated || null,
     author: {

package/src/lib/scrape.js

@@ -57,7 +57,7 @@ export async function extractUserData(url) {
   const uniqueId = extractUniqueId(url);
   if (!uniqueId) throw new Error(`无法从URL提取用户名: ${url}`);
   const user = await scraper.getUserInfo(normalizeUsername(uniqueId));
-  if (!user) return null;
+  if (!user) throw new Error('无法解析用户信息');
   return mapUserInfo(user);
 }
 
@@ -70,7 +70,7 @@ export async function extractVideoLocation(videoUrl) {
 export async function processUrl(url) {
   if (isProfileUrl(url)) {
     const profileData = await extractUserData(url);
-    return profileData ? [profileData] : [];
+    return [profileData];
   }
 
   if (isVideoUrl(url)) {
@@ -82,7 +82,6 @@ export async function processUrl(url) {
       extractVideoLocation(url),
     ]);
 
-    if (!profileData) return [];
     return [{ ...profileData, locationCreated }];
   }
 

package/src/lib/tiktok-scraper.mjs

@@ -1,31 +1,21 @@
-import os from "os";
-import path from "path";
-import fs from "fs";
 import { chromium } from "playwright";
 import { detectBrowser } from "./browser/launch.js";
-import { parseUserInfo, parseVideoInfo } from "./parse-ssr.mjs";
+import {
+  parseUserInfo,
+  parseVideoInfo,
+  isRetryableFailure,
+} from "./parse-ssr.mjs";
 
 const DEFAULT_POOL_SIZE = 3;
 const DEFAULT_WAF_TTL = 120000;
 const DEFAULT_WARM_URL = "https://www.tiktok.com/@nike";
 const BROWSER_CLOSE_TIMEOUT = 5000;
 const DEFAULT_MAX_REQUESTS_PER_PAGE = 50;
-const FALLBACK_PROFILE_PORT = 9999;
 
 function delay(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 
-function getFallbackProfileDir() {
-  const profile = `p${FALLBACK_PROFILE_PORT}`;
-  return path.join(
-    os.homedir(),
-    "Library",
-    "Application Support",
-    `Microsoft Edge For Testing_${profile}`,
-  );
-}
-
 class PageSlot {
   constructor(page) {
     this.page = page;
@@ -61,49 +51,6 @@ class PromiseQueue {
   }
 }
 
-function createLaunchOptions(executablePath) {
-  return {
-    headless: true,
-    executablePath,
-    handleSIGINT: false,
-    handleSIGTERM: false,
-    handleSIGHUP: false,
-    args: [
-      "--no-sandbox",
-      "--disable-setuid-sandbox",
-      "--disable-dev-shm-usage",
-    ],
-  };
-}
-
-async function initContext(executablePath, poolSize, userDataDir) {
-  let context;
-  let browser = null;
-  const slots = [];
-
-  if (userDataDir) {
-    context = await chromium.launchPersistentContext(
-      userDataDir,
-      createLaunchOptions(executablePath),
-    );
-    const existing = context.pages();
-    if (existing.length > 0) {
-      slots.push(new PageSlot(existing[0]));
-    }
-    for (let i = slots.length; i < poolSize; i++) {
-      slots.push(new PageSlot(await context.newPage()));
-    }
-  } else {
-    browser = await chromium.launch(createLaunchOptions(executablePath));
-    context = await browser.newContext();
-    for (let i = 0; i < poolSize; i++) {
-      slots.push(new PageSlot(await context.newPage()));
-    }
-  }
-
-  return { browser, context, slots };
-}
-
 export class TikTokScraper {
   constructor({
     poolSize = DEFAULT_POOL_SIZE,
@@ -121,11 +68,6 @@ export class TikTokScraper {
     this.slotIdx = 0;
     this.lastWarmTime = 0;
     this.warmPromise = null;
-    // 登录态 pool（init 时直接启动）
-    this.authBrowser = null;
-    this.authContext = null;
-    this.authSlots = [];
-    this.authSlotIdx = 0;
   }
 
   async init() {
@@ -135,73 +77,49 @@ export class TikTokScraper {
         "未找到本地浏览器（Chrome/Edge），请先安装浏览器或执行 npx playwright install",
       );
     }
-    const { browser, context, slots } = await initContext(
+    this.browser = await chromium.launch({
+      headless: true,
       executablePath,
-      this.poolSize,
-      null,
-    );
-    this.browser = browser;
-    this.context = context;
-    this.slots = slots;
-
-    // 启动登录态 pool（1 个 slot）
-    // profile 不存在则跳过，不影响主流程
-    const fallbackDir = getFallbackProfileDir();
-    if (fs.existsSync(fallbackDir)) {
-      const {
-        browser: authBrowser,
-        context: authContext,
-        slots: authSlots,
-      } = await initContext(executablePath, 1, fallbackDir);
-      this.authBrowser = authBrowser;
-      this.authContext = authContext;
-      this.authSlots = authSlots;
-    } else {
-      console.error(
-        `[TikTokScraper] 登录态 profile 不存在 (${fallbackDir})，跳过登录态 pool。请先运行 tt-help open 9999 登录 TikTok`,
-      );
+      handleSIGINT: false,
+      handleSIGTERM: false,
+      handleSIGHUP: false,
+      args: [
+        "--no-sandbox",
+        "--disable-setuid-sandbox",
+        "--disable-dev-shm-usage",
+      ],
+    });
+    this.context = await this.browser.newContext();
+    for (let i = 0; i < this.poolSize; i++) {
+      this.slots.push(new PageSlot(await this.context.newPage()));
     }
-
     await this.warmWaf();
   }
 
   async close() {
-    const closeAll = async (browser) => {
-      if (browser) {
-        let closeTimedOut = false;
-        const closePromise = browser.close().catch((error) => {
-          console.error(
-            `[TikTokScraper] browser.close() failed: ${error.message}`,
-          );
-        });
-        await Promise.race([
-          closePromise,
-          delay(BROWSER_CLOSE_TIMEOUT).then(() => {
-            closeTimedOut = true;
-          }),
-        ]);
-        if (closeTimedOut) {
-          console.error(
-            `[TikTokScraper] browser.close() 超时 ${BROWSER_CLOSE_TIMEOUT}ms，跳过等待并继续退出`,
-          );
-        }
+    if (this.browser) {
+      const browser = this.browser;
+      let closeTimedOut = false;
+      const closePromise = browser.close().catch((error) => {
+        console.error(
+          `[TikTokScraper] browser.close() failed: ${error.message}`,
+        );
+      });
+      await Promise.race([
+        closePromise,
+        delay(BROWSER_CLOSE_TIMEOUT).then(() => {
+          closeTimedOut = true;
+        }),
+      ]);
+      if (closeTimedOut) {
+        console.error(
+          `[TikTokScraper] browser.close() 超时 ${BROWSER_CLOSE_TIMEOUT}ms，跳过等待并继续退出`,
+        );
       }
-    };
-
-    // 无登录态的 browser
-    await closeAll(this.browser);
-    // 登录态的 context（launchPersistentContext 返回的是 context 当 browser）
-    if (this.authContext) {
-      try {
-        await this.authContext.close();
-      } catch {}
+      this.browser = null;
+      this.context = null;
+      this.slots = [];
     }
-    this.browser = null;
-    this.context = null;
-    this.slots = [];
-    this.authBrowser = null;
-    this.authContext = null;
-    this.authSlots = [];
   }
 
   async restart() {
@@ -211,7 +129,7 @@ export class TikTokScraper {
 
   isAlive() {
     try {
-      return !!(this.context && (!this.browser || this.browser.isConnected()));
+      return !!(this.browser && this.browser.isConnected());
     } catch {
       return false;
     }
@@ -238,11 +156,17 @@ export class TikTokScraper {
     return this.warmPromise;
   }
 
-  isWarmExpired() {
+  _needWarm() {
     return Date.now() - this.lastWarmTime > this.wafTtl;
   }
 
-  async _ensurePage(slot, context) {
+  _pickSlot() {
+    const slot = this.slots[this.slotIdx % this.poolSize];
+    this.slotIdx++;
+    return slot;
+  }
+
+  async _ensurePage(slot) {
     try {
       if (
         !slot.page.isClosed() &&
@@ -252,111 +176,88 @@ export class TikTokScraper {
       }
     } catch {}
     await slot.page?.close().catch(() => {});
-    slot.page = await context.newPage();
+    slot.page = await this.context.newPage();
     slot.requestCount = 0;
     return slot.page;
   }
 
-  async _fetchViewSource(url, ctx) {
-    const slots = ctx === this.authContext ? this.authSlots : this.slots;
-    const slotIdx = ctx === this.authContext ? this.authSlotIdx : this.slotIdx;
-    const slot = slots[slotIdx % slots.length];
-    if (ctx === this.authContext) {
-      this.authSlotIdx++;
-    } else {
-      this.slotIdx++;
-    }
-
-    try {
-      return await slot.lock.run(async () => {
-        const page = await this._ensurePage(slot, ctx);
-
-        if (ctx === this.context && this.isWarmExpired()) {
-          await this.warmWaf();
-        }
+  async _fetchViewSource(url, slot) {
+    const page = await this._ensurePage(slot);
 
-        await page.goto("view-source:" + url, {
-          waitUntil: "domcontentloaded",
-          timeout: 15000,
-        });
-
-        const content = await page.evaluate(() => {
-          const rows = document.querySelectorAll("tr");
-          let content = "";
-          rows.forEach((r) => {
-            const lc = r.querySelector(".line-content");
-            if (lc) content += lc.textContent + "\n";
-          });
-          return content;
-        });
-
-        // 导航到 about:blank 释放当前页面的 DOM 和 JS 堆
-        await page
-          .goto("about:blank", {
-            waitUntil: "domcontentloaded",
-            timeout: 5000,
-          })
-          .catch(() => {});
-
-        slot.requestCount += 1;
+    await page.goto("view-source:" + url, {
+      waitUntil: "domcontentloaded",
+      timeout: 15000,
+    });
 
-        return content;
+    const content = await page.evaluate(() => {
+      const rows = document.querySelectorAll("tr");
+      let content = "";
+      rows.forEach((r) => {
+        const lc = r.querySelector(".line-content");
+        if (lc) content += lc.textContent + "\n";
       });
-    } catch (e) {
-      console.error(`[TikTokScraper] _fetchViewSource failed: ${e.message}`);
-      return null;
-    }
-  }
-
-  async getUserInfo(username) {
-    const normalizedUsername = username.startsWith("@")
-      ? username.slice(1)
-      : username;
-    const url = `https://www.tiktok.com/@${normalizedUsername}`;
-
-    // 第一趟：无登录态
-    let rawHtml = await this._fetchViewSource(url, this.context);
-    let result = rawHtml ? parseUserInfo(rawHtml) : null;
+      return content;
+    });
 
-    // 解析失败：先尝试 warmWaf 后重试
-    if (!result) {
-      try {
-        await this.warmWaf();
-      } catch {}
-      rawHtml = await this._fetchViewSource(url, this.context);
-      result = rawHtml ? parseUserInfo(rawHtml) : null;
-    }
+    // 导航到 about:blank 释放当前页面的 DOM 和 JS 堆
+    await page
+      .goto("about:blank", {
+        waitUntil: "domcontentloaded",
+        timeout: 5000,
+      })
+      .catch(() => {});
 
-    // 仍然失败：使用登录态 pool
-    if (!result && this.authContext) {
-      rawHtml = await this._fetchViewSource(url, this.authContext);
-      result = rawHtml ? parseUserInfo(rawHtml) : null;
-    }
+    slot.requestCount += 1;
 
-    return result || null;
+    return content;
   }
 
-  async getVideoInfo(videoUrl) {
-    // 第一趟：无登录态
-    let rawHtml = await this._fetchViewSource(videoUrl, this.context);
-    let result = rawHtml ? parseVideoInfo(rawHtml) : null;
-
-    // 解析失败：先尝试 warmWaf 后重试
-    if (!result) {
-      try {
-        await this.warmWaf();
-      } catch {}
-      rawHtml = await this._fetchViewSource(videoUrl, this.context);
-      result = rawHtml ? parseVideoInfo(rawHtml) : null;
-    }
-
-    // 仍然失败：使用登录态 pool
-    if (!result && this.authContext) {
-      rawHtml = await this._fetchViewSource(videoUrl, this.authContext);
-      result = rawHtml ? parseVideoInfo(rawHtml) : null;
-    }
+  async getUserInfo(uniqueId, maxRetries = 3) {
+    const slot = this._pickSlot();
+    return slot.lock.run(async () => {
+      let rawHtml = await this._fetchViewSource(
+        `https://www.tiktok.com/@${uniqueId}`,
+        slot,
+      );
+      let result = parseUserInfo(rawHtml);
+      for (let attempt = 1; !result && attempt <= maxRetries; attempt++) {
+        // 检查是否值得重试：用户异常/不存在则跳过重试
+        if (!isRetryableFailure(rawHtml)) {
+          break;
+        }
+        try {
+          await this.warmWaf();
+        } catch {}
+        await delay(500 * attempt);
+        rawHtml = await this._fetchViewSource(
+          `https://www.tiktok.com/@${uniqueId}`,
+          slot,
+        );
+        result = parseUserInfo(rawHtml);
+      }
+      return result || null;
+    });
+  }
 
-    return result || null;
+  async getVideoInfo(videoUrl, maxRetries = 3) {
+    const slot = this._pickSlot();
+    return slot.lock.run(async () => {
+      let rawHtml = await this._fetchViewSource(videoUrl, slot);
+      let result = parseVideoInfo(rawHtml);
+      for (let attempt = 1; !result && attempt <= maxRetries; attempt++) {
+        // 检查是否值得重试
+        if (!isRetryableFailure(rawHtml)) {
+          break;
+        }
+        try {
+          await this.warmWaf();
+        } catch {}
+        await delay(500 * attempt);
+        rawHtml = await this._fetchViewSource(videoUrl, slot);
+        result = parseVideoInfo(rawHtml);
+      }
+      return result || null;
+    });
   }
 
   async getUserAndVideo(videoUrl) {

package/src/watch/data-store.js

@@ -114,9 +114,21 @@ function initUserDb(filePath) {
       updated_at INTEGER,
       region TEXT,
       signature TEXT,
-      sec_uid TEXT
+      sec_uid TEXT,
+      status_code INTEGER
     )
   `);
+
+  // 迁移：为已存在的 jobs 表添加 status_code 列
+  const existingJobColumns = new Set(
+    db
+      .prepare("PRAGMA table_info(jobs)")
+      .all()
+      .map((c) => c.name),
+  );
+  if (!existingJobColumns.has("status_code")) {
+    db.exec(`ALTER TABLE jobs ADD COLUMN status_code INTEGER`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS raw_jobs (
       unique_id TEXT PRIMARY KEY,
@@ -146,9 +158,21 @@ function initUserDb(filePath) {
       updated_at INTEGER,
       region TEXT,
       signature TEXT,
-      sec_uid TEXT
+      sec_uid TEXT,
+      status_code INTEGER
     )
   `);
+
+  // 迁移：为已存在的 raw_jobs 表添加 status_code 列
+  const existingRawJobColumns = new Set(
+    db
+      .prepare("PRAGMA table_info(raw_jobs)")
+      .all()
+      .map((c) => c.name),
+  );
+  if (!existingRawJobColumns.has("status_code")) {
+    db.exec(`ALTER TABLE raw_jobs ADD COLUMN status_code INTEGER`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS videos (
       id TEXT PRIMARY KEY,
@@ -1065,9 +1089,7 @@ function restoreRawJobsByFilter({ search, location }) {
 
   const count =
     db
-      .prepare(
-        `SELECT COUNT(*) as c FROM raw_jobs WHERE ${whereSql}`,
-      )
+      .prepare(`SELECT COUNT(*) as c FROM raw_jobs WHERE ${whereSql}`)
       .get(...args)?.c || 0;
 
   if (!count) {
@@ -1293,6 +1315,7 @@ const jobBooleanColumns = new Set([
   "processed",
   "tt_seller",
   "verified",
+  "error",
 ]);
 
 const videoBooleanColumns = new Set(["tt_seller"]);
@@ -1324,17 +1347,20 @@ const writableJobColumns = new Set([
   "region",
   "signature",
   "sec_uid",
+  "status_code",
 ]);
 
 function normalizeJobValue(column, value) {
+  if (value === undefined || value === null) return null;
   if (column === "sources") {
     if (!Array.isArray(value)) return JSON.stringify([]);
     return JSON.stringify([...new Set(value)]);
   }
   if (jobBooleanColumns.has(column)) {
-    if (value === undefined || value === null || value === "") return null;
     return value ? 1 : 0;
   }
+  // 防御：如果值是对象或数组，转为 JSON 字符串
+  if (typeof value === "object") return JSON.stringify(value);
   return value;
 }
 
@@ -1812,6 +1838,11 @@ export function createStore(filePath) {
         const args = [];
         if (!loggedIn) {
           where.push("COALESCE(tt_seller, 0) != 1");
+          // 未登录用户只能领取 statusCode 为空的任务（209002 只能被登录用户领取）
+          where.push("status_code IS NULL");
+        } else {
+          // 登录用户可以领取 statusCode 为空 或 statusCode=209002 的任务
+          where.push("status_code IS NULL OR status_code = 209002");
         }
         if (requireVideo) {
           where.push("COALESCE(video_count, 0) > 0");
@@ -2644,7 +2675,9 @@ export function createStore(filePath) {
           u.ttSeller === null || u.ttSeller === undefined || u.ttSeller === "";
         if (!ttSellerEmpty) return false;
         if (
-          updateCount === null || updateCount === undefined || updateCount <= 0
+          updateCount === null ||
+          updateCount === undefined ||
+          updateCount <= 0
         ) {
           if (hasCountryFilter) {
             const loc = (u.guessedLocation || "").toUpperCase();
@@ -2686,7 +2719,19 @@ export function createStore(filePath) {
   function batchUpdateUserInfo(updates) {
     if (db) {
       const txn = db.transaction((items) =>
-        items.map((item) => updateJobInfo(item.uniqueId, item.info, true)),
+        items.map((item) => {
+          // 处理 { error: true, statusCode: xxx } 的情况
+          const info = item.info;
+          if (info && info.error && info.statusCode !== undefined) {
+            // 只更新 status_code，不更新其他字段
+            return updateJobInfo(
+              item.uniqueId,
+              { statusCode: info.statusCode },
+              true,
+            );
+          }
+          return updateJobInfo(item.uniqueId, info, true);
+        }),
       );
       return txn(updates).map((result, index) =>
         result.error
@@ -2706,15 +2751,20 @@ export function createStore(filePath) {
         results.push({ uniqueId: item.uniqueId, error: "user not found" });
         continue;
       }
-      if (item.info) {
-        for (const key of Object.keys(item.info)) {
-          if (key === "uniqueId" || key === "sources") continue;
+      const info = item.info;
+      if (info && info.error && info.statusCode !== undefined) {
+        // 只更新 status_code
+        user.statusCode = info.statusCode;
+      } else {
+        for (const key of Object.keys(info)) {
+          if (key === "uniqueId" || key === "sources" || key === "error")
+            continue;
           if (
-            item.info[key] !== undefined &&
-            item.info[key] !== null &&
-            item.info[key] !== ""
+            info[key] !== undefined &&
+            info[key] !== null &&
+            info[key] !== ""
           ) {
-            user[key] = item.info[key];
+            user[key] = info[key];
           }
         }
       }

package/src/watch/public/index.html

@@ -1150,6 +1150,7 @@
               <th>猜测国家</th>
               <th>来源</th>
               <th>状态</th>
+              <th>StatusCode</th>
               <th>处理端</th>
               <th>领取时间</th>
               <th>完成时间</th>
@@ -1530,6 +1531,9 @@
         const claimer = u.claimedBy || '-';
         const claimTime = u.claimedAt ? formatTime(u.claimedAt) : '-';
         const procTime = u.processedAt ? formatTime(u.processedAt) : '-';
+        const statusCodeDisplay = u.statusCode != null && u.statusCode !== 0
+          ? `<span class="tag error" style="font-size:10px">${u.statusCode}</span>`
+          : '';
         return `<tr${rowClass}>
       <td class="user-id" data-label="用户名">@${u.uniqueId}</td>
       <td data-label="昵称">${nick}</td>
@@ -1539,6 +1543,7 @@
       <td data-label="猜测国家">${guessedLoc}</td>
       <td data-label="来源">${sources || '-'}</td>
       <td data-label="状态">${statusTag} ${extraTags.join(' ')}</td>
+      <td data-label="StatusCode">${statusCodeDisplay}</td>
       <td data-label="处理端" style="font-size:11px;color:#888">${claimer}</td>
       <td data-label="领取时间" style="font-size:11px;color:#888">${claimTime}</td>
       <td data-label="完成时间" style="font-size:11px;color:#888">${procTime}</td>