tt-help-cli-ycl 1.4.142 → 1.4.145

package/src/watch/public/app.js

@@ -185,6 +185,7 @@ function renderStats() {
   flashEl("statPending", d.pendingUsers);
   flashEl("statError", d.errorUsers);
   flashEl("statTarget", d.targetUsers, { full: true });
+  flashEl("statPrecise", d.preciseMerchants, { full: true });
   // 检测目标商家新增，放烟花（仅首页，且开关开启时）
   const hash = window.location.hash.replace(/^#/, "");
   if (
@@ -683,7 +684,7 @@ function closeAddModal() {
 
 // ========== 国家修改模态框 ==========
 
-const TARGET_LOCATIONS = [
+const DEFAULT_LOCATION_OPTIONS = [
   "AT",
   "BE",
   "CZ",
@@ -697,19 +698,35 @@ const TARGET_LOCATIONS = [
   "NL",
   "PL",
   "PT",
+  "TH",
+  "US",
 ];
+let locationOptions = [...DEFAULT_LOCATION_OPTIONS];
 
-function openLocationModal(uniqueId, currentLocation) {
+async function openLocationModal(uniqueId, currentLocation) {
   let overlay = document.getElementById("locationModalOverlay");
   if (overlay) return;
+  // 优先使用服务端配置的目标国家作为候选，失败则回退默认
+  try {
+    const res = await fetch("/api/settings/target-locations");
+    const data = await res.json();
+    const locs = (data.locations || []).filter(Boolean);
+    if (locs.length) {
+      locationOptions = [...new Set([...locs, ...DEFAULT_LOCATION_OPTIONS])];
+    }
+  } catch {
+    locationOptions = [...DEFAULT_LOCATION_OPTIONS];
+  }
   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('${safeId}','${loc}')">${loc}</button>`,
-  ).join("");
+  const options = locationOptions
+    .map(
+      (loc) =>
+        `<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>
@@ -1121,6 +1138,10 @@ document.getElementById("statTargetCard").addEventListener("click", () => {
   navigateToTarget();
 });
 
+document.getElementById("statPreciseCard").addEventListener("click", () => {
+  navigateToPrecise();
+});
+
 // Hash 路由
 window.addEventListener("hashchange", handleRoute);
 window.addEventListener("DOMContentLoaded", handleRoute);
@@ -1274,6 +1295,8 @@ function handleRoute() {
     showRawPage();
   } else if (hash === "#target") {
     showTargetPage();
+  } else if (hash === "#precise") {
+    showPrecisePage();
   } else if (hash === "#tags") {
     showTagsPage();
   } else if (hash === "#settings") {
@@ -1307,6 +1330,7 @@ function showPendingPage() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   fetchPendingByCountry();
@@ -1319,6 +1343,7 @@ function showUserUpdatePage() {
   document.getElementById("userUpdatePage").classList.add("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   fetchUserUpdateByCountry();
@@ -1338,6 +1363,7 @@ function showRawPage() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.add("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   fetchRawByCountry();
@@ -1350,6 +1376,7 @@ function showMainPage() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   document.getElementById("watchdogPage").classList.remove("active");
@@ -1363,6 +1390,10 @@ function navigateToTarget() {
   window.location.hash = "#target";
 }
 
+function navigateToPrecise() {
+  window.location.hash = "#precise";
+}
+
 function navigateToTags() {
   window.location.hash = "#tags";
 }
@@ -1383,6 +1414,7 @@ function hideAllPages() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   document.getElementById("watchdogPage").classList.remove("active");
@@ -1392,6 +1424,157 @@ function showSettingsPage() {
   hideAllPages();
   document.getElementById("settingsPage").classList.add("active");
   fetchLlmConfig();
+  loadTargetLocations();
+}
+
+// ========== 目标国家配置（通用 app-config，落盘 ~/.tt-help-config.json） ==========
+
+const AVAILABLE_COUNTRIES = [
+  "AT",
+  "BE",
+  "CZ",
+  "DE",
+  "ES",
+  "FR",
+  "GR",
+  "HU",
+  "IE",
+  "IT",
+  "NL",
+  "PL",
+  "PT",
+  "TH",
+  "US",
+  "GB",
+  "SE",
+  "NO",
+  "FI",
+  "DK",
+  "RO",
+  "BG",
+  "CH",
+  "SK",
+  "SI",
+  "HR",
+  "RS",
+  "UA",
+  "TR",
+  "MX",
+  "BR",
+  "AR",
+  "CL",
+  "CO",
+];
+
+function normalizeCountryInput(str) {
+  return [
+    ...new Set(
+      String(str || "")
+        .split(",")
+        .map((s) => s.trim().toUpperCase())
+        .filter(Boolean),
+    ),
+  ];
+}
+
+async function loadTargetLocations() {
+  const input = document.getElementById("targetLocationsInput");
+  const status = document.getElementById("targetLocationsStatus");
+  if (!input) return;
+  try {
+    const res = await fetch("/api/settings/target-locations");
+    const data = await res.json();
+    const locations = data.locations || [];
+    input.value = locations.join(",");
+    renderTargetCountryGrid(locations);
+    if (status) {
+      status.textContent = `当前 ${locations.length} 个国家: ${locations.join(", ")}`;
+      status.className = "settings-status ok";
+    }
+  } catch (e) {
+    console.error("loadTargetLocations error:", e);
+    if (status) {
+      status.textContent = "读取目标国家失败";
+      status.className = "settings-status warn";
+    }
+  }
+}
+
+function renderTargetCountryGrid(selected) {
+  const grid = document.getElementById("targetCountryGrid");
+  if (!grid) return;
+  const selectedSet = new Set(selected || []);
+  grid.innerHTML = AVAILABLE_COUNTRIES.map(
+    (loc) =>
+      `<button type="button" class="loc-option ${selectedSet.has(loc) ? "active" : ""}" onclick="toggleTargetCountry('${loc}')">${loc}</button>`,
+  ).join("");
+}
+
+function toggleTargetCountry(loc) {
+  const input = document.getElementById("targetLocationsInput");
+  if (!input) return;
+  let current = normalizeCountryInput(input.value);
+  if (current.includes(loc)) {
+    current = current.filter((l) => l !== loc);
+  } else {
+    current.push(loc);
+  }
+  input.value = current.join(",");
+  renderTargetCountryGrid(current);
+}
+
+async function saveTargetLocations() {
+  const input = document.getElementById("targetLocationsInput");
+  const status = document.getElementById("targetLocationsStatus");
+  if (!input) return;
+  const locations = normalizeCountryInput(input.value);
+  status.textContent = "保存中...";
+  status.className = "settings-status loading";
+  try {
+    const res = await fetch("/api/settings/target-locations", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ locations }),
+    });
+    const data = await res.json();
+    input.value = (data.locations || []).join(",");
+    renderTargetCountryGrid(data.locations || []);
+    status.textContent = `已保存 ${(data.locations || []).length} 个国家`;
+    status.className = "settings-status ok";
+  } catch (e) {
+    console.error("saveTargetLocations error:", e);
+    status.textContent = "保存失败";
+    status.className = "settings-status warn";
+  }
+}
+
+async function resetTargetLocations() {
+  const status = document.getElementById("targetLocationsStatus");
+  if (status) {
+    status.textContent = "保存中...";
+    status.className = "settings-status loading";
+  }
+  try {
+    const res = await fetch("/api/settings/target-locations", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ locations: [] }),
+    });
+    const data = await res.json();
+    const input = document.getElementById("targetLocationsInput");
+    if (input) input.value = (data.locations || []).join(",");
+    renderTargetCountryGrid(data.locations || []);
+    if (status) {
+      status.textContent = `已恢复默认 ${(data.locations || []).length} 个国家`;
+      status.className = "settings-status ok";
+    }
+  } catch (e) {
+    console.error("resetTargetLocations error:", e);
+    if (status) {
+      status.textContent = "恢复默认失败";
+      status.className = "settings-status warn";
+    }
+  }
 }
 
 let _llmProvidersCache = null;
@@ -1596,27 +1779,14 @@ function openAddTagModal() {
     if (e.target === overlay) closeAddTagModal();
   });
 
-  // 渲染国家复选框
+  // 渲染国家复选框（使用动态目标国家列表，含 TH/US，失败回退默认）
   const countryGrid = document.getElementById("addTagCountryCheckboxes");
-  const TARGET_LOCATIONS = [
-    "AT",
-    "BE",
-    "CZ",
-    "DE",
-    "ES",
-    "FR",
-    "GR",
-    "HU",
-    "IE",
-    "IT",
-    "NL",
-    "PL",
-    "PT",
-  ];
-  countryGrid.innerHTML = TARGET_LOCATIONS.map(
-    (c) =>
-      `<label class="checkbox-label"><input type="checkbox" value="${c}" checked> ${c}</label>`,
-  ).join("");
+  countryGrid.innerHTML = locationOptions
+    .map(
+      (c) =>
+        `<label class="checkbox-label"><input type="checkbox" value="${c}" checked> ${c}</label>`,
+    )
+    .join("");
 
   const ta = document.getElementById("addTagModalInput");
   ta.focus();
@@ -1704,6 +1874,220 @@ async function submitAddTags() {
   }
 }
 
+// ========== 精准商家页面 ==========
+
+async function showPrecisePage() {
+  hideAllPages();
+  document.getElementById("precisePage").classList.add("active");
+  // 每次进入都默认视频模式
+  setPreciseView("video");
+  showLoading("正在加载精准商家数据...");
+  await loadPreciseUsersPage(false, true);
+  hideLoading();
+}
+
+let currentPreciseUsers = [];
+let currentPreciseTotal = 0;
+let currentPreciseLoading = false;
+let currentPreciseAllLoaded = false;
+let currentPreciseSeq = 0;
+let currentPreciseView = "video";
+const PRECISE_PAGE_SIZE = 200;
+
+async function loadPreciseUsersPage(append = false, skipLoading = false) {
+  if (currentPreciseLoading) return;
+  currentPreciseLoading = true;
+  const seq = ++currentPreciseSeq;
+  const search = document.getElementById("preciseSearchInput")
+    ? document.getElementById("preciseSearchInput").value.trim()
+    : "";
+  const offset = append ? currentPreciseUsers.length : 0;
+  if (!append && !skipLoading) showLoading("正在加载数据...");
+
+  let data = null;
+  let error = null;
+  try {
+    let url = `/api/precise-merchants?limit=${PRECISE_PAGE_SIZE}&offset=${offset}`;
+    if (search) url += `&search=${encodeURIComponent(search)}`;
+    const res = await fetch(url);
+    data = await res.json();
+  } catch (e) {
+    error = e;
+    console.error("加载精准商家失败:", e);
+  } finally {
+    if (!append && !skipLoading) hideLoading();
+    currentPreciseLoading = false;
+    if (error || !data) return;
+    if (seq !== currentPreciseSeq && !append) return;
+    if (!append) {
+      currentPreciseUsers = data.users || [];
+      currentPreciseTotal = data.total || 0;
+    } else {
+      currentPreciseUsers = currentPreciseUsers.concat(data.users || []);
+      currentPreciseTotal = data.total || 0;
+    }
+    currentPreciseAllLoaded = currentPreciseUsers.length >= currentPreciseTotal;
+    renderPreciseView();
+  }
+}
+
+function setPreciseView(view) {
+  currentPreciseView = view === "table" ? "table" : "video";
+  const tableBtn = document.getElementById("preciseViewTableBtn");
+  const videoBtn = document.getElementById("preciseViewVideoBtn");
+  if (tableBtn)
+    tableBtn.classList.toggle("active", currentPreciseView === "table");
+  if (videoBtn)
+    videoBtn.classList.toggle("active", currentPreciseView === "video");
+  const videoWrap = document.getElementById("preciseVideoWrap");
+  const tableWrap = document.getElementById("preciseTableWrap");
+  if (videoWrap)
+    videoWrap.style.display = currentPreciseView === "video" ? "" : "none";
+  if (tableWrap)
+    tableWrap.style.display = currentPreciseView === "table" ? "" : "none";
+  renderPreciseView();
+}
+
+function renderPreciseView() {
+  if (currentPreciseView === "table") {
+    renderPreciseTable();
+  } else {
+    renderPreciseVideos();
+  }
+  updatePreciseMoreHint();
+}
+
+function updatePreciseMoreHint() {
+  const moreHint = document.getElementById("preciseMoreHint");
+  const totalEl = document.getElementById("precisePageStatTotal");
+  if (totalEl)
+    totalEl.textContent = formatStatNum(currentPreciseTotal, { full: true });
+  if (!moreHint) return;
+  if (currentPreciseTotal === 0) {
+    moreHint.textContent = "";
+    moreHint.style.display = "none";
+  } else if (currentPreciseAllLoaded) {
+    moreHint.textContent = `共 ${currentPreciseTotal} 个，已全部加载`;
+    moreHint.onclick = null;
+    moreHint.style.cursor = "default";
+    moreHint.style.color = "#6b7280";
+  } else {
+    moreHint.textContent = "点击加载更多";
+    moreHint.onclick = () => loadPreciseUsersPage(true);
+    moreHint.style.cursor = "pointer";
+    moreHint.style.color = "#60a5fa";
+  }
+}
+
+function renderPreciseTable() {
+  const el = document.getElementById("preciseTable");
+  if (!el) return;
+  if (!currentPreciseUsers.length) {
+    el.innerHTML =
+      '<tr><td colspan="12" style="text-align:center;color:#666;padding:20px">暂无精准商家</td></tr>';
+    return;
+  }
+  el.innerHTML = currentPreciseUsers
+    .map((u, i) => {
+      const sold = u.productSoldCount ?? 0;
+      const ec = u.ecOver1k ?? 0;
+      const maxEc = u.maxEcPlay ?? 0;
+      const title = (u.productName || "").replace(/</g, "&lt;");
+      return `<tr>
+        <td style="text-align:right;color:#666">${i + 1}</td>
+        <td><a href="https://www.tiktok.com/@${encodeURIComponent(u.uniqueId)}" target="_blank">@${escapeHtml(u.uniqueId)}</a></td>
+        <td>${escapeHtml(u.nickname || "-")}</td>
+        <td>${formatNum(u.followerCount || 0)}</td>
+        <td>${u.videoCount || 0}</td>
+        <td>${u.locationCreated || "-"}</td>
+        <td style="color:#22c55e">${formatNum(sold)}</td>
+        <td style="color:#f87171">${u.productReviewCount ?? 0}</td>
+        <td>${u.productRating != null ? u.productRating : "-"}</td>
+        <td>${ec}</td>
+        <td>${formatNum(maxEc)}</td>
+        <td style="max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap" title="${title}">${title || "-"}</td>
+      </tr>`;
+    })
+    .join("");
+}
+
+function renderPreciseVideos() {
+  const wrap = document.getElementById("preciseVideoWrap");
+  if (!wrap) return;
+  if (!currentPreciseUsers.length) {
+    wrap.innerHTML =
+      '<div style="color:#666;text-align:center;padding:24px">暂无精准商家</div>';
+    return;
+  }
+  wrap.innerHTML = currentPreciseUsers
+    .map((u) => {
+      const vids = Array.isArray(u.recentEcVideos) ? u.recentEcVideos : [];
+      const maxPlay = vids.reduce((m, v) => Math.max(m, v.playCount || 0), 0);
+      const sold = u.productSoldCount ?? 0;
+      const review = u.productReviewCount ?? 0;
+      const rating = u.productRating != null ? u.productRating : "-";
+      const userLink = `https://www.tiktok.com/@${encodeURIComponent(u.uniqueId)}`;
+      const tiles = vids
+        .reduce((acc, v) => {
+          const play = v.playCount || 0;
+          const time = v.createTime ? formatShortDate(v.createTime) : "";
+          const isAd = v.isAd ? '<span class="pv-ad">广告</span>' : "";
+          const prod = v.seoUrl
+            ? `<a class="pv-product" href="${escapeAttr(v.seoUrl)}" target="_blank" title="${escapeHtml(v.productTitle || "查看商品")}"><span class="pv-product-icon">🛒</span>${escapeHtml((v.productTitle || "查看商品").slice(0, 80))}</a>`
+            : "";
+          acc.push(`<div class="precise-video-item">
+          <a class="precise-video-tile" href="${escapeAttr(v.href || "#")}" target="_blank" title="播放视频">
+            <span class="pv-play">▶</span>
+            <span class="pv-count${maxPlay > 0 && play === maxPlay ? " pv-count-max" : ""}">${formatNum(play)}</span>
+            <span class="pv-time">${time}</span>
+            ${isAd}
+          </a>
+          ${prod}
+        </div>`);
+          return acc;
+        }, [])
+        .join("");
+      return `<div class="precise-merchant-card">
+        <div class="precise-merchant-head">
+          <a class="pm-user" href="${userLink}" target="_blank">@${escapeHtml(u.uniqueId)}</a>
+          <span class="pm-nick">${escapeHtml(u.nickname || "-")}</span>
+          <span class="pm-country">${u.locationCreated || "-"}</span>
+          <span class="pm-stats">粉丝 ${formatNum(u.followerCount || 0)} · 视频 ${u.videoCount || 0} · 销量 ${formatNum(sold)} · 评论 ${review} · 评分 ${rating} · EC视频 ${vids.length}</span>
+        </div>
+        ${tiles ? `<div class="precise-video-grid">${tiles}</div>` : '<div style="color:#666;font-size:12px;padding:6px 0">该商家暂无 EC 视频数据</div>'}
+      </div>`;
+    })
+    .join("");
+}
+
+function formatShortDate(sec) {
+  if (!sec) return "";
+  const d = new Date(sec * 1000);
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+
+function escapeAttr(str) {
+  return String(str)
+    .replace(/&/g, "&amp;")
+    .replace(/"/g, "&quot;")
+    .replace(/</g, "&lt;");
+}
+
+function clearPreciseFilters() {
+  const input = document.getElementById("preciseSearchInput");
+  if (input) input.value = "";
+  loadPreciseUsersPage();
+}
+
+let preciseSearchTimer = null;
+document.getElementById("preciseSearchInput").addEventListener("input", () => {
+  if (preciseSearchTimer) clearTimeout(preciseSearchTimer);
+  preciseSearchTimer = setTimeout(() => {
+    loadPreciseUsersPage();
+  }, 300);
+});
+
 // ========== 关键词页面 ==========
 
 let currentTags = [];
@@ -1725,6 +2109,7 @@ function showTagsPage() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.add("active");
   document.getElementById("settingsPage").classList.remove("active");
   showLoading("正在加载关键词...");
@@ -2199,6 +2584,7 @@ function showTargetPage() {
   document.getElementById("userUpdatePage").classList.remove("active");
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.add("active");
+  document.getElementById("precisePage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
   document.getElementById("settingsPage").classList.remove("active");
   showLoading("正在加载目标商家数据...");

package/src/watch/public/index.html

@@ -20,7 +20,7 @@
         <input type="checkbox" id="fireworkToggle" checked onchange="toggleFireworks()">
         <span>🎆</span>
       </label>
-      <a class="script-link" onclick="navigateToSettings()" style="cursor:pointer">⚙️ LLM</a>
+      <a class="script-link" onclick="navigateToSettings()" style="cursor:pointer">⚙️ 配置</a>
       <a class="script-link" onclick="navigateToWatchdog()" style="cursor:pointer">🐕 看门狗</a>
       <span class="status" id="lastUpdate">--</span>
     </div>
@@ -59,6 +59,10 @@
         <div class="label">目标商家</div>
         <div class="value target" id="statTarget">0</div>
       </div>
+      <div class="stat-card clickable" id="statPreciseCard" onclick="navigateToPrecise()">
+        <div class="label">精准商家</div>
+        <div class="value target" id="statPrecise">0</div>
+      </div>
       <div class="stat-card clickable pending-card" id="statCommentTaskCard">
         <div class="label">待评论任务</div>
         <div class="value rose" id="statCommentTask">0</div>
@@ -379,6 +383,55 @@
     </div>
     <div id="backToTop" title="回到顶部（可拖动）">↑</div>
   </div>
+  <div id="precisePage">
+    <div class="stats" style="margin-bottom:16px">
+      <div class="stat-card">
+        <div class="label">精准商家</div>
+        <div class="value target" id="precisePageStatTotal">0</div>
+      </div>
+      <div class="stat-card clickable pending-card" onclick="navigateToMain()" style="background:rgba(167,139,250,0.1)">
+        <div class="label">← 返回主页面</div>
+      </div>
+    </div>
+    <div class="table-wrap">
+      <div class="precise-list-header">
+        <h3>精准商家列表</h3>
+        <div class="view-toggle">
+          <button id="preciseViewTableBtn" onclick="setPreciseView('table')">表格</button>
+          <button id="preciseViewVideoBtn" onclick="setPreciseView('video')" class="active">视频</button>
+        </div>
+      </div>
+      <div class="controls">
+        <input type="text" id="preciseSearchInput" placeholder="搜索精准商家用户名 / 昵称...">
+        <button onclick="clearPreciseFilters()">清空筛选</button>
+      </div>
+      <div id="preciseVideoWrap"></div>
+      <div class="table-scroll" id="preciseTableWrap" style="display:none">
+        <table>
+          <thead>
+            <tr>
+              <th style="width:48px">#</th>
+              <th>用户名</th>
+              <th>昵称</th>
+              <th>粉丝</th>
+              <th>视频</th>
+              <th>国家</th>
+              <th>销量</th>
+              <th>评论</th>
+              <th>评分</th>
+              <th>EC超1k视频数</th>
+              <th>最高EC播放</th>
+              <th>商品</th>
+            </tr>
+          </thead>
+          <tbody id="preciseTable"></tbody>
+        </table>
+      </div>
+      <div id="preciseMoreHint" onclick="loadPreciseUsersPage(true)"
+        style="text-align:center;padding:10px 8px;font-size:13px;color:#6b7280;cursor:default;user-select:none;transition:color 0.2s">
+      </div>
+    </div>
+  </div>
   <div id="tagsPage">
     <div class="stats" style="margin-bottom:16px">
       <div class="stat-card">
@@ -488,6 +541,26 @@
         </div>
       </div>
     </div>
+    <div class="settings-card">
+      <h3>🎯 目标国家</h3>
+      <p class="settings-hint">设置采集的目标国家列表，保存后写入通用配置文件（~/.tt-help-config.json）。当前仅保存配置，后续接入采集流程后生效。</p>
+      <div class="settings-form">
+        <div class="settings-field">
+          <label>目标国家（英文国家代码，逗号分隔，如 CZ,GR,TH）</label>
+          <input type="text" id="targetLocationsInput" placeholder="CZ,GR,HU,PT,ES,PL,NL,BE,DE,FR,IT,IE,AT,TH,US">
+          <span class="settings-note">可手动输入，或点击下方国家快速选择。</span>
+        </div>
+        <div class="settings-field">
+          <label>快速选择</label>
+          <div class="loc-grid" id="targetCountryGrid"></div>
+        </div>
+        <div class="settings-status" id="targetLocationsStatus"></div>
+        <div class="btn-row">
+          <button class="btn-submit" onclick="saveTargetLocations()">保存目标国家</button>
+          <button class="btn-cancel" onclick="resetTargetLocations()">恢复默认</button>
+        </div>
+      </div>
+    </div>
   </div>
   <div id="watchdogPage">
     <div class="stats" style="margin-bottom:16px">