tt-help-cli-ycl 1.3.95 → 1.3.96

package/package.json

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

package/src/cli/tag.js

@@ -9,6 +9,7 @@ import {
   DEFAULT_TARGET_LOCATIONS,
   isLocationInList,
 } from "../lib/target-locations.js";
+import { delay as randomDelay } from "../lib/delay.js";
 import { discoverTags } from "../lib/tag-discover.js";
 import {
   server as cfgServer,
@@ -121,13 +122,13 @@ async function processTag(
       port: port || 9222,
       onProgress: ({ videos, authors }) => {
         process.stderr.write(
-          `\r${prefix} #${tag}: ${videos} 视频, ${authors} 作者`,
+          `\r${prefix} #${tag}: ${videos} 视频, ${authors} 作者\x1b[K`,
         );
       },
     });
 
     process.stderr.write(
-      `\r${prefix} #${tag}: ${result.videoCount} 视频, ${result.uniqueAuthorCount} 作者`,
+      `\r${prefix} #${tag}: ${result.videoCount} 视频, ${result.uniqueAuthorCount} 作者\x1b[K`,
     );
 
     let videos = result.videos;
@@ -154,7 +155,7 @@ async function processTag(
             locationCreated &&
             isLocationInList(locationCreated, targetLocations);
           process.stderr.write(
-            `\r  [${done}/${total}] ${label} → ${loc}${hit ? " ✓" : ""}`,
+            `\r  [${done}/${total}] ${label} → ${loc}${hit ? " ✓" : ""}\x1b[K`,
           );
         },
       });
