tt-help-cli-ycl 1.4.30 → 1.4.32

package/src/lib/constants.js

@@ -316,19 +316,21 @@ const HELP_TEXT = [
   "",
   "  search [选项]",
   "    基于 productive 标签搜索 TikTok 作者（score>70 的标签作为搜索词）",
-  "    5 个搜索 Tab 并行采集（综合/视频/用户/直播/照片），去重后提交到 job_base",
+  "    4 个搜索 Tab 采集（综合/视频/用户/照片），去重后提交到 job_base",
   "    选项:",
   "      -s, --server <URL>        服务端地址（默认 http://127.0.0.1:3000）",
   "      --base-port <端口号>      起始 CDP 端口，默认 3333",
   "      --port-count <数量>       端口数量（账户数），默认 10",
+  "      -p, --parallel <N>        并行搜索数，默认 1（串行）",
   "      --proxy <地址>            浏览器代理",
   "    行为:",
   "      - 从 tags 表取 score>70 的 productive 标签",
   "      - 去掉 # 号后作为搜索关键词",
-  "      - 并行搜索 5 个 tab，去重后提交到 job_base（来源=search）",
+  "      - 搜索 4 个 tab，去重后提交到 job_base（来源=search）",
   "      - 猜测国家取标签 countries 数组的第一个",
   "    示例: tt-help search",
   "          tt-help search -s http://127.0.0.1:3001",
+  "          tt-help search -p 2 -s http://127.0.0.1:3001",
   "          tt-help search --base-port 3333 -s http://127.0.0.1:3001",
   "          tt-help search --proxy http://127.0.0.1:7890",
   "",

package/src/lib/search-collector.js

@@ -14,7 +14,7 @@ const TAB_URLS = {
   照片: (q) => `https://www.tiktok.com/search/photo?q=${encodeURIComponent(q)}`,
 };
 
-const DEFAULT_TABS = ["综合", "视频", "用户", "直播", "照片"];
+const DEFAULT_TABS = ["综合", "视频", "用户", "照片"];
 
 const SCROLL = {
   maxRounds: 60,
@@ -60,10 +60,9 @@ async function scrollPage(page) {
 
 async function waitForSearchResults(page, timeoutMs = 20000) {
   try {
-    await page.waitForSelector(
-      '[class*="DivItemContainer"]',
-      { timeout: timeoutMs },
-    );
+    await page.waitForSelector('[class*="DivItemContainer"]', {
+      timeout: timeoutMs,
+    });
     return true;
   } catch {
     return false;
@@ -160,24 +159,41 @@ async function processOneTab(page, tabName, keyword, allIds, excludeSet, log) {
  */
 export async function collectSearchAuthors(browser, keyword, opts = {}) {
   const tabs = opts.tabs || DEFAULT_TABS;
+  const parallel = Math.max(1, opts.parallel || 1);
   const log = opts.log || ((...args) => console.error(...args));
   const excludeSet = new Set(opts.exclude || []);
 
-  log(`[collect] "${keyword}"  Tab: [${tabs.join(", ")}]`);
+  log(`[collect] "${keyword}"  Tab: [${tabs.join(", ")}]  并行: ${parallel}`);
   if (excludeSet.size > 0)
     log(`[collect] 排除: [${[...excludeSet].join(", ")}]`);
 
   const context = browser.contexts()[0];
-  const page = context.pages()[0];
+  const mainPage = context.pages()[0];
   const allIds = new Set();
 
-  // 串行：复用同一个页面，逐个 tab 采集
-  for (const tabName of tabs) {
-    try {
-      await processOneTab(page, tabName, keyword, allIds, excludeSet, log);
-    } catch (e) {
-      log(`[${tabName}] 异常: ${e.message}`);
-    }
+  // 分批并行：每批 parallel 个 tab，批内并行、批间串行
+  for (let i = 0; i < tabs.length; i += parallel) {
+    const batch = tabs.slice(i, i + parallel);
+    const batchPages = [];
+
+    const tasks = batch.map(async (tabName, j) => {
+      let page = null;
+      try {
+        page = j === 0 ? mainPage : await context.newPage();
+        if (j > 0) batchPages.push(page);
+        await processOneTab(page, tabName, keyword, allIds, excludeSet, log);
+      } catch (e) {
+        log(`[${tabName}] 异常: ${e.message}`);
+      } finally {
+        if (j > 0 && page) {
+          try {
+            await page.close();
+          } catch {}
+        }
+      }
+    });
+
+    await Promise.all(tasks);
   }
 
   return [...allIds].sort();

package/src/lib/shop-scraper.mjs

@@ -0,0 +1,280 @@
+/**
+ * TikTok Shop product scraper — pure HTTP with optional browser captcha fallback.
+ *
+ * @example
+ * ```js
+ * import { getProductInfo, formatCount } from './shop-scraper.mjs';
+ *
+ * // Basic usage (throws on captcha)
+ * const data = await getProductInfo('https://shop.tiktok.com/us/pdp/...', 'http://proxy:port');
+ *
+ * // With auto browser fallback for captcha
+ * const data = await getProductInfo(url, proxy, { captchaFallback: true });
+ *
+ * console.log(data.rating);        // 4.6
+ * console.log(formatCount(data.soldCount)); // "99.9K"
+ * ```
+ */
+
+import { ProxyAgent, request } from "undici";
+import { DEFAULT_PROXY } from "./constants.js";
+
+const PDP_HEADERS = {
+  "User-Agent":
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+  Accept: "text/html,application/xhtml+xml",
+  "Accept-Language": "en-US,en;q=0.9",
+};
+
+/**
+ * Extract a JSON object by its key name, handling nested braces and strings.
+ */
+function extractJsonByKey(html, keyPattern) {
+  const match = html.match(keyPattern);
+  if (!match) return null;
+
+  const braceIdx = html.indexOf("{", match.index);
+  if (braceIdx === -1) return null;
+
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+
+  for (let i = braceIdx; i < html.length; i++) {
+    const ch = html[i];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (ch === "\\") {
+      escaped = true;
+      continue;
+    }
+    if (ch === '"') {
+      inString = !inString;
+      continue;
+    }
+    if (inString) continue;
+    if (ch === "{") depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0) {
+        try {
+          return JSON.parse(html.substring(braceIdx, i + 1));
+        } catch {
+          return null;
+        }
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Open a headed browser for the user to manually solve TikTok captcha.
+ * Returns true once the user closes the browser (captcha assumed solved).
+ */
+/**
+ * Open a headed browser for manual captcha solving. Polls the page until
+ * product content appears, then auto-closes the browser.
+ * @param {string} url - TikTok Shop PDP URL to open in browser
+ * @param {string} [proxyUrl]
+ * @returns {Promise<boolean>} true if captcha was solved, false if timed out
+ */
+export async function resolveCaptchaWithBrowser(url, proxyUrl) {
+  const { chromium } = await import("playwright");
+
+  const args = ["--no-sandbox"];
+  if (proxyUrl) {
+    args.push(`--proxy-server=${proxyUrl.replace("http://", "http://")}`);
+  }
+
+  const browser = await chromium.launch({
+    headless: false,
+    channel: "msedge",
+    args,
+  });
+
+  const page = await browser.newPage();
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
+
+  await page.evaluate(() => {
+    const div = document.createElement("div");
+    div.style.cssText =
+      "position:fixed;top:10px;left:50%;transform:translateX(-50%);z-index:99999;background:#ff0050;color:white;padding:12px 24px;border-radius:8px;font:16px Arial;box-shadow:0 4px 12px rgba(0,0,0,0.3)";
+    div.textContent = "Captcha detected - please solve it";
+    document.body.appendChild(div);
+  });
+
+  console.error(
+    "[shop-scraper] Browser opened, waiting for captcha to be solved...",
+  );
+
+  // Poll until captcha is solved (page loads real content) or user closes browser
+  let solved = false;
+  const POLL_MS = 1000;
+  const MAX_WAIT_MS = 120000;
+  const start = Date.now();
+
+  while (!solved && Date.now() - start < MAX_WAIT_MS) {
+    try {
+      const html = await page.content();
+      if (
+        html.includes('"product_model"') ||
+        html.includes('"review_ratings"')
+      ) {
+        solved = true;
+        break;
+      }
+      // Check if browser was closed by user
+      if (!browser.isConnected()) break;
+    } catch (e) {
+      // Page might be closed, check browser
+      if (!browser.isConnected()) break;
+    }
+    await new Promise((r) => setTimeout(r, POLL_MS));
+  }
+
+  if (solved) {
+    console.error("[shop-scraper] Captcha solved, closing browser...");
+  } else {
+    console.error("[shop-scraper] Timed out or browser closed, proceeding...");
+  }
+
+  await browser.close().catch(() => {});
+  return solved;
+}
+
+/**
+ * Fetch and parse a TikTok Shop product page.
+ * @param {string} url - TikTok Shop PDP URL
+ * @param {string} [proxyUrl] - Proxy URL, defaults to DEFAULT_PROXY from config
+ * @param {object} [options]
+ * @param {boolean} [options.captchaFallback] - If true, open browser for captcha when blocked
+ * @returns {Promise<{rating, reviewCount, soldCount, productName, ratingBreakdown, productId, sellerId}>}
+ */
+export async function getProductInfo(url, proxyUrl, options = {}) {
+  const proxy = proxyUrl || DEFAULT_PROXY;
+  const agent = proxy ? new ProxyAgent(proxy) : null;
+
+  let lastError;
+  for (let attempt = 1; attempt <= 3; attempt++) {
+    try {
+      const opts = {
+        headers: PDP_HEADERS,
+        ...(agent ? { dispatcher: agent } : {}),
+      };
+
+      const { body } = await request(url, opts);
+      const html = await body.text();
+
+      const data = parseProductHtml(html);
+      return data;
+    } catch (err) {
+      lastError = err;
+
+      // Captcha: try browser fallback if enabled
+      if (
+        err.message?.includes("Blocked by TikTok") &&
+        options.captchaFallback
+      ) {
+        console.error("[shop-scraper] Captcha hit, opening browser...");
+        await resolveCaptchaWithBrowser(url, proxy);
+        // Retry HTTP after captcha solved
+        attempt = 0; // reset counter for fresh retries
+        continue;
+      }
+
+      if (err.message?.includes("Blocked by TikTok")) throw err;
+
+      if (attempt < 3) {
+        const waitMs = Math.pow(2, attempt - 1) * 3000 + Math.random() * 2000;
+        await new Promise((r) => setTimeout(r, waitMs));
+      }
+    }
+  }
+
+  throw new Error(
+    `Failed to fetch ${url} (retried 3 times): ${lastError?.message}`,
+  );
+}
+
+/**
+ * Parse product data from TikTok Shop PDP HTML.
+ * @param {string} html
+ * @returns {{rating, reviewCount, soldCount, productName, ratingBreakdown, productId, sellerId}}
+ */
+export function parseProductHtml(html) {
+  // 只检测真正的验证码页面，避免 JS 源码中的 "captcha" 字符串误报
+  if (
+    html.includes("<title>Security Check</title>") ||
+    html.includes("captcha-verify-container")
+  ) {
+    throw new Error("Blocked by TikTok security check (captcha)");
+  }
+
+  const result = {
+    rating: null,
+    reviewCount: null,
+    soldCount: null,
+    productName: null,
+    ratingBreakdown: null,
+    productId: null,
+    sellerId: null,
+  };
+
+  // sold_count from product_model (string value, not shop-level integer)
+  const soldMatch = html.match(/"sold_count":"(\d+)"/);
+  if (soldMatch) result.soldCount = parseInt(soldMatch[1], 10);
+
+  // product_model section
+  const pmIdx = html.indexOf('"product_model"');
+  if (pmIdx > -1) {
+    const seg = html.substring(pmIdx);
+    const nameMatch = seg.match(/"name":"([^"]+)"/);
+    if (nameMatch) result.productName = nameMatch[1];
+
+    const pidMatch = seg.match(/"product_id":"(\d+)"/);
+    if (pidMatch) result.productId = pidMatch[1];
+
+    const sellerMatch = seg.match(/"seller_id":"(\d+)"/);
+    if (sellerMatch) result.sellerId = sellerMatch[1];
+  }
+
+  // review_ratings (nested JSON)
+  const ratings = extractJsonByKey(html, /"review_ratings"/);
+  if (ratings) {
+    result.rating = ratings.overall_score ?? null;
+    result.reviewCount = ratings.review_count
+      ? parseInt(ratings.review_count, 10)
+      : null;
+    result.ratingBreakdown = ratings.rating_result ?? null;
+  }
+
+  return result;
+}
+
+/**
+ * Fetch and parse a TikTok Shop product page via CDP browser.
+ * Use this when HTTP mode is blocked or no proxy is available.
+ * @param {import('playwright').Page} page - Playwright page from CDP browser
+ * @param {string} url - TikTok Shop PDP URL
+ * @returns {Promise<{rating, reviewCount, soldCount, productName, ratingBreakdown, productId, sellerId}>}
+ */
+export async function getProductInfoCDP(page, url) {
+  await page.goto(url, { waitUntil: "networkidle", timeout: 60000 });
+  // 等待 JS 渲染完成（CSR 页面需要）
+  await new Promise((r) => setTimeout(r, 3000));
+  const html = await page.content();
+  return parseProductHtml(html);
+}
+
+/**
+ * Format a count number to human-readable string (e.g. 99906 -> "99.9K")
+ */
+export function formatCount(n) {
+  if (n === null || n === undefined) return "N/A";
+  if (n >= 1e6) return (n / 1e6).toFixed(1).replace(/\.0$/, "") + "M";
+  if (n >= 1e3) return (n / 1e3).toFixed(1).replace(/\.0$/, "") + "K";
+  return String(n);
+}

package/src/scraper/explore-core.js

@@ -43,6 +43,7 @@ async function processExplore(page, username, options, log) {
     locationCreated: null,
     latestVideoTime: null,
     recentEcVideos: null,
+    productDetail: null,
     noVideo: false,
     restricted: false,
     error: null,
@@ -103,6 +104,9 @@ async function processExplore(page, username, options, log) {
         playCount: v.playCount,
         createTime: v.createTime,
         isAd: v.isAd,
+        productId: v.productId || null,
+        productTitle: v.productTitle || null,
+        seoUrl: v.seoUrl || null,
       }));
       const maxPlay = recentVideos.reduce(
         (max, v) => (v.playCount > max ? v.playCount : max),
@@ -119,7 +123,32 @@ async function processExplore(page, username, options, log) {
         playCount: topVideo.playCount,
         createTime: topVideo.createTime,
         isAd: topVideo.isAd,
+        productId: topVideo.productId || null,
+        productTitle: topVideo.productTitle || null,
+        seoUrl: topVideo.seoUrl || null,
       };
+
+      // 如果有商品链接，抓取商品详情页（评分、销量等）
+      if (topVideo.seoUrl && options.shopPage) {
+        try {
+          const { getProductInfoCDP } = await import("../lib/shop-scraper.mjs");
+          const shopUrl = topVideo.seoUrl.replace(
+            "www.tiktok.com/shop/pdp",
+            "shop.tiktok.com/us/pdp",
+          );
+
+          const productDetail = await getProductInfoCDP(
+            options.shopPage,
+            shopUrl,
+          );
+          result.productDetail = productDetail;
+          log(
+            `  商品详情: 评分${productDetail.rating ?? "-"} | 销量${productDetail.soldCount ?? "-"} | 评论${productDetail.reviewCount ?? "-"}`,
+          );
+        } catch (e) {
+          log(`  商品详情获取失败: ${e.message}`);
+        }
+      }
     }
 
     if (videoArray.length <= 0) {

package/src/watch/data-store.js

@@ -350,6 +350,8 @@ function getTargetUsersFromDb(targetLocations = []) {
           guessed_location, pinned, processed_at, video_count,
           no_video, claimed_by, claimed_at, created_at, updated_at,
           top_video_play_count, top_video_href, top_video_is_ad,
+          top_video_product_id, top_video_product_title, top_video_seo_url,
+          product_rating, product_review_count, product_sold_count, product_name,
           recent_ec_videos
         FROM jobs
         WHERE tt_seller = 1
@@ -433,6 +435,13 @@ function getTargetUsersByCountryFromDb(targetLocations = [], options = {}) {
         top_video_play_count,
         top_video_href,
         top_video_is_ad,
+        top_video_product_id,
+        top_video_product_title,
+        top_video_seo_url,
+        product_rating,
+        product_review_count,
+        product_sold_count,
+        product_name,
         recent_ec_videos,
         status,
         sources
@@ -1937,6 +1946,7 @@ export function createStore(filePath, options = {}) {
         "sources",
         "topRecentVideo", // 单独处理，不进入通用循环
         "recentEcVideos", // 单独处理，不进入通用循环
+        "productDetail", // 单独处理，不进入通用循环
       ];
       for (const key of Object.keys(result)) {
         if (extraFields.includes(key)) continue;
@@ -1953,6 +1963,16 @@ export function createStore(filePath, options = {}) {
         user.topVideoPlayCount = result.topRecentVideo.playCount || null;
         user.topVideoHref = result.topRecentVideo.href || null;
         user.topVideoIsAd = result.topRecentVideo.isAd ?? null;
+        user.topVideoProductId = result.topRecentVideo.productId || null;
+        user.topVideoProductTitle = result.topRecentVideo.productTitle || null;
+        user.topVideoSeoUrl = result.topRecentVideo.seoUrl || null;
+      }
+      // 存储商品详情（评分、销量等，来自 Shop PDP 抓取）
+      if (result.productDetail && typeof result.productDetail === "object") {
+        user.productRating = result.productDetail.rating ?? null;
+        user.productReviewCount = result.productDetail.reviewCount ?? null;
+        user.productSoldCount = result.productDetail.soldCount ?? null;
+        user.productName = result.productDetail.productName || null;
       }
       // 将 recentEcVideos 数组序列化为 JSON 字符串
       if (
@@ -2225,6 +2245,16 @@ export function createStore(filePath, options = {}) {
         user.topVideoPlayCount = result.topRecentVideo.playCount || null;
         user.topVideoHref = result.topRecentVideo.href || null;
         user.topVideoIsAd = result.topRecentVideo.isAd ?? null;
+        user.topVideoProductId = result.topRecentVideo.productId || null;
+        user.topVideoProductTitle = result.topRecentVideo.productTitle || null;
+        user.topVideoSeoUrl = result.topRecentVideo.seoUrl || null;
+      }
+      // 存储商品详情（评分、销量等，来自 Shop PDP 抓取）
+      if (result.productDetail && typeof result.productDetail === "object") {
+        user.productRating = result.productDetail.rating ?? null;
+        user.productReviewCount = result.productDetail.reviewCount ?? null;
+        user.productSoldCount = result.productDetail.soldCount ?? null;
+        user.productName = result.productDetail.productName || null;
       }
       // 将 recentEcVideos 数组序列化为 JSON 字符串
       if (
@@ -2260,6 +2290,16 @@ export function createStore(filePath, options = {}) {
       user.topVideoPlayCount = result.topRecentVideo.playCount || null;
       user.topVideoHref = result.topRecentVideo.href || null;
       user.topVideoIsAd = result.topRecentVideo.isAd ?? null;
+      user.topVideoProductId = result.topRecentVideo.productId || null;
+      user.topVideoProductTitle = result.topRecentVideo.productTitle || null;
+      user.topVideoSeoUrl = result.topRecentVideo.seoUrl || null;
+    }
+    // 存储商品详情（评分、销量等，来自 Shop PDP 抓取）
+    if (result.productDetail && typeof result.productDetail === "object") {
+      user.productRating = result.productDetail.rating ?? null;
+      user.productReviewCount = result.productDetail.reviewCount ?? null;
+      user.productSoldCount = result.productDetail.soldCount ?? null;
+      user.productName = result.productDetail.productName || null;
     }
     // 将 recentEcVideos 数组序列化为 JSON 字符串
     if (

package/src/watch/db-columns.js

@@ -91,6 +91,13 @@ export const WRITABLE_JOB_COLUMNS = new Set([
   "top_video_play_count",
   "top_video_href",
   "top_video_is_ad",
+  "top_video_product_id",
+  "top_video_product_title",
+  "top_video_seo_url",
+  "product_rating",
+  "product_review_count",
+  "product_sold_count",
+  "product_name",
   "user_create_time",
   "recent_ec_videos",
 ]);

package/src/watch/db-schema.js

@@ -128,6 +128,13 @@ export function initDb(filePath) {
     top_video_play_count: "INTEGER",
     top_video_href: "TEXT",
     top_video_is_ad: "INTEGER",
+    top_video_product_id: "TEXT",
+    top_video_product_title: "TEXT",
+    top_video_seo_url: "TEXT",
+    product_rating: "REAL",
+    product_review_count: "INTEGER",
+    product_sold_count: "INTEGER",
+    product_name: "TEXT",
     user_create_time: "INTEGER",
     recent_ec_videos: "TEXT",
   });
@@ -156,6 +163,13 @@ export function initDb(filePath) {
     top_video_play_count: "INTEGER",
     top_video_href: "TEXT",
     top_video_is_ad: "INTEGER",
+    top_video_product_id: "TEXT",
+    top_video_product_title: "TEXT",
+    top_video_seo_url: "TEXT",
+    product_rating: "REAL",
+    product_review_count: "INTEGER",
+    product_sold_count: "INTEGER",
+    product_name: "TEXT",
     user_create_time: "INTEGER",
     recent_ec_videos: "TEXT",
   });

package/src/watch/public/app.js

@@ -22,6 +22,22 @@ let currentSort = { key: null, asc: true };
 let prevStatValues = {};
 let prevUserMap = {};
 let prevTargetUsers = 0;
+let fireworksEnabled = true;
+
+// 初始化烟花开关状态（从 localStorage 读取，默认开启）
+(function initFireworkToggle() {
+  const saved = localStorage.getItem("fireworksEnabled");
+  if (saved !== null) {
+    fireworksEnabled = saved === "true";
+  }
+  const toggle = document.getElementById("fireworkToggle");
+  if (toggle) toggle.checked = fireworksEnabled;
+})();
+
+function toggleFireworks() {
+  fireworksEnabled = document.getElementById("fireworkToggle").checked;
+  localStorage.setItem("fireworksEnabled", fireworksEnabled);
+}
 
 async function fetchStats() {
   try {
@@ -163,9 +179,14 @@ function renderStats() {
   flashEl("statPending", d.pendingUsers);
   flashEl("statError", d.errorUsers);
   flashEl("statTarget", d.targetUsers, { full: true });
-  // 检测目标商家新增，放烟花（仅首页）
+  // 检测目标商家新增，放烟花（仅首页，且开关开启时）
   const hash = window.location.hash.replace(/^#/, "");
-  if (!hash && prevTargetUsers > 0 && d.targetUsers > prevTargetUsers) {
+  if (
+    !hash &&
+    fireworksEnabled &&
+    prevTargetUsers > 0 &&
+    d.targetUsers > prevTargetUsers
+  ) {
     const diff = d.targetUsers - prevTargetUsers;
     triggerFirework(diff);
   }
@@ -2403,7 +2424,11 @@ function renderTargetTable() {
           .sort((a, b) => b.playCount - a.playCount)
           .map((v) => {
             const adTag = v.isAd ? ' <span style="color:red">(AD)</span>' : "";
-            return `<a href="${v.href}" target="_blank" style="color:#3b82f6;text-decoration:none;display:block;line-height:1.6" title="点击查看视频">${formatNum(v.playCount)}${adTag}</a>`;
+            // 商品标识：有 productId 则显示 [有商品] 链接
+            const productTag = v.productId
+              ? ` <a href="${v.seoUrl || "#"}" target="_blank" style="color:#22c55e;text-decoration:none;font-size:10px" title="商品: ${v.productTitle || ""}&#10;销量: ${formatNum(u.productSoldCount || 0)}&#10;评论: ${formatNum(u.productReviewCount || 0)}&#10;评分: ${u.productRating != null ? "★".repeat(Math.round(u.productRating)) + " " + u.productRating : "-"}">[有商品]</a>`
+              : "";
+            return `<span style="display:block;line-height:1.6"><a href="${v.href}" target="_blank" style="color:#3b82f6;text-decoration:none" title="点击查看视频">${formatNum(v.playCount)}${adTag}</a>${productTag}</span>`;
           })
           .join("");
         topPlayCountCell = `<td data-label="最大播放量" style="font-size:11px;color:#888">${videoLinks}</td>`;

package/src/watch/public/index.html

@@ -16,6 +16,10 @@
     <div style="display:flex;gap:8px;align-items:center">
       <a href="/scripts/run-explore.sh" class="script-link" download="run-explore.sh">mac</a>
       <a href="/scripts/run-explore.bat" class="script-link" download="run-explore.bat">windows</a>
+      <label class="firework-toggle" title="切换烟花动画">
+        <input type="checkbox" id="fireworkToggle" checked onchange="toggleFireworks()">
+        <span>🎆</span>
+      </label>
       <a class="script-link" onclick="navigateToSettings()" style="cursor:pointer">⚙️ LLM</a>
       <span class="status" id="lastUpdate">--</span>
     </div>

package/src/watch/public/style.css

@@ -1629,6 +1629,27 @@ td.user-id:hover {
   accent-color: #a78bfa;
 }
 
+/* ========== 烟花开关 ========== */
+.firework-toggle {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  cursor: pointer;
+  font-size: 16px;
+  user-select: none;
+  opacity: 0.7;
+  transition: opacity 0.2s;
+}
+.firework-toggle:hover {
+  opacity: 1;
+}
+.firework-toggle input[type="checkbox"] {
+  accent-color: #fe2c55;
+  width: 14px;
+  height: 14px;
+  cursor: pointer;
+}
+
 /* ========== 烟花画布 ========== */
 #fireworkCanvas {
   position: fixed;

package/src/watch/server.js

@@ -1112,8 +1112,15 @@ export function startWatchServer(
             topVideoPlayCount: u.topVideoPlayCount || null,
             topVideoHref: u.topVideoHref || null,
             topVideoIsAd: u.topVideoIsAd ?? null,
+            topVideoProductId: u.topVideoProductId || null,
+            topVideoProductTitle: u.topVideoProductTitle || null,
+            topVideoSeoUrl: u.topVideoSeoUrl || null,
             recentEcVideos: u.recentEcVideos || null,
             latestVideoTime: u.latestVideoTime || null,
+            productRating: u.productRating ?? null,
+            productReviewCount: u.productReviewCount ?? null,
+            productSoldCount: u.productSoldCount ?? null,
+            productName: u.productName || null,
           }));
           sendJSON(res, 200, { total: targets.length, users });
         }