dsh-config-manager 0.1.72 → 0.1.76

package/lib/schema/section-registry.js

@@ -1,4 +1,4 @@
-/** 分区载荷版本：当前 15 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
+/** 分区载荷版本：当前 17 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
 export const SECTION_DATA_VERSION = 1;
 /**
  * 分区注册表（**Record<SectionId, SectionMeta>**：漏注册/写错 id → 编译失败）。
@@ -152,7 +152,7 @@ export const SECTION_REGISTRY = {
     },
     pluginFiles: {
         id: 'pluginFiles',
-        displayName: 'Plugin Files',
+        displayName: "Other Plugins' Loose Files",
         group: 'extensions',
         payload: { kind: 'files', filePrefix: 'plugin-files/' },
         dataVersion: SECTION_DATA_VERSION,
@@ -205,7 +205,7 @@ export const SECTION_REGISTRY = {
     },
     self: {
         id: 'self',
-        displayName: 'Plugin Self Config',
+        displayName: "This Plugin's Own Config",
         group: 'extensions',
         payload: { kind: 'files', filePrefix: 'self/' },
         dataVersion: SECTION_DATA_VERSION,
@@ -216,6 +216,35 @@ export const SECTION_REGISTRY = {
         defaultIncluded: true,
         configSnapshot: true,
     },
+    pluginData: {
+        id: 'pluginData',
+        displayName: "Other Plugins' Data",
+        group: 'extensions',
+        payload: { kind: 'files', filePrefix: 'plugin-data/' },
+        dataVersion: SECTION_DATA_VERSION,
+        applyOrder: 16,
+        riskTier: 'high',
+        // 第三方插件的数据目录不在 DSH 的三个核心存储里：路径是「机器的 home 布局」而非配置内容，
+        // 换机后可能整个目录不存在（未安装该插件）→ deviceSpecific + 不参与自动同步。
+        portability: 'deviceSpecific',
+        syncOptIn: 'off',
+        defaultIncluded: false,
+        // 体量由用户数据主导（可能几百 MB），与 sessions 同理不进「配置状态」采集口径
+        configSnapshot: false,
+    },
+    pluginAssets: {
+        id: 'pluginAssets',
+        displayName: "Other Plugins' Large Files",
+        group: 'extensions',
+        payload: { kind: 'files', filePrefix: 'plugin-assets/' },
+        dataVersion: SECTION_DATA_VERSION,
+        applyOrder: 17,
+        riskTier: 'high',
+        portability: 'deviceSpecific',
+        syncOptIn: 'off',
+        defaultIncluded: false,
+        configSnapshot: false,
+    },
 };
 /** 分区 id（按 applyOrder 升序）——历史上与 SECTION_IDS 数组逐项一致 */
 export const SECTION_IDS = Object.keys(SECTION_REGISTRY)

package/lib/schema/types.d.ts

@@ -11,7 +11,7 @@ export type Platform = 'win32' | 'darwin' | 'linux' | 'freebsd' | 'openbsd' | 'a
  * 明确不实现的分区（keybindings/workflows/commands）不在此列；
  * rules 已由 agentInstructions（~/.dsh/AGENTS.md，dsh-agent-instructions 全局指令）承接。
  */
