dsh-config-manager 0.1.52 → 0.1.54

package/README.md

@@ -7,7 +7,7 @@ Backup, restore, export, import, migrate and sync your complete DeepSeek Harness
 - 🔄 **Backup & Restore** DeepSeek Harness configuration
 - 📦 **Export / Import** complete DSH configuration
 - 🚚 **Migrate** DSH to another machine
-- ⏰ **Scheduled full backups** — automatic, on your own cadence (6h / 12h / 24h / 7d), secrets never included
+- ⏰ **Scheduled full backups** — automatic, on your own cadence (6h / 12h / 24h / 7d / custom weekly), secrets never included
 - 🔌 Backup installed **plugins** and plugin configuration
 - 🧩 Backup **MCP servers** and **Skills**
 - 🔐 Encrypted backups with optional credentials
@@ -56,7 +56,7 @@ Keep portable configuration synchronized between machines through a private Git
 
 ### Schedule automatic full backups
 
-Turn on scheduled backups (6h / 12h / 24h / 7d) and DSH quietly keeps a fresh full backup of your configuration in the background — secrets are never included, so it stays safe on disk without a password.
+Turn on scheduled backups (6h / 12h / 24h / 7d — or a **custom weekly weekday & time**) and DSH quietly keeps a fresh full backup of your configuration in the background — secrets are never included, so it stays safe on disk without a password. Consecutive failures are highlighted in red in the settings card.
 
 ### Discover & install configurations from the marketplace
 
