rssany 0.1.6 → 0.3.0

package/dist/index.js

@@ -9,7 +9,7 @@ import { join, dirname, basename, resolve, sep, relative } from "node:path";
 import { promisify } from "node:util";
 import puppeteerCore from "puppeteer-core";
 import { parse, NodeType } from "node-html-parser";
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 import { mkdir, writeFile, copyFile, access, rename, readFile, readdir, stat, unlink } from "node:fs/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { createHash } from "node:crypto";
@@ -242,7 +242,7 @@ async function migrateFile(from, to) {
     logger.warn("config", "配置迁移失败", { from, to, err: err instanceof Error ? err.message : String(err) });
   }
 }
-const INIT_DATA_DIR = join(PACKAGE_ROOT, "init");
+const INIT_DATA_DIR = join(PACKAGE_ROOT, "app/init");
 const EXAMPLE_SOURCES = join(INIT_DATA_DIR, "sources.json");
 const EXAMPLE_CONFIG = join(INIT_DATA_DIR, "config.json");
 async function seedExampleConfigsIfMissing() {
@@ -292,16 +292,14 @@ async function initUserDir() {
 }
 const MAIN_DB_JOURNAL = (process.env.RSSANY_DB_JOURNAL ?? "wal").toLowerCase() === "delete" ? "DELETE" : "WAL";
 let _db = null;
-let _dbInit = null;
 let _writeLock = Promise.resolve();
 const MAIN_DB_LOCK_PATH = join(DATA_DIR, "rssany.db.lock");
 function logCorruptDiagnostic(operation, err) {
-  const code = err?.code;
   const msg = err instanceof Error ? err.message : String(err);
   const lines = [
     "[rssany db] 数据库可能损坏或并发冲突",
     `  操作: ${operation}`,
-    `  错误: ${code ?? "unknown"} - ${msg}`,
+    `  错误: ${msg}`,
     "  常见原因:",
     "    1. 多进程同时打开同一库（例如 tsx --watch 与另一实例同时写）",
     "    2. 异常退出后 WAL 未正常 checkpoint",
@@ -437,48 +435,40 @@ function mapRowsToDbItems(rows) {
   return rows.map(toDbItem);
 }
 function isCorruptError(err) {
-  const code = err?.code;
   const msg = err instanceof Error ? err.message : String(err);
-  return code === "SQLITE_CORRUPT" || code === "SQLITE_CORRUPT_VTAB" || msg.includes("database disk image is malformed");
+  return msg.includes("SQLITE_CORRUPT") || msg.includes("database disk image is malformed");
 }
 async function getDb() {
   if (_db) return _db;
-  if (_dbInit) return _dbInit;
   const dbPath = join(DATA_DIR, "rssany.db");
-  _dbInit = (async () => {
-    await mkdir(DATA_DIR, { recursive: true });
-    acquireDbLock(DATA_DIR);
-    let db = null;
-    try {
-      db = new Database(dbPath);
-      db.pragma(`journal_mode = ${MAIN_DB_JOURNAL}`);
-      db.pragma("synchronous = NORMAL");
-      initSchema(db);
-      _db = db;
-      return db;
-    } catch (err) {
-      _dbInit = null;
-      releaseDbLock();
-      if (db) {
-        try {
-          db.close();
-        } catch {
-        }
-        db = null;
-      }
-      if (isCorruptError(err)) {
-        logCorruptDiagnostic("打开/初始化主库 (getDb)", err);
+  await mkdir(DATA_DIR, { recursive: true });
+  acquireDbLock(DATA_DIR);
+  try {
+    _db = new DatabaseSync(dbPath);
+    _db.exec(`PRAGMA journal_mode = ${MAIN_DB_JOURNAL}`);
+    _db.exec("PRAGMA synchronous = NORMAL");
+    initSchema(_db);
+    return _db;
+  } catch (err) {
+    releaseDbLock();
+    if (_db) {
+      try {
+        _db.close();
+      } catch {
       }
-      throw err;
+      _db = null;
+    }
+    if (isCorruptError(err)) {
+      logCorruptDiagnostic("打开/初始化主库 (getDb)", err);
     }
-  })();
-  return _dbInit;
+    throw err;
+  }
 }
 async function runIntegrityCheck() {
   const db = await getDb();
   try {
-    const row = db.prepare("PRAGMA integrity_check").get();
-    return row?.integrity_check ?? "unknown";
+    const result = db.prepare("PRAGMA integrity_check").get();
+    return result?.integrity_check ?? "unknown";
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return `integrity_check 执行失败: ${msg}`;
@@ -486,7 +476,6 @@ async function runIntegrityCheck() {
 }
 const LOGS_DB_PATH = join(DATA_DIR, "logs.db");
 let _logsDb = null;
-let _logsDbInit = null;
 function initLogsSchema(db) {
   db.exec(`
     CREATE TABLE IF NOT EXISTS logs (
@@ -504,17 +493,12 @@ function initLogsSchema(db) {
 }
 async function getLogsDb() {
   if (_logsDb) return _logsDb;
-  if (_logsDbInit) return _logsDbInit;
-  _logsDbInit = (async () => {
-    await mkdir(DATA_DIR, { recursive: true });
-    const db = new Database(LOGS_DB_PATH);
-    db.pragma("journal_mode = WAL");
-    db.pragma("synchronous = NORMAL");
-    initLogsSchema(db);
-    _logsDb = db;
-    return db;
-  })();
-  return _logsDbInit;
+  await mkdir(DATA_DIR, { recursive: true });
+  _logsDb = new DatabaseSync(LOGS_DB_PATH);
+  _logsDb.exec("PRAGMA journal_mode = WAL");
+  _logsDb.exec("PRAGMA synchronous = NORMAL");
+  initLogsSchema(_logsDb);
+  return _logsDb;
 }
 function initSchema(db) {
   db.exec(`
@@ -588,8 +572,8 @@ function initSchema(db) {
     END;
   `);
   try {
-    const info = db.prepare("PRAGMA table_info(items)").all();
-    if (info && !info.some((c) => c.name === "image_url")) {
+    const cols = db.prepare("PRAGMA table_info(items)").all().map((r) => r.name);
+    if (!cols.includes("image_url")) {
       db.exec("ALTER TABLE items ADD COLUMN image_url TEXT");
     }
   } catch {
@@ -597,20 +581,25 @@ function initSchema(db) {
   migrateItemsSourceUrlIfNeeded(db);
 }
 function migrateItemsSourceUrlIfNeeded(db) {
-  const v = db.pragma("user_version", { simple: true });
+  const pragmaResult = db.exec("PRAGMA user_version");
+  const v = pragmaResult?.values?.[0]?.[0] ?? 0;
   if (v >= 2) return;
   const rows = db.prepare("SELECT rowid, source_url FROM items").all();
-  const upd = db.prepare("UPDATE items SET source_url = @next WHERE rowid = @rowid");
-  const run = db.transaction(() => {
+  const updateStmt = db.prepare("UPDATE items SET source_url = @next WHERE rowid = @rowid");
+  db.exec("BEGIN TRANSACTION");
+  try {
     for (const r of rows) {
       const next = canonicalHttpSourceRef(r.source_url);
       if (next !== r.source_url) {
-        upd.run({ next, rowid: r.rowid });
+        updateStmt.run({ next, rowid: r.rowid });
       }
     }
-    db.pragma("user_version = 2");
-  });
-  run();
+    db.exec("PRAGMA user_version = 2");
+    db.exec("COMMIT");
+  } catch (err) {
+    db.exec("ROLLBACK");
+    throw err;
+  }
 }
 async function upsertItems(items, sourceUrlOverride) {
   if (items.length === 0) return { newCount: 0, newIds: /* @__PURE__ */ new Set() };
@@ -621,98 +610,96 @@ async function upsertItems(items, sourceUrlOverride) {
   const sourceUrl = canonicalHttpSourceRef(raw);
   return withWriteLock(async () => {
     const db = await getDb();
-    const stmt = db.prepare(`
-    INSERT OR IGNORE INTO items (id, url, source_url, title, author, summary, image_url, tags, pub_date, fetched_at)
-    VALUES (@id, @url, @sourceUrl, @title, @author, @summary, @imageUrl, @tags, @pubDate, @fetchedAt)
-  `);
-    const selectExistingStmt = db.prepare(`
-    SELECT id, title, author, summary, image_url, pub_date, fetched_at
-    FROM items
-    WHERE id = @id
-  `);
-    const repairExistingStmt = db.prepare(`
-    UPDATE items
-    SET title = @title,
-        author = @author,
-        summary = @summary,
-        image_url = @imageUrl,
-        pub_date = @pubDate,
-        fetched_at = @fetchedAt
-    WHERE id = @id
-  `);
     const now2 = (/* @__PURE__ */ new Date()).toISOString();
     let newCount = 0;
     const newIds = /* @__PURE__ */ new Set();
-    const run = db.transaction((rows) => {
-      for (const item of rows) {
-        const nextTitle = normalizeText(item.title) || null;
-        const nextSummary = normalizeText(item.summary) || null;
-        const nextAuthorArr = normalizeAuthor(item.author);
-        const nextAuthor = nextAuthorArr?.length ? JSON.stringify(nextAuthorArr) : null;
-        const nextPubDate = pubDateToIsoOrNull(item.pubDate);
-        const nextTags = item.tags?.length ? JSON.stringify(item.tags) : null;
-        const nextImageUrl = typeof item.imageUrl === "string" && item.imageUrl.trim() ? item.imageUrl.trim() : null;
-        const info = stmt.run({
-          id: item.guid,
-          url: item.link,
-          sourceUrl,
-          title: nextTitle,
-          author: nextAuthor,
-          summary: nextSummary,
-          imageUrl: nextImageUrl,
-          tags: nextTags,
-          pubDate: nextPubDate,
-          fetchedAt: now2
-        });
-        newCount += info.changes;
-        if (info.changes > 0) newIds.add(item.guid);
-        if (info.changes > 0) continue;
-        const existing = selectExistingStmt.get({ id: item.guid });
-        if (!existing) continue;
-        const shouldRepairTitle = !!nextTitle && !isDateOnlyTitle(nextTitle) && (isDateOnlyTitle(existing.title) || !normalizeText(existing.title));
-        const shouldRepairSummary = !!nextSummary && normalizeText(existing.summary).length < nextSummary.length;
-        const shouldRepairImageUrl = !!nextImageUrl && !existing.image_url?.trim();
-        const existingAuthorArr = parseAuthorFromDb(existing.author);
-        const shouldRepairAuthor = !!nextAuthorArr?.length && !existingAuthorArr?.length;
-        const existingPubDateMs = toMs(existing.pub_date);
-        const existingFetchedAtMs = toMs(existing.fetched_at);
-        const nextPubDateMs = toMs(nextPubDate);
-        const existingPubDateLooksFallback = existingPubDateMs != null && existingFetchedAtMs != null && Math.abs(existingPubDateMs - existingFetchedAtMs) <= 5 * 60 * 1e3;
-        const shouldRepairPubDate = nextPubDateMs != null && (existingPubDateMs == null || existingPubDateLooksFallback && nextPubDateMs < existingPubDateMs - 24 * 60 * 60 * 1e3);
-        if (!(shouldRepairTitle || shouldRepairSummary || shouldRepairImageUrl || shouldRepairAuthor || shouldRepairPubDate)) {
-          continue;
-        }
-        repairExistingStmt.run({
-          id: item.guid,
-          title: shouldRepairTitle ? nextTitle : existing.title,
-          author: shouldRepairAuthor ? nextAuthor : existing.author ?? null,
-          summary: shouldRepairSummary ? nextSummary : existing.summary,
-          imageUrl: shouldRepairImageUrl ? nextImageUrl : existing.image_url ?? null,
-          pubDate: shouldRepairPubDate ? nextPubDate : existing.pub_date,
-          fetchedAt: now2
-        });
+    const insertStmt = db.prepare(`
+      INSERT OR IGNORE INTO items (id, url, source_url, title, author, summary, image_url, tags, pub_date, fetched_at)
+      VALUES (@id, @url, @sourceUrl, @title, @author, @summary, @imageUrl, @tags, @pubDate, @fetchedAt)
+    `);
+    const selectExistingStmt = db.prepare(`
+      SELECT title, author, summary, image_url, pub_date, fetched_at
+      FROM items WHERE id = @id
+    `);
+    const updateStmt = db.prepare(`
+      UPDATE items SET title = @title, author = @author, summary = @summary,
+        image_url = @imageUrl, pub_date = @pubDate, fetched_at = @fetchedAt
+      WHERE id = @id
+    `);
+    for (const item of items) {
+      const nextTitle = normalizeText(item.title) || null;
+      const nextSummary = normalizeText(item.summary) || null;
+      const nextAuthorArr = normalizeAuthor(item.author);
+      const nextAuthor = nextAuthorArr?.length ? JSON.stringify(nextAuthorArr) : null;
+      const nextPubDate = pubDateToIsoOrNull(item.pubDate);
+      const nextTags = item.tags?.length ? JSON.stringify(item.tags) : null;
+      const rawImageUrl = item.imageUrl ?? item.coverImg ?? item.cover_img;
+      const nextImageUrl = typeof rawImageUrl === "string" && rawImageUrl.trim() ? rawImageUrl.trim() : null;
+      const info = insertStmt.run({
+        id: item.guid,
+        url: item.link,
+        sourceUrl,
+        title: nextTitle,
+        author: nextAuthor,
+        summary: nextSummary,
+        imageUrl: nextImageUrl,
+        tags: nextTags,
+        pubDate: nextPubDate,
+        fetchedAt: now2
+      });
+      newCount += Number(info.changes);
+      if (info.changes > 0) {
+        newIds.add(item.guid);
+        continue;
       }
-    });
-    run(items);
+      const existing = selectExistingStmt.get({ id: item.guid });
+      if (!existing) continue;
+      const shouldRepairTitle = !!nextTitle && !isDateOnlyTitle(nextTitle) && (isDateOnlyTitle(existing.title) || !normalizeText(existing.title));
+      const existingSummaryText = normalizeText(existing.summary ?? "");
+      const shouldClearDuplicatedSummary = nextSummary == null && !!nextTitle && existingSummaryText === nextTitle;
+      const shouldRepairSummary = !!nextSummary && (existingSummaryText.length < nextSummary.length || /!\[[^\]]*\]\([^)]*\)/.test(existingSummaryText)) || shouldClearDuplicatedSummary;
+      const shouldRepairImageUrl = !!nextImageUrl && !existing.image_url?.trim();
+      const existingAuthorArr = parseAuthorFromDb(existing.author);
+      const shouldRepairAuthor = !!nextAuthorArr?.length && !existingAuthorArr?.length;
+      const existingPubDateMs = toMs(existing.pub_date);
+      const existingFetchedAtMs = toMs(existing.fetched_at);
+      const nextPubDateMs = toMs(nextPubDate);
+      const existingPubDateLooksFallback = existingPubDateMs != null && existingFetchedAtMs != null && Math.abs(existingPubDateMs - existingFetchedAtMs) <= 5 * 60 * 1e3;
+      const shouldRepairPubDate = nextPubDateMs != null && (existingPubDateMs == null || existingPubDateLooksFallback && nextPubDateMs < existingPubDateMs - 24 * 60 * 60 * 1e3);
+      if (!(shouldRepairTitle || shouldRepairSummary || shouldRepairImageUrl || shouldRepairAuthor || shouldRepairPubDate)) {
+        continue;
+      }
+      updateStmt.run({
+        id: item.guid,
+        title: shouldRepairTitle ? nextTitle : existing.title,
+        author: shouldRepairAuthor ? nextAuthor : existing.author ?? null,
+        summary: shouldClearDuplicatedSummary ? null : shouldRepairSummary ? nextSummary : existing.summary,
+        imageUrl: shouldRepairImageUrl ? nextImageUrl : existing.image_url ?? null,
+        pubDate: shouldRepairPubDate ? nextPubDate : existing.pub_date,
+        fetchedAt: now2
+      });
+    }
     return { newCount, newIds };
   });
 }
 async function updateItemContent(item) {
   return withWriteLock(async () => {
     const db = await getDb();
+    const rawImageUrl = item.imageUrl ?? item.coverImg ?? item.cover_img;
+    const nextImageUrl = typeof rawImageUrl === "string" && rawImageUrl.trim() ? rawImageUrl.trim() : null;
     db.prepare(`
-    UPDATE items
-    SET content      = COALESCE(content, @content),
-        image_url   = COALESCE(@imageUrl, image_url),
-        author      = COALESCE(@author, author),
-        pub_date    = COALESCE(@pubDate, pub_date),
-        tags        = @tags,
+      UPDATE items SET
+        content = COALESCE(content, @content),
+        image_url = COALESCE(@imageUrl, image_url),
+        author = COALESCE(@author, author),
+        pub_date = COALESCE(@pubDate, pub_date),
+        tags = @tags,
         translations = COALESCE(@translations, translations)
-    WHERE id = @id
-  `).run({
+      WHERE id = @id
+    `).run({
       id: item.guid,
       content: item.content ?? null,
-      imageUrl: typeof item.imageUrl === "string" && item.imageUrl.trim() ? item.imageUrl.trim() : null,
+      imageUrl: nextImageUrl,
       author: (() => {
         const arr = normalizeAuthor(item.author);
         return arr?.length ? JSON.stringify(arr) : null;
@@ -723,62 +710,24 @@ async function updateItemContent(item) {
     });
   });
 }
-async function queryFeedItems(sourceUrls, limit, offset, opts) {
-  if (sourceUrls.length === 0) return { items: [], hasMore: false };
-  const expanded = [...new Set(sourceUrls.map((u) => canonicalHttpSourceRef(u)).filter(Boolean))];
-  if (expanded.length === 0) return { items: [], hasMore: false };
-  const db = await getDb();
-  const placeholders = expanded.map((_, i) => `@u${i}`).join(", ");
-  const conditions = [`source_url IN (${placeholders})`];
-  const params = { lim: limit + 1, off: offset };
-  expanded.forEach((url, i) => {
-    params[`u${i}`] = url;
-  });
-  if (opts?.since) {
-    conditions.push("COALESCE(pub_date, fetched_at) >= @since");
-    params.since = opts.since.length === 10 ? `${opts.since}T00:00:00.000Z` : opts.since;
-  }
-  if (opts?.until) {
-    conditions.push("COALESCE(pub_date, fetched_at) < @until");
-    if (opts.until.length === 10) {
-      const d = /* @__PURE__ */ new Date(`${opts.until}T12:00:00Z`);
-      d.setUTCDate(d.getUTCDate() + 1);
-      params.until = d.toISOString();
-    } else {
-      params.until = opts.until;
-    }
-  }
-  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
-  const rows = db.prepare(`
-    SELECT * FROM items
-    ${where}
-    ORDER BY COALESCE(pub_date, fetched_at) DESC
-    LIMIT @lim OFFSET @off
-  `).all(params);
-  const hasMore = rows.length > limit;
-  const items = mapRowsToDbItems(hasMore ? rows.slice(0, limit) : rows);
-  return { items, hasMore };
-}
 async function queryItems(opts) {
   const db = await getDb();
   const { sourceUrl, sourceUrls, author, q, tags: tagsFilter, limit = 20, offset = 0, since, until } = opts;
   const conditions = [];
-  const params = { limit, offset };
+  const params = {};
   if (sourceUrl) {
     const key = canonicalHttpSourceRef(sourceUrl);
-    if (!key) {
-      return { items: [], total: 0 };
-    }
+    if (!key) return { items: [], total: 0 };
     conditions.push("i.source_url = @sourceUrl");
     params.sourceUrl = key;
   } else if (sourceUrls && sourceUrls.length > 0) {
     const expanded = [...new Set(sourceUrls.map((s) => canonicalHttpSourceRef(s)).filter(Boolean))];
-    if (expanded.length === 0) {
-      return { items: [], total: 0 };
-    }
+    if (expanded.length === 0) return { items: [], total: 0 };
     const placeholders = expanded.map((_, i) => `@src${i}`).join(", ");
     conditions.push(`i.source_url IN (${placeholders})`);
-    expanded.forEach((s, i) => params[`src${i}`] = s);
+    expanded.forEach((s, i) => {
+      params[`src${i}`] = s;
+    });
   }
   if (author && author.trim().length >= 2) {
     conditions.push("instr(i.author, @author) > 0");
@@ -789,9 +738,9 @@ async function queryItems(opts) {
     params.q = q;
   }
   if (tagsFilter && tagsFilter.length > 0) {
-    const trimmed = tagsFilter.filter((t) => typeof t === "string" && t.trim()).map((t) => t.trim());
+    const trimmed = tagsFilter.filter((t) => typeof t === "string" && t.trim().length > 0).map((t) => t.trim());
     if (trimmed.length > 0) {
-      const tagConds = trimmed.map((_, i) => `LOWER(TRIM(json_each.value)) = LOWER(@tag${i})`).join(" OR ");
+      const tagConds = trimmed.map((_, idx) => `LOWER(TRIM(json_each.value)) = LOWER(@tag${idx})`).join(" OR ");
       conditions.push(`i.tags IS NOT NULL AND EXISTS (SELECT 1 FROM json_each(i.tags) WHERE ${tagConds})`);
       trimmed.forEach((t, i) => {
         params[`tag${i}`] = t;
@@ -807,14 +756,19 @@ async function queryItems(opts) {
     params.until = until.toISOString();
   }
   const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  const sqlParams = params;
   const rows = db.prepare(`
-    SELECT i.id, i.url, i.source_url, i.title, i.author, i.summary, i.content, i.tags, i.translations, i.pub_date, i.fetched_at, i.pushed_at
-    FROM items i ${where}
-    ORDER BY COALESCE(i.pub_date, i.fetched_at) DESC
-    LIMIT @limit OFFSET @offset
-  `).all(params);
-  const { count } = db.prepare(`SELECT COUNT(*) as count FROM items i ${where}`).get(params);
-  return { items: mapRowsToDbItems(rows), total: count };
+      SELECT i.id, i.url, i.source_url, i.title, i.author, i.summary, i.content, i.image_url, i.tags, i.translations, i.pub_date, i.fetched_at, i.pushed_at
+      FROM items i ${where}
+      ORDER BY COALESCE(i.pub_date, i.fetched_at) DESC
+      LIMIT ${limit} OFFSET ${offset}
+    `).all(sqlParams);
+  const { count } = db.prepare(`SELECT COUNT(*) as count FROM items i ${where}`).get(sqlParams);
+  return { items: mapRowsToDbItems(rows.map((r) => {
+    const obj = {};
+    for (const [k, v] of Object.entries(r)) obj[k] = v;
+    return obj;
+  })), total: count };
 }
 async function removeTagFromAllItems(tag) {
   const trimmed = String(tag ?? "").trim();
@@ -825,22 +779,19 @@ async function removeTagFromAllItems(tag) {
     const rows = db.prepare("SELECT id, tags FROM items WHERE tags IS NOT NULL AND tags != ''").all();
     const updateStmt = db.prepare("UPDATE items SET tags = @tags WHERE id = @id");
     let count = 0;
-    const run = db.transaction(() => {
-      for (const row of rows) {
-        let itemTags;
-        try {
-          itemTags = JSON.parse(row.tags);
-        } catch {
-          continue;
-        }
-        const filtered = itemTags.filter((t) => String(t).trim().toLowerCase() !== targetLower);
-        if (filtered.length === itemTags.length) continue;
-        const nextTags = filtered.length > 0 ? JSON.stringify(filtered) : null;
-        updateStmt.run({ id: row.id, tags: nextTags });
-        count += 1;
+    for (const row of rows) {
+      let itemTags;
+      try {
+        itemTags = JSON.parse(row.tags);
+      } catch {
+        continue;
       }
-    });
-    run();
+      const filtered = itemTags.filter((t) => String(t).trim().toLowerCase() !== targetLower);
+      if (filtered.length === itemTags.length) continue;
+      const nextTags = filtered.length > 0 ? JSON.stringify(filtered) : null;
+      updateStmt.run({ id: row.id, tags: nextTags });
+      count += 1;
+    }
     return count;
   });
 }
@@ -849,25 +800,19 @@ async function markPushed(ids) {
   return withWriteLock(async () => {
     const db = await getDb();
     const now2 = (/* @__PURE__ */ new Date()).toISOString();
-    const stmt = db.prepare("UPDATE items SET pushed_at = @now WHERE id = @id");
-    const run = db.transaction((list) => {
-      for (const id of list) stmt.run({ now: now2, id });
-    });
-    run(ids);
+    const placeholders = ids.map(() => "?").join(",");
+    db.prepare(`UPDATE items SET pushed_at = ? WHERE id IN (${placeholders})`).run(now2, ...ids);
   });
 }
 async function deleteItem(id) {
   if (!id?.trim()) return false;
   return withWriteLock(async () => {
     const db = await getDb();
-    const run = db.transaction(() => {
-      const row = db.prepare("SELECT rowid FROM items WHERE id = @id").get({ id: id.trim() });
-      if (!row) return 0;
-      db.prepare("DELETE FROM items_fts WHERE rowid = @rowid").run({ rowid: row.rowid });
-      const info = db.prepare("DELETE FROM items WHERE id = @id").run({ id: id.trim() });
-      return info.changes;
-    });
-    return run() > 0;
+    const row = db.prepare("SELECT rowid FROM items WHERE id = @id").get({ id: id.trim() });
+    if (!row) return false;
+    db.prepare("DELETE FROM items_fts WHERE rowid = @rowid").run({ rowid: row.rowid });
+    const info = db.prepare("DELETE FROM items WHERE id = @id").run({ id: id.trim() });
+    return Number(info.changes) > 0;
   });
 }
 async function deleteItemsBySourceUrl(sourceUrl) {
@@ -877,29 +822,33 @@ async function deleteItemsBySourceUrl(sourceUrl) {
   return withWriteLock(async () => {
     const db = await getDb();
     const info = db.prepare("DELETE FROM items WHERE source_url = @sourceUrl").run({ sourceUrl: key });
-    return info.changes;
+    return Number(info.changes);
   });
 }
 async function getPendingPushItems(limit = 100) {
   const db = await getDb();
   const rows = db.prepare(`
-    SELECT * FROM items
-    WHERE pushed_at IS NULL AND content IS NOT NULL
-    ORDER BY fetched_at ASC
-    LIMIT @limit
-  `).all({ limit });
-  return mapRowsToDbItems(rows);
+      SELECT * FROM items
+      WHERE pushed_at IS NULL AND content IS NOT NULL
+      ORDER BY fetched_at ASC
+      LIMIT ${limit}
+    `).all();
+  return mapRowsToDbItems(rows.map((r) => {
+    const obj = {};
+    for (const [k, v] of Object.entries(r)) obj[k] = v;
+    return obj;
+  }));
 }
 async function getSourceStats() {
   const { mergeSourceStatsRows: mergeSourceStatsRows2 } = await Promise.resolve().then(() => httpSourceRef);
   const db = await getDb();
-  const rows = db.prepare(
-    `SELECT source_url,
-              COUNT(*) as count,
-              SUM(CASE WHEN julianday(fetched_at) >= julianday('now', '-7 days') THEN 1 ELSE 0 END) as count_7d,
-              MAX(COALESCE(pub_date, fetched_at)) as latest_at
- FROM items GROUP BY source_url ORDER BY count DESC`
-  ).all();
+  const rows = db.prepare(`
+      SELECT source_url,
+             COUNT(*) as count,
+             SUM(CASE WHEN julianday(fetched_at) >= julianday('now', '-7 days') THEN 1 ELSE 0 END) as count_7d,
+             MAX(COALESCE(pub_date, fetched_at)) as latest_at
+      FROM items GROUP BY source_url ORDER BY count DESC
+    `).all();
   return mergeSourceStatsRows2(rows);
 }
 async function insertLog(entry) {
@@ -919,7 +868,7 @@ async function queryLogs(opts) {
   const db = await getLogsDb();
   const { level, category, limit = 50, offset = 0, since } = opts;
   const conditions = [];
-  const params = { limit, offset };
+  const params = {};
   if (level) {
     conditions.push("level = @level");
     params.level = level;
@@ -933,19 +882,30 @@ async function queryLogs(opts) {
     params.since = since.toISOString();
   }
   const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  const sqlParams = params;
   const rows = db.prepare(`
-    SELECT id, level, category, message, payload, created_at
-    FROM logs ${where}
-    ORDER BY created_at DESC
-    LIMIT @limit OFFSET @offset
-  `).all(params);
-  const { count } = db.prepare(`SELECT COUNT(*) as count FROM logs ${where}`).get(params);
-  return { items: rows, total: count };
+      SELECT id, level, category, message, payload, created_at
+      FROM logs ${where}
+      ORDER BY created_at DESC
+      LIMIT ${limit} OFFSET ${offset}
+    `).all(sqlParams);
+  const { count } = db.prepare(`SELECT COUNT(*) as count FROM logs ${where}`).get(sqlParams);
+  return {
+    items: rows.map((r) => ({
+      id: Number(r.id),
+      level: String(r.level),
+      category: String(r.category),
+      message: String(r.message),
+      payload: r.payload,
+      created_at: String(r.created_at)
+    })),
+    total: Number(count)
+  };
 }
 async function clearAllLogs() {
   const db = await getLogsDb();
   const r = db.prepare("DELETE FROM logs").run();
-  return r.changes;
+  return Number(r.changes);
 }
 async function getSystemTags() {
   try {
@@ -1213,6 +1173,22 @@ function isFrameDetachedError(e) {
   const msg = e instanceof Error ? e.message : String(e);
   return /detached|Navigating frame was detached|Session closed/i.test(msg);
 }
+const sharedBrowsers = /* @__PURE__ */ new Map();
+function browserKey(config) {
+  const wantHeadless = config.headless !== false;
+  const executablePath = config.chromeExecutablePath ?? process.env.CHROME_PATH ?? findChromeExecutable() ?? "";
+  const userDataDir = getUserDataDir(config.cacheDir);
+  const proxy = resolveProxy(config) ?? "";
+  return JSON.stringify({
+    headless: wantHeadless,
+    userDataDir: userDataDir ? resolve(userDataDir) : "",
+    proxy,
+    executablePath
+  });
+}
+function isBrowserConnected(browser) {
+  return !!browser && browser.connected !== false;
+}
 async function launchBrowser(config) {
   const wantHeadless = config.headless !== false;
   const executablePath = config.chromeExecutablePath ?? process.env.CHROME_PATH ?? findChromeExecutable();
@@ -1256,29 +1232,53 @@ async function launchBrowser(config) {
   }
   throw lastErr;
 }
+async function getOrCreateBrowser(config) {
+  const key = browserKey(config);
+  const current = sharedBrowsers.get(key);
+  if (isBrowserConnected(current?.browser)) {
+    return current.browser;
+  }
+  if (current?.promise) {
+    return current.promise;
+  }
+  const slot = {};
+  const promise = launchBrowser({ ...config, proxy: resolveProxy(config) }).then((browser) => {
+    slot.browser = browser;
+    slot.promise = void 0;
+    browser.once("disconnected", () => {
+      if (sharedBrowsers.get(key)?.browser === browser) {
+        sharedBrowsers.delete(key);
+      }
+    });
+    return browser;
+  }).catch((err) => {
+    if (sharedBrowsers.get(key) === slot) {
+      sharedBrowsers.delete(key);
+    }
+    throw err;
+  });
+  slot.promise = promise;
+  sharedBrowsers.set(key, slot);
+  return promise;
+}
 async function preCheckAuth(authFlow, cacheDir, opts) {
   const { checkAuth, loginUrl, domain } = authFlow;
   if (domain == null || !cacheDir) return true;
   const isHeadless = opts?.headless !== false;
-  const browser = await launchBrowser({
+  const browser = await getOrCreateBrowser({
     headless: isHeadless,
     cacheDir,
     proxy: resolveProxy(opts)
   });
+  const page = await browser.newPage();
   try {
-    const page = await browser.newPage();
-    try {
-      await setupPage(page, isHeadless);
-      await applyProxyAuthToPage(page, opts);
-      await page.goto(loginUrl, { waitUntil: "domcontentloaded", timeout: 6e4 });
-      await new Promise((resolve2) => setTimeout(resolve2, 3e3));
-      return await checkAuth(page, page.url());
-    } finally {
-      await page.close().catch(() => {
-      });
-    }
+    await setupPage(page, isHeadless);
+    await applyProxyAuthToPage(page, opts);
+    await page.goto(loginUrl, { waitUntil: "domcontentloaded", timeout: 6e4 });
+    await new Promise((resolve2) => setTimeout(resolve2, 3e3));
+    return await checkAuth(page, page.url());
   } finally {
-    await browser.close().catch(() => {
+    await page.close().catch(() => {
     });
   }
 }
@@ -1323,10 +1323,11 @@ async function fetchHtml(url, config = {}) {
     waitAfterLoadMs,
     waitForSelector,
     waitForSelectorTimeoutMs,
+    scrollBeforeSnapshot,
     useHttpResponseBody
   } = config;
   const isHeadless = headless !== false;
-  const browser = await launchBrowser({
+  const browser = await getOrCreateBrowser({
     headless: isHeadless,
     cacheDir,
     proxy: resolveProxy(config),
@@ -1335,84 +1336,105 @@ async function fetchHtml(url, config = {}) {
   const navigationTimeout = timeoutMs ?? 6e4;
   const maxAttempts = 2;
   let lastError;
-  try {
-    for (let attempt = 0; attempt < maxAttempts; attempt++) {
-      const page = await browser.newPage();
-      const isRetry = attempt === 1;
-      const waitUntil = isRetry ? "domcontentloaded" : "load";
-      const extraWaitMs = isRetry ? Math.min(500, Math.max(0, waitAfterLoadMs ?? 2e3)) : Math.max(0, waitAfterLoadMs ?? 2e3);
-      try {
-        if (config.browserContext) {
-          await config.browserContext(page.browserContext());
-        }
-        await setupPage(page, isHeadless);
-        const extraHeaders = { "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8", ...headers ?? {} };
-        if (cookies != null && cookies !== "") {
-          extraHeaders.cookie = cookies;
-        }
-        await page.setExtraHTTPHeaders(extraHeaders);
-        const proxy = resolveProxy(config);
-        if (proxy) {
-          const { username, password } = parseProxy(proxy);
-          if (username !== void 0 || password !== void 0) {
-            await page.authenticate({ username: username ?? "", password: password ?? "" });
-          }
-        }
-        if (timeoutMs != null) {
-          await page.setDefaultNavigationTimeout(timeoutMs);
-        }
-        const response = await page.goto(url, { waitUntil, timeout: navigationTimeout });
-        if (extraWaitMs > 0) {
-          await new Promise((resolve2) => setTimeout(resolve2, extraWaitMs));
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    const page = await browser.newPage();
+    const isRetry = attempt === 1;
+    const waitUntil = isRetry ? "domcontentloaded" : "load";
+    const extraWaitMs = isRetry ? Math.min(500, Math.max(0, waitAfterLoadMs ?? 2e3)) : Math.max(0, waitAfterLoadMs ?? 2e3);
+    try {
+      if (config.browserContext) {
+        await config.browserContext(page.browserContext());
+      }
+      await setupPage(page, isHeadless);
+      const extraHeaders = { "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8", ...headers ?? {} };
+      if (cookies != null && cookies !== "") {
+        extraHeaders.cookie = cookies;
+      }
+      await page.setExtraHTTPHeaders(extraHeaders);
+      const proxy = resolveProxy(config);
+      if (proxy) {
+        const { username, password } = parseProxy(proxy);
+        if (username !== void 0 || password !== void 0) {
+          await page.authenticate({ username: username ?? "", password: password ?? "" });
         }
-        if (waitForSelector != null && waitForSelector !== "" && !isRetry) {
-          const selectorTimeout = waitForSelectorTimeoutMs ?? 2e4;
-          await page.waitForSelector(waitForSelector, { timeout: selectorTimeout });
+      }
+      if (timeoutMs != null) {
+        await page.setDefaultNavigationTimeout(timeoutMs);
+      }
+      const response = await page.goto(url, { waitUntil, timeout: navigationTimeout });
+      if (extraWaitMs > 0) {
+        await new Promise((resolve2) => setTimeout(resolve2, extraWaitMs));
+      }
+      if (waitForSelector != null && waitForSelector !== "" && !isRetry) {
+        const selectorTimeout = waitForSelectorTimeoutMs ?? 2e4;
+        await page.waitForSelector(waitForSelector, { timeout: selectorTimeout });
+      }
+      if (scrollBeforeSnapshot && !isRetry) {
+        const scrollSelector = scrollBeforeSnapshot.selector ?? null;
+        const rounds = scrollBeforeSnapshot.rounds ?? 6;
+        const pauseMs = scrollBeforeSnapshot.pauseMs ?? 800;
+        for (let i = 0; i < rounds; i++) {
+          const before = await page.evaluate((sel) => {
+            const target = sel ? document.querySelector(sel) : null;
+            const el = target ?? document.scrollingElement ?? document.documentElement;
+            return el?.scrollHeight ?? 0;
+          }, scrollSelector);
+          await page.evaluate((sel) => {
+            const target = sel ? document.querySelector(sel) : null;
+            const el = target ?? document.scrollingElement ?? document.documentElement;
+            if (!el) return;
+            el.scrollTop = el.scrollHeight;
+            window.scrollBy(0, window.innerHeight);
+          }, scrollSelector);
+          await new Promise((resolve2) => setTimeout(resolve2, pauseMs));
+          const after = await page.evaluate((sel) => {
+            const target = sel ? document.querySelector(sel) : null;
+            const el = target ?? document.scrollingElement ?? document.documentElement;
+            return el?.scrollHeight ?? 0;
+          }, scrollSelector);
+          if (after <= before && i >= 2) break;
         }
-        if (checkAuth != null || authFlow != null) {
-          const authCheck = checkAuth ?? authFlow?.checkAuth;
-          if (authCheck != null) {
-            const ok = await authCheck(page, url);
-            if (!ok) {
-              throw new Error("checkAuth failed: 未通过认证检查，请先调用 ensureAuth 进行预处理登录");
-            }
+      }
+      if (checkAuth != null || authFlow != null) {
+        const authCheck = checkAuth ?? authFlow?.checkAuth;
+        if (authCheck != null) {
+          const ok = await authCheck(page, url);
+          if (!ok) {
+            throw new Error("checkAuth failed: 未通过认证检查，请先调用 ensureAuth 进行预处理登录");
           }
         }
-        let rawBody;
-        if (useHttpResponseBody === true && response != null) {
-          try {
-            rawBody = await response.text();
-          } catch {
-            rawBody = await page.content();
-          }
-        } else {
+      }
+      let rawBody;
+      if (useHttpResponseBody === true && response != null) {
+        try {
+          rawBody = await response.text();
+        } catch {
           rawBody = await page.content();
         }
-        const finalUrl = response?.url() ?? page.url() ?? String(url);
-        const status = response?.status() ?? 0;
-        const statusText = response?.statusText() ?? "";
-        const rawHeaders = response?.headers() ?? {};
-        const normalizedHeaders = headersToRecord(rawHeaders);
-        const body = applyPurify(rawBody, purify);
-        await page.close().catch(() => {
-        });
-        return { finalUrl, status, statusText, headers: normalizedHeaders, body };
-      } catch (e) {
-        lastError = e;
-        await page.close().catch(() => {
-        });
-        if (isRetry || !isFrameDetachedError(e)) {
-          throw e;
-        }
-        logger.warn("scraper", "fetchHtml 因 frame 分离重试", { url, attempt: attempt + 1, err: e instanceof Error ? e.message : String(e) });
-        await new Promise((r) => setTimeout(r, 800));
+      } else {
+        rawBody = await page.content();
+      }
+      const finalUrl = response?.url() ?? page.url() ?? String(url);
+      const status = response?.status() ?? 0;
+      const statusText = response?.statusText() ?? "";
+      const rawHeaders = response?.headers() ?? {};
+      const normalizedHeaders = headersToRecord(rawHeaders);
+      const body = applyPurify(rawBody, purify);
+      await page.close().catch(() => {
+      });
+      return { finalUrl, status, statusText, headers: normalizedHeaders, body };
+    } catch (e) {
+      lastError = e;
+      await page.close().catch(() => {
+      });
+      if (isRetry || !isFrameDetachedError(e)) {
+        throw e;
       }
+      logger.warn("scraper", "fetchHtml 因 frame 分离重试", { url, attempt: attempt + 1, err: e instanceof Error ? e.message : String(e) });
+      await new Promise((r) => setTimeout(r, 800));
     }
-    throw lastError;
-  } finally {
-    await browser.close().catch(() => {
-    });
   }
+  throw lastError;
 }
 const VALID_INTERVALS = ["1min", "5min", "10min", "30min", "1h", "6h", "12h", "1day", "3day", "7day"];
 function cronToRefreshInterval(cronExpr) {
@@ -1946,6 +1968,7 @@ function buildSiteContext(site, ctx) {
         purify: opts?.purify,
         waitForSelector: opts?.waitForSelector,
         waitForSelectorTimeoutMs: opts?.waitForSelectorTimeoutMs,
+        scrollBeforeSnapshot: opts?.scrollBeforeSnapshot,
         useHttpResponseBody: opts?.useHttpResponseBody
       });
       return { html: res.body, finalUrl: res.finalUrl ?? url, status: res.status };
@@ -1984,6 +2007,7 @@ function createWebSource(site) {
   const authFlow = toAuthFlow(site);
   return {
     id: site.id,
+    name: site.name,
     pattern: site.listUrlPattern,
     priority: 50,
     refreshInterval: site.refreshInterval ?? void 0,
@@ -2512,18 +2536,30 @@ function onFeedUpdated(fn) {
   eventBus.on("feed:updated", fn);
   return () => eventBus.off("feed:updated", fn);
 }
+function migrateGatewayFromFile(j) {
+  const g = j?.deliver?.gateway?.trim();
+  if (g) return g;
+  const u = j?.deliver?.url?.trim() ?? "";
+  if (u) {
+    return u.replace(/\/items\/?$/i, "").replace(/\/+$/, "").trim();
+  }
+  const s = j?.deliver?.sourcesUrl?.trim() ?? "";
+  if (s) {
+    return s.replace(/\/sources\/?$/i, "").replace(/\/+$/, "").trim();
+  }
+  return "";
+}
 async function getDeliverConfig() {
   try {
     const raw = await readFile(CONFIG_PATH, "utf-8");
     const j = JSON.parse(raw);
-    const u = j?.deliver?.url;
     const t = j?.deliver?.token;
     return {
-      url: typeof u === "string" ? u.trim() : "",
+      gateway: migrateGatewayFromFile(j),
       token: typeof t === "string" ? t.trim() : ""
     };
   } catch {
-    return { url: "", token: "" };
+    return { gateway: "", token: "" };
   }
 }
 async function saveDeliverConfig(config) {
@@ -2533,13 +2569,11 @@ async function saveDeliverConfig(config) {
     root = JSON.parse(raw);
   } catch {
   }
-  const prev = root.deliver;
-  const base2 = typeof prev === "object" && prev !== null && !Array.isArray(prev) ? { ...prev } : {};
-  const url = config.url.trim();
+  const gateway = config.gateway.trim();
   const token = config.token.trim();
-  const next = { ...base2, url };
+  const next = {};
+  if (gateway) next.gateway = gateway;
   if (token) next.token = token;
-  else delete next.token;
   root.deliver = next;
   await writeFile(CONFIG_PATH, JSON.stringify(root, null, 2) + "\n", "utf-8");
 }
@@ -2557,6 +2591,11 @@ function feedItemsToPayload(items) {
     translations: i.translations
   }));
 }
+function joinGatewayPath(gatewayBase, segment) {
+  const base2 = gatewayBase.trim().replace(/\/+$/, "");
+  if (!base2) return "";
+  return `${base2}/${segment}`;
+}
 async function postDeliverItems(url, sourceRef, items, options) {
   if (!url.trim() || items.length === 0) return;
   const body = JSON.stringify({ sourceRef, items: feedItemsToPayload(items) });
@@ -2585,6 +2624,52 @@ async function postDeliverItemsSafe(url, sourceRef, items, options) {
     });
   }
 }
+async function postDeliverSources(url, sourcesJson, options) {
+  if (!url.trim() || !sourcesJson.trim()) return;
+  const headers = {
+    "Content-Type": "application/json; charset=utf-8"
+  };
+  const t = options?.bearerToken?.trim();
+  if (t) headers.Authorization = `Bearer ${t}`;
+  const res = await fetch(url.trim(), {
+    method: "POST",
+    headers,
+    body: sourcesJson,
+    signal: AbortSignal.timeout(12e4)
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+  }
+}
+async function postDeliverSourcesSafe(url, sourcesJson, options) {
+  try {
+    await postDeliverSources(url, sourcesJson, options);
+  } catch (err) {
+    logger.warn("deliver", "信源配置投递失败", {
+      err: err instanceof Error ? err.message : String(err)
+    });
+  }
+}
+async function postDeliverGatewayTest(gateway, body, options) {
+  const url = joinGatewayPath(gateway, "test");
+  if (!url) throw new Error("gateway 不能为空");
+  const headers = {
+    "Content-Type": "application/json; charset=utf-8"
+  };
+  const t = options?.bearerToken?.trim();
+  if (t) headers.Authorization = `Bearer ${t}`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(12e4)
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`HTTP ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}`);
+  }
+}
 function resolveHeadlessForFeeder(config) {
   if (config.force === true) {
     return config.headless === true ? true : false;
@@ -2642,7 +2727,7 @@ async function generateAndCache(listUrl, key, config, proxy) {
   });
   generatingKeys.delete(key);
   logger.info("scraper", "抓取成功", { source_url: listUrl, count: items.length });
-  const { url: deliverUrl, token: deliverToken } = await getDeliverConfig();
+  const { gateway: deliverGateway, token: deliverToken } = await getDeliverConfig();
   let newCount = 0;
   let newIds = /* @__PURE__ */ new Set();
   const upsertResult = await upsertItems(items).catch((err) => {
@@ -2672,14 +2757,14 @@ async function generateAndCache(listUrl, key, config, proxy) {
     emitFeedUpdated({ sourceUrl: sourceRefStored, newCount: newCount - pipelineDroppedNew });
   }
   const out = items.filter((i) => !isPipelineDroppedItem(i));
-  if (deliverUrl && out.length > 0) {
-    await postDeliverItemsSafe(deliverUrl, sourceRefStored, out, {
+  if (deliverGateway.trim() && out.length > 0) {
+    await postDeliverItemsSafe(joinGatewayPath(deliverGateway, "items"), sourceRefStored, out, {
       bearerToken: deliverToken || void 0
     });
   }
   return { items: out };
 }
-async function getItems(listUrl, config = {}) {
+async function crawlSource(listUrl, config = {}) {
   const source = getSource(listUrl);
   const proxy = await getEffectiveProxyForListUrl(listUrl, source);
   const headless = resolveHeadlessForFeeder(config);
@@ -2704,6 +2789,10 @@ async function getItems(listUrl, config = {}) {
     if (!config.force) generatingKeys.set(key, task);
   }
   const { items } = await task;
+  return { items };
+}
+async function getItems(listUrl, config = {}) {
+  const { items } = await crawlSource(listUrl, config);
   return { items, fromCache: false };
 }
 function feedItemsToRssXml(items, listUrl, lng, opts) {
@@ -2899,17 +2988,24 @@ const DEFAULT_REFRESH = "1day";
 const SOURCES_CONCURRENCY = 1;
 function createPullTask(ref, cacheDir, cronExpr) {
   return async () => {
-    try {
-      await getItems(ref, {
-        cacheDir,
-        cron: cronExpr
-      });
-    } catch (err) {
-      throw err;
-    }
+    await crawlSource(ref, {
+      cacheDir,
+      cron: cronExpr
+    });
   };
 }
 const SOURCES_GROUP = "sources";
+async function deliverSourcesConfigIfConfigured() {
+  const { gateway, token } = await getDeliverConfig();
+  if (!gateway.trim()) return;
+  let raw;
+  try {
+    raw = await getSourcesRaw();
+  } catch {
+    return;
+  }
+  await postDeliverSourcesSafe(joinGatewayPath(gateway, "sources"), raw, { bearerToken: token || void 0 });
+}
 async function rescheduleSources(cacheDir, runNow2) {
   unscheduleGroup(SOURCES_GROUP);
   let sources;
@@ -2939,7 +3035,7 @@ async function initScheduler(cacheDir) {
     const watcher = watch(SOURCES_CONFIG_PATH, () => {
       if (debounceTimer) clearTimeout(debounceTimer);
       debounceTimer = setTimeout(() => {
-        rescheduleSources(cacheDir, false).catch(() => {
+        void rescheduleSources(cacheDir, false).then(() => deliverSourcesConfigIfConfigured()).catch(() => {
         });
       }, 500);
     });
@@ -3009,24 +3105,26 @@ function registerSchedulerRoutes(app) {
   });
 }
 const SITE_TEMPLATE_FALLBACK = `/**
- * Site 插件模板（由 /plugins 页添加，位于 .rssany/plugins/）
- * HTML DOM 解析请用 ctx.deps.parseHtml，勿在插件内 import node_modules。
+ * Site plugin template created from the /plugins page.
+ * Plugin protocol: named exports. No export default is required.
+ * Parse HTML with ctx.deps.parseHtml; do not import app dependencies directly.
  */
-export default {
-  id: "__PLUGIN_ID__",
-  listUrlPattern: __LIST_URL_PATTERN__,
-  refreshInterval: "1day",
 
-  async fetchItems(sourceId, ctx) {
-    const { html, finalUrl } = await ctx.fetchHtml(sourceId, {
-      waitMs: 2000,
-      purify: true,
-    });
-    void ctx.deps.parseHtml(html);
-    void finalUrl;
-    return [];
-  },
-};
+// Predefined fields stay together at the top.
+export const id = "__PLUGIN_ID__";
+export const name = "__PLUGIN_ID__";
+export const listUrlPattern = __LIST_URL_PATTERN__;
+export const refreshInterval = "1day";
+
+export async function fetchItems(sourceId, ctx) {
+  const { html, finalUrl } = await ctx.fetchHtml(sourceId, {
+    waitMs: 2000,
+    purify: true,
+  });
+  void ctx.deps.parseHtml(html);
+  void finalUrl;
+  return [];
+}
 `;
 function isValidNewPluginId(id) {
   return /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/.test(id) && id !== "generic" && id !== "new";
@@ -3095,6 +3193,7 @@ function registerPluginsRoutes(app) {
     const sites = getPluginSites().map((s) => ({
       kind: "site",
       id: s.id,
+      name: s.name ?? s.id,
       listUrlPattern: typeof s.listUrlPattern === "string" ? s.listUrlPattern : String(s.listUrlPattern),
       hasAuth: !!(s.checkAuth && s.loginUrl)
     }));
@@ -3102,6 +3201,7 @@ function registerPluginsRoutes(app) {
     const sources = registeredSources.filter((src) => src.id !== "generic" && !siteIds.has(src.id)).map((src) => ({
       kind: "source",
       id: src.id,
+      name: src.name ?? src.id,
       listUrlPattern: typeof src.pattern === "string" ? src.pattern : String(src.pattern),
       hasAuth: false
     }));
@@ -3204,8 +3304,25 @@ function registerFeedRoutes(app) {
       ref: resolveRef(s),
       label: s.label ?? resolveRef(s)
     }));
-    const dateOpts = since || until ? { since: since ?? void 0, until: until ?? void 0 } : void 0;
-    const { items: dbItems, hasMore } = await queryFeedItems(sourceRefs, limit, offset, dateOpts);
+    const parseDateBound = (value, endExclusive) => {
+      if (!value) return void 0;
+      if (value.length === 10) {
+        const d2 = /* @__PURE__ */ new Date(endExclusive ? `${value}T12:00:00Z` : `${value}T00:00:00.000Z`);
+        if (endExclusive) d2.setUTCDate(d2.getUTCDate() + 1);
+        return d2;
+      }
+      const d = new Date(value);
+      return Number.isNaN(d.getTime()) ? void 0 : d;
+    };
+    const result = sourceRefs.length > 0 ? await queryItems({
+      sourceUrls: sourceRefs,
+      limit: limit + 1,
+      offset,
+      since: parseDateBound(since ?? void 0, false),
+      until: parseDateBound(until ?? void 0, true)
+    }) : { items: [] };
+    const hasMore = result.items.length > limit;
+    const dbItems = hasMore ? result.items.slice(0, limit) : result.items;
     const items = dbItems.map((item) => {
       const refKey = item.source_url ?? "";
       const base2 = {
@@ -3326,7 +3443,7 @@ function registerItemsRoutes(app) {
       return c.json({ items: [], total: 0, hasMore: false });
     }
     const result = await queryItems({
-      sourceUrl: effectiveSourceUrl ?? (sourceUrls ? void 0 : ref),
+      sourceUrl: sourceUrls ? void 0 : effectiveSourceUrl ? canonicalHttpSourceRef(effectiveSourceUrl) : void 0,
       sourceUrls,
       author,
       q,
@@ -3533,16 +3650,29 @@ function registerTopicsRoutes(app) {
 }
 function registerDeliverRoutes(app) {
   app.get("/api/deliver", requireAdmin(), async (c) => {
-    const { url, token } = await getDeliverConfig();
-    return c.json({ url, token });
+    const { gateway, token } = await getDeliverConfig();
+    return c.json({ gateway, token });
   });
   app.put("/api/deliver", requireAdmin(), async (c) => {
     try {
       const body = await c.req.json();
-      const url = typeof body?.url === "string" ? body.url.trim() : "";
-      const token = typeof body?.token === "string" ? body.token.trim() : "";
-      await saveDeliverConfig({ url, token });
-      return c.json({ ok: true, url, token });
+      const prev = await getDeliverConfig();
+      const explicitGateway = body != null && "gateway" in body;
+      const explicitUrl = body != null && "url" in body;
+      const explicitToken = body != null && "token" in body;
+      let gateway = typeof body?.gateway === "string" ? body.gateway.trim() : "";
+      if (!gateway && typeof body?.url === "string") {
+        gateway = body.url.trim().replace(/\/items\/?$/i, "").replace(/\/+$/, "");
+      }
+      if (!explicitGateway && !explicitUrl) {
+        gateway = prev.gateway;
+      }
+      let token = typeof body?.token === "string" ? body.token.trim() : "";
+      if (!explicitToken) {
+        token = prev.token;
+      }
+      await saveDeliverConfig({ gateway, token });
+      return c.json({ ok: true, gateway, token });
     } catch (err) {
       return c.json({ ok: false, message: err instanceof Error ? err.message : String(err) }, 400);
     }
@@ -3550,31 +3680,39 @@ function registerDeliverRoutes(app) {
   app.post("/api/deliver/test", requireAdmin(), async (c) => {
     try {
       const body = await c.req.json();
-      const url = typeof body?.url === "string" ? body.url.trim() : "";
-      const token = typeof body?.token === "string" ? body.token.trim() : "";
-      if (!url) return c.json({ ok: false, message: "url 不能为空" }, 400);
+      const prev = await getDeliverConfig();
+      let gateway = typeof body?.gateway === "string" ? body.gateway.trim() : "";
+      if (!gateway && typeof body?.url === "string") {
+        gateway = body.url.trim().replace(/\/items\/?$/i, "").replace(/\/+$/, "");
+      }
+      if (!gateway) gateway = prev.gateway;
+      const token = typeof body?.token === "string" ? body.token.trim() : prev.token;
+      if (!gateway.trim()) return c.json({ ok: false, message: "gateway 不能为空" }, 400);
+      const now2 = Date.now();
       const sample = {
-        guid: "deliver-test-" + Date.now(),
+        guid: "deliver-test-" + now2,
         title: "投递连通性测试",
         link: "https://example.com/rssany-deliver-test",
-        pubDate: (/* @__PURE__ */ new Date()).toISOString(),
-        summary: "若下游收到此条，说明投递 URL 可用。"
+        pubDate: /* @__PURE__ */ new Date(),
+        summary: "若下游 /test 收到此条，说明 Gateway 可用。",
+        sourceRef: "rssany-deliver-test"
       };
-      await postDeliverItems(
-        url,
-        "rssany-deliver-test",
-        [
-          {
-            guid: sample.guid,
-            title: sample.title,
-            link: sample.link,
-            pubDate: new Date(sample.pubDate),
-            summary: sample.summary,
-            sourceRef: "rssany-deliver-test"
-          }
-        ],
-        { bearerToken: token || void 0 }
-      );
+      const raw = await getSourcesRaw();
+      let sourcesDoc;
+      try {
+        sourcesDoc = JSON.parse(raw);
+      } catch {
+        sourcesDoc = { sources: [] };
+      }
+      const payload = {
+        rssanyConnectivityTest: true,
+        items: {
+          sourceRef: "rssany-deliver-test",
+          items: feedItemsToPayload([sample])
+        },
+        sources: sourcesDoc
+      };
+      await postDeliverGatewayTest(gateway.trim(), payload, { bearerToken: token || void 0 });
       return c.json({ ok: true });
     } catch (err) {
       return c.json({ ok: false, message: err instanceof Error ? err.message : String(err) }, 400);
@@ -3760,7 +3898,7 @@ function registerTasksRoutes(app) {
         schedule(SOURCES_GROUP, taskId, async () => {
           setTaskRunning(taskId);
           try {
-            await getItems(ref, { cacheDir: CACHE_DIR, force: true });
+            await crawlSource(ref, { cacheDir: CACHE_DIR, force: true });
             setTaskDone(taskId, { ok: true });
           } catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
@@ -4167,7 +4305,7 @@ function registerAuthRoutes(app) {
     return c.json({ ok: true, message: "已打开登录窗口，请在弹出的浏览器中完成登录，完成后刷新订阅页面即可。" });
   });
 }
-const STATICS_DIR = join(PACKAGE_ROOT, "statics");
+const STATICS_DIR = join(PACKAGE_ROOT, "app/statics");
 function parseUrlFromPath(path, prefix) {
   const raw = path.slice(prefix.length) || "";
   const decoded = decodeURIComponent(raw.startsWith("/") ? raw.slice(1) : raw);
@@ -4395,7 +4533,7 @@ function getWebUiBuildDir() {
     if (w.startsWith("/") || /^[A-Za-z]:[\\/]/.test(w)) return w;
     return join(process.cwd(), w);
   }
-  return join(PACKAGE_ROOT, "webui/build");
+  return join(PACKAGE_ROOT, "app/webui/build");
 }
 function isBackendOnlyPath(pathname) {
   if (pathname.startsWith("/api")) return true;
@@ -4411,11 +4549,10 @@ function registerWebUiRoutes(app) {
   const absRoot = getWebUiBuildDir();
   if (!existsSync(absRoot)) {
     console.warn(
-      "未找到 WebUI 构建目录，跳过根路径静态托管:",
+      "未找到 WebUI 构建目录，静态路由已注册，等待前端 watch 构建:",
       absRoot,
-      "（构建前端：pnpm run webui:build）"
+      "（开发模式：npm run dev；单独构建：npm run webui:build）"
     );
-    return;
   }
   const relRoot = relative(process.cwd(), absRoot).replace(/\\/g, "/");
   const staticRoot = relRoot === "" || relRoot === "." ? "." : relRoot.startsWith(".") || relRoot.startsWith("/") || /^[A-Za-z]:/.test(relRoot) ? relRoot : `./${relRoot}`;
@@ -4440,6 +4577,16 @@ function registerWebUiRoutes(app) {
   };
   app.get("*", spaFallback);
 }
+const here = dirname(fileURLToPath(import.meta.url));
+function getAppVersion() {
+  try {
+    const pkgPath = join(here, "../package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 const PORT = Number(process.env.PORT) || 18473;
 const IS_DEV = process.env.NODE_ENV === "development" || process.argv.includes("--watch");
 const PLUGIN_WATCH_EXTS = [".rssany.js", ".rssany.ts"];
@@ -4489,7 +4636,9 @@ async function main() {
   const app = createApp();
   const server = serve({ fetch: app.fetch, port: PORT, hostname: "0.0.0.0" });
   server.setMaxListeners(32);
-  console.log(`服务已启动 http://127.0.0.1:${PORT}/（API + 静态前端，需先 pnpm run webui:build）`);
+  console.log(
+    `RssAny ${getAppVersion()} 服务已启动 http://127.0.0.1:${PORT}/（API + 静态前端单地址）`
+  );
   const lanIp = Object.values(networkInterfaces()).flat().find((iface) => iface?.family === "IPv4" && !iface.internal)?.address;
   if (lanIp) console.log(`局域网访问 http://${lanIp}:${PORT}/`);
   if (IS_DEV) {