@@ -295,8 +296,8 @@ async function scoreSingleTag(
   { baseUrl, cdpPort, targetCountries, effectiveProxy },
 ) {
   const log = (...args) => process.stderr.write(args.join(" ") + "\n");
-  const progress = (msg) => process.stderr.write(`\r  ${msg}`);
-  const clearLine = () => process.stderr.write("\r" + " ".repeat(80) + "\r");
+  const progress = (msg) => process.stderr.write(`\r  ${msg}\x1b[K`);
+  const clearLine = () => process.stderr.write("\r\x1b[K");
 
   const startTime = Date.now();
 
@@ -613,7 +614,7 @@ export async function handleScoreAll(parsed) {
   const cdpOpts = { port: cdpPort };
   if (effectiveProxy) cdpOpts.proxyServer = effectiveProxy;
   const browser = await ensureBrowserReady(cdpOpts);
-  const page = await getOrCreatePage(browser);
+  let page = await getOrCreatePage(browser);
 
   let totalScored = 0;
   let emptyRounds = 0; // 连续无任务的轮数
@@ -633,6 +634,15 @@ export async function handleScoreAll(parsed) {
   log(`  客户端 ID: ${clientId.substring(0, 8)}...`);
   log("");
 
+  // Ctrl+C 时关闭浏览器和 scraper
+  const cleanup = () => {
+    log("\n正在清理资源...");
+    enrichScraper.close().catch(() => {});
+    killEdgeProcesses(null, cdpPort);
+    process.exit(0);
+  };
+  process.on("SIGINT", cleanup);
+
   try {
     while (true) {
       try {
@@ -724,11 +734,13 @@ export async function handleScoreAll(parsed) {
         const tagResult = await fetchTagData(tag, {
           port: cdpPort,
           onProgress: ({ videos, authors }) => {
-            process.stderr.write(`\r  抓取中: ${videos} 视频, ${authors} 作者`);
+            process.stderr.write(
+              `\r  抓取中: ${videos} 视频, ${authors} 作者\x1b[K`,
+            );
           },
         });
         log(
-          `\r  完成: ${tagResult.videoCount} 视频, ${tagResult.uniqueAuthorCount} 作者`,
+          `\r  完成: ${tagResult.videoCount} 视频, ${tagResult.uniqueAuthorCount} 作者\x1b[K`,
         );
 
         result.totalPosts = tagResult.totalPosts || 0;
@@ -751,7 +763,7 @@ export async function handleScoreAll(parsed) {
           onProgress: ({ done, total, current, locationCreated }) => {
             if (done % 10 === 0 || done === total) {
               process.stderr.write(
-                `\r    [${done}/${total}] ${current.split("/").pop().slice(0, 20)} → ${locationCreated || "-"}`,
+                `\r    [${done}/${total}] ${current.split("/").pop().slice(0, 20)} → ${locationCreated || "-"}\x1b[K`,
               );
             }
           },
@@ -799,6 +811,19 @@ export async function handleScoreAll(parsed) {
           `  ${icon} ${result.status} score=${result.score} authors=${result.authorCount} matched=${result.matchedAuthors} (${elapsed}s)${mc ? "  " + mc : ""}`,
         );
         log("");
+
+        // 随机等待 3-7 秒，避免连续访问 TikTok 触发风控
+        await randomDelay(3000, 7000);
+
+        // 每打 200 个 tag 重建一次 page，释放浏览器内存
+        if (totalScored % 200 === 0) {
+          log(`🔄 已打 ${totalScored} 个标签，重建页面释放内存...`);
+          try {
+            await page.close();
+          } catch {}
+          page = await getOrCreatePage(browser);
+          log("✅ 页面已重建");
+        }
       } catch (e) {
         // 区分网络错误和业务错误
         const isNetworkError =

package/src/lib/api-interceptor.js

@@ -23,6 +23,7 @@ async function processAPIResponse(
       href,
       createTime: item.createTime || null,
       playCount: item.stats?.playCount || 0,
+      isECVideo: item.isECVideo ? 1 : 0,
     });
   }
 
@@ -72,6 +73,7 @@ async function processAPIResponse(
             href,
             createTime: item.createTime || null,
             playCount: item.stats?.playCount || 0,
+            isECVideo: item.isECVideo ? 1 : 0,
           });
         }
       }

package/src/lib/tag-fetcher.js

@@ -56,43 +56,45 @@ export async function fetchTagData(tag, options = {}) {
   const browser = await ensureBrowserReady(cdpOptions);
   const page = await getOrCreatePage(browser);
 
-  try {
-    let challengeInfo = null;
-    const rawVideos = [];
-    const seenVideoIds = new Set();
-    const authors = new Set();
-
-    page.on("response", async (resp) => {
-      try {
-        const url = resp.url();
-        const ct = resp.headers()["content-type"] || "";
-
-        if (url.includes("/api/challenge/detail/") && ct.includes("json")) {
-          const body = await resp.json();
-          if (body?.challengeInfo?.challenge) {
-            challengeInfo = body.challengeInfo.challenge;
-          }
+  let challengeInfo = null;
+  const rawVideos = [];
+  const seenVideoIds = new Set();
+  const authors = new Set();
+
+  const responseHandler = async (resp) => {
+    try {
+      const url = resp.url();
+      const ct = resp.headers()["content-type"] || "";
+
+      if (url.includes("/api/challenge/detail/") && ct.includes("json")) {
+        const body = await resp.json();
+        if (body?.challengeInfo?.challenge) {
+          challengeInfo = body.challengeInfo.challenge;
         }
+      }
 
-        if (url.includes("/api/challenge/item_list/") && ct.includes("json")) {
-          const body = await resp.json();
-          if (!body?.itemList) return;
-          for (const item of body.itemList) {
-            const vid = item.id || "";
-            if (vid && !seenVideoIds.has(vid)) {
-              seenVideoIds.add(vid);
-              const uid = item.author?.uniqueId || "";
-              if (uid) authors.add(uid);
-              rawVideos.push(extractItemData(item));
-            }
-          }
-          if (onProgress) {
-            onProgress({ videos: rawVideos.length, authors: authors.size });
+      if (url.includes("/api/challenge/item_list/") && ct.includes("json")) {
+        const body = await resp.json();
+        if (!body?.itemList) return;
+        for (const item of body.itemList) {
+          const vid = item.id || "";
+          if (vid && !seenVideoIds.has(vid)) {
+            seenVideoIds.add(vid);
+            const uid = item.author?.uniqueId || "";
+            if (uid) authors.add(uid);
+            rawVideos.push(extractItemData(item));
           }
         }
-      } catch {}
-    });
+        if (onProgress) {
+          onProgress({ videos: rawVideos.length, authors: authors.size });
+        }
+      }
+    } catch {}
+  };
 
+  page.on("response", responseHandler);
+
+  try {
     const tagUrl = `${TAG_URL}/${encodeURIComponent(tag)}`;
     const resp = await page.goto(tagUrl, {
       waitUntil: "domcontentloaded",
@@ -185,7 +187,7 @@ export async function fetchTagData(tag, options = {}) {
       uniqueAuthors: [...authors],
     };
   } finally {
-    // 不关闭 page 和 browser，由用户自行关闭
+    page.off("response", responseHandler);
   }
 }
 

package/src/scraper/explore-core.js

@@ -87,11 +87,14 @@ async function processExplore(page, username, options, log) {
       if (result.userInfo) result.userInfo.latestVideoTime = latestCreateTime;
     }
 
-    // 找出 7 天内发布且播放量最大的视频
+    // 找出 7 天内发布且 isECVideo=1 且播放量最大的视频
     const SEVEN_DAYS_SECONDS = 7 * 24 * 60 * 60;
     const nowSeconds = Math.floor(Date.now() / 1000);
     const recentVideos = videoArray.filter(
-      (v) => v.createTime && nowSeconds - v.createTime <= SEVEN_DAYS_SECONDS,
+      (v) =>
+        v.isECVideo === 1 &&
+        v.createTime &&
+        nowSeconds - v.createTime <= SEVEN_DAYS_SECONDS,
     );
     if (recentVideos.length > 0) {
       const topVideo = recentVideos.reduce((max, v) =>
@@ -104,7 +107,7 @@ async function processExplore(page, username, options, log) {
         createTime: topVideo.createTime,
       };
       log(
-        `  7天内最高播放视频: ${topVideo.playCount} 次播放 (${recentVideos.length} 个候选)`,
+        `  7天内 EC视频最高播放: ${topVideo.playCount} 次播放 (${recentVideos.length} 个EC候选)`,
       );
     }
 

package/src/watch/data-store.js

@@ -90,6 +90,7 @@ import {
   getDeadTags,
   claimTag,
   reportTagScore,
+  resetStaleScoringTags,
   getAllTags,
   rawQuery,
   normalizeTags,
@@ -2674,6 +2675,30 @@ export function createStore(filePath, options = {}) {
     return { ok: true, location, modifiedAt: user.modifiedAt };
   }
 
+  function setNonSeller(uniqueId) {
+    if (getDb()) {
+      const existing = getDb()
+        .prepare("SELECT * FROM jobs WHERE unique_id = ?")
+        .get(uniqueId);
+      if (!existing) return { error: "user not found" };
+      const now = Date.now();
+      getDb()
+        .prepare(
+          "UPDATE jobs SET tt_seller = 0, updated_at = ? WHERE unique_id = ?",
+        )
+        .run(now, uniqueId);
+      console.error(`[DB] setNonSeller: ${uniqueId} → tt_seller=0`);
+      return { ok: true };
+    }
+
+    const user = getUser(uniqueId);
+    if (!user) return { error: "user not found" };
+    user.ttSeller = false;
+    user.updatedAt = Date.now();
+    save();
+    return { ok: true };
+  }
+
   // 将单个 job 移动到 raw_jobs 表（完整字段复制 + 删除原记录）
   function moveJobToRaw(uniqueId) {
     if (!getDb()) return false;
@@ -3127,6 +3152,7 @@ export function createStore(filePath, options = {}) {
     getPendingUserUpdateTasks,
     updateUserInfo,
     updateUserLocation,
+    setNonSeller,
     batchUpdateUserInfo,
     reportClientError,
     deleteClientError,
@@ -3154,6 +3180,7 @@ export function createStore(filePath, options = {}) {
     getDeadTags,
     claimTag,
     reportTagScore,
+    resetStaleScoringTags,
     getAllTags,
     normalizeTags,
     clearTags,

package/src/watch/db-tags.js

@@ -64,12 +64,33 @@ export function getDeadTags(country) {
   return rows.map(parseTagRow).filter((r) => r.countries.includes(country));
 }
 
+export function resetStaleScoringTags(minutes = 30) {
+  const db = getDb();
+  if (!db) return { ok: false, error: "db not ready" };
+  // 清理超时的 scoring 标签：有时间戳的按时间，没时间戳的（旧数据）直接清
+  const result = db
+    .prepare(
+      "UPDATE tags SET status = 'new', scored_at = NULL WHERE status = 'scoring' AND (scored_at IS NULL OR scored_at < datetime('now', ?))",
+    )
+    .run(`-${minutes} minutes`);
+  if (result.changes > 0) {
+    console.error(
+      `[tags] 清理了 ${result.changes} 个超时 scoring 标签（>${minutes}分钟）`,
+    );
+  }
+  return { ok: true, reset: result.changes };
+}
+
 export function claimTag(tag) {
   const db = getDb();
   if (!db) return { ok: false, error: "db not ready" };
+
+  // 先清理超时的 scoring 标签，防止死任务堆积
+  resetStaleScoringTags();
+
   const result = db
     .prepare(
-      "UPDATE tags SET status = 'scoring' WHERE tag = ? AND status = 'new'",
+      "UPDATE tags SET status = 'scoring', scored_at = datetime('now') WHERE tag = ? AND status = 'new'",
     )
     .run(tag);
   if (result.changes === 0) {

package/src/watch/public/app.js

@@ -659,16 +659,21 @@ function openLocationModal(uniqueId, currentLocation) {
   overlay = document.createElement("div");
   overlay.id = "locationModalOverlay";
   overlay.className = "modal-overlay";
+  const safeId = escapeJsString(uniqueId);
   const options = TARGET_LOCATIONS.map(
     (loc) =>
-      `<button class="loc-option ${loc === currentLocation ? "active" : ""}" onclick="selectLocation('${uniqueId}','${loc}')">${loc}</button>`,
+      `<button class="loc-option ${loc === currentLocation ? "active" : ""}" onclick="selectLocation('${safeId}','${loc}')">${loc}</button>`,
   ).join("");
   overlay.innerHTML = `
     <div class="modal" style="max-width:420px">
       <h3>修改用户国家</h3>
-      <div class="hint">用户: @${uniqueId}，当前国家: ${currentLocation}</div>
+      <div class="hint">用户: @${safeId}，当前国家: ${currentLocation}</div>
       <div class="loc-grid">${options}</div>
-      <div class="btn-row" style="margin-top:16px">
+      <div class="custom-loc-row">
+        <input type="text" id="customLocationInput" class="custom-loc-input" placeholder="或手动输入国家代码，如 UK" maxlength="10" onkeydown="if(event.key==='Enter')confirmCustomLocation('${safeId}')">
+      </div>
+      <div class="btn-row" style="margin-top:12px">
+        <button class="btn-submit" onclick="confirmCustomLocation('${safeId}')">确认</button>
         <button class="btn-cancel" onclick="closeLocationModal()">取消</button>
       </div>
     </div>
@@ -677,6 +682,21 @@ function openLocationModal(uniqueId, currentLocation) {
   overlay.addEventListener("click", (e) => {
     if (e.target === overlay) closeLocationModal();
   });
+  // 自动聚焦输入框
+  setTimeout(() => {
+    const input = document.getElementById("customLocationInput");
+    if (input) input.focus();
+  }, 100);
+}
+
+function confirmCustomLocation(uniqueId) {
+  const input = document.getElementById("customLocationInput");
+  const val = input ? input.value.trim().toUpperCase() : "";
+  if (!val) {
+    showToast("请输入国家代码", true);
+    return;
+  }
+  selectLocation(uniqueId, val);
 }
 
 function closeLocationModal() {
@@ -726,6 +746,56 @@ async function selectLocation(uniqueId, location) {
   }
 }
 
+async function confirmNonSeller(uniqueId) {
+  if (
+    !confirm(
+      `确定要将 @${uniqueId} 标记为非商家吗？\n这将把 ta 的商家标识(ttSeller)设为 false。`,
+    )
+  ) {
+    return;
+  }
+  showLoading("正在更新...");
+  try {
+    const res = await fetch(
+      `/api/user-non-seller/${encodeURIComponent(uniqueId)}`,
+      {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+      },
+    );
+    const data = await res.json();
+    if (data.error) {
+      showToast(data.error, true);
+      return;
+    }
+    showToast(`@${uniqueId} 已标记为非商家`);
+
+    // 从当前列表中移除该用户
+    currentTargetUsers = currentTargetUsers.filter(
+      (u) => u.uniqueId !== uniqueId,
+    );
+    currentTargetTotal = Math.max(0, currentTargetTotal - 1);
+    renderTargetTable();
+
+    // 同时更新统计数据
+    const statEl = document.getElementById("targetPageStatTotal");
+    if (statEl)
+      statEl.textContent = formatStatNum(currentTargetTotal, { full: true });
+    // 更新主页面统计
+    if (currentStats) {
+      currentStats.targetUsers = Math.max(
+        0,
+        (currentStats.targetUsers || 0) - 1,
+      );
+      flashEl("statTarget", currentStats.targetUsers, { full: true });
+    }
+  } catch (e) {
+    showToast("更新失败: " + e.message, true);
+  } finally {
+    hideLoading();
+  }
+}
+
 async function submitAddUsers() {
   const ta = document.getElementById("modalUserInput");
   const raw = ta.value.trim();
@@ -1209,7 +1279,7 @@ function renderTargetTable() {
 
   if (displayUsers.length === 0) {
     el.innerHTML =
-      '<tr><td colspan="10" style="text-align:center;color:#888;padding:24px">暂无数据</td></tr>';
+      '<tr><td colspan="11" style="text-align:center;color:#888;padding:24px">暂无数据</td></tr>';
     if (moreHint) {
       moreHint.style.display = "none";
     }
@@ -1224,11 +1294,14 @@ function renderTargetTable() {
       const fans = u.followerCount != null ? formatNum(u.followerCount) : "-";
       const videos = u.videoCount != null ? u.videoCount : "-";
       const userLocation = u.locationCreated || "-";
-      const confirmedLocation = u.confirmedLocation
-        ? u.confirmedLocation === u.locationCreated
-          ? `<span style="color:#22c55e">${u.confirmedLocation} ✓</span>`
-          : `<span style="color:#ef4444">${u.confirmedLocation} ✗</span>`
-        : "-";
+      // 如果用户手工修改过国家，确认国家列显示"已修正"
+      const confirmedLocation = u.modifiedAt
+        ? `<span style="color:#f59e0b;font-weight:600">已修正</span>`
+        : u.confirmedLocation
+          ? u.confirmedLocation === u.locationCreated
+            ? `<span style="color:#22c55e">${u.confirmedLocation} ✓</span>`
+            : `<span style="color:#ef4444">${u.confirmedLocation} ✗</span>`
+          : "-";
       const latestVideo = u.latestVideoTime
         ? formatTime(u.latestVideoTime * 1000)
         : "-";
@@ -1270,6 +1343,9 @@ function renderTargetTable() {
       ${topPlayCountCell}
       <td data-label="最近发布" style="font-size:11px;color:#888">${latestVideo}</td>
       <td data-label="最近刷新" style="font-size:11px;color:#888">${refreshTime}</td>
+      <td data-label="操作">
+        <button class="btn-non-seller" onclick="confirmNonSeller('${escapeJsString(u.uniqueId)}')" title="将此用户标记为非商家">设为非商家</button>
+      </td>
     </tr>`;
     })
     .join("");

package/src/watch/public/index.html

@@ -351,6 +351,7 @@
                 <th class="sortable-target" data-sort="topVideoPlayCount">最大播放量 <span class="sort-icon">↕</span></th>
                 <th class="sortable-target" data-sort="latestVideoTime">最近发布 <span class="sort-icon">↕</span></th>
                 <th>最近刷新</th>
+                <th>操作</th>
               </tr>
             </thead>
             <tbody id="targetTable"></tbody>

package/src/watch/public/style.css

@@ -1389,3 +1389,53 @@ td.user-id:hover {
     height: 140px;
   }
 }
+
+/* 自定义国家输入行 */
+.custom-loc-row {
+  margin-top: 12px;
+}
+
+.custom-loc-input {
+  width: 100%;
+  padding: 10px 12px;
+  border: 1px solid #333;
+  border-radius: 6px;
+  background: #0f0f13;
+  color: #e0e0e0;
+  font-size: 13px;
+  font-weight: 600;
+  outline: none;
+  text-transform: uppercase;
+  transition: border-color 0.15s;
+  box-sizing: border-box;
+}
+
+.custom-loc-input:focus {
+  border-color: #a78bfa;
+}
+
+.custom-loc-input::placeholder {
+  color: #555;
+  font-weight: 400;
+  text-transform: none;
+}
+
+/* 非商家按钮 */
+.btn-non-seller {
+  padding: 4px 10px;
+  border: 1px solid #f87171;
+  border-radius: 4px;
+  background: transparent;
+  color: #f87171;
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.15s;
+  white-space: nowrap;
+}
+
+.btn-non-seller:hover {
+  background: rgba(248, 113, 113, 0.12);
+  border-color: #ef4444;
+  color: #ef4444;
+}

package/src/watch/server.js

@@ -561,6 +561,26 @@ export function startWatchServer(
         return;
       }
 
+      const nonSellerMatch = routePath.match(
+        /^\/api\/user-non-seller\/([^/]+)$/,
+      );
+      if (req.method === "PUT" && nonSellerMatch) {
+        const uniqueId = nonSellerMatch[1];
+        try {
+          const ret = store.setNonSeller(uniqueId);
+          if (ret.error) {
+            sendJSON(res, 404, { error: ret.error });
+            return;
+          }
+          const ts = new Date().toISOString().slice(11, 19);
+          console.error(`[JOB ${ts}] NON-SELLER: ${uniqueId} → ttSeller=false`);
+          sendJSON(res, 200, ret);
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
       if (req.method === "GET" && routePath === "/api/comment-tasks") {
         const limit = parseInt(params.limit) || 1;
         const tasks = store.getPendingCommentTasks(limit);
@@ -1266,6 +1286,22 @@ export function startWatchServer(
       console.error(`Watch 监控服务已启动:`);
       console.error(`  本地访问: http://127.0.0.1:${port}`);
       console.error(`  局域网访问: http://${localIP}:${port}`);
+
+      // 启动时清理超时的 scoring 标签
+      try {
+        const { resetStaleScoringTags } = store;
+        if (resetStaleScoringTags) {
+          const result = resetStaleScoringTags(30);
+          if (result.reset > 0) {
+            console.error(
+              `[启动] 已重置 ${result.reset} 个超时的 scoring 标签`,
+            );
+          }
+        }
+      } catch (e) {
+        console.error(`[启动] 清理 scoring 标签失败: ${e.message}`);
+      }
+
       _resolve({ server, port });
     });
 

package/src/watch/tag-service.js

@@ -45,7 +45,7 @@ export async function callLLM(prompt) {
       model: LLM_MODEL,
       messages: [{ role: "user", content: prompt }],
       max_tokens: 1024,
-      temperature: 0.7,
+      temperature: 0.3,
     }),
   });
 
@@ -163,7 +163,7 @@ export function buildDiscoverPrompt(
           .map((t) => `${t.tag}(score:${Math.round(t.score)})`)
           .join(
             ", ",
-          )}. These are examples of what works — explore DIFFERENT directions, not variations of these.`
+          )}. Use these as reference for the STYLE and TYPE of tag that works — prefer commonly used words like these.`
       : "";
 
   // 负样本：该国 dead tag
@@ -186,7 +186,7 @@ export function buildDiscoverPrompt(
   const allExisting = history.allExisting || [];
   const existingHint =
     allExisting.length > 0
-      ? `\nTags already in database (DO NOT generate these again): ${allExisting.slice(-50).join(", ")}.`
+      ? `\nTags already in database (DO NOT generate these again): ${allExisting.slice(0, 50).join(", ")}.`
       : "";
 
   const userHint = userPrompt
@@ -210,39 +210,60 @@ Based on the above, which strategies produced high-scoring tags? Which failed?
 Use this analysis to decide your strategy for this round.`;
   }
 
+  const deadRatio =
+    history.dead.length > 0 && history.productive.length > 0
+      ? (
+          (history.dead.length /
+            (history.dead.length + history.productive.length)) *
+          100
+        ).toFixed(0)
+      : null;
+  const qualityWarning =
+    deadRatio && Number(deadRatio) > 40
+      ? `\n⚠️ WARNING: Currently ${deadRatio}% of our generated tags fail (no real TikTok posts). This is critically high. You MUST be more conservative — only suggest hashtags you have HIGH CONFIDENCE actually exist on TikTok.`
+      : "";
+
   return `You are discovering TikTok hashtags used by people who sell things in ${country}.
 
-Your goal: Find hashtags that real sellers in ${country} actually use — any kind of tag they might use. Think broadly:
-- Who they are (seller, shop owner, entrepreneur, artisan...)
-- What they sell (shoes, clothes, jewelry, food, pets, furniture...)
-- How they sell (online, handmade, second-hand, local pickup...)
-- Product-specific tags (sneakers, dresses, cakes, necklaces...)
-- Niche categories: beauty, fitness, pets, plants, books, toys, music, art, photography, gardening, DIY, automotive, real estate...
+⛔ CRITICAL RULE: ONLY suggest hashtags that you are CONFIDENT actually exist on TikTok with real posts.
+Never invent, construct, or guess compound words. If you aren't sure a hashtag is real, DO NOT suggest it.
+
+✅ Good examples of REAL TikTok hashtags:
+  - Simple, common words: "verkaufen", "handmade", "secondhand", "bakery", "vintage"
+  - Common category tags: "shoplocal", "onlineshopping", "handwerker", "trödel"
+  - Established brand/community tags: "smallbusiness", "supportlocal", "vendita"
+❌ BAD examples (INVENTED, will fail):
+  - Novel compound words: "sourdoughschaleverkauf", "predavamdruhouseoblečenípraha"
+  - Hyper-specific location+product: "dublinvintagelamp", "canalistalisboa"
+  - Rare technical terms: "briefmarkensammlungankauf", "aquascapingzubehör"
+  - Underscore-connected constructs: "mtg_cardhu", "epoxigyanta_alkotás_eladó"
+
+Think about the MOST COMMON hashtags that real sellers in ${country} use on TikTok:
+- Common selling verbs in ${langName} (sell, buy, offer, clearance...)
+- Common product categories in ${langName} (shoes, clothes, furniture, food, pets...)
+- Common seller identities (shop, boutique, small business, creator...)
+- Well-known community tags (support local, marketplace, second round...)
 
-All tags must be in ${langName} language (or widely used in ${country}).
-Generate ${count} tags that are ALL DIFFERENT from each other and from any existing tags.${productiveHint}${deadHint}${errorHint}${existingHint}${userHint}${strategyReview}
+${qualityWarning}${productiveHint}${deadHint}${errorHint}${existingHint}${userHint}${strategyReview}
 
-## IMPORTANT: Think first, then generate
+## Quality check before responding
 
-Before generating tags, analyze:
-1. Which tag directions scored highest? What makes them work?
-2. Which directions completely failed? Why?
-3. What seller niches are NOT yet covered? (e.g., if we have "shop" but no "bakery", "petstore", "bookshop"...)
-4. What specific direction will YOU explore this round? Be concrete.
+For each tag you consider, ask yourself: "Have I actually seen this hashtag used on TikTok, or am I just translating a concept?" If you're translating/constructing — DON'T include it. Only include if you're genuinely confident it's a real, used hashtag.
 
 ## Output format
 
 Return ONLY a JSON object with two fields:
 {
-  "strategy": "Your analysis and plan for this round (2-4 sentences). Explain what direction you're exploring and why.",
+  "strategy": "Your analysis (2-3 sentences). Acknowledge what worked/failed before and explain why your chosen tags are likely real and commonly used.",
   "tags": ["tag1", "tag2", "tag3", "tag4"]
 }
 
 Rules:
-- Each tag should explore a DIFFERENT angle — don't just swap country suffixes
-- Prefer specific and niche tags over generic ones (e.g., "vendozapatos" beats "vender")
-- Do NOT generate tags that already exist
-- Your strategy should be different from previous rounds — if a direction worked, go deeper; if it failed, try something new`;
+- QUALITY over creativity — 3 real, commonly used tags beat 4 invented ones
+- NEVER invent compound words or translate concepts into hashtags
+- Prefer simpler, more common tags over hyper-specific ones
+- Look for tags with broad appeal (many potential posters)
+- Do NOT generate tags that already exist`;
 }
 
 // ====== discover: 单国家标签发现 ======