tt-help-cli-ycl 1.4.20 → 1.4.22

package/src/watch/public/app.js

@@ -268,6 +268,7 @@ function renderActiveClients(clients) {
     "explore",
     "refresh",
     "attach",
+    "recheck",
     "comments",
     "scoring",
     "tag-refresh",
@@ -276,6 +277,7 @@ function renderActiveClients(clients) {
     explore: "Explore",
     refresh: "Refresh",
     attach: "Attach",
+    recheck: "Recheck",
     comments: "Comments",
     scoring: "Scoring",
     "tag-refresh": "TagRefresh",
@@ -1243,6 +1245,8 @@ function handleRoute() {
     showTargetPage();
   } else if (hash === "#tags") {
     showTagsPage();
+  } else if (hash === "#settings") {
+    showSettingsPage();
   } else {
     showMainPage();
   }
@@ -1271,6 +1275,7 @@ function showPendingPage() {
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
   fetchPendingByCountry();
   fetchAttachStuckByCountry();
 }
@@ -1282,6 +1287,7 @@ function showUserUpdatePage() {
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
   fetchUserUpdateByCountry();
   fetchAttachStuckByCountry();
 }
@@ -1300,6 +1306,7 @@ function showRawPage() {
   document.getElementById("rawPage").classList.add("active");
   document.getElementById("targetPage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
   fetchRawByCountry();
   fetchRawJobs();
 }
@@ -1311,6 +1318,7 @@ function showMainPage() {
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
   document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
 }
 
 function navigateToTarget() {
@@ -1321,6 +1329,189 @@ function navigateToTags() {
   window.location.hash = "#tags";
 }
 
+function navigateToSettings() {
+  window.location.hash = "#settings";
+}
+
+// ========== LLM 配置页面 ==========
+
+function hideAllPages() {
+  document.getElementById("mainPage").classList.add("hidden");
+  document.getElementById("pendingPage").classList.remove("active");
+  document.getElementById("userUpdatePage").classList.remove("active");
+  document.getElementById("rawPage").classList.remove("active");
+  document.getElementById("targetPage").classList.remove("active");
+  document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
+}
+
+function showSettingsPage() {
+  hideAllPages();
+  document.getElementById("settingsPage").classList.add("active");
+  fetchLlmConfig();
+}
+
+let _llmProvidersCache = null;
+
+async function fetchLlmConfig() {
+  try {
+    const res = await fetch("/api/llm-config");
+    const data = await res.json();
+    _llmProvidersCache = data.providers || [];
+
+    const providerSel = document.getElementById("settingsProvider");
+    const modelSel = document.getElementById("settingsModel");
+    const urlInput = document.getElementById("settingsUrl");
+    const keyInput = document.getElementById("settingsApiKey");
+    const keyHint = document.getElementById("settingsKeyHint");
+    const status = document.getElementById("settingsStatus");
+
+    // 渲染服务商下拉（只渲染一次）
+    if (providerSel && providerSel.options.length === 0) {
+      providerSel.innerHTML = _llmProvidersCache
+        .map(
+          (p) =>
+            `<option value="${p.id}" ${p.id === data.provider ? "selected" : ""}>${p.name}</option>`,
+        )
+        .join("");
+    } else if (providerSel) {
+      providerSel.value = data.provider;
+    }
+
+    // 根据当前 provider 渲染模型下拉
+    renderModelSelect(data.provider, data.model);
+
+    if (urlInput) urlInput.value = data.url || "";
+    if (keyInput) {
+      keyInput.value = data.hasApiKey ? data.apiKeyHint : "";
+    }
+    if (keyHint) {
+      keyHint.textContent = data.hasApiKey
+        ? "已配置"
+        : "未配置，请输入 API Key";
+      keyHint.style.color = data.hasApiKey ? "#4ade80" : "#f87171";
+    }
+    if (status) {
+      const provider = _llmProvidersCache.find((p) => p.id === data.provider);
+      status.textContent = `当前: ${provider?.name || data.provider} / ${data.model}`;
+      status.className = "settings-status ok";
+    }
+  } catch (e) {
+    console.error("fetchLlmConfig error:", e);
+  }
+}
+
+function renderModelSelect(providerId, selectedModel) {
+  const modelSel = document.getElementById("settingsModel");
+  if (!modelSel) return;
+  const provider = (_llmProvidersCache || []).find((p) => p.id === providerId);
+  const models = provider?.models || [];
+  modelSel.innerHTML = models
+    .map(
+      (m) =>
+        `<option value="${m.id}" ${m.id === selectedModel ? "selected" : ""}>${m.label}</option>`,
+    )
+    .join("");
+}
+
+// Provider 切换 → 更新 Model 列表 + URL
+function onProviderChange() {
+  const providerSel = document.getElementById("settingsProvider");
+  const providerId = providerSel?.value;
+  if (!providerId) return;
+
+  const provider = (_llmProvidersCache || []).find((p) => p.id === providerId);
+  if (!provider) return;
+
+  // 更新 URL
+  const urlInput = document.getElementById("settingsUrl");
+  if (urlInput) urlInput.value = provider.url;
+
+  // 更新模型列表（默认选第一个）
+  renderModelSelect(providerId, provider.models[0]?.id);
+}
+
+// 绑定事件
+(function initSettingsEvents() {
+  const providerSel = document.getElementById("settingsProvider");
+  if (providerSel) {
+    providerSel.addEventListener("change", onProviderChange);
+  }
+})();
+
+function toggleApiKeyVisibility() {
+  const input = document.getElementById("settingsApiKey");
+  const btn = document.getElementById("settingsToggleKey");
+  if (input.type === "password") {
+    input.type = "text";
+    btn.textContent = "🙈";
+  } else {
+    input.type = "password";
+    btn.textContent = "👁";
+  }
+}
+
+async function saveLlmConfig() {
+  const provider = document.getElementById("settingsProvider").value;
+  const model = document.getElementById("settingsModel").value;
+  const url = document.getElementById("settingsUrl").value;
+  const apiKeyInput = document.getElementById("settingsApiKey");
+  const status = document.getElementById("settingsStatus");
+
+  // 防止把提示字符串当 key 保存：若输入值含 "..." 且未被用户修改过，不发送
+  const rawKey = apiKeyInput.value.trim();
+  const isHint = rawKey.includes("...") && rawKey.length < 20;
+  const keyWasEdited = apiKeyInput.dataset.edited === "true";
+  let apiKey = undefined;
+  if (rawKey && !isHint) {
+    apiKey = rawKey;
+  } else if (rawKey && isHint && keyWasEdited) {
+    // 用户手动修改了（可能是输入了新 key），发送
+    apiKey = rawKey;
+  }
+  // 如果 isHint && !keyWasEdited → 不发送，保留服务端已有 key
+
+  status.textContent = "保存中...";
+  status.className = "settings-status loading";
+
+  try {
+    const body = { provider, model, url };
+    if (apiKey !== undefined) body.apiKey = apiKey;
+    const res = await fetch("/api/llm-config", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (data.hasApiKey) {
+      apiKeyInput.value = data.apiKeyHint;
+      apiKeyInput.dataset.edited = "false";
+      const keyHint = document.getElementById("settingsKeyHint");
+      if (keyHint) {
+        keyHint.textContent = "已配置";
+        keyHint.style.color = "#4ade80";
+      }
+    }
+    const p = (_llmProvidersCache || []).find((x) => x.id === data.provider);
+    status.textContent = `✅ 已保存: ${p?.name || data.provider} / ${data.model}`;
+    status.className = "settings-status ok";
+    _llmProvidersCache = data.providers || _llmProvidersCache;
+  } catch (e) {
+    status.textContent = "❌ 保存失败: " + e.message;
+    status.className = "settings-status error";
+  }
+}
+
+// 追踪 API Key 输入框是否被用户编辑过
+(function initKeyEditTracking() {
+  const input = document.getElementById("settingsApiKey");
+  if (input) {
+    input.addEventListener("input", () => {
+      input.dataset.edited = "true";
+    });
+  }
+})();
+
 // ========== 添加关键词弹窗 ==========
 
 function openAddTagModal() {
@@ -1481,6 +1672,7 @@ function showTagsPage() {
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.remove("active");
   document.getElementById("tagsPage").classList.add("active");
+  document.getElementById("settingsPage").classList.remove("active");
   showLoading("正在加载关键词...");
   Promise.all([loadTagStats(), loadTagsPage(), loadRefreshStats()]).finally(
     hideLoading,
@@ -1624,6 +1816,11 @@ async function loadTagsPage(append = false) {
     if (currentTagsFilter !== "all") url += `&status=${currentTagsFilter}`;
     if (country) url += `&country=${encodeURIComponent(country)}`;
 
+    const searchVal =
+      document.getElementById("tagsSearchInput")?.value.trim().toLowerCase() ||
+      "";
+    if (searchVal) url += `&search=${encodeURIComponent(searchVal)}`;
+
     const res = await fetch(url);
     const data = await res.json();
 
@@ -1650,14 +1847,6 @@ function renderTagsTable() {
   const moreHint = document.getElementById("tagsMoreHint");
   let display = [...currentTags];
 
-  // 搜索过滤（本地二次过滤）
-  const searchVal =
-    document.getElementById("tagsSearchInput")?.value.trim().toLowerCase() ||
-    "";
-  if (searchVal) {
-    display = display.filter((t) => t.tag.toLowerCase().includes(searchVal));
-  }
-
   // 本地排序
   if (currentTagsSort.key) {
     display.sort((a, b) => {
@@ -1955,6 +2144,7 @@ function showTargetPage() {
   document.getElementById("rawPage").classList.remove("active");
   document.getElementById("targetPage").classList.add("active");
   document.getElementById("tagsPage").classList.remove("active");
+  document.getElementById("settingsPage").classList.remove("active");
   showLoading("正在加载目标商家数据...");
   fetchTargetByCountry();
   fetchTargetOtherCountries();

package/src/watch/public/index.html

@@ -16,6 +16,7 @@
     <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>
+      <a class="script-link" onclick="navigateToSettings()" style="cursor:pointer">⚙️ LLM</a>
       <span class="status" id="lastUpdate">--</span>
     </div>
   </div>
@@ -446,6 +447,44 @@
       </div>
     </div>
   </div>
+  <div id="settingsPage">
+    <div class="stats" style="margin-bottom:16px">
+      <div class="stat-card clickable" onclick="navigateToMain()" style="background:rgba(96,165,250,0.1)">
+        <div class="label">← 返回主页面</div>
+      </div>
+    </div>
+    <div class="settings-card">
+      <h3>⚙️ LLM 模型配置</h3>
+      <p class="settings-hint">切换后立即生效，无需重启服务。配置保存在数据库中。</p>
+      <div class="settings-form">
+        <div class="settings-field">
+          <label>服务商</label>
+          <select id="settingsProvider" onchange="onProviderChange()"></select>
+        </div>
+        <div class="settings-field">
+          <label>模型</label>
+          <select id="settingsModel"></select>
+        </div>
+        <div class="settings-field">
+          <label>API 地址</label>
+          <input type="text" id="settingsUrl" placeholder="https://..." readonly>
+          <span class="settings-note">选服务商后自动填入，也可手动修改</span>
+        </div>
+        <div class="settings-field">
+          <label>API Key</label>
+          <div class="settings-key-row">
+            <input type="password" id="settingsApiKey" placeholder="sk-...">
+            <button id="settingsToggleKey" onclick="toggleApiKeyVisibility()" title="显示/隐藏">👁</button>
+          </div>
+          <span class="settings-note" id="settingsKeyHint"></span>
+        </div>
+        <div class="settings-status" id="settingsStatus"></div>
+        <div class="btn-row">
+          <button class="btn-submit" onclick="saveLlmConfig()">保存配置</button>
+        </div>
+      </div>
+    </div>
+  </div>
   <script src="app.js"></script>
 </body>
 

package/src/watch/public/style.css

@@ -1623,3 +1623,157 @@ td.user-id:hover {
   pointer-events: none;
   z-index: 9999;
 }
+
+/* ========== LLM 设置页 ========== */
+#settingsPage {
+  display: none;
+}
+
+#settingsPage.active {
+  display: block;
+}
+
+.settings-card {
+  background: #1a1a24;
+  border-radius: 12px;
+  padding: 28px;
+  max-width: 560px;
+  margin: 0 auto;
+}
+
+.settings-card h3 {
+  font-size: 17px;
+  color: #e0e0e0;
+  margin-bottom: 6px;
+}
+
+.settings-hint {
+  font-size: 12px;
+  color: #888;
+  margin-bottom: 24px;
+}
+
+.settings-form {
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+}
+
+.settings-field label {
+  display: block;
+  font-size: 13px;
+  color: #aaa;
+  margin-bottom: 6px;
+  font-weight: 600;
+}
+
+.settings-field input,
+.settings-field select {
+  width: 100%;
+  padding: 10px 14px;
+  border: 1px solid #333;
+  border-radius: 8px;
+  background: #0f0f13;
+  color: #e0e0e0;
+  font-size: 14px;
+  font-family: inherit;
+  outline: none;
+  transition: border-color 0.2s;
+}
+
+.settings-field input:focus,
+.settings-field select:focus {
+  border-color: #fe2c55;
+}
+
+.settings-field input[readonly] {
+  color: #888;
+  cursor: default;
+}
+
+.settings-field select {
+  cursor: pointer;
+  appearance: none;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23888' d='M6 8L1 3h10z'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 12px center;
+  padding-right: 36px;
+}
+
+.settings-key-row {
+  display: flex;
+  gap: 6px;
+}
+
+.settings-key-row input {
+  flex: 1;
+}
+
+.settings-key-row button {
+  padding: 8px 12px;
+  border: 1px solid #333;
+  border-radius: 8px;
+  background: #2a2a3a;
+  color: #ccc;
+  font-size: 16px;
+  cursor: pointer;
+  transition: background 0.2s;
+}
+
+.settings-key-row button:hover {
+  background: #333;
+}
+
+.settings-note {
+  display: block;
+  font-size: 11px;
+  color: #666;
+  margin-top: 4px;
+}
+
+.settings-status {
+  padding: 10px 14px;
+  border-radius: 8px;
+  font-size: 13px;
+  text-align: center;
+}
+
+.settings-status.ok {
+  background: rgba(74, 222, 128, 0.1);
+  color: #4ade80;
+  border: 1px solid rgba(74, 222, 128, 0.2);
+}
+
+.settings-status.error {
+  background: rgba(248, 113, 113, 0.1);
+  color: #f87171;
+  border: 1px solid rgba(248, 113, 113, 0.2);
+}
+
+.settings-status.loading {
+  background: rgba(250, 204, 21, 0.1);
+  color: #facc15;
+  border: 1px solid rgba(250, 204, 21, 0.2);
+}
+
+.settings-form .btn-row {
+  display: flex;
+  justify-content: flex-end;
+  margin-top: 4px;
+}
+
+.settings-form .btn-submit {
+  padding: 10px 28px;
+  border: none;
+  border-radius: 8px;
+  background: #fe2c55;
+  color: #fff;
+  font-size: 14px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: background 0.2s;
+}
+
+.settings-form .btn-submit:hover {
+  background: #e61944;
+}

package/src/watch/server.js

@@ -216,6 +216,16 @@ export function startWatchServer(
   return new Promise((_resolve, reject) => {
     const store = existingStore || createStore(dataAnchor, options);
 
+    // 初始化 LLM 动态配置（SQLite > 环境变量 > 默认值）
+    import("./llm-config.js").then((m) => m.loadLlmConfig());
+
+    // 启动时清理废弃的反思规则（避免 DB 膨胀）
+    import("./db-tags.js").then((m) => {
+      if (m.cleanupInactiveReflectionRules) {
+        m.cleanupInactiveReflectionRules();
+      }
+    });
+
     function logJob(action, detail) {
       const ts = new Date().toLocaleTimeString("zh-CN", { hour12: false });
       const d = detail
@@ -1253,6 +1263,55 @@ export function startWatchServer(
         return;
       }
 
+      // ====== LLM 配置 API ======
+      if (req.method === "GET" && routePath === "/api/llm-config") {
+        try {
+          const { getLlmConfig, LLM_PROVIDERS } =
+            await import("./llm-config.js");
+          sendJSON(res, 200, {
+            ...getLlmConfig(),
+            providers: LLM_PROVIDERS,
+          });
+        } catch (e) {
+          sendJSON(res, 500, { error: e.message });
+        }
+        return;
+      }
+
+      if (req.method === "POST" && routePath === "/api/llm-config") {
+        try {
+          const body = await readBody(req);
+          const { updateLlmConfig, getLlmConfig, LLM_PROVIDERS } =
+            await import("./llm-config.js");
+          const result = updateLlmConfig({
+            provider: body.provider,
+            model: body.model,
+            url: body.url,
+            apiKey: body.apiKey,
+          });
+          sendJSON(res, 200, { ...result, providers: LLM_PROVIDERS });
+        } catch (e) {
+          sendJSON(res, 400, { error: e.message });
+        }
+        return;
+      }
+
+      // GET /api/llm-test — 直接测试 LLM API 连通性
+      if (req.method === "GET" && routePath === "/api/llm-test") {
+        try {
+          const { callLLM } = await import("./tag-service.js");
+          const result = await callLLM("Say hello in exactly one word.", 0.1);
+          sendJSON(res, 200, {
+            ok: result.length > 0,
+            reply: result || "(空)",
+            replyLen: result.length,
+          });
+        } catch (e) {
+          sendJSON(res, 500, { ok: false, error: e.message });
+        }
+        return;
+      }
+
       if (req.method === "POST" && routePath === "/api/attach-stuck/restore") {
         try {
           const body = await readBody(req);
@@ -1502,23 +1561,31 @@ export function startWatchServer(
         return;
       }
 
-      // GET /api/tags?status=&country=&limit=&offset=
+      // GET /api/tags?status=&country=&search=&limit=&offset=
       if (req.method === "GET" && routePath === "/api/tags") {
         const status = params.status || null;
         const country = params.country || null;
+        const search = params.search || null;
         const limit = Math.min(parseInt(params.limit) || 200, 500);
         const offset = parseInt(params.offset) || 0;
         const upperCountry = country ? country.toUpperCase() : null;
+        const searchTerm = search ? search.trim().toLowerCase() : null;
 
         let tags;
         if (status) {
-          tags = store.getTagsByStatus(status, limit, offset, upperCountry);
+          tags = store.getTagsByStatus(
+            status,
+            limit,
+            offset,
+            upperCountry,
+            searchTerm,
+          );
         } else {
-          tags = store.getAllTags(limit, offset, upperCountry);
+          tags = store.getAllTags(limit, offset, upperCountry, searchTerm);
         }
 
-        // 获取总数（带国家过滤，按 status 返回对应计数）
-        const stats = store.getTagStats(upperCountry);
+        // 获取总数（带搜索过滤，按 status 返回对应计数）
+        const stats = store.getTagStats(upperCountry, searchTerm);
         let total;
         if (stats) {
           if (status === "new") total = stats.new;
@@ -1676,6 +1743,35 @@ export function startWatchServer(
         return;
       }
 
+      // POST /api/tags/batch-add-if-new — 批量添加 tag（只插入不存在的，不覆盖已有）
+      if (req.method === "POST" && routePath === "/api/tags/batch-add-if-new") {
+        try {
+          const body = await readBody(req);
+          const { tags, countries, source } = body || {};
+          if (!Array.isArray(tags) || tags.length === 0) {
+            sendJSON(res, 400, { error: "tags 不能为空" });
+            return;
+          }
+          if (!Array.isArray(countries) || countries.length === 0) {
+            sendJSON(res, 400, { error: "countries 不能为空" });
+            return;
+          }
+          const ret = store.insertTagsIfNew(tags, countries, source || "video");
+          if (ret.error) {
+            sendJSON(res, 500, { error: ret.error });
+            return;
+          }
+          sendJSON(res, 200, {
+            ok: true,
+            inserted: ret.inserted,
+            tags: ret.tags,
+          });
+        } catch (e) {
+          sendJSON(res, 500, { error: e.message });
+        }
+        return;
+      }
+
       // GET /api/tags/health?country=ES — 自闭环：获取国家 tag 健康指标
       if (req.method === "GET" && routePath === "/api/tags/health") {
         try {
@@ -2179,7 +2275,9 @@ export function startWatchServer(
 
       if (
         req.method === "GET" &&
-        (routePath === "/" || routePath === "/index.html")
+        (routePath === "/" ||
+          routePath === "/index.html" ||
+          routePath === "/settings")
       ) {
         // 设有密码时，检查登录态
         if (PASSWORD_ENABLED) {