@@ -79,7 +79,7 @@ Browse the built-in official market for ready-made configurations (model provide
 | 🔄 | **Remote Sync** | Push/pull portable config via **Git private repo or WebDAV** (secrets never sync) |
 | ⏰ | **Scheduled backups** | Full backup on a fixed cadence (6h / 12h / 24h / 7d) — set-and-forget, secrets never included |
 | 🛒 | **Config Marketplace** | Browse & one-click install community configs — supply-chain warnings + per-section approval |
-| 🗂️ | **Profiles** | Save multiple setups (Work / Personal) and switch anytime |
+| 🗂️ | **Profiles** | Save multiple setups (Work / Personal) and switch anytime — preview + auto-backup + rollback |
 | 🌐 | **Bilingual UI** | Interface, reports and error details follow the DSH app language (中文 / English) |
 | 🤖 | **Agent tools** | Backup / snapshot / restore / sync right from an agent session |
 
@@ -186,11 +186,16 @@ Copy the ZIP to Machine B (import)
 
 > Output: `dsh-config-<date>.zip` with manifest + per-category data + SHA-256 checksums.
 
+**Export extras:**
+- **Preview before export** — see what will be packaged (section count + estimated size, no secrets) before anything is written
+- **Custom file name & note** — name the ZIP yourself (auto-naming is the default) and attach an optional note that shows in the **Backup Files** list (the note travels with the self section when you sync/backup the config)
+
 ### 📥 Import (safe flow)
 
 - **Nothing is written before confirmation** — analyze & preview are zero-write
 - **Backup before applying** — the target config is snapshotted automatically
 - **Automatic rollback on failure** — full rollback or skip-and-continue, your choice
+- **Next-steps checklist after import** — the result page lists what needs a DSH restart (per plugin/MCP), credentials to re-enter, and failed/skipped items you can retry
 
 ### 👀 Import Preview (dry run)
 
@@ -242,13 +247,15 @@ Push / pull your portable config between machines through **either of two channe
 - **Switching channels starts fresh**: Git and WebDAV do **not** share snapshots or a common ancestor. When you switch transport, sync begins again from the new remote's empty baseline — push a fresh snapshot first.
 - **WebDAV auth** uses HTTP Basic: the `username` is stored in the config and may be echoed back into the UI, while the `password` is read live from the DSH credentials slot `DSH_CONFIG_MANAGER_SYNC_WEBDAV_PASSWORD` — it never appears in any sync file or log.
 - **Plugins auto-install**: when pulling diffs, plugins that are new in the backup are **installed automatically** on confirm — no manual per-item ticking in the diff list. Only **version-conflict** plugins still ask you to pick "Keep Current / Use Imported".
+- **Push preview before uploading** — the Push button first shows a read-only preview of what will be sent (sections + per-section counts + changed-vs-baseline markers, first-baseline notice) and only writes the remote after you confirm.
 
 ### 🛒 Configuration Marketplace
 
 Browse and install ready-made configurations (model providers, plugins, MCP servers, skills, agent presets…) shared by the community:
 
 - **Built-in official market** — read-only, bound to the official public repo (official badge shown, not editable); first open auto-refreshes, manual refresh also available
-- **Search & filter** — keyword search, category filter, source filter (Official / Community), sorting (recently updated / most starred / name A–Z), and a ⭐ badge showing the **source repo's** star count (queried anonymously, no token involved)
+- **Search & filter** — keyword search (matches name / description / author / **categories**), category filter, **section filter** (items already downloaded list their sections; others are excluded with a hint), source filter (Official / Community), sorting (recently updated / most starred / name A–Z), and a ⭐ badge showing the **source repo's** star count (queried anonymously, no token involved)
+- **Impact preview** — the detail view shows "what installing this will change" (items updated / identical / conflicts / secrets to re-enter / DSH restart needed) before you approve anything
 - **Supply-chain warnings always shown** — source repo URL, "not officially reviewed", download time; **per-section approval** — high-risk sections (sessions / arbitrary files) are banned from listing outright, and every remaining section must be explicitly approved before the import is confirmed
 - **Install reuses the safe import pipeline** — analyze → preview → auto-backup → apply → rollback; nothing is written before you confirm
 - **"My Configs"** — sign in with GitHub (device flow), upload a config to **your own public repo** in one click, and an **auto listing PR** is opened against the official market repo; manage your listings (status badges: not listed / PR pending / listed), update in one click, install back locally, or delist (auto de-listing PR)
@@ -257,6 +264,11 @@ Browse and install ready-made configurations (model providers, plugins, MCP serv
 
 Save multiple configurations (Work / Personal) and switch anytime; switching includes preview + auto-backup + rollback.
 
+- **Save current config** — pick a name and store the current DSH configuration (settings / providers / plugins / skills / agent presets…; no secrets, file sections embedded)
+- **Switch with safety** — preview first (zero writes) → confirm → automatic snapshot → staged apply; any failure rolls back fully
+- **Manage** — rename / delete (confirmed) / import an exported profile.json
+- Library is an independent tab: Settings → "Backup & Migration" → **Profiles**
+
 ### 📸 Snapshot restore (undo an import)
 
 Every import creates a **safety snapshot** first. If something feels off afterwards, restore the target back to its pre-import state:
@@ -270,6 +282,16 @@ Every import creates a **safety snapshot** first. If something feels off afterwa
 
 **GUI**: Settings → "Backup & Migration" → **Snapshots & Restore** tab → pick a snapshot → preview the plan (dry-run, zero writes) → confirm.
 
+**Snapshot management:**
+- **Retention is visible** — up to **10** snapshots are kept automatically (oldest pruned); the hint is shown in the list
+- **Pin important snapshots** — a pinned snapshot is exempt from auto-pruning and can only be deleted manually
+- **Manual delete** — remove any snapshot (danger, confirmed) when you no longer need that rollback point
+
+**Backup Files management** (same tab → "Backup Files"):
+- List every export ZIP (manual + scheduled) with source badge, size, time and your custom **note**
+- **Search** by file name or note
+- **Inspect / Compare** — read-only preview of what the backup contains (sections + per-section counts) and the diff against your current config (zero writes) before deciding to import
+
 ---
 
 ### 🚨 CLI — the first line of defense when DSH is broken

package/lib/adapters/self.js

@@ -33,6 +33,9 @@ export const SELF_CONFIG_FILES = [
     'sync/ui-prefs.json',
     'sync/backup-schedule.json',
     'market/market-config.json',
+    // P0-④：导出产物备注清单（exports/.backup-notes.json）——随 self 分区迁移，
+    // 换机器后备份列表仍能看到手动导出时填写的备注
+    'exports/.backup-notes.json',
 ];
 export class SelfAdapter extends FileCollectionAdapter {
     id = 'self';

package/lib/adapters/self.js.map

@@ -1 +1 @@
-{"version":3,"file":"self.js","sourceRoot":"","sources":["../../src/adapters/self.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,uBAAuB;IACvB,yBAAyB;IACzB,0BAA0B;IAC1B,oBAAoB;IACpB,2BAA2B;IAC3B,2BAA2B;CAC5B,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,qBAAqB;IAC3C,EAAE,GAAG,MAAe,CAAC;IACrB,WAAW,GAAG,oBAAoB,CAAC;IACnC,eAAe,GAAG,IAAI,CAAC;IACvB,WAAW,GAAG,UAAmB,CAAC;IAC3C,kEAAkE;IACzD,OAAO,CAAS;IAEzB,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;iGAC6F;IACpF,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,QAAuB;QAC7D,MAAM,KAAK,GAA0B,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,oEAAoE;YACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS,CAAC,0BAA0B;YACvD,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;YAC3B,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;YAC/B,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../src/adapters/self.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,uBAAuB;IACvB,yBAAyB;IACzB,0BAA0B;IAC1B,oBAAoB;IACpB,2BAA2B;IAC3B,2BAA2B;IAC3B,0DAA0D;IAC1D,yBAAyB;IACzB,4BAA4B;CAC7B,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,qBAAqB;IAC3C,EAAE,GAAG,MAAe,CAAC;IACrB,WAAW,GAAG,oBAAoB,CAAC;IACnC,eAAe,GAAG,IAAI,CAAC;IACvB,WAAW,GAAG,UAAmB,CAAC;IAC3C,kEAAkE;IACzD,OAAO,CAAS;IAEzB,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;iGAC6F;IACpF,KAAK,CAAC,MAAM,CAAC,GAAgB,EAAE,QAAuB;QAC7D,MAAM,KAAK,GAA0B,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,oEAAoE;YACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS,CAAC,0BAA0B;YACvD,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE;YAC3B,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;YAC/B,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

package/lib/client.d.ts

@@ -83,6 +83,8 @@ interface ExportOptions {
   only?: SectionId[];
   /** 导出文件路径（缺省自动生成 dsh-config-<date>.zip） */
   outPath?: string;
+  /** 导出备注（P0-④：host 写入 exports/.backup-notes.json，随 self 分区迁移；非敏感） */
+  note?: string;
 }
 type PlanItemKind = 'Create' | 'Update' | 'Skip' | 'Conflict' | 'Install' | 'MissingSecret' | 'MissingDependency' | 'PathMapping' | 'Warning' | 'Error';
 type ItemResolution = 'keepCurrent' | 'useImported' | 'review';
@@ -278,11 +280,40 @@ interface SnapshotMeta {
   entryCount: number;
   hostFileBackupCount: number;
   beforePluginCount: number;
+  /** 置顶标记（P1-⑧）：置顶快照不参与自动保留清理（最多保留 N 个时的淘汰豁免） */
+  pinned?: boolean;
+}
+//#endregion
+//#region src/profiles/profile-manager.d.ts
+interface ProfileMeta {
+  name: string;
+  createdAt: string;
+  updatedAt: string;
+  sections: SectionId[];
+  fileCount: number;
+}
+interface SwitchPreview {
+  items: PlanItem[];
+  missingSecrets: {
+    ref: string;
+    required: boolean;
+  }[];
+  needsRestart: boolean;
+  sectionsInProfile: SectionId[];
+}
+interface ProfileSwitchResult {
+  ok: boolean;
+  executed: ExecutedItem[];
+  needsRestart: boolean;
+  missingSecrets: string[];
+  warnings: string[];
+  rollback: RollbackReport | null;
+  snapshotId: string | null;
 }
 //#endregion
 //#region src/core/run-registry.d.ts
-/** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份 / 快照恢复。 */
-type RunKind = 'export' | 'import' | 'autosync' | 'sync-apply' | 'backup-schedule' | 'restore';
+/** run 类型：导出 / 导入 / 自动同步 / 一键同步逐项应用 / 定时备份 / 快照恢复 / 配置档案切换。 */
+type RunKind = 'export' | 'import' | 'autosync' | 'sync-apply' | 'backup-schedule' | 'restore' | 'profile-switch';
 /** run 状态：进行中 / 完成 / 失败。 */
 type RunStatus = 'running' | 'done' | 'failed';
 /** 单个 run 的实时状态（/progress 返回体；纯 JSON 可序列化）。 */
@@ -313,8 +344,22 @@ interface RunState {
 }
 //#endregion
 //#region src/sync/backup-schedule-config.d.ts
-/** 定时备份间隔档位（全量备份无需太频繁；默认 24h） */
-type BackupInterval = '6h' | '12h' | '24h' | '7d';
+/** 定时备份间隔档位（全量备份无需太频繁；默认 24h）。
+ *  - '6h' | '12h' | '24h' | '7d'：固定间隔；
+ *  - 'custom'：每周固定时刻（见 customSchedule）。 */
+type BackupInterval = '6h' | '12h' | '24h' | '7d' | 'custom';
+/**
+ * 自定义（每周固定时刻）档配置：
+ * - dayOfWeek：0-6（0 = 周日，1 = 周一 … 6 = 周六）；
+ * - hour：0-23；
+ * - minute：0-59。
+ * 语义 = 每周该时刻触发一次全量备份（错过的时间点不补跑——下次排期自然对齐）。
+ */
+interface BackupWeeklySchedule {
+  dayOfWeek: number;
+  hour: number;
+  minute: number;
+}
 /** 最近一次定时备份执行状态 */
 type BackupRunStatus = 'success' | 'skipped' | 'failed';
 //#endregion
@@ -330,15 +375,18 @@ interface BackupRunResult {
 }
 //#endregion
 //#region src/ui/backup-schedule.d.ts
-/** 设置草稿（表单编辑态：总开关 + 间隔档位）。 */
+/** 设置草稿（表单编辑态：总开关 + 间隔档位 + 自定义周档）。 */
 interface BackupScheduleDraft {
   enabled: boolean;
   interval: BackupInterval;
+  /** custom 档的每周固定时刻（仅 interval='custom' 时校验；其他档位忽略） */
+  customSchedule?: BackupWeeklySchedule;
 }
 /** 定时备份配置的浏览器侧视图（与 sync/backup-schedule-config.ts 的持久化面一致；无敏感字段）。 */
 interface BackupScheduleStatus {
   enabled: boolean;
   interval: BackupInterval;
+  customSchedule?: BackupWeeklySchedule;
   startupMinIntervalMs: number;
   consecutiveFailures: number;
   lastRunAt?: string;
@@ -361,6 +409,8 @@ interface BackupFileMeta {
   mtimeMs: number;
   /** 来源：auto = 定时备份；manual = 手动导出 */
   source: BackupFileSource;
+  /** 用户备注（手动导出时可选填写；null = 无备注） */
+  note?: string | null;
 }
 //#endregion
 //#region src/ui/i18n.d.ts
@@ -513,6 +563,9 @@ declare const uiZh: {
   readonly 'sync.neverSyncedShort': "从未同步";
   readonly 'sync.pushFailed': "推送失败";
   readonly 'sync.pushOk': "推送成功（快照 {id}）";
+  readonly 'sync.pushPreviewHeadline': "将推送 {total} 个分区（{changed} 个有变化）";
+  readonly 'sync.pushPreviewHint': "以上为只读预览，不会写入远端。确认后点击「推送」才真正上传。";
+  readonly 'sync.pushPreviewEncrypted': "加密快照：载荷将整体加密，各分区相对基线的变化不可比对。";
   readonly 'sync.pullFailed': "拉取失败";
   readonly 'sync.pullOk': "远端快照 {id} 差异预览：共 {count} 项变更";
   readonly 'sync.pullEmpty': "远端快照与本地一致（无变更）";
@@ -649,6 +702,23 @@ interface UploadResponse {
   /** zip=普通备份；encrypted=整体加密备份容器（需先 decryptArchive 解锁才能按 ZIP 解析） */
   containerType: 'zip' | 'encrypted';
 }
+/** P1-⑦/P2-⑬：备份内容查看 / 差异对比结果（只读；复用 analyze + plan 链路，零写入） */
+interface BackupInspectResult {
+  analysis: ImportAnalysis;
+  plan: ImportPlan;
+}
+/** P2-⑫：导出前预览响应（不落盘 ZIP；各分区 counts + 估算大小） */
+interface ExportPreviewResponse {
+  ok: boolean;
+  sections: {
+    section: SectionId;
+    count: number;
+    sizeBytes: number;
+  }[];
+  totalSections: number;
+  totalSizeBytes: number;
+  sectionsFailed: number;
+}
 /** decrypt-archive 端点响应：解锁整体加密容器后返回明文 ZIP 路径 + 解密覆盖的凭据 ref 名（非值） */
 interface DecryptArchiveResponse {
   zipPath: string;
@@ -721,6 +791,8 @@ declare class ConfigManagerApi {
   status(): Promise<ServiceStatus>;
   /** Star 引导弹窗状态（进入页面时判定是否展示 / 是否补记首次使用时间）。 */
   starPromptStatus(): Promise<StarPromptStatus>;
+  /** P2-⑫：导出前只读预览（不落盘 ZIP）——「将打包 X 分区 / Y 条目 / 约 Z 大小」。 */
+  exportPreview(only?: SectionId[]): Promise<ExportPreviewResponse>;
   /** 保存 Star 引导弹窗状态（局部更新：firstSeenAt / dismissed / clicked）。
    * 纯偏好无 secret；失败由调用方静默降级（本次不弹/不记，下次再判）。 */
   saveStarPrompt(patch: StarPromptPatch): Promise<StarPromptSaveResponse>;
@@ -765,6 +837,34 @@ declare class ConfigManagerApi {
   snapshots(): Promise<SnapshotMeta[]>;
   /** 快照恢复：dryRun=true 只取动作计划（零写入）；false 执行并返回诚实报告 */
   restoreSnapshot(snapshotId: string, dryRun: boolean): Promise<RestoreResponse>;
+  /** P1-⑧：手动删除单个快照（危险操作：该导入前回滚点不可恢复；`removed` 为是否实际删除）。 */
+  deleteSnapshot(snapshotId: string): Promise<{
+    removed: boolean;
+  }>;
+  /** P1-⑧：置顶/取消置顶快照（置顶快照豁免自动保留清理，只能手动删除）。 */
+  setSnapshotPinned(snapshotId: string, pinned: boolean): Promise<{
+    pinned: boolean;
+  }>;
+  /** 列出全部 Profile（name/createdAt/updatedAt/sections/fileCount）。 */
+  profilesList(): Promise<ProfileMeta[]>;
+  /** 保存当前 DSH 配置为新 Profile（天然不含秘密值）。 */
+  profileSave(name: string, sections?: SectionId[]): Promise<ProfileMeta>;
+  /** 删除 Profile（危险操作：该组配置快照不可恢复）。 */
+  profileDelete(name: string): Promise<void>;
+  /** 重命名 Profile（目录级移动）。 */
+  profileRename(name: string, newName: string): Promise<ProfileMeta>;
+  /** 切换前预览（只读，零写入）：分析切换到该 Profile 会产生的计划项。 */
+  profileAnalyzeSwitch(name: string): Promise<SwitchPreview>;
+  /** 执行切换（confirm=true 安全阀；走快照 + 分阶段 apply + 失败回滚；响应含 runId）。 */
+  profileExecuteSwitch(name: string, opts: {
+    strategy?: 'merge' | 'replace' | 'skipExisting';
+    secretInputs?: Record<string, string>;
+    rollbackOnError?: boolean;
+  }): Promise<ProfileSwitchResult & {
+    runId: string;
+  }>;
+  /** 导入 Profile（content = profile.json 字符串；asName 可选覆盖目标名）。 */
+  profileImport(content: string, asName?: string): Promise<ProfileMeta>;
   /** 读取定时备份配置（enabled / interval / 上次运行状态；无敏感字段）。 */
   backupSchedule(): Promise<BackupScheduleStatus>;
   /** 保存定时备份设置（enabled + interval）；Host 校验后原子写 + 重排调度器。 */
@@ -780,6 +880,9 @@ declare class ConfigManagerApi {
   deleteBackupFile(name: string): Promise<{
     removed: boolean;
   }>;
+  /** 「查看备份内容」：对 exports 目录内的备份文件做只读分析（reuse /analyze，零写入）。
+   *  返回分析 + 与当前配置的差异计划摘要（"装/导这个备份会动你什么"）。 */
+  inspectBackup(zipPath: string): Promise<BackupInspectResult>;
 }
 //#endregion
 //#region src/sync/sync-engine.d.ts
@@ -809,6 +912,26 @@ interface SyncPullReport {
   needsReview: boolean;
   message?: string;
 }
+/** P0-②：push 前只读预览 ——「将推送什么」的单分区摘要（不写远端、不落盘）。 */
+interface SyncPushPreviewSection {
+  /** 分区 id（将进入快照的 portable 分区） */
+  section: SectionId;
+  /** 分区内条目计数（adapter.export 的 counts 聚合；无计数时为 0） */
+  count: number;
+  /** 相对上次基线（sync-state）是否变化：true = 本次会更新该分区；false = 与基线一致 */
+  changed: boolean;
+}
+/** P0-②：push 前预览结果（零写入）。 */
+interface SyncPushPreview {
+  ok: boolean;
+  /** 将推送的分区清单（含计数与变化标记） */
+  sections: SyncPushPreviewSection[];
+  /** 远端现有快照数（0 = 首次推送将创建首个基线） */
+  remoteSnapshotCount: number;
+  /** 加密快照：载荷将整体加密（分区计数与基线比较不可得） */
+  encrypted: boolean;
+  message?: string;
+}
 //#endregion
 //#region src/client/sync/sync-api.d.ts
 /** 远程同步通道类型：git（默认）或 webdav */
@@ -1126,6 +1249,8 @@ declare class SyncApi {
   status(): Promise<SyncStatusResponse>;
   /** 推送：导出 portable 分区 → 提交到私有 Git 仓库 → 更新 sync-state */
   push(payload: SyncPushPayload): Promise<SyncPushReport>;
+  /** P0-②：push 前只读预览（「将推送什么」，零写入远端）——body.preview=true 触发 */
+  pushPreview(payload: SyncPushPayload): Promise<SyncPushPreview>;
   /** 拉取差异预览：拉取远端最新快照 → 只读分析（绝不执行导入） */
   pull(payload: SyncPullPayload): Promise<SyncPullReport>;
   /** GitHub OAuth device flow：发起登录，返回一次性用户码 + 授权页 URL + flowId */
@@ -1241,6 +1366,8 @@ interface MarketListItem {
   stars?: number;
   /** 本地缓存状态：cached | fresh | none（UI 徽章） */
   cacheState: 'cached' | 'fresh' | 'none';
+  /** 分区清单（P2-⑭：已缓存条目从 L2 manifest 合并；未缓存条目缺省 = 未知，列表分区筛选时排除） */
+  sections?: SectionId[];
 }
 /** POST /market/download 响应：条目详情 + 校验结果（dry-run 预览） */
 interface MarketItemDetail {
@@ -1527,12 +1654,14 @@ interface ConfigManagerSectionInjected {
 declare const zh$2: {
   readonly 'section.label': "备份与迁移";
   readonly 'section.description': "导出 / 导入 / 迁移 DSH 配置（备份不含密钥，加密备份可选）";
+  readonly 'view.transfer': "导出与导入";
   readonly 'view.export': "导出备份";
   readonly 'view.import': "导入恢复";
   readonly 'view.snapshots': "备份与快照";
   readonly 'view.sync': "远程同步";
   readonly 'view.market': "配置市场";
   readonly 'view.about': "关于";
+  readonly 'view.profiles': "配置文件";
   readonly 'common.close': "关闭";
   readonly 'common.cancel': "取消";
   readonly 'common.back': "上一步";
@@ -1558,6 +1687,10 @@ declare const zh$2: {
   readonly 'export.includeSecrets': "导出密钥";
   readonly 'export.includeSecretsHint': "把真实密钥（凭据值）写入备份。密钥必须以加密形式保存：勾选时会自动选中「加密备份」；取消「加密备份」会同时取消「导出密钥」。";
   readonly 'export.run': "开始导出";
+  readonly 'export.preview': "预览将导出内容";
+  readonly 'export.previewing': "正在统计…";
+  readonly 'export.previewSummary': "将打包 {sections} 个分区，约 {size}（不含密钥）";
+  readonly 'export.previewSkipped': "{count} 个分区导出失败已跳过";
   readonly 'export.running': "正在导出…";
   readonly 'export.download': "下载备份文件";
   readonly 'export.saved': "已保存到下载目录：{name}";
@@ -1565,6 +1698,13 @@ declare const zh$2: {
   readonly 'export.group.unknown': "其他";
   readonly 'export.included': "已包含";
   readonly 'export.excluded': "未包含";
+  readonly 'export.naming': "文件名与备注（可选）";
+  readonly 'export.fileName': "自定义文件名";
+  readonly 'export.fileNameHint': "留空自动命名（dsh-config-<日期>.zip）；无需手动输入 .zip 后缀，保存时自动补全。仅允许字母数字、空格、- _ .。";
+  readonly 'export.fileNameInvalid': "文件名不合法：仅允许字母数字、空格、- _ .，不能包含路径分隔符。";
+  readonly 'export.note': "备注";
+  readonly 'export.notePlaceholder': "例如：迁移前的完整备份 / 2026-08 存档";
+  readonly 'export.noteHint': "备注保存在本机备份列表中（随配置备份迁移），便于区分多个导出产物。";
   readonly 'import.select.title': "选择备份文件";
   readonly 'import.select.hint': "选择本机导出的 dsh-config-*.zip 备份文件开始导入。分析阶段只读，不会修改任何配置。";
   readonly 'import.select.browse': "选择 ZIP 文件";
@@ -1634,11 +1774,19 @@ declare const zh$2: {
   readonly 'snapshots.status': "状态";
   readonly 'snapshots.entries': "条目";
   readonly 'snapshots.plugins': "插件";
+  readonly 'snapshots.actions': "操作";
+  readonly 'snapshots.retentionHint': "最多自动保留 {count} 个快照（超出清理最旧的）；置顶的快照不参与自动清理，只能手动删除。";
+  readonly 'snapshots.pin': "置顶";
+  readonly 'snapshots.unpin': "取消置顶";
+  readonly 'snapshots.delete': "删除";
+  readonly 'snapshots.deleteConfirmTitle': "删除快照";
+  readonly 'snapshots.deleteConfirm': "确认删除 {time} 创建的快照？该导入前回滚点将被永久删除，不可恢复。";
   readonly 'snapshots.status.pending': "进行中";
   readonly 'snapshots.status.done': "已完成";
   readonly 'snapshots.status.rolled-back': "已回滚";
   readonly 'snapshots.status.unknown': "未知";
   readonly 'snapshots.planTitle': "恢复计划预览";
+  readonly 'snapshots.viewPlan': "查看恢复计划";
   readonly 'snapshots.noActions': "该快照无可用恢复动作（或全部跳过）。";
   readonly 'snapshots.execute': "执行恢复";
   readonly 'snapshots.executing': "恢复执行中…";
@@ -1659,6 +1807,15 @@ declare const zh$2: {
   readonly 'backupSchedule.interval.12h': "每 12 小时";
   readonly 'backupSchedule.interval.24h': "每 24 小时";
   readonly 'backupSchedule.interval.7d': "每 7 天";
+  readonly 'backupSchedule.interval.custom': "自定义（每周固定时刻）";
+  readonly 'backupSchedule.customHint': "每周在选定星期与时刻各执行一次全量备份（错过的时间点不补跑）";
+  readonly 'backupSchedule.weekday.sunday': "周日";
+  readonly 'backupSchedule.weekday.monday': "周一";
+  readonly 'backupSchedule.weekday.tuesday': "周二";
+  readonly 'backupSchedule.weekday.wednesday': "周三";
+  readonly 'backupSchedule.weekday.thursday': "周四";
+  readonly 'backupSchedule.weekday.friday': "周五";
+  readonly 'backupSchedule.weekday.saturday': "周六";
   readonly 'backupSchedule.save': "保存设置";
   readonly 'backupSchedule.saved': "设置已保存";
   readonly 'backupSchedule.runNow': "立即备份";
@@ -1668,6 +1825,7 @@ declare const zh$2: {
   readonly 'backupSchedule.status.success': "成功";
   readonly 'backupSchedule.status.skipped': "已跳过";
   readonly 'backupSchedule.status.failed': "失败";
+  readonly 'backupSchedule.consecutiveFailures': "定时备份连续失败 {count} 次，请检查配置（磁盘空间 / 权限 / 分区导出错误）";
   readonly 'backupSchedule.loading': "加载定时备份设置…";
   readonly 'backupSchedule.error': "定时备份设置加载失败";
   readonly 'backupFiles.title': "备份文件";
@@ -1682,6 +1840,19 @@ declare const zh$2: {
   readonly 'backupFiles.delete': "删除";
   readonly 'backupFiles.deleteConfirmTitle': "删除备份文件";
   readonly 'backupFiles.deleteConfirm': "确认删除备份文件「{name}」？此操作不可恢复。";
+  readonly 'backupFiles.searchPlaceholder': "按文件名或备注搜索…";
+  readonly 'backupFiles.searchEmpty': "没有匹配的备份文件";
+  readonly 'backupFiles.inspect': "查看 / 对比";
+  readonly 'backupFiles.inspectLoading': "正在分析备份内容…";
+  readonly 'backupFiles.inspectEmpty': "该备份无法分析（文件损坏或格式不支持）";
+  readonly 'backupFiles.inspectSections': "包含的分区";
+  readonly 'backupFiles.inspectDiff': "与此备份的差异（只读预览）";
+  readonly 'backupFiles.inspectItems': "变更明细";
+  readonly 'backupFiles.inspectGroup.conflicts': "冲突（需决策）";
+  readonly 'backupFiles.inspectGroup.changes': "变更（将写入）";
+  readonly 'backupFiles.inspectGroup.paths': "路径映射（需处理）";
+  readonly 'backupFiles.inspectGroup.skipped': "已一致（无需处理）";
+  readonly 'backupFiles.inspectGroup.others': "其他";
   readonly 'report.export.title': "导出完成";
   readonly 'report.import.title': "导入结果";
   readonly 'report.rollback.title': "回滚报告";
@@ -1689,6 +1860,14 @@ declare const zh$2: {
   readonly 'report.action.viewDetails': "查看详情";
   readonly 'report.action.done': "完成";
   readonly 'report.needsRestart': "插件 / MCP 变更将在重启 DSH 后生效。";
+  readonly 'nextSteps.title': "接下来需要处理";
+  readonly 'nextSteps.done': "全部完成，无需额外处理";
+  readonly 'nextSteps.restart.title': "重启 DSH 后生效（{count}）";
+  readonly 'nextSteps.restart.hint': "以下变更需要重启 DSH 才会生效：";
+  readonly 'nextSteps.secrets.title': "补录凭据（{count}）";
+  readonly 'nextSteps.secrets.hint': "以下凭据未随备份导出，需在本机手动补录：";
+  readonly 'nextSteps.unresolved.title': "失败 / 已跳过（{count}）";
+  readonly 'nextSteps.unresolved.hint': "以下项未成功应用，可在结果页点击「重试」：";
   readonly 'error.title': "操作失败";
   readonly 'error.hint': "错误消息已自动脱敏，不会泄露任何密钥信息。";
   readonly 'starPrompt.title': "喜欢 Config Manager 吗？";
@@ -1708,6 +1887,49 @@ declare const zh$2: {
   readonly 'about.authorLabel': "作者";
   readonly 'about.loading': "正在获取版本信息…";
   readonly 'about.retryStatus': "重新获取";
+  readonly 'about.cli.title': "CLI 救援工具";
+  readonly 'about.cli.hint': "GUI 运行在 DSH 内部——DSH 无法启动时，独立安装的 CLI（dsh-config-manager）是第一救援手段：列快照 / 离线恢复 / 一键重装 DSH，全程无需 DSH 运行。安装一次即可在任何机器上用：";
+  readonly 'about.cli.docs': "CLI 使用文档";
+  readonly 'profiles.title': "配置档案";
+  readonly 'profiles.subtitle': "把当前 DSH 配置保存为多套档案（Work / Personal / …），随时切换；切换含预览 + 自动快照 + 失败回滚。";
+  readonly 'profiles.save.title': "保存当前配置为档案";
+  readonly 'profiles.save.hint': "输入档案名并保存：内容复用导出管道（不含密钥），文件类分区（技能/预设）一并内嵌。";
+  readonly 'profiles.save.placeholder': "例如 Work / Personal / Minimal";
+  readonly 'profiles.save.action': "保存档案";
+  readonly 'profiles.save.saving': "保存中…";
+  readonly 'profiles.nameInvalid': "档案名不合法：仅允许字母数字与常见字符，禁止路径分隔符（/ \\）与 ..";
+  readonly 'profiles.name': "档案名";
+  readonly 'profiles.sections': "分区";
+  readonly 'profiles.updatedAt': "更新时间";
+  readonly 'profiles.loading': "加载档案中…";
+  readonly 'profiles.empty': "暂无档案。先保存一份当前配置即可开始。";
+  readonly 'profiles.switch': "切换";
+  readonly 'profiles.previewHint': "点击查看切换预览（只读）";
+  readonly 'profiles.rename': "重命名";
+  readonly 'profiles.delete': "删除";
+  readonly 'profiles.renameTitle': "重命名档案";
+  readonly 'profiles.renameMessage': "将档案「{name}」重命名为：";
+  readonly 'profiles.deleteTitle': "删除档案";
+  readonly 'profiles.deleteMessage': "确认删除档案「{name}」？该组配置快照将被永久删除，不可恢复。";
+  readonly 'profiles.import.title': "导入档案";
+  readonly 'profiles.import.hint': "导入导出的 profile.json 文件（本机或他机导出的档案，含文件类分区内嵌数据）。";
+  readonly 'profiles.import.choose': "选择 JSON 文件";
+  readonly 'profiles.switchPreviewTitle': "切换预览：{name}";
+  readonly 'profiles.previewing': "正在分析切换计划…";
+  readonly 'profiles.previewSummary': "切换影响";
+  readonly 'profiles.previewWillChange': "将变更 {count} 项";
+  readonly 'profiles.previewUnchanged': "已一致 {count} 项";
+  readonly 'profiles.previewConflicts': "冲突 {count}";
+  readonly 'profiles.previewSecrets': "需补录密钥 {count}";
+  readonly 'profiles.previewRestart': "需重启 DSH 生效";
+  readonly 'profiles.previewNote': "以上为只读预览（零写入）。确认后会自动创建快照并执行，失败时整体回滚。";
+  readonly 'profiles.previewSections': "档案包含的分区";
+  readonly 'profiles.previewItems': "变更明细";
+  readonly 'profiles.switchConfirm': "确认切换";
+  readonly 'profiles.switching': "切换中…（自动快照 + 分阶段应用）";
+  readonly 'profiles.switchDone': "切换完成：{count} 项已应用";
+  readonly 'profiles.switchFailed': "切换失败（部分项未应用）";
+  readonly 'profiles.switchRolledBack': "切换失败，已整体回滚";
 };
 /** 字典键联合（注册处 compile-time 校验） */
 type ConfigManagerKey = keyof typeof zh$2;
@@ -1808,6 +2030,11 @@ declare const zh$1: {
   readonly 'syncflow.rollingBack': "正在回滚…";
   readonly 'syncflow.rollbackDone': "已回滚到应用前";
   readonly 'syncflow.needsRestart': "部分改动需要重启 DSH 后生效";
+  readonly 'syncflow.pushPreviewTitle': "确认推送";
+  readonly 'syncflow.pushPreviewSections': "将推送的分区";
+  readonly 'syncflow.pushConfirm': "确认推送";
+  readonly 'syncflow.pushing': "正在推送…";
+  readonly 'syncflow.pushFirstBaseline': "远端暂无快照：本次将创建首个同步基线";
   readonly 'mode.title': "同步模式";
   readonly 'mode.hint': "选择推送时导出哪些分区：默认 = 推荐分区一键推送（快速导出）；高级 = 自定义勾选（自定义导出）。";
   readonly 'mode.default': "默认（快速导出）";
@@ -1913,6 +2140,8 @@ declare const zh: {
   readonly 'list.noItems': "该市场暂无条目。";
   readonly 'list.searchPlaceholder': "搜索名称 / 作者 / 描述…";
   readonly 'list.categoriesAll': "全部类别";
+  readonly 'list.sectionsAll': "全部分区";
+  readonly 'list.sectionsUnknown': "另有 {count} 个条目未下载，无法按分区匹配";
   readonly 'list.sourceAll': "全部来源";
   readonly 'list.sourceOfficial': "官方配置";
   readonly 'list.sourcePersonal': "个人配置";
@@ -1935,6 +2164,12 @@ declare const zh: {
   readonly 'detail.emptySections': "该条目未包含任何可导入分区";
   readonly 'detail.needReview': "需要人工确认";
   readonly 'detail.previewHint': "以下为只读 dry-run 预览（零写入）。确认导入将复用现有安全管道（快照 + 校验 + 失败回滚）。";
+  readonly 'detail.impact.willChange': "将变更 {count} 项";
+  readonly 'detail.impact.unchanged': "已一致 {count} 项";
+  readonly 'detail.impact.conflicts': "冲突 {count}";
+  readonly 'detail.impact.secrets': "需补录密钥 {count}";
+  readonly 'detail.impact.paths': "路径映射 {count}";
+  readonly 'detail.impact.restart': "需重启 DSH 生效";
   readonly 'detail.import': "确认导入";
   readonly 'detail.back': "返回列表";
   readonly 'detail.approval.title': "逐分区批准导入";