luckytri 1.0.0 → 1.0.2

package/server/storage/backup-cleanup.js

@@ -1,414 +1,415 @@
-import { Worker } from "node:worker_threads";
-import { runtimePaths } from "../paths.js";
-import { backupDirectory } from "../../scripts/backup.js";
-import { dirname, join, resolve } from "node:path";
-import {
-  existsSync,
-  lstatSync,
-  readdirSync,
-  readFileSync,
-  realpathSync,
-  rmSync,
-  statSync,
-} from "node:fs";
-import { archiveIdentity, verifyArchive } from "./archive.js";
-import { withBackupLock } from "./backup-lock.js";
-
-const DAY = 86400000;
-const DEFAULTS = Object.freeze({
-  enabled: true,
-  time: "04:30",
-  retainDays: 14,
-  keepFull: 2,
-});
-
-function kind(scope, name) {
-  if (scope === "root")
-    return /^friend\.pre-[\w-]+\.db$/.test(name) ? "snapshot" : null;
-  if (/^luckytri-auto-\d{4}-\d\d-\d\dT[\d-]+Z\.db$/.test(name)) return "auto";
-  if (/^luckytri-migration-v\d+-to-v\d+-\d+-[\da-f]{8}\.db$/.test(name))
-    return "migration";
-  if (/^luckytri-\d{4}-\d\d-\d\dT[\d-]+Z-[\da-f]{8}\.db$/.test(name))
-    return "full";
-  if (/^(?:luckybot|unlucky|xiaoman)-[\w-]+\.db$/.test(name)) return "legacy";
-  return null;
-}
-
-function stamped(name, modified) {
-  const match = /(\d{4}-\d\d-\d\d)T(\d\d)-(\d\d)-(\d\d)-(\d{3})Z/.exec(name);
-  const value = match
-    ? Date.parse(`${match[1]}T${match[2]}:${match[3]}:${match[4]}.${match[5]}Z`)
-    : NaN;
-  return Number.isFinite(value) ? value : modified;
-}
-
-export function cleanupPolicy(value = {}) {
-  if (
-    typeof value !== "object" ||
-    !value ||
-    Array.isArray(value) ||
-    typeof value.enabled !== "boolean" ||
-    !/^([01]\d|2[0-3]):[0-5]\d$/.test(value.time) ||
-    !Number.isInteger(value.retainDays) ||
-    value.retainDays < 1 ||
-    value.retainDays > 3650 ||
-    !Number.isInteger(value.keepFull) ||
-    value.keepFull < 0 ||
-    value.keepFull > 100
-  )
-    throw Error("清理规则无效：保留天数为 1–3650，完整备份数量为 0–100");
-  return Object.fromEntries(
-    Object.keys(DEFAULTS).map((key) => [key, value[key]]),
-  );
-}
-
-export function backupInventory({ directory, source }) {
-  const root = dirname(resolve(source));
-  const sourcePath = existsSync(source)
-    ? realpathSync(source)
-    : resolve(source);
-  const sourceStat = existsSync(source) ? statSync(source) : null;
-  const sourceId = sourceStat ? archiveIdentity(source) : null;
-  const normalize = (path) =>
-    process.platform === "win32" ? path.toLowerCase() : path;
-  const folders = [
-    ["backup", resolve(directory)],
-    ["root", root],
-  ];
-  const entries = [];
-  for (const [scope, folder] of folders) {
-    if (!existsSync(folder)) continue;
-    for (const entry of readdirSync(folder, { withFileTypes: true })) {
-      const category = kind(scope, entry.name);
-      if (!category || !entry.isFile()) continue;
-      const path = join(folder, entry.name);
-      const stat = lstatSync(path);
-      if (!stat.isFile()) continue;
-      if (
-        normalize(realpathSync(path)) === normalize(sourcePath) ||
-        (sourceStat?.ino &&
-          stat.ino === sourceStat.ino &&
-          stat.dev === sourceStat.dev)
-      )
-        continue;
-      let databaseId = null;
-      const manifestPath = `${path}.json`;
-      if (existsSync(manifestPath)) {
-        try {
-          if (lstatSync(manifestPath).isFile())
-            databaseId =
-              JSON.parse(readFileSync(manifestPath, "utf8")).databaseId || null;
-        } catch {
-          // A damaged manifest is not a trusted recovery point.
-        }
-      }
-      const inUse = existsSync(`${path}-wal`) || existsSync(`${path}-shm`);
-      entries.push({
-        scope,
-        name: entry.name,
-        kind: category,
-        bytes: stat.size,
-        modified: stat.mtimeMs,
-        at: stamped(entry.name, stat.mtimeMs),
-        manifest: existsSync(`${path}.json`),
-        databaseId,
-        protected: inUse,
-        protectionReason: inUse ? "存在运行伴随文件" : "",
-      });
-    }
-  }
-  entries.sort((a, b) => b.at - a.at || b.name.localeCompare(a.name));
-  for (const entry of entries
-    .filter(
-      (item) =>
-        item.kind === "auto" && sourceId && item.databaseId === sourceId,
-    )
-    .slice(0, 2)) {
-    entry.protected = true;
-    entry.protectionReason = "近期自动恢复点";
-  }
-  return entries;
-}
-
-export function cleanupPlan(entries, policy, now = Date.now()) {
-  const full = entries.filter((item) => item.kind === "full");
-  const items = full.filter(
-    (item, index) =>
-      !item.protected &&
-      (index >= policy.keepFull || item.at < now - policy.retainDays * DAY),
-  );
-  return { items, bytes: items.reduce((sum, item) => sum + item.bytes, 0) };
-}
-
-function safeRecoveryPoint(entries, directory, source, now, chosen) {
-  const identity = archiveIdentity(source);
-  const selected = new Set(chosen.map((item) => `${item.scope}:${item.name}`));
-  for (const candidate of entries.filter(
-    (item) =>
-      item.kind === "auto" &&
-      identity &&
-      item.databaseId === identity &&
-      item.manifest &&
-      now - item.at <= 72 * 3600000 &&
-      item.at <= now + 5 * 60000 &&
-      !selected.has(`${item.scope}:${item.name}`),
-  )) {
-    try {
-      const result = verifyArchive(join(resolve(directory), candidate.name));
-      if (result.databaseId === identity)
-        return {
-          name: candidate.name,
-          at: candidate.at,
-          bytes: candidate.bytes,
-        };
-    } catch {
-      // A newer damaged copy must not hide an older valid recovery point.
-    }
-  }
-  throw Error("缺少同一实例近 72 小时内可校验的自动备份，已停止清理");
-}
-
-export function executeCleanup({
-  directory,
-  source,
-  policy,
-  mode,
-  selection = [],
-  now = Date.now(),
-  remove = rmSync,
-}) {
-  return withBackupLock(directory, () =>
-    cleanupBatch({ directory, source, policy, mode, selection, now, remove }),
-  );
-}
-
-function cleanupBatch({
-  directory,
-  source,
-  policy,
-  mode,
-  selection,
-  now,
-  remove,
-}) {
-  const entries = backupInventory({ directory, source });
-  const chosen =
-    mode === "scheduled"
-      ? cleanupPlan(entries, cleanupPolicy(policy), now).items
-      : selection.map((request) => {
-          if (
-            !request ||
-            typeof request.name !== "string" ||
-            typeof request.scope !== "string" ||
-            !Number.isSafeInteger(request.bytes) ||
-            !Number.isFinite(request.modified)
-          )
-            throw Error("选择的备份信息无效");
-          const found = entries.find(
-            (item) =>
-              item.name === request.name && item.scope === request.scope,
-          );
-          if (
-            !found ||
-            found.protected ||
-            found.bytes !== request.bytes ||
-            found.modified !== request.modified
-          )
-            throw Error("备份已变化或属于必须保留的恢复点，请刷新列表");
-          return found;
-        });
-  if (!["scheduled", "manual"].includes(mode)) throw Error("清理方式无效");
-  if (
-    new Set(chosen.map((item) => `${item.scope}:${item.name}`)).size !==
-    chosen.length
-  )
-    throw Error("不能重复选择同一份备份");
-  if (!chosen.length) return { removed: [], bytes: 0, failures: [] };
-  const recovery = safeRecoveryPoint(entries, directory, source, now, chosen);
-  const removed = [];
-  const failures = [];
-  for (const item of chosen) {
-    const folder =
-      item.scope === "root" ? dirname(resolve(source)) : resolve(directory);
-    const path = join(folder, item.name);
-    try {
-      const stat = lstatSync(path);
-      if (
-        !stat.isFile() ||
-        stat.size !== item.bytes ||
-        stat.mtimeMs !== item.modified ||
-        existsSync(`${path}-wal`) ||
-        existsSync(`${path}-shm`)
-      )
-        throw Error("备份在清理期间发生变化，已停止后续清理");
-      remove(path);
-      removed.push({ scope: item.scope, name: item.name, bytes: item.bytes });
-      remove(`${path}.json`, { force: true });
-    } catch (error) {
-      failures.push({
-        scope: item.scope,
-        name: item.name,
-        error: error.code
-          ? `删除失败（${error.code}）`
-          : "备份文件已变化或不可删除",
-      });
-    }
-  }
-  return {
-    removed,
-    bytes: removed.reduce((sum, item) => sum + item.bytes, 0),
-    failures,
-    recovery,
-  };
-}
-
-function localDay(now) {
-  const d = new Date(now);
-  const day = [
-    d.getFullYear(),
-    String(d.getMonth() + 1).padStart(2, "0"),
-    String(d.getDate()).padStart(2, "0"),
-  ].join("-");
-  const time = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
-  return { day, time };
-}
-
-function workerRun(payload) {
-  return new Promise((resolve, reject) => {
-    const worker = new Worker(
-      new URL("./backup-cleanup-worker.js", import.meta.url),
-      {
-        workerData: payload,
-      },
-    );
-    worker.once("message", ({ result, error }) =>
-      error ? reject(Error(error)) : resolve(result),
-    );
-    worker.once("error", reject);
-    worker.once("exit", (code) => {
-      if (code) reject(Error(`清理工作异常结束：${code}`));
-    });
-  });
-}
-
-export function createBackupCleanup({
-  store,
-  backup,
-  source = runtimePaths().database,
-  directory = backupDirectory(source),
-  now = () => Date.now(),
-  run = workerRun,
-  log = console,
-} = {}) {
-  let running = false;
-  const policy = () => ({ ...DEFAULTS, ...store.settings().backupCleanup });
-  const last = () => store.settings().backupCleanupLast || null;
-  const info = () => {
-    const entries = backupInventory({ directory, source });
-    return {
-      policy: policy(),
-      last: last(),
-      running,
-      serverTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-      totalBytes: entries.reduce((sum, item) => sum + item.bytes, 0),
-      plan: cleanupPlan(entries, policy(), now()),
-      entries,
-    };
-  };
-  const launch = async (mode, selection = []) => {
-    if (running || backup?.running)
-      throw Error("备份或清理正在进行，请稍后再试");
-    running = true;
-    try {
-      return await run({
-        directory,
-        source,
-        policy: policy(),
-        mode,
-        selection,
-        now: now(),
-      });
-    } finally {
-      running = false;
-    }
-  };
-  return {
-    info,
-    get running() {
-      return running;
-    },
-    save(value) {
-      const next = cleanupPolicy(value);
-      store.save({ backupCleanup: next });
-      return info();
-    },
-    async manual(selection) {
-      if (
-        !Array.isArray(selection) ||
-        !selection.length ||
-        selection.length > 100
-      )
-        throw Error("请先选择要清理的备份，单次最多 100 份");
-      return launch("manual", selection);
-    },
-    tick() {
-      const current = policy();
-      const clock = localDay(now());
-      if (
-        !current.enabled ||
-        running ||
-        backup?.running ||
-        last()?.day === clock.day ||
-        clock.time < current.time
-      )
-        return false;
-      const preview = cleanupPlan(
-        backupInventory({ directory, source }),
-        current,
-        now(),
-      );
-      if (!preview.items.length) {
-        store.save({
-          backupCleanupLast: {
-            day: clock.day,
-            at: now(),
-            removed: 0,
-            bytes: 0,
-          },
-        });
-        return false;
-      }
-      launch("scheduled")
-        .then((result) => {
-          store.save({
-            backupCleanupLast: {
-              day: clock.day,
-              at: now(),
-              removed: result.removed.length,
-              bytes: result.bytes,
-              ...(result.failures?.length
-                ? {
-                    error: "部分备份未清理，请刷新列表后重试",
-                    failures: result.failures,
-                  }
-                : {}),
-            },
-          });
-          log.log(`定时备份整理完成：${result.removed.length} 份`);
-        })
-        .catch((error) => {
-          store.save({
-            backupCleanupLast: {
-              day: clock.day,
-              at: now(),
-              removed: 0,
-              bytes: 0,
-              error: error.message,
-            },
-          });
-          log.error(`定时备份整理失败：${error.message}`);
-        });
-      return true;
-    },
-  };
-}
+import { Worker } from "node:worker_threads";
+import { runtimePaths } from "../paths.js";
+import { backupDirectory } from "../../scripts/backup.js";
+import { dirname, join, resolve } from "node:path";
+import {
+  existsSync,
+  lstatSync,
+  readdirSync,
+  readFileSync,
+  realpathSync,
+  rmSync,
+  statSync,
+} from "node:fs";
+import { archiveIdentity, verifyArchive } from "./archive.js";
+import { withBackupLock } from "./backup-lock.js";
+
+const DAY = 86400000;
+const DEFAULTS = Object.freeze({
+  enabled: true,
+  time: "04:30",
+  retainDays: 14,
+  keepFull: 2,
+});
+
+function kind(scope, name) {
+  if (scope === "root")
+    return /^friend\.pre-[\w-]+\.db$/.test(name) ? "snapshot" : null;
+  if (/^luckytri-before-import-\d+-[\da-f]{8}\.db$/.test(name)) return "import";
+  if (/^luckytri-auto-\d{4}-\d\d-\d\dT[\d-]+Z\.db$/.test(name)) return "auto";
+  if (/^luckytri-migration-v\d+-to-v\d+-\d+-[\da-f]{8}\.db$/.test(name))
+    return "migration";
+  if (/^luckytri-\d{4}-\d\d-\d\dT[\d-]+Z-[\da-f]{8}\.db$/.test(name))
+    return "full";
+  if (/^(?:luckybot|unlucky|xiaoman)-[\w-]+\.db$/.test(name)) return "legacy";
+  return null;
+}
+
+function stamped(name, modified) {
+  const match = /(\d{4}-\d\d-\d\d)T(\d\d)-(\d\d)-(\d\d)-(\d{3})Z/.exec(name);
+  const value = match
+    ? Date.parse(`${match[1]}T${match[2]}:${match[3]}:${match[4]}.${match[5]}Z`)
+    : NaN;
+  return Number.isFinite(value) ? value : modified;
+}
+
+export function cleanupPolicy(value = {}) {
+  if (
+    typeof value !== "object" ||
+    !value ||
+    Array.isArray(value) ||
+    typeof value.enabled !== "boolean" ||
+    !/^([01]\d|2[0-3]):[0-5]\d$/.test(value.time) ||
+    !Number.isInteger(value.retainDays) ||
+    value.retainDays < 1 ||
+    value.retainDays > 3650 ||
+    !Number.isInteger(value.keepFull) ||
+    value.keepFull < 0 ||
+    value.keepFull > 100
+  )
+    throw Error("清理规则无效：保留天数为 1–3650，完整备份数量为 0–100");
+  return Object.fromEntries(
+    Object.keys(DEFAULTS).map((key) => [key, value[key]]),
+  );
+}
+
+export function backupInventory({ directory, source }) {
+  const root = dirname(resolve(source));
+  const sourcePath = existsSync(source)
+    ? realpathSync(source)
+    : resolve(source);
+  const sourceStat = existsSync(source) ? statSync(source) : null;
+  const sourceId = sourceStat ? archiveIdentity(source) : null;
+  const normalize = (path) =>
+    process.platform === "win32" ? path.toLowerCase() : path;
+  const folders = [
+    ["backup", resolve(directory)],
+    ["root", root],
+  ];
+  const entries = [];
+  for (const [scope, folder] of folders) {
+    if (!existsSync(folder)) continue;
+    for (const entry of readdirSync(folder, { withFileTypes: true })) {
+      const category = kind(scope, entry.name);
+      if (!category || !entry.isFile()) continue;
+      const path = join(folder, entry.name);
+      const stat = lstatSync(path);
+      if (!stat.isFile()) continue;
+      if (
+        normalize(realpathSync(path)) === normalize(sourcePath) ||
+        (sourceStat?.ino &&
+          stat.ino === sourceStat.ino &&
+          stat.dev === sourceStat.dev)
+      )
+        continue;
+      let databaseId = null;
+      const manifestPath = `${path}.json`;
+      if (existsSync(manifestPath)) {
+        try {
+          if (lstatSync(manifestPath).isFile())
+            databaseId =
+              JSON.parse(readFileSync(manifestPath, "utf8")).databaseId || null;
+        } catch {
+          // A damaged manifest is not a trusted recovery point.
+        }
+      }
+      const inUse = existsSync(`${path}-wal`) || existsSync(`${path}-shm`);
+      entries.push({
+        scope,
+        name: entry.name,
+        kind: category,
+        bytes: stat.size,
+        modified: stat.mtimeMs,
+        at: stamped(entry.name, stat.mtimeMs),
+        manifest: existsSync(`${path}.json`),
+        databaseId,
+        protected: inUse,
+        protectionReason: inUse ? "存在运行伴随文件" : "",
+      });
+    }
+  }
+  entries.sort((a, b) => b.at - a.at || b.name.localeCompare(a.name));
+  for (const entry of entries
+    .filter(
+      (item) =>
+        item.kind === "auto" && sourceId && item.databaseId === sourceId,
+    )
+    .slice(0, 2)) {
+    entry.protected = true;
+    entry.protectionReason = "近期自动恢复点";
+  }
+  return entries;
+}
+
+export function cleanupPlan(entries, policy, now = Date.now()) {
+  const full = entries.filter((item) => item.kind === "full");
+  const items = full.filter(
+    (item, index) =>
+      !item.protected &&
+      (index >= policy.keepFull || item.at < now - policy.retainDays * DAY),
+  );
+  return { items, bytes: items.reduce((sum, item) => sum + item.bytes, 0) };
+}
+
+function safeRecoveryPoint(entries, directory, source, now, chosen) {
+  const identity = archiveIdentity(source);
+  const selected = new Set(chosen.map((item) => `${item.scope}:${item.name}`));
+  for (const candidate of entries.filter(
+    (item) =>
+      item.kind === "auto" &&
+      identity &&
+      item.databaseId === identity &&
+      item.manifest &&
+      now - item.at <= 72 * 3600000 &&
+      item.at <= now + 5 * 60000 &&
+      !selected.has(`${item.scope}:${item.name}`),
+  )) {
+    try {
+      const result = verifyArchive(join(resolve(directory), candidate.name));
+      if (result.databaseId === identity)
+        return {
+          name: candidate.name,
+          at: candidate.at,
+          bytes: candidate.bytes,
+        };
+    } catch {
+      // A newer damaged copy must not hide an older valid recovery point.
+    }
+  }
+  throw Error("缺少同一实例近 72 小时内可校验的自动备份，已停止清理");
+}
+
+export function executeCleanup({
+  directory,
+  source,
+  policy,
+  mode,
+  selection = [],
+  now = Date.now(),
+  remove = rmSync,
+}) {
+  return withBackupLock(directory, () =>
+    cleanupBatch({ directory, source, policy, mode, selection, now, remove }),
+  );
+}
+
+function cleanupBatch({
+  directory,
+  source,
+  policy,
+  mode,
+  selection,
+  now,
+  remove,
+}) {
+  const entries = backupInventory({ directory, source });
+  const chosen =
+    mode === "scheduled"
+      ? cleanupPlan(entries, cleanupPolicy(policy), now).items
+      : selection.map((request) => {
+          if (
+            !request ||
+            typeof request.name !== "string" ||
+            typeof request.scope !== "string" ||
+            !Number.isSafeInteger(request.bytes) ||
+            !Number.isFinite(request.modified)
+          )
+            throw Error("选择的备份信息无效");
+          const found = entries.find(
+            (item) =>
+              item.name === request.name && item.scope === request.scope,
+          );
+          if (
+            !found ||
+            found.protected ||
+            found.bytes !== request.bytes ||
+            found.modified !== request.modified
+          )
+            throw Error("备份已变化或属于必须保留的恢复点，请刷新列表");
+          return found;
+        });
+  if (!["scheduled", "manual"].includes(mode)) throw Error("清理方式无效");
+  if (
+    new Set(chosen.map((item) => `${item.scope}:${item.name}`)).size !==
+    chosen.length
+  )
+    throw Error("不能重复选择同一份备份");
+  if (!chosen.length) return { removed: [], bytes: 0, failures: [] };
+  const recovery = safeRecoveryPoint(entries, directory, source, now, chosen);
+  const removed = [];
+  const failures = [];
+  for (const item of chosen) {
+    const folder =
+      item.scope === "root" ? dirname(resolve(source)) : resolve(directory);
+    const path = join(folder, item.name);
+    try {
+      const stat = lstatSync(path);
+      if (
+        !stat.isFile() ||
+        stat.size !== item.bytes ||
+        stat.mtimeMs !== item.modified ||
+        existsSync(`${path}-wal`) ||
+        existsSync(`${path}-shm`)
+      )
+        throw Error("备份在清理期间发生变化，已停止后续清理");
+      remove(path);
+      removed.push({ scope: item.scope, name: item.name, bytes: item.bytes });
+      remove(`${path}.json`, { force: true });
+    } catch (error) {
+      failures.push({
+        scope: item.scope,
+        name: item.name,
+        error: error.code
+          ? `删除失败（${error.code}）`
+          : "备份文件已变化或不可删除",
+      });
+    }
+  }
+  return {
+    removed,
+    bytes: removed.reduce((sum, item) => sum + item.bytes, 0),
+    failures,
+    recovery,
+  };
+}
+
+function localDay(now) {
+  const d = new Date(now);
+  const day = [
+    d.getFullYear(),
+    String(d.getMonth() + 1).padStart(2, "0"),
+    String(d.getDate()).padStart(2, "0"),
+  ].join("-");
+  const time = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+  return { day, time };
+}
+
+function workerRun(payload) {
+  return new Promise((resolve, reject) => {
+    const worker = new Worker(
+      new URL("./backup-cleanup-worker.js", import.meta.url),
+      {
+        workerData: payload,
+      },
+    );
+    worker.once("message", ({ result, error }) =>
+      error ? reject(Error(error)) : resolve(result),
+    );
+    worker.once("error", reject);
+    worker.once("exit", (code) => {
+      if (code) reject(Error(`清理工作异常结束：${code}`));
+    });
+  });
+}
+
+export function createBackupCleanup({
+  store,
+  backup,
+  source = runtimePaths().database,
+  directory = backupDirectory(source),
+  now = () => Date.now(),
+  run = workerRun,
+  log = console,
+} = {}) {
+  let running = false;
+  const policy = () => ({ ...DEFAULTS, ...store.settings().backupCleanup });
+  const last = () => store.settings().backupCleanupLast || null;
+  const info = () => {
+    const entries = backupInventory({ directory, source });
+    return {
+      policy: policy(),
+      last: last(),
+      running,
+      serverTimeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+      totalBytes: entries.reduce((sum, item) => sum + item.bytes, 0),
+      plan: cleanupPlan(entries, policy(), now()),
+      entries,
+    };
+  };
+  const launch = async (mode, selection = []) => {
+    if (running || backup?.running)
+      throw Error("备份或清理正在进行，请稍后再试");
+    running = true;
+    try {
+      return await run({
+        directory,
+        source,
+        policy: policy(),
+        mode,
+        selection,
+        now: now(),
+      });
+    } finally {
+      running = false;
+    }
+  };
+  return {
+    info,
+    get running() {
+      return running;
+    },
+    save(value) {
+      const next = cleanupPolicy(value);
+      store.save({ backupCleanup: next });
+      return info();
+    },
+    async manual(selection) {
+      if (
+        !Array.isArray(selection) ||
+        !selection.length ||
+        selection.length > 100
+      )
+        throw Error("请先选择要清理的备份，单次最多 100 份");
+      return launch("manual", selection);
+    },
+    tick() {
+      const current = policy();
+      const clock = localDay(now());
+      if (
+        !current.enabled ||
+        running ||
+        backup?.running ||
+        last()?.day === clock.day ||
+        clock.time < current.time
+      )
+        return false;
+      const preview = cleanupPlan(
+        backupInventory({ directory, source }),
+        current,
+        now(),
+      );
+      if (!preview.items.length) {
+        store.save({
+          backupCleanupLast: {
+            day: clock.day,
+            at: now(),
+            removed: 0,
+            bytes: 0,
+          },
+        });
+        return false;
+      }
+      launch("scheduled")
+        .then((result) => {
+          store.save({
+            backupCleanupLast: {
+              day: clock.day,
+              at: now(),
+              removed: result.removed.length,
+              bytes: result.bytes,
+              ...(result.failures?.length
+                ? {
+                    error: "部分备份未清理，请刷新列表后重试",
+                    failures: result.failures,
+                  }
+                : {}),
+            },
+          });
+          log.log(`定时备份整理完成：${result.removed.length} 份`);
+        })
+        .catch((error) => {
+          store.save({
+            backupCleanupLast: {
+              day: clock.day,
+              at: now(),
+              removed: 0,
+              bytes: 0,
+              error: error.message,
+            },
+          });
+          log.error(`定时备份整理失败：${error.message}`);
+        });
+      return true;
+    },
+  };
+}