dsh-config-manager 0.1.48 → 0.1.50

package/lib/client.d.ts

@@ -281,8 +281,8 @@ interface SnapshotMeta {
 }
 //#endregion
 //#region src/core/run-registry.d.ts
-/** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份。 */
-type RunKind = 'export' | 'import' | 'autosync' | 'sync-apply' | 'backup-schedule';
+/** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份 / 快照恢复。 */
+type RunKind = 'export' | 'import' | 'autosync' | 'sync-apply' | 'backup-schedule' | 'restore';
 /** run 状态：进行中 / 完成 / 失败。 */
 type RunStatus = 'running' | 'done' | 'failed';
 /** 单个 run 的实时状态（/progress 返回体；纯 JSON 可序列化）。 */
@@ -346,6 +346,23 @@ interface BackupScheduleStatus {
   lastRunMessage?: string;
 }
 //#endregion
+//#region src/sync/backup-files.d.ts
+/** 备份文件来源（UI Badge 展示） */
+type BackupFileSource = 'auto' | 'manual';
+/** 备份文件元信息（列表行数据；无敏感字段） */
+interface BackupFileMeta {
+  /** 文件名（如 dsh-config-auto-20260824-120000-abc.zip） */
+  name: string;
+  /** 绝对路径（供 /download 与导入向导引用） */
+  path: string;
+  /** 字节数 */
+  sizeBytes: number;
+  /** 修改时间（ms 时间戳；按此倒序展示/清理） */
+  mtimeMs: number;
+  /** 来源：auto = 定时备份；manual = 手动导出 */
+  source: BackupFileSource;
+}
+//#endregion
 //#region src/ui/i18n.d.ts
 /**
  * 客户端展示层（src/ui/*、src/client/common/*）的渲染文案目录（zh 源语言 / en 镜像）。
@@ -638,11 +655,13 @@ interface DecryptArchiveResponse {
   /** 解密覆盖的凭据 ref 名（非值）；UI 据此从补录阶段剔除已恢复项 */
   refs: string[];
 }
-/** restore 端点响应：dryRun=true 返回 plan；执行返回 report（与 CLI 一致的诚实报告） */
+/** restore 端点响应：dryRun=true 返回 plan；执行返回 report（与 CLI 一致的诚实报告）。
+ *  runId 仅真实执行时存在（宿主 RunRegistry 登记；/runs + /progress 刷新恢复用）。 */
 interface RestoreResponse {
   dryRun: boolean;
   plan?: RestorePlan;
   report?: RestoreReport;
+  runId?: string;
 }
 /** Star 引导弹窗状态（GET /star-prompt；纯偏好，无 secret） */
 interface StarPromptStatus {
@@ -755,6 +774,12 @@ declare class ConfigManagerApi {
     run: BackupRunResult;
     schedule: BackupScheduleStatus;
   }>;
+  /** 列出导出目录（exports/*.zip）下的全部备份文件（时间倒序；含来源 auto/manual）。 */
+  listBackupFiles(): Promise<BackupFileMeta[]>;
+  /** 删除一个备份文件（危险操作：不可恢复；仅限 exports 目录内 .zip）。 */
+  deleteBackupFile(name: string): Promise<{
+    removed: boolean;
+  }>;
 }
 //#endregion
 //#region src/sync/sync-engine.d.ts
@@ -1643,6 +1668,18 @@ declare const zh$2: {
   readonly 'backupSchedule.status.failed': "失败";
   readonly 'backupSchedule.loading': "加载定时备份设置…";
   readonly 'backupSchedule.error': "定时备份设置加载失败";
+  readonly 'backupFiles.title': "备份文件";
+  readonly 'backupFiles.hint': "导出产物（手动导出与定时备份）统一在此管理：可下载到本机、直接导入恢复，或删除。定时备份自动保留最近 10 个。";
+  readonly 'backupFiles.empty': "暂无备份文件。手动导出或启用定时备份后此处会列出。";
+  readonly 'backupFiles.loading': "加载备份文件…";
+  readonly 'backupFiles.error': "备份文件加载失败";
+  readonly 'backupFiles.source.auto': "定时备份";
+  readonly 'backupFiles.source.manual': "手动导出";
+  readonly 'backupFiles.download': "下载";
+  readonly 'backupFiles.import': "导入";
+  readonly 'backupFiles.delete': "删除";
+  readonly 'backupFiles.deleteConfirmTitle': "删除备份文件";
+  readonly 'backupFiles.deleteConfirm': "确认删除备份文件「{name}」？此操作不可恢复。";
   readonly 'report.export.title': "导出完成";
   readonly 'report.import.title': "导入结果";
   readonly 'report.rollback.title': "回滚报告";