tt-help-cli-ycl 1.3.84 → 1.3.85

package/src/lib/target-locations.js

@@ -51,10 +51,28 @@ function findFirstMatchingLocation(
   );
 }
 
+/**
+ * 从按频率排序的 entries 中，找第一个属于目标国家的。
+ * @param {Array<[string, number]>} entries - 已按频率降序排列的 [国家, 次数] 数组
+ * @param {string[]} targetLocations - 目标国家列表
+ * @returns {string|null} 频率最高的目标国家，如都不匹配则返回 null
+ */
+function findBestMatchingLocation(
+  entries,
+  targetLocations = DEFAULT_TARGET_LOCATIONS,
+) {
+  const normalizedTarget = normalizeLocationList(targetLocations);
+  for (const [loc] of entries) {
+    if (normalizedTarget.includes(loc)) return loc;
+  }
+  return null;
+}
+
 export {
   DEFAULT_TARGET_LOCATIONS,
   DEFAULT_TARGET_LOCATIONS_CSV,
   findFirstMatchingLocation,
+  findBestMatchingLocation,
   isLocationInList,
   normalizeLocation,
   normalizeLocationList,

package/src/main.js

@@ -11,6 +11,12 @@ import { handleVideoStats } from "./cli/videostats.js";
 import { handleDbImport } from "./cli/db-import.js";
 import { handleWebserver } from "./cli/webserver.js";
 import { handleRefresh } from "./cli/refresh.js";
+import {
+  handleTag,
+  handleDiscover,
+  handleScore,
+  handleScoreAll,
+} from "./cli/tag.js";
 
 async function main() {
   const parsed = parseArgs();
@@ -36,6 +42,14 @@ async function main() {
       return handleDbImport(parsed);
     case "refresh":
       return handleRefresh(parsed);
+    case "tag":
+      return handleTag(parsed);
+    case "tag-discover":
+      return handleDiscover(parsed);
+    case "tag-score":
+      return handleScore(parsed);
+    case "tag-score-all":
+      return handleScoreAll(parsed);
   }
 
   const {

package/src/npm-main.js

@@ -7,6 +7,7 @@ import { handleConfig, showConfig, showUsage, version } from "./cli/config.js";
 import { handleOpen } from "./cli/open.js";
 import { handleComments } from "./cli/comments.js";
 import { handleRefresh } from "./cli/refresh.js";
+import { handleTag } from "./cli/tag.js";
 
 function exitUnsupportedCommand(command) {
   console.error(
@@ -36,6 +37,8 @@ async function main() {
       return handleComments(parsed);
     case "refresh":
       return handleRefresh(parsed);
+    case "tag":
+      return handleTag(parsed);
   }
 
   const {

package/src/scraper/explore-core.js

@@ -6,7 +6,7 @@ import { extractFollowAndFollowers } from "./modules/follow-extractor.js";
 import { extractVideoLocation, setScraperProxy } from "../lib/scrape.js";
 import {
   DEFAULT_TARGET_LOCATIONS_CSV,
-  findFirstMatchingLocation,
+  findBestMatchingLocation,
   isLocationInList,
   normalizeLocation,
   normalizeLocationList,
@@ -152,13 +152,13 @@ async function processExplore(page, username, options, log) {
           locationDecision = `众数 (${entries[0][1]}次)`;
         }
       } else {
-        // explore 模式：优先命中目标国家，不匹配则回退众数
-        const matchedTargetLocation = findFirstMatchingLocation(
-          normalizedLocations,
+        // explore 模式：取频率最高的目标国家，不匹配则回退众数
+        const bestTargetLocation = findBestMatchingLocation(
+          entries,
           locationList,
         );
-        if (matchedTargetLocation) {
-          locationCreated = matchedTargetLocation;
+        if (bestTargetLocation) {
+          locationCreated = bestTargetLocation;
           locationDecision = "命中目标国家";
         } else if (entries.length > 0) {
           locationCreated = entries[0][0];

package/src/watch/data-store.js

@@ -152,6 +152,9 @@ function initUserDb(filePath) {
   if (!existingJobColumns.has("top_video_href")) {
     db.exec(`ALTER TABLE jobs ADD COLUMN top_video_href TEXT`);
   }
+  if (!existingJobColumns.has("user_create_time")) {
+    db.exec(`ALTER TABLE jobs ADD COLUMN user_create_time INTEGER`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS jobs_base (
       unique_id TEXT PRIMARY KEY,
@@ -212,6 +215,9 @@ function initUserDb(filePath) {
   if (!existingJobBaseColumns.has("bio_link")) {
     db.exec(`ALTER TABLE jobs_base ADD COLUMN bio_link TEXT`);
   }
+  if (!existingJobBaseColumns.has("user_create_time")) {
+    db.exec(`ALTER TABLE jobs_base ADD COLUMN user_create_time INTEGER`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS raw_jobs (
       unique_id TEXT PRIMARY KEY,
@@ -271,6 +277,9 @@ function initUserDb(filePath) {
   if (!existingRawJobColumns.has("bio_link")) {
     db.exec(`ALTER TABLE raw_jobs ADD COLUMN bio_link TEXT`);
   }
+  if (!existingRawJobColumns.has("user_create_time")) {
+    db.exec(`ALTER TABLE raw_jobs ADD COLUMN user_create_time INTEGER`);
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS videos (
       id TEXT PRIMARY KEY,
@@ -384,6 +393,30 @@ function initUserDb(filePath) {
     db.exec(`ALTER TABLE videos ADD COLUMN create_time INTEGER`);
   }
 
+  // tags 表：标签发现与打分系统
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS tags (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      tag TEXT NOT NULL UNIQUE,
+      status TEXT NOT NULL DEFAULT 'new',
+      score REAL NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      scored_at TEXT,
+      score_count INTEGER NOT NULL DEFAULT 0,
+      countries TEXT NOT NULL DEFAULT '[]',
+      matched_countries TEXT DEFAULT '[]',
+      total_posts INTEGER DEFAULT 0,
+      author_count INTEGER DEFAULT 0,
+      matched_authors INTEGER DEFAULT 0,
+      pushed_users INTEGER DEFAULT 0,
+      source TEXT NOT NULL DEFAULT 'llm',
+      user_prompt TEXT,
+      last_error TEXT
+    )
+  `);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_tags_status ON tags(status)`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_tags_score ON tags(score DESC)`);
+
   const count = db.prepare("SELECT COUNT(*) as c FROM users").get().c;
   console.log(`[data-store] SQLite users 表初始化完成: ${count} 条`);
 }
@@ -956,7 +989,7 @@ function moveJobsToRawByCountry(scope, country) {
       guessed_location, location_created, follower_count,
       following_count, heart_count, refresh_time, processed,
       processed_at, created_at, updated_at, region, signature,
-      sec_uid, latest_video_time
+      sec_uid, latest_video_time, user_create_time
     `;
   } else if (normalizedScope === "userUpdate") {
     sourceTable = "jobs_base";
@@ -968,7 +1001,7 @@ function moveJobsToRawByCountry(scope, country) {
       guessed_location, location_created, follower_count,
       following_count, heart_count, refresh_time, processed,
       processed_at, created_at, updated_at, region, signature,
-      sec_uid, latest_video_time
+      sec_uid, latest_video_time, user_create_time
     `;
   } else {
     return {
@@ -1307,6 +1340,158 @@ function getRawJobsPageFromDb({
   };
 }
 
+// ====== Tag 发现与打分 CRUD ======
+
+function insertTag(tag, countries, source = "llm") {
+  if (!db) return { inserted: false, error: "db not ready" };
+  try {
+    const result = db
+      .prepare(
+        `
+      INSERT OR IGNORE INTO tags (tag, countries, source)
+      VALUES (?, ?, ?)
+    `,
+      )
+      .run(tag, JSON.stringify(countries), source);
+    return { inserted: result.changes > 0, tag };
+  } catch (e) {
+    return { inserted: false, error: e.message };
+  }
+}
+
+function getTagsByStatus(status, limit = 100) {
+  if (!db) return [];
+  const rows = db
+    .prepare(
+      `
+    SELECT * FROM tags WHERE status = ? ORDER BY score ASC, created_at ASC LIMIT ?
+  `,
+    )
+    .all(status, limit);
+  return rows.map((r) => ({
+    ...r,
+    countries: JSON.parse(r.countries || "[]"),
+    matched_countries: JSON.parse(r.matched_countries || "[]"),
+  }));
+}
+
+function getTagsByCountry(country, minScore = 0) {
+  if (!db) return [];
+  const rows = db
+    .prepare(
+      `
+    SELECT * FROM tags WHERE status != 'dead'
+    ORDER BY score DESC
+  `,
+    )
+    .all();
+  // Filter in JS since countries is JSON
+  return rows
+    .map((r) => ({
+      ...r,
+      countries: JSON.parse(r.countries || "[]"),
+      matched_countries: JSON.parse(r.matched_countries || "[]"),
+    }))
+    .filter((r) => r.countries.includes(country) && r.score >= minScore);
+}
+
+function getDeadTags(country) {
+  if (!db) return [];
+  const rows = db
+    .prepare(
+      `
+    SELECT * FROM tags WHERE status = 'dead' ORDER BY score ASC
+  `,
+    )
+    .all();
+  return rows
+    .map((r) => ({
+      ...r,
+      countries: JSON.parse(r.countries || "[]"),
+      matched_countries: JSON.parse(r.matched_countries || "[]"),
+    }))
+    .filter((r) => r.countries.includes(country));
+}
+
+function claimTag(tag) {
+  if (!db) return { ok: false, error: "db not ready" };
+  const row = db.prepare("SELECT status FROM tags WHERE tag = ?").get(tag);
+  if (!row) return { ok: false, error: "tag not found" };
+  if (row.status !== "new")
+    return { ok: false, error: `tag status is ${row.status}, not new` };
+  db.prepare("UPDATE tags SET status = 'scoring' WHERE tag = ?").run(tag);
+  return { ok: true, tag, previousStatus: row.status };
+}
+
+function reportTagScore(tag, fields) {
+  if (!db) return { ok: false, error: "db not ready" };
+  const {
+    score,
+    status,
+    totalPosts,
+    authorCount,
+    matchedAuthors,
+    matchedCountries,
+    pushedUsers,
+    error,
+  } = fields;
+  const matchedCountriesJson = matchedCountries
+    ? JSON.stringify(matchedCountries)
+    : null;
+  const now = new Date().toISOString();
+
+  try {
+    const result = db
+      .prepare(
+        `
+      UPDATE tags SET
+        score = COALESCE(?, score),
+        status = COALESCE(?, status),
+        total_posts = COALESCE(?, total_posts),
+        author_count = COALESCE(?, author_count),
+        matched_authors = COALESCE(?, matched_authors),
+        matched_countries = COALESCE(?, matched_countries),
+        pushed_users = COALESCE(?, pushed_users),
+        last_error = COALESCE(?, last_error),
+        scored_at = ?,
+        score_count = score_count + 1
+      WHERE tag = ?
+    `,
+      )
+      .run(
+        score ?? null,
+        status ?? null,
+        totalPosts ?? null,
+        authorCount ?? null,
+        matchedAuthors ?? null,
+        matchedCountriesJson,
+        pushedUsers ?? null,
+        error ?? null,
+        now,
+        tag,
+      );
+    return { ok: result.changes > 0, tag };
+  } catch (e) {
+    return { ok: false, error: e.message };
+  }
+}
+
+function getAllTags(limit = 200) {
+  if (!db) return [];
+  const rows = db
+    .prepare(
+      `
+    SELECT * FROM tags ORDER BY score DESC, created_at DESC LIMIT ?
+  `,
+    )
+    .all(limit);
+  return rows.map((r) => ({
+    ...r,
+    countries: JSON.parse(r.countries || "[]"),
+    matched_countries: JSON.parse(r.matched_countries || "[]"),
+  }));
+}
+
 // 调试接口：直接执行 SQL 查询，返回原始数据
 function rawQuery(sql, params = []) {
   if (!db) return { error: "db not ready" };
@@ -1668,6 +1853,7 @@ const writableJobColumns = new Set([
   "latest_video_time",
   "top_video_play_count",
   "top_video_href",
+  "user_create_time",
 ]);
 
 function normalizeJobValue(column, value) {
@@ -1761,8 +1947,9 @@ function updateJobInfo(uniqueId, info, incrementCount = true) {
     if (key === "uniqueId" || key === "unique_id") continue;
     if (value === undefined || value === "") continue;
     let column = camelToSnake(key);
-    // 字段别名：bio → signature
+    // 字段别名：bio → signature, createTime → user_create_time
     if (column === "bio") column = "signature";
+    if (column === "create_time") column = "user_create_time";
     if (!writableJobColumns.has(column)) continue;
     nextValues[column] = normalizeJobValue(column, value);
   }
@@ -1805,8 +1992,9 @@ function updateJobBaseInfo(uniqueId, info, incrementCount = true) {
     if (key === "uniqueId" || key === "unique_id") continue;
     if (value === undefined || value === "") continue;
     let column = camelToSnake(key);
-    // 字段别名：bio → signature
+    // 字段别名：bio → signature, createTime → user_create_time
     if (column === "bio") column = "signature";
+    if (column === "create_time") column = "user_create_time";
     if (!writableJobColumns.has(column)) continue;
     nextValues[column] = normalizeJobValue(column, value);
   }
@@ -2194,6 +2382,43 @@ export function createStore(filePath, options = {}) {
     }
   }
 
+  function addRawUsers(users) {
+    if (!Array.isArray(users)) return { added: 0, skipped: 0 };
+    const now = Date.now();
+    let added = 0;
+    let skipped = 0;
+
+    for (const u of users) {
+      const uniqueId = (u.uniqueId || "").replace(/^@/, "").trim();
+      if (!uniqueId) continue;
+      if (hasUser(uniqueId)) {
+        skipped++;
+        continue;
+      }
+      const userObj = {
+        uniqueId,
+        status: "pending",
+        sources: Array.isArray(u.sources)
+          ? u.sources
+          : u.sources
+            ? [u.sources]
+            : ["tag"],
+        guessedLocation: u.guessedLocation || u.locationCreated || null,
+        locationCreated: u.locationCreated || null,
+        createdAt: now,
+        updatedAt: now,
+      };
+      const writeTxn = db.transaction((job) => {
+        addUserToDb(job);
+        addJobBaseToDb(job);
+      });
+      writeTxn(userObj);
+      added++;
+    }
+
+    return { added, skipped };
+  }
+
   function getPendingUsers() {
     if (db) {
       return getAllJobs().filter((u) => u.status === "pending");
@@ -2410,7 +2635,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
 
     // 构建 WHERE 条件
     const conditions = [
-      "COALESCE(video_count, 0) > 0",
+      "COALESCE(video_count, 0) > 6",
       "COALESCE(follower_count, 0) > 0",
       "COALESCE(following_count, 0) > 0",
     ];
@@ -2496,7 +2721,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
               .prepare(
                 `
                 SELECT * FROM raw_jobs WHERE ${whereSql} AND guessed_location = ?
-                ORDER BY created_at DESC
+                ORDER BY COALESCE(video_count, 0) DESC, created_at DESC
                 LIMIT ? OFFSET ?
               `,
               )
@@ -2610,7 +2835,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
           guessed_location, location_created, confirmed_location,
           follower_count, following_count, heart_count,
           created_at, updated_at, region, signature, bio_link, sec_uid,
-          status_code, latest_video_time
+          status_code, latest_video_time, user_create_time
         )
         SELECT
           unique_id, nickname, 'pending', sources, pinned,
@@ -2618,10 +2843,10 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
           guessed_location, location_created, confirmed_location,
           follower_count, following_count, heart_count,
           created_at, updated_at, region, signature, bio_link, sec_uid,
-          status_code, latest_video_time
+          status_code, latest_video_time, user_create_time
         FROM raw_jobs
         WHERE ${whereSql}
-        ORDER BY created_at DESC
+        ORDER BY COALESCE(video_count, 0) DESC, created_at DESC
         LIMIT ?
       `,
       ).run(...args, safeLimit);
@@ -2633,7 +2858,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
         WHERE unique_id IN (
           SELECT unique_id FROM raw_jobs
           WHERE ${whereSql}
-          ORDER BY created_at DESC
+          ORDER BY COALESCE(video_count, 0) DESC, created_at DESC
           LIMIT ?
         )
       `,
@@ -3734,20 +3959,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
       const now = Date.now();
       const threshold = now - maxAgeSeconds * 1000;
       const defaultTime = new Date("2016-01-01T00:00:00Z").getTime();
-      const targetLocations = [
-        "CZ",
-        "GR",
-        "HU",
-        "PT",
-        "ES",
-        "PL",
-        "NL",
-        "BE",
-        "DE",
-        "FR",
-        "IT",
-        "IE",
-      ];
+      const targetLocations = DEFAULT_TARGET_LOCATIONS;
       const placeholders = targetLocations.map(() => "?").join(",");
       const row = db
         .prepare(
@@ -3758,7 +3970,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             AND verified = 0
             AND location_created IN (${placeholders})
             AND COALESCE(refresh_time, ?) < ?
-          ORDER BY COALESCE(refresh_time, ?) ASC
+          ORDER BY COALESCE(pinned, 0) DESC, COALESCE(refresh_time, ?) ASC
           LIMIT 1
         `,
         )
@@ -3779,20 +3991,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
     const defaultTime = new Date("2016-01-01T00:00:00Z").getTime();
 
     // 筛选目标国家用户，按 refreshTime 升序取最远的（没有则默认 2016-01-01）
-    const targetLocations = [
-      "CZ",
-      "GR",
-      "HU",
-      "PT",
-      "ES",
-      "PL",
-      "NL",
-      "BE",
-      "DE",
-      "FR",
-      "IT",
-      "IE",
-    ];
+    const targetLocations = DEFAULT_TARGET_LOCATIONS;
     const targetUsers = data.filter(
       (u) =>
         u.ttSeller &&
@@ -3808,6 +4007,10 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
     if (recentEnough.length === 0) return null;
 
     recentEnough.sort((a, b) => {
+      // pinned 优先，其次按 refreshTime 升序
+      if ((a.pinned ? 1 : 0) !== (b.pinned ? 1 : 0)) {
+        return (b.pinned ? 1 : 0) - (a.pinned ? 1 : 0);
+      }
       const ta = a.refreshTime || defaultTime;
       const tb = b.refreshTime || defaultTime;
       return ta - tb;
@@ -4101,7 +4304,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
           guessed_location, location_created, confirmed_location, modified_at,
           follower_count, following_count, heart_count, refresh_time,
           processed, processed_at, created_at, updated_at,
-          region, signature, bio_link, sec_uid, status_code, latest_video_time
+          region, signature, bio_link, sec_uid, status_code, latest_video_time,
+          user_create_time
         )
         SELECT
           unique_id, nickname, status, sources, claimed_by, claimed_at,
@@ -4110,7 +4314,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
           guessed_location, location_created, confirmed_location, modified_at,
           follower_count, following_count, heart_count, refresh_time,
           processed, processed_at, created_at, updated_at,
-          region, signature, bio_link, sec_uid, status_code, latest_video_time
+          region, signature, bio_link, sec_uid, status_code, latest_video_time,
+          user_create_time
         FROM jobs WHERE unique_id = ?
       `,
       ).run(safeId);
@@ -4149,11 +4354,12 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             return;
           }
 
-          // 检查 tt_seller：商家移到 jobs，非商家移到 raw_jobs
+          // 检查 tt_seller：商家且视频数>0移到 jobs，否则移到 raw_jobs
           const row = getJobBaseRow(uniqueId);
           const ttSeller = row ? row.tt_seller : null;
-          if (ttSeller) {
-            // 商家：标记移动到 jobs
+          const videoCount = row ? row.video_count || 0 : 0;
+          if (ttSeller && videoCount > 0) {
+            // 商家且有视频：标记移动到 jobs
             results.push({
               uniqueId,
               ok: true,
@@ -4162,7 +4368,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             });
             sellerMoveList.push(uniqueId);
           } else {
-            // 非商家：标记移动到 raw_jobs
+            // 非商家或无视频：标记移动到 raw_jobs
             results.push({
               uniqueId,
               ok: true,
@@ -4187,7 +4393,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             guessed_location, location_created, confirmed_location, modified_at,
             follower_count, following_count, heart_count, refresh_time,
             processed, processed_at, created_at, updated_at,
-            region, signature, bio_link, sec_uid, status_code, latest_video_time
+            region, signature, bio_link, sec_uid, status_code, latest_video_time,
+            user_create_time
           )
           SELECT
             unique_id, nickname, status, sources, claimed_by, claimed_at,
@@ -4196,7 +4403,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             guessed_location, location_created, confirmed_location, modified_at,
             follower_count, following_count, heart_count, refresh_time,
             processed, processed_at, created_at, updated_at,
-            region, signature, bio_link, sec_uid, status_code, latest_video_time
+            region, signature, bio_link, sec_uid, status_code, latest_video_time,
+            user_create_time
           FROM jobs_base WHERE unique_id IN (${placeholders})
         `,
         ).run(...sellerMoveList);
@@ -4218,7 +4426,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             guessed_location, location_created, confirmed_location, modified_at,
             follower_count, following_count, heart_count, refresh_time,
             processed, processed_at, created_at, updated_at,
-            region, signature, bio_link, sec_uid, status_code, latest_video_time
+            region, signature, bio_link, sec_uid, status_code, latest_video_time,
+            user_create_time
           )
           SELECT
             unique_id, nickname, status, sources, claimed_by, claimed_at,
@@ -4227,7 +4436,8 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
             guessed_location, location_created, confirmed_location, modified_at,
             follower_count, following_count, heart_count, refresh_time,
             processed, processed_at, created_at, updated_at,
-            region, signature, bio_link, sec_uid, status_code, latest_video_time
+            region, signature, bio_link, sec_uid, status_code, latest_video_time,
+            user_create_time
           FROM jobs_base WHERE unique_id IN (${placeholders})
         `,
         ).run(...rawMoveList);
@@ -4483,6 +4693,7 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
     hasUser,
     userExists,
     addUser,
+    addRawUsers,
     getPendingUsers,
     getProcessedUsers,
     getAllUsers,
@@ -4540,6 +4751,14 @@ Standards: 90-100=clear match, 70-89=likely, 50-69=possible, 20-49=low, 0-19=unl
     stopBackup,
     rawQuery,
     getLlmSampleOffsets, // 获取 LLM 采样偏移量状态
+    // Tag 发现与打分
+    insertTag,
+    getTagsByStatus,
+    getTagsByCountry,
+    getDeadTags,
+    claimTag,
+    reportTagScore,
+    getAllTags,
     data,
   };