tt-help-cli-ycl 1.4.27 → 1.4.28

package/src/watch/db-columns.js

@@ -117,6 +117,7 @@ export const VIDEO_COLUMNS = [
   "tt_seller",
   "registered_at",
   "user_update_count",
+  "claimed_at",
   "play_count",
   "digg_count",
   "comment_count",

package/src/watch/db-crud.js

@@ -158,7 +158,7 @@ export function addJobToDb(user) {
     "bio_link",
     "sec_uid",
   ];
-  db.prepare(insertIgnoreSql("jobs", columns)).run(
+  db.prepare(insertIgnoreSql("task_queue", columns)).run(
     user.uniqueId,
     user.nickname || null,
     user.status || inferStatus(user),
@@ -312,9 +312,28 @@ export function addJob(user) {
 export function getJobRow(uniqueId) {
   const db = getDb();
   if (!db) return null;
+  // 优先查 task_queue（热数据），回退 jobs（归档）
+  const row = db
+    .prepare("SELECT * FROM task_queue WHERE unique_id = ?")
+    .get(uniqueId);
+  if (row) return row;
   return db.prepare("SELECT * FROM jobs WHERE unique_id = ?").get(uniqueId);
 }
 
+/**
+ * 判断用户在哪个表，返回 'task_queue' 或 'jobs'
+ * 用于需要更新正确表的场景（置顶、重置、移动等）
+ */
+export function getUserTable(uniqueId) {
+  const db = getDb();
+  if (!db) return null;
+  return db
+    .prepare("SELECT 1 FROM task_queue WHERE unique_id = ?")
+    .get(uniqueId)
+    ? "task_queue"
+    : "jobs";
+}
+
 export function getJobBaseRow(uniqueId) {
   const db = getDb();
   if (!db) return null;
@@ -377,7 +396,12 @@ export function getAllVideoRows() {
 
 // ===== 更新 Job 信息 =====
 
-export function updateJobInfo(uniqueId, info, incrementCount = true) {
+export function updateJobInfo(
+  uniqueId,
+  info,
+  incrementCount = true,
+  tableName = "jobs",
+) {
   const db = getDb();
   if (!db) return { error: "db not initialized" };
   const existing = getJobRow(uniqueId);
@@ -401,7 +425,7 @@ export function updateJobInfo(uniqueId, info, incrementCount = true) {
 
   const columns = Object.keys(nextValues);
   if (columns.length > 0) {
-    const sql = `UPDATE jobs SET ${updateSetClause(columns)} WHERE unique_id = ?`;
+    const sql = `UPDATE ${tableName} SET ${updateSetClause(columns)} WHERE unique_id = ?`;
     db.prepare(sql).run(...columns.map((c) => nextValues[c]), uniqueId);
   }
 

package/src/watch/db-raw-jobs.js

@@ -103,7 +103,7 @@ export function restoreRawJobsByCountry(country) {
 
   const restoreTxn = db.transaction((targetCountry) => {
     db.prepare(
-      `INSERT OR REPLACE INTO jobs (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE ${whereSql}`,
+      `INSERT OR REPLACE INTO task_queue (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE ${whereSql}`,
     ).run(targetCountry);
     db.prepare(`DELETE FROM raw_jobs WHERE ${whereSql}`).run(targetCountry);
   });
@@ -128,7 +128,7 @@ export function restoreRawJobById(uniqueId) {
 
   const restoreTxn = db.transaction(() => {
     db.prepare(
-      `INSERT OR REPLACE INTO jobs (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE unique_id = ?`,
+      `INSERT OR REPLACE INTO task_queue (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE unique_id = ?`,
     ).run(safeId);
     db.prepare("DELETE FROM raw_jobs WHERE unique_id = ?").run(safeId);
   });
@@ -176,7 +176,7 @@ export function restoreRawJobsByFilter({
 
   const restoreTxn = db.transaction(() => {
     db.prepare(
-      `INSERT OR REPLACE INTO jobs (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE ${whereSql}`,
+      `INSERT OR REPLACE INTO task_queue (${RESTORE_COLUMNS}) SELECT ${RESTORE_COLUMNS} FROM raw_jobs WHERE ${whereSql}`,
     ).run(...args);
     db.prepare(`DELETE FROM raw_jobs WHERE ${whereSql}`).run(...args);
   });

package/src/watch/db-schema.js

@@ -132,6 +132,34 @@ export function initDb(filePath) {
     recent_ec_videos: "TEXT",
   });
 
+  // ===== task_queue 表（热数据：仅 pending + processing，高频读写） =====
+  // 直接复制 jobs 表结构（含所有历史迁移列），确保列完全一致
+  const tqExists = db
+    .prepare(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='task_queue'",
+    )
+    .get();
+  if (!tqExists) {
+    db.exec(`CREATE TABLE task_queue AS SELECT * FROM jobs WHERE 1=0`);
+    // 补主键（CREATE TABLE ... AS 不会复制约束）
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_tq_pk ON task_queue(unique_id)`,
+    );
+  }
+  // 后续迁移也要给 task_queue 补列
+  migrateColumns("task_queue", {
+    status_code: "INTEGER",
+    latest_video_time: "INTEGER",
+    confirmed_location: "TEXT",
+    modified_at: "INTEGER",
+    bio_link: "TEXT",
+    top_video_play_count: "INTEGER",
+    top_video_href: "TEXT",
+    top_video_is_ad: "INTEGER",
+    user_create_time: "INTEGER",
+    recent_ec_videos: "TEXT",
+  });
+
   // ===== jobs_base 表 =====
   db.exec(`
     CREATE TABLE IF NOT EXISTS jobs_base (
@@ -226,6 +254,21 @@ export function initDb(filePath) {
   });
 
   // ===== videos 表 =====
+  // 首次启动时将旧 videos 重命名为 videos_old，创建全新 videos 表
+  const videosOldExists = db
+    .prepare(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='videos_old'",
+    )
+    .get();
+  const videosExists = db
+    .prepare(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='videos'",
+    )
+    .get();
+  if (!videosOldExists && videosExists) {
+    db.exec("ALTER TABLE videos RENAME TO videos_old");
+    console.log("[data-store] videos → videos_old");
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS videos (
       id TEXT PRIMARY KEY,
@@ -252,6 +295,18 @@ export function initDb(filePath) {
     collect_count: "INTEGER",
     stats_updated_at: "INTEGER",
     create_time: "INTEGER",
+    claimed_at: "INTEGER",
+  });
+  // videos_old 同步添加列（已重命名的旧 videos 表）
+  migrateColumns("videos_old", {
+    play_count: "INTEGER",
+    digg_count: "INTEGER",
+    comment_count: "INTEGER",
+    share_count: "INTEGER",
+    collect_count: "INTEGER",
+    stats_updated_at: "INTEGER",
+    create_time: "INTEGER",
+    claimed_at: "INTEGER",
   });
 
   // ===== tags 表 =====
@@ -284,6 +339,9 @@ export function initDb(filePath) {
     direction_id: "INTEGER",
     refreshing: "INTEGER DEFAULT 0",
     refreshed_at: "TEXT",
+    searching: "INTEGER DEFAULT 0",
+    searched_at: "TEXT",
+    searched_users: "INTEGER DEFAULT 0",
   });
 
   // ===== tag_directions 表（分层探索：通用词/分类/产品） =====
@@ -415,6 +473,7 @@ export function initDb(filePath) {
     `CREATE INDEX IF NOT EXISTS idx_jobs_user_update_queue_expr ON jobs(created_at ASC, unique_id ASC) WHERE COALESCE(tt_seller, '') = '' AND COALESCE(user_update_count, 0) <= 0`,
     `CREATE INDEX IF NOT EXISTS idx_videos_comment_queue ON videos(user_update_count, tt_seller DESC, registered_at ASC)`,
     `CREATE INDEX IF NOT EXISTS idx_videos_comment_queue_pending ON videos(tt_seller DESC, registered_at ASC, id) WHERE user_update_count IS NULL OR user_update_count <= 0`,
+    `CREATE INDEX IF NOT EXISTS idx_videos_old_id ON videos_old(id)`,
     `CREATE INDEX IF NOT EXISTS idx_tags_status ON tags(status)`,
     `CREATE INDEX IF NOT EXISTS idx_tags_score ON tags(score DESC)`,
     `CREATE INDEX IF NOT EXISTS idx_discover_log_country ON discover_log(country, round DESC)`,
@@ -426,11 +485,52 @@ export function initDb(filePath) {
     `CREATE INDEX IF NOT EXISTS idx_cross_country_target ON cross_country_learnings(target_country)`,
     `CREATE INDEX IF NOT EXISTS idx_tags_dead_reason ON tags(dead_reason)`,
     `CREATE INDEX IF NOT EXISTS idx_jobs_recheck ON jobs(status, updated_at) WHERE status = 'done' AND (tt_seller IS NULL OR tt_seller != 1)`,
+    // 监控页面用户列表查询加速（简化排序：pinned DESC, processed_at DESC, follower_count DESC, unique_id ASC）
+    `CREATE INDEX IF NOT EXISTS idx_jobs_list_done ON jobs(pinned, processed_at, follower_count, unique_id) WHERE status = 'done'`,
+    `CREATE INDEX IF NOT EXISTS idx_jobs_list_error ON jobs(pinned, processed_at, follower_count, unique_id) WHERE status = 'error'`,
+    `CREATE INDEX IF NOT EXISTS idx_jobs_list_restricted ON jobs(pinned, processed_at, follower_count, unique_id) WHERE status = 'restricted'`,
   ];
   for (const sql of indexes) {
     db.exec(sql);
   }
 
+  // ===== task_queue 索引（对应 claimNextJob UNION 查询的 4 个部分索引） =====
+  const tqIndexes = [
+    `CREATE INDEX IF NOT EXISTS idx_tq_status ON task_queue(status)`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_claimed_by_status ON task_queue(claimed_by, status, claimed_at)`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_status_claimed_at ON task_queue(status, claimed_at)`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_claim_pending_pinned ON task_queue(created_at ASC, unique_id ASC) WHERE status = 'pending' AND COALESCE(pinned, 0) = 1`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_claim_pending_seller ON task_queue(UPPER(COALESCE(guessed_location, '')), follower_count DESC, created_at ASC, unique_id ASC) WHERE status = 'pending' AND COALESCE(pinned, 0) = 0 AND tt_seller = 1 AND verified = 0`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_claim_pending_follow ON task_queue(UPPER(COALESCE(guessed_location, '')), follower_count DESC, created_at ASC, unique_id ASC) WHERE status = 'pending' AND COALESCE(pinned, 0) = 0 AND (instr(COALESCE(sources, ''), '"following"') > 0 OR instr(COALESCE(sources, ''), '"follower"') > 0)`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_claim_pending_other ON task_queue(UPPER(COALESCE(guessed_location, '')), follower_count DESC, created_at ASC, unique_id ASC) WHERE status = 'pending' AND COALESCE(pinned, 0) = 0`,
+    // 监控页面用户列表查询加速
+    `CREATE INDEX IF NOT EXISTS idx_tq_list_pending ON task_queue(pinned, processed_at, follower_count, unique_id) WHERE status = 'pending'`,
+    `CREATE INDEX IF NOT EXISTS idx_tq_list_processing ON task_queue(pinned, processed_at, follower_count, unique_id) WHERE status = 'processing'`,
+  ];
+  for (const sql of tqIndexes) {
+    db.exec(sql);
+  }
+
+  // 首次迁移：将 jobs 中的 pending/processing 行移动到 task_queue
+  const tqCount = db.prepare("SELECT COUNT(*) as c FROM task_queue").get().c;
+  if (tqCount === 0) {
+    const moved = db
+      .prepare(
+        `
+      INSERT INTO task_queue SELECT * FROM jobs WHERE status IN ('pending', 'processing')
+    `,
+      )
+      .run().changes;
+    if (moved > 0) {
+      db.prepare(
+        `DELETE FROM jobs WHERE status IN ('pending', 'processing')`,
+      ).run();
+      console.log(
+        `[data-store] 迁移 ${moved} 条 pending/processing → task_queue`,
+      );
+    }
+  }
+
   const count = db.prepare("SELECT COUNT(*) as c FROM users").get().c;
   console.log(`[data-store] SQLite users 表初始化完成: ${count} 条`);
 }

package/src/watch/db-stats.js

@@ -15,13 +15,33 @@ export function getDashboardStatsFromDb(targetLocations = [], options = {}) {
   const targetPlaceholders = targetLocations.map(() => "?").join(", ");
   const targetParams = targetLocations.length ? targetLocations : [];
 
-  const aggregateRow = db
+  // Phase 2: pending/processing/source 从 task_queue，done/error/restricted 从 jobs
+  const tqAgg = db
     .prepare(
-      `
-      SELECT
-        COUNT(*) as total,
+      `SELECT
+        COUNT(*) as tqTotal,
         SUM(CASE WHEN status = 'pending' THEN 1 ELSE 0 END) as pending,
         SUM(CASE WHEN status = 'processing' THEN 1 ELSE 0 END) as processing,
+        SUM(CASE WHEN instr(COALESCE(sources, ''), '"video"') > 0 THEN 1 ELSE 0 END) as video,
+        SUM(CASE WHEN instr(COALESCE(sources, ''), '"comment"') > 0 THEN 1 ELSE 0 END) as comment,
+        SUM(CASE WHEN instr(COALESCE(sources, ''), '"guess"') > 0 THEN 1 ELSE 0 END) as guess,
+        SUM(CASE WHEN instr(COALESCE(sources, ''), '"following"') > 0 THEN 1 ELSE 0 END) as following,
+        SUM(CASE WHEN instr(COALESCE(sources, ''), '"follower"') > 0 THEN 1 ELSE 0 END) as follower,
+        SUM(CASE
+          WHEN instr(COALESCE(sources, ''), '"video"') = 0
+            AND instr(COALESCE(sources, ''), '"comment"') = 0
+            AND instr(COALESCE(sources, ''), '"guess"') = 0
+            AND instr(COALESCE(sources, ''), '"following"') = 0
+            AND instr(COALESCE(sources, ''), '"follower"') = 0
+          THEN 1 ELSE 0 END) as seed
+      FROM task_queue`,
+    )
+    .get();
+
+  const jobsAgg = db
+    .prepare(
+      `SELECT
+        COUNT(*) as jobsTotal,
         SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) as done,
         SUM(CASE WHEN status = 'error' THEN 1 ELSE 0 END) as error,
         SUM(CASE WHEN status = 'restricted' THEN 1 ELSE 0 END) as restricted,
@@ -30,25 +50,28 @@ export function getDashboardStatsFromDb(targetLocations = [], options = {}) {
             ? `AND location_created IN (${targetPlaceholders})`
             : "AND 1 = 0"
         } THEN 1 ELSE 0 END) as targetUsers,
-        SUM(CASE WHEN no_video = 1 THEN 1 ELSE 0 END) as noVideo,
-        SUM(CASE WHEN status != 'done' AND instr(COALESCE(sources, ''), '"video"') > 0 THEN 1 ELSE 0 END) as video,
-        SUM(CASE WHEN status != 'done' AND instr(COALESCE(sources, ''), '"comment"') > 0 THEN 1 ELSE 0 END) as comment,
-        SUM(CASE WHEN status != 'done' AND instr(COALESCE(sources, ''), '"guess"') > 0 THEN 1 ELSE 0 END) as guess,
-        SUM(CASE WHEN status != 'done' AND instr(COALESCE(sources, ''), '"following"') > 0 THEN 1 ELSE 0 END) as following,
-        SUM(CASE WHEN status != 'done' AND instr(COALESCE(sources, ''), '"follower"') > 0 THEN 1 ELSE 0 END) as follower,
-        SUM(CASE
-          WHEN status != 'done'
-            AND instr(COALESCE(sources, ''), '"video"') = 0
-            AND instr(COALESCE(sources, ''), '"comment"') = 0
-            AND instr(COALESCE(sources, ''), '"guess"') = 0
-            AND instr(COALESCE(sources, ''), '"following"') = 0
-            AND instr(COALESCE(sources, ''), '"follower"') = 0
-          THEN 1 ELSE 0 END) as seed
-      FROM jobs
-    `,
+        SUM(CASE WHEN no_video = 1 THEN 1 ELSE 0 END) as noVideo
+      FROM jobs`,
     )
     .get(...targetParams);
 
+  const aggregateRow = {
+    total: tqAgg.tqTotal + jobsAgg.jobsTotal,
+    pending: tqAgg.pending,
+    processing: tqAgg.processing,
+    done: jobsAgg.done,
+    error: jobsAgg.error,
+    restricted: jobsAgg.restricted,
+    targetUsers: jobsAgg.targetUsers,
+    noVideo: jobsAgg.noVideo,
+    video: tqAgg.video,
+    comment: tqAgg.comment,
+    guess: tqAgg.guess,
+    following: tqAgg.following,
+    follower: tqAgg.follower,
+    seed: tqAgg.seed,
+  };
+
   const userUpdateTasksRow = db
     .prepare(
       `SELECT COUNT(*) as userUpdateTasks FROM jobs_base WHERE COALESCE(user_update_count, 0) <= 0`,
@@ -145,7 +168,7 @@ export function getPendingByCountryFromDb() {
   return db
     .prepare(
       `SELECT COALESCE(guessed_location, '未知') as country, COUNT(*) as count
-       FROM jobs WHERE status = 'pending'
+       FROM task_queue WHERE status = 'pending'
        GROUP BY COALESCE(guessed_location, '未知')
        ORDER BY count DESC`,
     )
@@ -237,13 +260,13 @@ export function resetPendingByCountry(country) {
   const whereSql = `status = 'pending' AND COALESCE(guessed_location, '未知') = ?`;
   const count =
     db
-      .prepare(`SELECT COUNT(*) as c FROM jobs WHERE ${whereSql}`)
+      .prepare(`SELECT COUNT(*) as c FROM task_queue WHERE ${whereSql}`)
       .get(normalizedCountry)?.c || 0;
 
   if (!count) return { reset: 0, country: normalizedCountry };
 
   db.prepare(
-    `UPDATE jobs SET user_update_count = 0, updated_at = ?, claimed_by = NULL, claimed_at = NULL WHERE ${whereSql}`,
+    `UPDATE task_queue SET user_update_count = 0, updated_at = ?, claimed_by = NULL, claimed_at = NULL WHERE ${whereSql}`,
   ).run(Date.now(), normalizedCountry);
 
   return { reset: count, country: normalizedCountry };

package/src/watch/db-tags.js

@@ -103,6 +103,7 @@ export function getTagsByStatus(
   offset = 0,
   country = null,
   search = null,
+  source = null,
 ) {
   const db = getDb();
   if (!db) return [];
@@ -116,8 +117,12 @@ export function getTagsByStatus(
     sql += " AND tag LIKE ?";
     params.push(`%${search}%`);
   }
+  if (source) {
+    sql += " AND source = ?";
+    params.push(source);
+  }
   sql +=
-    " ORDER BY refreshed_at DESC NULLS LAST, score ASC, created_at ASC LIMIT ? OFFSET ?";
+    " ORDER BY CASE WHEN source = 'llm' THEN 0 ELSE 1 END, refreshed_at DESC NULLS LAST, score ASC, created_at ASC LIMIT ? OFFSET ?";
   params.push(limit, offset);
   const rows = db.prepare(sql).all(...params);
   return rows.map(parseTagRow);
@@ -144,6 +149,7 @@ export function getTagStats(country = null, search = null) {
     SUM(CASE WHEN status = 'productive' THEN 1 ELSE 0 END) as productive,
     SUM(CASE WHEN status = 'dead' THEN 1 ELSE 0 END) as dead,
     SUM(CASE WHEN status = 'new' THEN 1 ELSE 0 END) as newCount,
+    SUM(CASE WHEN status = 'new' AND source = 'llm' THEN 1 ELSE 0 END) as newLlm,
     SUM(CASE WHEN status = 'scoring' THEN 1 ELSE 0 END) as scoring
   FROM tags${whereClause}`;
   const row = db.prepare(sql).get(...params);
@@ -161,6 +167,7 @@ export function getTagStats(country = null, search = null) {
     productive: row.productive || 0,
     dead: row.dead || 0,
     new: row.newCount || 0,
+    newLlm: row.newLlm || 0,
     scoring: row.scoring || 0,
     countries: [...countrySet].sort(),
   };
@@ -1649,3 +1656,95 @@ export function reportRefreshResult(tag, fields) {
     return { ok: false, error: e.message };
   }
 }
+
+// ===== 搜索任务（基于 productive 标签搜索作者） =====
+
+/** 领取一个 productive 标签用于搜索（score>70，未被搜索过） */
+export function getProductiveSearchTask() {
+  const db = getDb();
+  if (!db) return null;
+
+  // 清理超时的 searching 锁（超过 30 分钟）
+  db.prepare(
+    `UPDATE tags SET searching = 0 
+     WHERE searching = 1 AND searched_at IS NOT NULL 
+     AND searched_at < datetime('now', '-30 minutes')`,
+  ).run();
+
+  const row = db
+    .prepare(
+      `SELECT * FROM tags 
+       WHERE status = 'productive' AND score > 70 AND searching = 0 
+       ORDER BY searched_at IS NULL DESC, searched_at ASC 
+       LIMIT 1`,
+    )
+    .get();
+  if (!row) return null;
+  const parsed = parseTagRow(row);
+  return {
+    tag: parsed.tag,
+    score: parsed.score,
+    // 取第一个国家作为搜索结果的猜测国家
+    country: parsed.countries?.[0] || null,
+    countries: parsed.countries,
+    searched_at: parsed.searched_at,
+  };
+}
+
+/** 锁定标签用于搜索（防并发） */
+export function claimSearchTag(tag) {
+  const db = getDb();
+  if (!db) return { ok: false, error: "db not ready" };
+
+  const normalized = tag.replace(/^#+/, "").trim().toLowerCase();
+  if (!normalized || normalized.length < 2) {
+    return { ok: false, error: "invalid tag" };
+  }
+
+  const result = db
+    .prepare(
+      `UPDATE tags SET searching = 1, searched_at = datetime('now') 
+       WHERE (tag = ? OR tag = ?) AND status = 'productive' AND score > 70 AND searching = 0`,
+    )
+    .run(normalized, `#${normalized}`);
+  if (result.changes === 0) {
+    const row = db
+      .prepare("SELECT status, searching FROM tags WHERE tag = ? OR tag = ?")
+      .get(normalized, `#${normalized}`);
+    if (!row) return { ok: false, error: "tag not found" };
+    if (row.searching) return { ok: false, error: "already being searched" };
+    return { ok: false, error: `tag status is ${row.status}, not eligible` };
+  }
+  return { ok: true, tag: normalized };
+}
+
+/** 报告搜索结果并解锁标签 */
+export function reportSearchResult(tag, fields) {
+  const db = getDb();
+  if (!db) return { ok: false, error: "db not ready" };
+  const { searchedUsers, error } = fields;
+  const now = new Date().toISOString();
+  const normalized = tag.replace(/^#+/, "").trim().toLowerCase();
+
+  try {
+    const result = db
+      .prepare(
+        `UPDATE tags SET 
+          searching = 0, 
+          searched_at = ?,
+          searched_users = COALESCE(searched_users, 0) + COALESCE(?, 0),
+          last_error = COALESCE(?, last_error)
+        WHERE tag = ? OR tag = ?`,
+      )
+      .run(
+        now,
+        searchedUsers ?? null,
+        error ?? null,
+        normalized,
+        `#${normalized}`,
+      );
+    return { ok: result.changes > 0, tag: normalized };
+  } catch (e) {
+    return { ok: false, error: e.message };
+  }
+}

package/src/watch/llm-config.js

@@ -125,6 +125,16 @@ function saveToDb(key, value) {
  */
 export function loadLlmConfig() {
   if (_loaded) return;
+  _doLoadLlmConfig();
+}
+
+/** 强制重载配置（用于 sync 程序每轮读取最新模型配置） */
+export function reloadLlmConfig() {
+  _loaded = false;
+  _doLoadLlmConfig();
+}
+
+function _doLoadLlmConfig() {
   const dbConfig = loadFromDb();
 
   _cachedUrl = dbConfig.llm_url || process.env.LLM_URL || LLM_PROVIDERS[0].url;
@@ -141,6 +151,11 @@ export function loadLlmConfig() {
     "";
   _loaded = true;
 
+  // 恢复上次 auto 模式下成功的模型（持久化到 _llm_config）
+  if (_cachedModel === "auto" && dbConfig.auto_last_model) {
+    _lastAutoSuccess = dbConfig.auto_last_model;
+  }
+
   console.error(
     `[llm-config] 加载完成: provider=${_cachedProvider}, model=${_cachedModel}, url=${_cachedUrl}, hasKey=${!!_cachedApiKey}`,
   );
@@ -208,6 +223,7 @@ function clearAutoPoolCache() {
 }
 
 let _lastAutoSuccess = null; // 上次成功的模型，下次优先用它
+let _allDeadUntil = 0; // 全部模型不可用时的冷却时间戳，避免同批次重复遍历
 
 /** 是否处于 auto 模式 */
 export function isAutoMode() {
@@ -215,9 +231,20 @@ export function isAutoMode() {
   return _cachedModel === "auto";
 }
 
-/** 记录 auto 模式下成功调用的模型 */
+/** 记录 auto 模式下成功调用的模型（内存 + 持久化） */
 export function recordAutoSuccess(model) {
   _lastAutoSuccess = model;
+  try {
+    const db = getDb();
+    if (db) {
+      ensureTable();
+      db.prepare(
+        `INSERT INTO _llm_config (key, value) VALUES ('auto_last_model', ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
+      ).run(String(model));
+    }
+  } catch {
+    // 写入失败不影响主流程
+  }
 }
 
 /** 获取 auto 模式候选池（上次成功的排最前，失败时依次尝试） */
@@ -255,6 +282,123 @@ export function getLlmApiKey() {
   return _cachedApiKey;
 }
 
+/**
+ * 统一的 LLM 调用入口，内部处理 auto 模式模型切换、重试、持久化。
+ * @param {{ messages: Array<{role:string,content:string}>, max_tokens?: number, temperature?: number, enable_thinking?: boolean }} opts
+ * @returns {Promise<string>} LLM 返回的文本内容
+ * @throws {Error} 全部模型均失败时抛出
+ */
+export async function llmFetch({
+  messages,
+  max_tokens = 1024,
+  temperature = 0.1,
+  enable_thinking = false,
+} = {}) {
+  if (!_loaded) loadLlmConfig();
+
+  // 全部模型不可用冷却中：同批次直接跳过，不重复遍历 25 个模型
+  if (_allDeadUntil > Date.now()) {
+    throw new Error("全部模型不可用（冷却中）");
+  }
+
+  const url = _cachedUrl;
+  const apiKey = _cachedApiKey;
+  const models = isAutoMode() ? getAutoPool() : [null];
+
+  const { fetch } = await import("undici");
+  let lastError = "";
+  let deadCount = 0;
+
+  for (let i = 0; i < models.length; i++) {
+    if (_allDeadUntil > Date.now()) break; // 同批次其他调用已发现全挂
+    const model = models[i] !== null ? models[i] : resolveModel();
+
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+          model,
+          messages,
+          max_tokens,
+          temperature,
+          enable_thinking,
+        }),
+      });
+    } catch (e) {
+      lastError = e.message;
+      deadCount++;
+      if (deadCount >= models.length) break;
+      console.error(`[llmFetch] ${model} 网络失败: ${e.message}，尝试下一个`);
+      continue;
+    }
+
+    const result = await response.json().catch(() => null);
+    const content = result?.choices?.[0]?.message?.content;
+
+    if (!content) {
+      lastError = result?.error?.message || `HTTP ${response.status}`;
+      deadCount++;
+      if (deadCount >= models.length) break;
+      console.error(`[llmFetch] ${model} 失败: ${lastError}，尝试下一个`);
+      continue;
+    }
+
+    if (i > 0) {
+      console.error(`[llmFetch] ✅ auto 切换成功: ${model}`);
+    }
+
+    if (isAutoMode()) recordAutoSuccess(model);
+    _allDeadUntil = 0; // 成功则清除冷却
+    return content;
+  }
+
+  // 全部失败 → auto 模式下尝试 fallback 模型
+  if (isAutoMode()) {
+    const fbModel =
+      (await loadFromDb()).fallback_model || LLM_PROVIDERS[0].models[0].id;
+    const fbUrl = (await loadFromDb()).fallback_url || LLM_PROVIDERS[0].url;
+    console.error(`[llmFetch] auto 池全挂，尝试 fallback: ${fbModel}`);
+    try {
+      const { fetch: fbFetch } = await import("undici");
+      const fbRes = await fbFetch(fbUrl, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+          model: fbModel,
+          messages,
+          max_tokens,
+          temperature,
+          enable_thinking,
+        }),
+      });
+      const fbJson = await fbRes.json().catch(() => null);
+      const fbContent = fbJson?.choices?.[0]?.message?.content;
+      if (fbContent) {
+        _allDeadUntil = 0;
+        return fbContent;
+      }
+      console.error(
+        `[llmFetch] fallback 也失败: ${fbJson?.error?.message || fbRes.status}`,
+      );
+    } catch (e) {
+      console.error(`[llmFetch] fallback 异常: ${e.message}`);
+    }
+  }
+
+  // 全部失败（含 fallback），冷却 30 秒
+  _allDeadUntil = Date.now() + 30000;
+  console.error(`[llmFetch] ❌ 全部模型均失败（含 fallback），冷却 30s`);
+  throw new Error(`全部模型均失败: ${lastError}`);
+}
+
 /**
  * 更新 LLM 配置（通过 API 调用）
  * @param {{ provider?: string, model?: string, url?: string, apiKey?: string }} updates