tt-help-cli-ycl 1.3.52 → 1.3.57

package/package.json

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

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,14 @@ 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('运行 "tt-help open --list" 查看内置浏览器配置');
     process.exit(1);
   }
 
   const port = parseInt(openPort);
   if (isNaN(port) || port < 1 || port > 65535) {
-    console.error(`端口 ${openPort} 无效，请输入 1-65535 之间的端口号`);
+    console.error(`端口 ${openPort} 无效 (请使用 1 - 65535)`);
     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 }];
   }