-export type SectionId = 'settings' | 'ui' | 'providers' | 'plugins' | 'mcp' | 'prompts' | 'skills' | 'agentPresets' | 'agentInstructions' | 'workspaces' | 'pluginFiles' | 'credentialsStatus' | 'secrets' | 'sessions' | 'self';
+export type SectionId = 'settings' | 'ui' | 'providers' | 'plugins' | 'mcp' | 'prompts' | 'skills' | 'agentPresets' | 'agentInstructions' | 'workspaces' | 'pluginFiles' | 'credentialsStatus' | 'secrets' | 'sessions' | 'self' | 'pluginData' | 'pluginAssets';
 /** 加密备份的算法参数（非秘密：salt/iv/authTag 仅用于解密与完整性校验） */
 export interface EncryptionInfo {
     algorithm: 'aes-256-gcm';

package/lib/sync/messages.d.ts

@@ -57,6 +57,7 @@ export declare const zh: {
     readonly 'sync.backupHistoryDone': '{trigger}完成：{zip}';
     readonly 'sync.backupHistorySkipped': '{trigger}跳过：{reason}';
     readonly 'sync.backupHistoryFailed': '{trigger}失败';
+    readonly 'sync.pushPreviewUnpackedLocalSources': '本地源插件（link:/file:）需打包才能精确比对变更，分区 {sections} 本次按「有变化」展示';
 };
 export declare const en: Record<keyof typeof zh, string>;
 /** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */

package/lib/sync/messages.js

@@ -83,6 +83,8 @@ export const zh = {
     'sync.backupHistoryDone': '{trigger}完成：{zip}',
     'sync.backupHistorySkipped': '{trigger}跳过：{reason}',
     'sync.backupHistoryFailed': '{trigger}失败',
+    // ---------- 推送前只读预览（issue #91） ----------
+    'sync.pushPreviewUnpackedLocalSources': '本地源插件（link:/file:）需打包才能精确比对变更，分区 {sections} 本次按「有变化」展示',
 };
 export const en = {
     'sync.ancestorSnapshotIdRequired': 'loadAncestor: snapshotId must not be empty',
@@ -142,6 +144,7 @@ export const en = {
     'sync.backupHistoryDone': '{trigger} finished: {zip}',
     'sync.backupHistorySkipped': '{trigger} skipped: {reason}',
     'sync.backupHistoryFailed': '{trigger} failed',
+    'sync.pushPreviewUnpackedLocalSources': 'Local-source plugins (link:/file:) must be packed to compare changes exactly; section(s) {sections} are shown as changed',
 };
 registerMessageCatalog({ id: 'sync-domain', zh, en });
 /** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */

package/lib/sync/sync-engine.d.ts

@@ -331,20 +331,34 @@ export declare class SyncEngine {
      */
     private decryptSnapshotCredentials;
     /**
-     * 把「随加密快照迁移的凭据」补进导入计划：每个解密出的 ref 生成一条 MissingSecret 项。
+     * 把「随加密快照迁移的凭据」补进导入计划：**需要写回**的 ref 生成 MissingSecret 项，
+     * 本机值已与快照逐字节相同的 ref 生成 Skip（info）——写回是 no-op，不该再让用户确认。
      * 执行阶段由 credentials adapter 经 ImportContext.decryptedCredentials（仅内存）
      * 调用 credentials.set(ref, value) 写回本机 —— 与手动补录走同一条已验证路径。
      *
-     * 判定与导入路径同规则（**值的有无优先于本机状态**）：
-     *  - 本函数只处理**有值**的 ref → 一律生成 MissingSecret（确认后写回）。
-     *    **不因本机已配置而跳过**：快照显式带了值（用户勾了「导出密钥」），跳过就等于
-     *    「密钥没同步过来」；要逐项放过用确认列表的批量按钮（sync-view 的 isBulkDecidable）。
+     * 判定与导入路径同规则（**值的有无优先于本机状态**），并多做一步「值是否已经相同」：
+     *  - 有值 + 本机不同 / 本机没有 → MissingSecret（确认后写回）。**不因本机已配置而跳过**：
+     *    快照显式带了值（用户勾了「导出密钥」），跳过就等于「密钥没同步过来」；
+     *    要逐项放过用确认列表的批量按钮（sync-view 的 isBulkDecidable）。
+     *  - 有值 + 本机逐字节相同 → Skip（info）。这是对上一轮「有值一律 MissingSecret」的**收窄**
+     *    （真机反馈：本机 refs 一条不缺，列表却全标「缺密钥」+ 黄色警告）：只有真的会改动本机的
+     *    ref 才需要人工确认。
+     *  - 本机凭据文件读不到 → 无法比较 → 保守按 MissingSecret 处理，绝不静默跳过。
      *  - 「只有 ref 名、没有值」的情形由 createImportPlan → buildCredentialPlanItems 处理
      *    （那里才做本机已配置 → Skip 的判定）。
-     *  - 同 id 已是 **Skip**（上面那条规则在「无值」时先判成了 Skip）→ **升级**为 MissingSecret：
-     *    否则有值也会被 Skip 挡住，值永远不会写回。
+     *  - 同 id 已是 **Skip**（上面那条规则在「无值」时先判成了 Skip）→ 值不同时**升级**为
+     *    MissingSecret：否则有值也会被 Skip 挡住，值永远不会写回；值相同时保持 Skip。
      */
     private appendCredentialPlanItems;
+    /**
+     * 读本机 `$DSH_HOME/.credentials.yaml` → `Map<ref, value>`，**只用于**「值是否已经相同」比对。
+     * 与 push 侧 buildCredentialsPayload 读同一个文件、同一解析口径（credentialsMapFromYaml）；
+     * 不新增任何能力，也不回读凭据值到 UI。
+     * 读不到 / 解析失败 → undefined = **无法比较**：调用方必须按「未知」保守处理（照旧要求确认），
+     * 绝不因为读失败就静默跳过写回。
+     * 安全：值只在进程内存里比较 —— 不落盘、不进日志/报告/响应体。
+     */
+    private readLocalCredentials;
     /**
      * sessions 分区的导出选项（opt-in 分区）：显式勾选清单优先于「最新 N 个」。
      *

package/lib/sync/sync-engine.js

@@ -22,6 +22,8 @@ import path from 'node:path';
 import { createAdapters } from '../adapters/index.js';
 import { defaultSecretScanner } from '../core/exporter.js';
 import { Importer } from '../core/importer.js';
+// issue #91：只读预览与基线 hash 的口径判定（本地源插件在预览里不会被 npm pack）
+import { isLocalPluginSpec } from '../core/local-plugin-pack.js';
 import { isFileSection, SECTION_FILE_PREFIXES, SECTION_JSON_PATHS } from '../schema/config.js';
 import { buildManifest, CHECKSUMS_FILE, MANIFEST_FILE } from '../schema/manifest.js';
 import { CURRENT_SCHEMA_VERSION } from '../schema/versions.js';
@@ -83,6 +85,24 @@ const FORBIDDEN_SECTIONS = ['credentialsStatus', 'secrets'];
  * 保留导出是为了让既有调用方/测试仍能引用「缺省保留份数」这一事实，不再作为唯一判据。
  */
 export const MAX_REMOTE_SNAPSHOTS = DEFAULT_RETENTION_POLICY.keepLast;
+/**
+ * issue #91：走只读 `preview()` 拿到的产物，能否直接与该分区**基线 hash**（push 时按 export() 产物记录）比对。
+ *
+ * 为什么需要这个判定：`plugins` 适配器的 `preview()` 走 `collect(…, pack=false)` —— 刻意**不做**
+ * 本地源（`link:` / `file:`）插件的 `npm pack`。于是当 profile 里存在本地源插件时，预览产物既没有
+ * `localTarballs`、插件 spec 也保持原样（export() 会改写成 `file:<tarball>`），与基线**不同口径**：
+ * 此时既不能断言「无变化」（本地插件源码改了体积/内容，预览看不见），也不该为了比对去打包
+ * （那正是本 issue 的缺陷本身）。
+ *
+ * 返回 true = 该分区本趟**不可比** ⇒ 调用方只能保守报「有变化」并如实说明原因。
+ * 其余分区的 preview() 产物与 export() 逐字节相同（文件类分区不走 preview()，见 previewPush）。
+ */
+function previewCaliberDiffersFromExport(sectionId, data) {
+    if (sectionId !== 'plugins')
+        return false;
+    const plugins = data.plugins;
+    return Array.isArray(plugins) && plugins.some((p) => isLocalPluginSpec(p?.spec));
+}
 export class SyncEngine {
     ctx;
     transport;
@@ -282,26 +302,49 @@ export class SyncEngine {
         return credentialsMapFromYaml(await decryptCredentialsPayload(payload, password));
     }
     /**
-     * 把「随加密快照迁移的凭据」补进导入计划：每个解密出的 ref 生成一条 MissingSecret 项。
+     * 把「随加密快照迁移的凭据」补进导入计划：**需要写回**的 ref 生成 MissingSecret 项，
+     * 本机值已与快照逐字节相同的 ref 生成 Skip（info）——写回是 no-op，不该再让用户确认。
      * 执行阶段由 credentials adapter 经 ImportContext.decryptedCredentials（仅内存）
      * 调用 credentials.set(ref, value) 写回本机 —— 与手动补录走同一条已验证路径。
      *
-     * 判定与导入路径同规则（**值的有无优先于本机状态**）：
-     *  - 本函数只处理**有值**的 ref → 一律生成 MissingSecret（确认后写回）。
-     *    **不因本机已配置而跳过**：快照显式带了值（用户勾了「导出密钥」），跳过就等于
-     *    「密钥没同步过来」；要逐项放过用确认列表的批量按钮（sync-view 的 isBulkDecidable）。
+     * 判定与导入路径同规则（**值的有无优先于本机状态**），并多做一步「值是否已经相同」：
+     *  - 有值 + 本机不同 / 本机没有 → MissingSecret（确认后写回）。**不因本机已配置而跳过**：
+     *    快照显式带了值（用户勾了「导出密钥」），跳过就等于「密钥没同步过来」；
+     *    要逐项放过用确认列表的批量按钮（sync-view 的 isBulkDecidable）。
+     *  - 有值 + 本机逐字节相同 → Skip（info）。这是对上一轮「有值一律 MissingSecret」的**收窄**
+     *    （真机反馈：本机 refs 一条不缺，列表却全标「缺密钥」+ 黄色警告）：只有真的会改动本机的
+     *    ref 才需要人工确认。
+     *  - 本机凭据文件读不到 → 无法比较 → 保守按 MissingSecret 处理，绝不静默跳过。
      *  - 「只有 ref 名、没有值」的情形由 createImportPlan → buildCredentialPlanItems 处理
      *    （那里才做本机已配置 → Skip 的判定）。
-     *  - 同 id 已是 **Skip**（上面那条规则在「无值」时先判成了 Skip）→ **升级**为 MissingSecret：
-     *    否则有值也会被 Skip 挡住，值永远不会写回。
+     *  - 同 id 已是 **Skip**（上面那条规则在「无值」时先判成了 Skip）→ 值不同时**升级**为
+     *    MissingSecret：否则有值也会被 Skip 挡住，值永远不会写回；值相同时保持 Skip。
      */
-    appendCredentialPlanItems(plan, credentials) {
+    async appendCredentialPlanItems(plan, credentials) {
         if (credentials === undefined || credentials.size === 0)
             return;
+        const local = await this.readLocalCredentials();
         const byId = new Map(plan.items.map((i) => [i.id, i]));
-        for (const ref of credentials.keys()) {
+        for (const [ref, value] of credentials) {
             const id = `secret:${ref}`;
             const prev = byId.get(id);
+            if (local?.get(ref) === value) {
+                const description = this.msg('sync.credentialsItemSame', { ref });
+                if (prev === undefined) {
+                    const same = {
+                        id, kind: 'Skip', adapter: 'credentialsStatus', description,
+                        severity: 'info', target: { adapter: 'credentialsStatus', ref },
+                    };
+                    plan.items.push(same);
+                    byId.set(id, same);
+                }
+                else if (prev.kind === 'Skip' || prev.kind === 'MissingSecret') {
+                    prev.kind = 'Skip';
+                    prev.severity = 'info';
+                    prev.description = description;
+                }
+                continue;
+            }
             if (prev !== undefined) {
                 if (prev.kind !== 'Skip')
                     continue; // 已有可执行项 → 不重复
@@ -326,6 +369,24 @@ export class SyncEngine {
             .filter((i) => i.kind === 'MissingSecret')
             .map((i) => ({ ref: i.id.replace(/^secret:/, ''), required: true }));
     }
+    /**
+     * 读本机 `$DSH_HOME/.credentials.yaml` → `Map<ref, value>`，**只用于**「值是否已经相同」比对。
+     * 与 push 侧 buildCredentialsPayload 读同一个文件、同一解析口径（credentialsMapFromYaml）；
+     * 不新增任何能力，也不回读凭据值到 UI。
+     * 读不到 / 解析失败 → undefined = **无法比较**：调用方必须按「未知」保守处理（照旧要求确认），
+     * 绝不因为读失败就静默跳过写回。
+     * 安全：值只在进程内存里比较 —— 不落盘、不进日志/报告/响应体。
+     */
+    async readLocalCredentials() {
+        try {
+            const file = path.join(this.ctx.homeDir, '.credentials.yaml');
+            const raw = Buffer.from(await this.ctx.fs.readFile(file)).toString('utf8');
+            return credentialsMapFromYaml(raw);
+        }
+        catch {
+            return undefined;
+        }
+    }
     /**
      * sessions 分区的导出选项（opt-in 分区）：显式勾选清单优先于「最新 N 个」。
      *
@@ -475,14 +536,29 @@ export class SyncEngine {
         const targets = this.pushTargets(opts.sections, warnings);
         const plainSections = {};
         const counts = {};
+        /** issue #91：本趟只读预览省掉了本地源打包 ⇒ 与基线不可比的分区（不可断言「无变化」） */
+        const unpackedSections = new Set();
         for (const adapter of targets) {
+            const exportOptions = {
+                includeSecrets,
+                // 与 push 同口径：显式勾选清单 > 「最新 N 个」上限
+                ...this.sessionExportOptions(adapter.id, opts.sessions),
+            };
             let section;
             try {
-                section = await adapter.export(this.ctx, {
-                    includeSecrets,
-                    // 与 push 同口径：显式勾选清单 > 「最新 N 个」上限
-                    ...this.sessionExportOptions(adapter.id, opts.sessions),
-                });
+                // issue #91：**非文件类**分区优先走 adapter.preview()。只读预览必须零进程副作用，而
+                // plugins 的 export() 会对每个 `link:`/`file:` 插件真的跑一次 `npm pack`
+                // （真机 2 GB 本地源插件 = 297 s；这段时间全局写锁被该请求占满 ⇒ 界面上所有写操作静默 423）。
+                // 为什么文件类分区**不能**走 preview()：其预览产物是「无内容」形态（条目 data 为空、
+                // contentHash 为空串），既不能与基线 hash 比对，也不能进 assertNoForbiddenSections
+                // —— 那会让预览谎报「每个文件分区都变了」。
+                const summary = !isFileSection(adapter.id) && adapter.preview !== undefined
+                    ? await adapter.preview(this.ctx, exportOptions)
+                    : undefined;
+                section = summary?.section ?? await adapter.export(this.ctx, exportOptions);
+                if (summary !== undefined && previewCaliberDiffersFromExport(adapter.id, section.data)) {
+                    unpackedSections.add(adapter.id);
+                }
             }
             catch (err) {
                 warnings.push(this.msg('sync.sectionFailed', { adapter: adapter.id, reason: err instanceof Error ? err.message : String(err) }));
@@ -503,15 +579,29 @@ export class SyncEngine {
         if (!encrypted) {
             try {
                 const state = await loadSyncState(this.stateDir, this.fsx, this.msg);
-                baselineHashes = state.sections;
+                // 基线条目是 SyncSectionState（{hash, updatedAt}），**不是**裸 hash 字符串。
+                // 这里曾把整个对象 as Record<string,string> 直接比对 ⇒ 对象 !== 字符串 恒真
+                // ⇒ 预览对**每一个**分区都报「有变化」，「N 个有变化」这句永远是「全都有变化」。
+                for (const [sid, rec] of Object.entries(state.sections)) {
+                    if (rec !== undefined && typeof rec.hash === 'string')
+                        baselineHashes[sid] = rec.hash;
+                }
             }
             catch {
                 baselineHashes = {};
             }
         }
+        if (unpackedSections.size > 0) {
+            // 如实说明：本次预览没有为本地源插件执行 npm pack，故这些分区的基线比对不可得
+            warnings.push(this.msg('sync.pushPreviewUnpackedLocalSources', { sections: [...unpackedSections].join(', ') }));
+        }
         const sections = Object.keys(plainSections).map((sid) => {
             const id = sid;
-            const changed = encrypted || baselineHashes[id] === undefined || baselineHashes[id] !== hashSection(plainSections[id]);
+            const changed = encrypted
+                // issue #91：只读预览省掉了本地源打包 ⇒ 产物与基线不同口径，**绝不**据此断言「无变化」
+                || unpackedSections.has(id)
+                || baselineHashes[id] === undefined
+                || baselineHashes[id] !== hashSection(plainSections[id]);
             return { section: id, count: counts[id] ?? 0, changed };
         });
         let remoteSnapshotCount = 0;
@@ -659,7 +749,7 @@ export class SyncEngine {
                 pathMappings: opts.pathMappings ?? [],
             });
             // 凭据迁移项（ref 名进计划/报告，值绝不进）
-            this.appendCredentialPlanItems(plan, credentials);
+            await this.appendCredentialPlanItems(plan, credentials);
             const changes = plan.items.map((i) => ({
                 id: i.id,
                 adapter: i.adapter,
@@ -831,7 +921,7 @@ export class SyncEngine {
             // issue #45：自动重定基 + 用户映射（与 pull 同口径；一键同步的 apply-items 复用本 plan）
             pathMappings: opts.pathMappings ?? [],
         });
-        this.appendCredentialPlanItems(plan, credentials);
+        await this.appendCredentialPlanItems(plan, credentials);
         return {
             ok: analysis.valid, zipPath, plan, analysis, snapshotId: targetId, credentials,
             message: tombstoned.length === 0

package/lib/sync/ui-prefs.d.ts

@@ -29,11 +29,33 @@ export interface UiPrefs {
      * 「用户主动改配置」或「非本插件客户端」时起作用。
      */
     sessionFormatDisposition?: SessionFormatDisposition;
+    /**
+     * 回合自动留点（回滚点）总开关。**缺省 / 任何非 true 值 = 关闭**（issue #88 / #89：
+     * 该功能与「配置备份 / 同步」是两件事，却随 bundle 默认启用且没有关闭入口；
+     * 默认启用时账本每回合整份读改写，真机上把宿主拖到 V8 heap OOM）。
+     *
+     * 关闭语义（宿主侧 gate，见 src/core/rollback-gate.ts）：
+     *  · 不订阅 `session/event`（不是「订阅了什么都不做」）；
+     *  · 不留点、不写台账；
+     *  · 聊天内的「↺ 回退」入口收起（不是置灰）。
+     * 台账 / 回退路由本身仍可用：已有回滚点仍能查看、回退、删除、清理 —— 关的是「自动留点」。
+     */
+    rollbackEnabled?: boolean;
 }
 /** 缺省配置（首次无文件 / 损坏 / 不支持 schema 时回退） */
 export declare function defaultUiPrefs(): UiPrefs;
 /** 读取 UI 偏好；文件不存在 / 损坏 / 不支持 schema → 缺省值（不抛错）。 */
 export declare function readUiPrefs(dir: string): Promise<UiPrefs>;
+/**
+ * 同步读取「回滚点开关」（启动期专用）。
+ *
+ * 为什么必须有同步版本：宿主 `apply()` 是同步函数（`src/index.ts`），而开关必须在
+ * **注册订阅之前**就定下来 —— 否则「关闭」只等于「订阅了什么都不做」，与 issue 要求的
+ * 「关闭后不再订阅 `session/event`」不符。读一个几百字节的小文件，启动期一次，代价可忽略。
+ *
+ * 任何异常（不存在 / 损坏 / 形状不符）一律回 false = 关闭。
+ */
+export declare function readRollbackEnabledSync(dir: string): boolean;
 /** 写入 UI 偏好（原子写：临时文件 + rename；自动创建目录）。 */
 export declare function writeUiPrefs(dir: string, prefs: UiPrefs): Promise<void>;
 /**

package/lib/sync/ui-prefs.js

@@ -21,6 +21,7 @@
  *   避免「sync/ui-prefs 写 lastSyncChannel」与「star-prompt 写弹窗状态」互相覆盖。
  */
 import fs from 'node:fs/promises';
+import fsSync from 'node:fs';
 import path from 'node:path';
 import { parseJsonSafe, stringifyJsonSafe } from '../utils/json.js';
 import { atomicWriteFile } from '../utils/atomic-write.js';
@@ -84,8 +85,34 @@ export async function readUiPrefs(dir) {
     if (disposition === 'abort' || disposition === 'skip' || disposition === 'guide') {
         prefs.sessionFormatDisposition = disposition;
     }
+    // 开关只认字面 true：false / 缺省 / 形状不符一律 = 关闭（fail-closed，绝不猜用户想开）
+    if (obj['rollbackEnabled'] === true) {
+        prefs.rollbackEnabled = true;
+    }
     return prefs;
 }
+/**
+ * 同步读取「回滚点开关」（启动期专用）。
+ *
+ * 为什么必须有同步版本：宿主 `apply()` 是同步函数（`src/index.ts`），而开关必须在
+ * **注册订阅之前**就定下来 —— 否则「关闭」只等于「订阅了什么都不做」，与 issue 要求的
+ * 「关闭后不再订阅 `session/event`」不符。读一个几百字节的小文件，启动期一次，代价可忽略。
+ *
+ * 任何异常（不存在 / 损坏 / 形状不符）一律回 false = 关闭。
+ */
+export function readRollbackEnabledSync(dir) {
+    try {
+        const raw = fsSync.readFileSync(path.join(dir, UI_PREFS_FILE), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+            return false;
+        const obj = parsed;
+        return obj['schemaVersion'] === UI_PREFS_SCHEMA_VERSION && obj['rollbackEnabled'] === true;
+    }
+    catch {
+        return false;
+    }
+}
 /** 写入 UI 偏好（原子写：临时文件 + rename；自动创建目录）。 */
 export async function writeUiPrefs(dir, prefs) {
     await fs.mkdir(dir, { recursive: true });
@@ -98,6 +125,7 @@ export async function writeUiPrefs(dir, prefs) {
         ...(prefs.releaseNotesLastSeenVersion !== undefined ? { releaseNotesLastSeenVersion: prefs.releaseNotesLastSeenVersion } : {}),
         ...(prefs.releaseNotesDismissed === true ? { releaseNotesDismissed: true } : {}),
         ...(prefs.sessionFormatDisposition !== undefined ? { sessionFormatDisposition: prefs.sessionFormatDisposition } : {}),
+        ...(prefs.rollbackEnabled === true ? { rollbackEnabled: true } : {}),
     };
     const target = path.join(dir, UI_PREFS_FILE);
     const data = stringifyJsonSafe(payload, { space: 2 });

package/lib/ui/diff-view.d.ts

@@ -32,3 +32,13 @@ export declare function toSideBySide(hunks: readonly DiffHunk[]): SideBySideHunk
 export declare function maxLineDigits(hunks: readonly DiffHunk[]): number;
 /** 行对总数（渲染层做「超长截断」提示时的分母）。 */
 export declare function countSideRows(groups: readonly SideBySideHunk[]): number;
+/** 增删行数（编辑器式文件头的 `+A` / `−R` 用；上下文行不计）。 */
+export interface DiffLineCounts {
+    added: number;
+    removed: number;
+}
+/**
+ * 一侧的行数统计：**只数 unidiff 语义的增删行**（与 git 的 `+A −R` 同口径）。
+ * 成对修改在 unidiff 里本来就是「一删一增」，所以这里不需要按行对再折算。
+ */
+export declare function diffLineCounts(hunks: readonly DiffHunk[]): DiffLineCounts;

package/lib/ui/diff-view.js

@@ -63,4 +63,21 @@ export function maxLineDigits(hunks) {
 export function countSideRows(groups) {
     return groups.reduce((sum, group) => sum + group.rows.length, 0);
 }
+/**
+ * 一侧的行数统计：**只数 unidiff 语义的增删行**（与 git 的 `+A −R` 同口径）。
+ * 成对修改在 unidiff 里本来就是「一删一增」，所以这里不需要按行对再折算。
+ */
+export function diffLineCounts(hunks) {
+    let added = 0;
+    let removed = 0;
+    for (const hunk of hunks) {
+        for (const line of hunk.lines) {
+            if (line.kind === 'add')
+                added += 1;
+            else if (line.kind === 'del')
+                removed += 1;
+        }
+    }
+    return { added, removed };
+}
 //# sourceMappingURL=diff-view.js.map

package/lib/ui/export-flow.js

@@ -51,6 +51,8 @@ const CATEGORY_DESCRIPTION_KEY = {
     ui: 'export.category.ui',
     credentialsStatus: 'export.category.credentialsStatus',
     sessions: 'export.category.sessions',
+    pluginData: 'export.category.pluginData',
+    pluginAssets: 'export.category.pluginAssets',
 };
 /** 需在 UI 标注安全提示、但绝不显示值的分区（凭据状态只有 configured 标记） */
 const SENSITIVE_SECTIONS = new Set(['credentialsStatus']);

package/lib/ui/i18n.d.ts

@@ -92,7 +92,7 @@ export declare const uiZh: {
     readonly 'error.downloadFailed': '下载失败：HTTP {status}';
     readonly 'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态';
     readonly 'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试';
-    readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态';
+    readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：过程可能仍在后台进行，请先刷新预览确认；确实未完成再重试';
     readonly 'error.settingsConflict.title': '配置已被并发修改';
     readonly 'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。';
     readonly 'error.notConfirmed.title': '导入未确认';
@@ -162,7 +162,7 @@ export declare const uiZh: {
     readonly 'sync.kind.skip': '跳过';
     readonly 'sync.kind.conflict': '冲突';
     readonly 'sync.kind.install': '安装';
-    readonly 'sync.kind.missingSecret': '缺密钥';
+    readonly 'sync.kind.missingSecret': '凭据迁移';
     readonly 'sync.kind.missingDependency': '缺依赖';
     readonly 'sync.kind.pathMapping': '路径映射';
     readonly 'sync.kind.warning': '警告';
@@ -517,8 +517,10 @@ export declare const uiZh: {
     readonly 'export.category.settings': 'DSH 全局设置（namespace 分区，redacted）';
     readonly 'export.category.providers': 'LLM Provider / Model / 默认模型 / BaseURL';
     readonly 'export.category.plugins': '已安装插件清单与启用状态（不含二进制）';
-    readonly 'export.category.pluginFiles': '插件自有配置文件（白名单 + plugin-config/ 目录，整文件复制）';
+    readonly 'export.category.pluginFiles': '其他插件放在 ~/.dsh 根下的零散配置文件（白名单 + plugin-config/ 目录，整文件复制）';
     readonly 'export.category.self': '本插件自身配置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）';
+    readonly 'export.category.pluginData': '其他插件在系统主目录下的数据（如 ~/.dsh-wallpaper-engine、~/.mnemon 的配置与状态；可再生成缓存绝不收录）';
+    readonly 'export.category.pluginAssets': '其他插件的大体积文件（上传的壁纸、本地数据库等；默认不勾选）';
     readonly 'export.category.mcp': 'MCP 服务器组合配置（需重启生效）';
     readonly 'export.category.prompts': 'System Prompt / Plan Mode 提示';
     readonly 'export.category.skills': '用户技能文件（~/.dsh/skills）';

package/lib/ui/i18n.js

@@ -99,7 +99,7 @@ export const uiZh = {
     'error.downloadFailed': '下载失败：HTTP {status}',
     'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态',
     'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试',
-    'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态',
+    'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：过程可能仍在后台进行，请先刷新预览确认；确实未完成再重试',
     'error.settingsConflict.title': '配置已被并发修改',
     'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。',
     'error.notConfirmed.title': '导入未确认',
@@ -172,7 +172,7 @@ export const uiZh = {
     'sync.kind.skip': '跳过',
     'sync.kind.conflict': '冲突',
     'sync.kind.install': '安装',
-    'sync.kind.missingSecret': '缺密钥',
+    'sync.kind.missingSecret': '凭据迁移',
     'sync.kind.missingDependency': '缺依赖',
     'sync.kind.pathMapping': '路径映射',
     'sync.kind.warning': '警告',
@@ -547,8 +547,10 @@ export const uiZh = {
     'export.category.settings': 'DSH 全局设置（namespace 分区，redacted）',
     'export.category.providers': 'LLM Provider / Model / 默认模型 / BaseURL',
     'export.category.plugins': '已安装插件清单与启用状态（不含二进制）',
-    'export.category.pluginFiles': '插件自有配置文件（白名单 + plugin-config/ 目录，整文件复制）',
+    'export.category.pluginFiles': '其他插件放在 ~/.dsh 根下的零散配置文件（白名单 + plugin-config/ 目录，整文件复制）',
     'export.category.self': '本插件自身配置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）',
+    'export.category.pluginData': '其他插件在系统主目录下的数据（如 ~/.dsh-wallpaper-engine、~/.mnemon 的配置与状态；可再生成缓存绝不收录）',
+    'export.category.pluginAssets': '其他插件的大体积文件（上传的壁纸、本地数据库等；默认不勾选）',
     'export.category.mcp': 'MCP 服务器组合配置（需重启生效）',
     'export.category.prompts': 'System Prompt / Plan Mode 提示',
     'export.category.skills': '用户技能文件（~/.dsh/skills）',
@@ -660,7 +662,7 @@ export const uiEn = {
     'error.downloadFailed': 'Download failed: HTTP {status}',
     'error.exportTimeout': 'Export timed out ({minutes} min): the export did not complete, please retry; if it keeps timing out, check the DSH state',
     'error.syncTimeout': 'Sync request timed out ({minutes} min): check network and repository reachability, then retry',
-    'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): the recovery did not complete, please retry; if it keeps timing out, check the DSH state',
+    'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): it may still be running in the background — refresh the preview to confirm, then retry if it did not finish',
     'error.settingsConflict.title': 'Configuration changed concurrently',
     'error.settingsConflict.action': 'This configuration on the target DSH was modified by another process during import. To avoid overwriting it, re-export or review it manually, then retry.',
     'error.notConfirmed.title': 'Import not confirmed',
@@ -730,7 +732,7 @@ export const uiEn = {
     'sync.kind.skip': 'Skip',
     'sync.kind.conflict': 'Conflict',
     'sync.kind.install': 'Install',
-    'sync.kind.missingSecret': 'Secret',
+    'sync.kind.missingSecret': 'Credential',
     'sync.kind.missingDependency': 'Dependency',
     'sync.kind.pathMapping': 'Path',
     'sync.kind.warning': 'Warning',
@@ -1091,8 +1093,10 @@ export const uiEn = {
     'export.category.settings': 'Global DSH settings (namespace sections, redacted)',
     'export.category.providers': 'LLM providers / models / default model / base URL',
     'export.category.plugins': 'Installed plugin list and enablement (binaries excluded)',
-    'export.category.pluginFiles': "Plugins' own config files (allowlist + plugin-config/, copied whole)",
+    'export.category.pluginFiles': "Other plugins' loose config files at the ~/.dsh root (allowlist + plugin-config/, copied whole)",
     'export.category.self': "This plugin's own config (sync / autosync / section selection / UI prefs / market; sync-*.json etc., no credential values)",
+    'export.category.pluginData': "Other plugins' data under the system home directory (e.g. the config/state of ~/.dsh-wallpaper-engine and ~/.mnemon; regenerable caches are never included)",
+    'export.category.pluginAssets': "Other plugins' large files (uploaded wallpapers, local databases, ...; not selected by default)",
     'export.category.mcp': 'MCP server composition (restart required)',
     'export.category.prompts': 'System prompt / Plan Mode prompts',
     'export.category.skills': 'Your skill files (~/.dsh/skills)',