dsh-config-manager 0.1.73 → 0.1.77

package/lib/adapters/plugin-data-declared.d.ts

@@ -0,0 +1,12 @@
+import type { PluginDataSource } from '../core/plugin-data-registry.ts';
+import type { HostContext } from '../core/types.ts';
+/** 单次扫描最多读取多少个已安装插件的 manifest（防御性上限：profile 依赖数量异常时不无限读） */
+export declare const MAX_DECLARED_PACKAGES = 300;
+/**
+ * 解析声明时用的 profile 目录名。
+ *
+ * 与 DSH 的 profile 解析同口径：空 / undefined = \`web\`（与改造前的私有实现一致）。
+ */
+export declare function declaredProfileName(profile: string | undefined): string;
+/** 扫描本机已安装插件自述的数据目录声明（零副作用；读不到的一律跳过）。 */
+export declare function scanDeclaredDataSources(ctx: HostContext, maxPackages?: number): Promise<PluginDataSource[]>;

package/lib/adapters/plugin-data-declared.js

@@ -0,0 +1,57 @@
+/**
+ * 「已安装插件自述数据目录（dsh.dataDirs）」的**单一扫描实现**。
+ *
+ * 为什么单独一个模块：这份扫描有两个消费者 ——
+ *  - \`pluginData\` / \`pluginAssets\` adapter（决定要收集哪些区域）；
+ *  - \`plugins\` adapter（导出选择器「按插件看」需要知道**每个插件自己声明的数据区域**，
+ *    才能在不读任何数据目录的前提下画出树骨架）。
+ * 两处各写一份必然漂移（同一条铁律：同一事实只有一份实现）。
+ *
+ * 语义（与改造前 plugin-data.ts 的私有实现逐字一致）：
+ *  - 读的是 **profile 实际安装**的那份 manifest（\`profiles/<profile>/node_modules/<pkg>/package.json\`），
+ *    不是全局目录 —— 同一个包在不同 profile 可以是不同版本，声明必须取本 profile 装的；
+ *  - 读不到（未安装 / 无声明 / 形状非法）一律跳过：本机制是**附加**信息，绝不因为一个包读不出来
+ *    就影响内置来源或整次导出；
+ *  - 本函数**不缓存**（缓存策略由调用方决定：pluginData 有实例级 TTL 缓存，plugins 有模块级缓存）。
+ */
+import { parseDeclaredDataDirs } from '../core/plugin-data-registry.js';
+/** 单次扫描最多读取多少个已安装插件的 manifest（防御性上限：profile 依赖数量异常时不无限读） */
+export const MAX_DECLARED_PACKAGES = 300;
+/**
+ * 解析声明时用的 profile 目录名。
+ *
+ * 与 DSH 的 profile 解析同口径：空 / undefined = \`web\`（与改造前的私有实现一致）。
+ */
+export function declaredProfileName(profile) {
+    return profile !== undefined && profile !== '' ? profile : 'web';
+}
+/** 扫描本机已安装插件自述的数据目录声明（零副作用；读不到的一律跳过）。 */
+export async function scanDeclaredDataSources(ctx, maxPackages = MAX_DECLARED_PACKAGES) {
+    const base = 'profiles/' + declaredProfileName(ctx.profile);
+    const out = [];
+    let deps = [];
+    try {
+        const raw = await ctx.fs.readFile(base + '/package.json');
+        const parsed = JSON.parse(new TextDecoder().decode(raw));
+        const dep = parsed?.dependencies;
+        if (dep !== null && typeof dep === 'object')
+            deps = Object.keys(dep).slice(0, maxPackages);
+    }
+    catch {
+        deps = [];
+    }
+    for (const name of deps) {
+        try {
+            const raw = await ctx.fs.readFile(base + '/node_modules/' + name + '/package.json');
+            const manifest = JSON.parse(new TextDecoder().decode(raw));
+            const source = parseDeclaredDataDirs(name, manifest);
+            if (source !== null)
+                out.push(source);
+        }
+        catch {
+            // 未安装 / 无 manifest → 无声明，跳过
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=plugin-data-declared.js.map

package/lib/adapters/plugin-data.d.ts

@@ -47,13 +47,11 @@ export declare class PluginDataAdapter extends FileCollectionAdapter {
     private allowedEntries;
     private allSources;
     /**
-     * 已安装插件的自述声明（dsh.dataDirs）。
+     * 已安装插件的自述声明（dsh.dataDirs）—— 本方法只做**缓存**，扫描实现见 plugin-data-declared.ts。
      *
-     * 为什么读 profile 的 node_modules 而不是全局目录：DSH 的插件装在 \`profiles/<profile>/node_modules\`
-     * 下（pnpm 隔离布局），且同一个包在不同 profile 可以是不同版本 —— 声明必须取**本 profile 实际装的**那份。
-     *
-     * 读不到（未安装 / 无声明 / 形状非法）一律跳过：本机制是**附加**信息，绝不因为一个包读不出来
-     * 就影响内置来源或整次导出。
+     * 为什么缓存必须带 ctx 键（homeDir + profile）：DSH 的插件装在 \`profiles/<profile>/node_modules\`
+     * 下（pnpm 隔离布局），而「这台机器装了某插件」不代表另一台装了 —— 缓存若按实例共享，
+     * 导入到「没装该插件」的目标机时会拿源机的声明去放行写入，白名单就变成「谁先导入谁说了算」。
      */
     private declaredSources;
     /**

package/lib/adapters/plugin-data.js

@@ -30,13 +30,12 @@ import { normalizePath } from '../utils/paths.js';
 import { engineMsg } from './messages.js';
 import { listFilesDetailed } from './link-report.js';
 import { sectionMeta } from '../schema/section-registry.js';
-import { BUILTIN_PLUGIN_DATA_SOURCES, areaOfPath, areasForSection, isExcludedRel, normalizeHomeRel, parseDeclaredDataDirs, } from '../core/plugin-data-registry.js';
+import { BUILTIN_PLUGIN_DATA_SOURCES, areaOfPath, areasForSection, isExcludedRel, normalizeHomeRel, } from '../core/plugin-data-registry.js';
+import { declaredProfileName, scanDeclaredDataSources } from './plugin-data-declared.js';
 import { osHomeDirOf } from '../core/backup.js';
 import { FileCollectionAdapter } from './file-collection.js';
 /** 声明来源缓存的 TTL（毫秒）：一次导出/导入/执行里会多次解析，逐次读 15+ 个 package.json 是净开销 */
 const DECLARED_TTL_MS = 5_000;
-/** 单次解析里最多读取多少个已安装插件的 manifest（防御性上限：profile 依赖数量异常时不无限读） */
-const MAX_DECLARED_PACKAGES = 300;
 export class PluginDataAdapter extends FileCollectionAdapter {
     id;
     displayName;
@@ -75,48 +74,21 @@ export class PluginDataAdapter extends FileCollectionAdapter {
         return [...this.builtin, ...declared];
     }
     /**
-     * 已安装插件的自述声明（dsh.dataDirs）。
+     * 已安装插件的自述声明（dsh.dataDirs）—— 本方法只做**缓存**，扫描实现见 plugin-data-declared.ts。
      *
-     * 为什么读 profile 的 node_modules 而不是全局目录：DSH 的插件装在 \`profiles/<profile>/node_modules\`
-     * 下（pnpm 隔离布局），且同一个包在不同 profile 可以是不同版本 —— 声明必须取**本 profile 实际装的**那份。
-     *
-     * 读不到（未安装 / 无声明 / 形状非法）一律跳过：本机制是**附加**信息，绝不因为一个包读不出来
-     * 就影响内置来源或整次导出。
+     * 为什么缓存必须带 ctx 键（homeDir + profile）：DSH 的插件装在 \`profiles/<profile>/node_modules\`
+     * 下（pnpm 隔离布局），而「这台机器装了某插件」不代表另一台装了 —— 缓存若按实例共享，
+     * 导入到「没装该插件」的目标机时会拿源机的声明去放行写入，白名单就变成「谁先导入谁说了算」。
      */
     async declaredSources(ctx) {
         const now = Date.now();
-        const profile = ctx.profile !== undefined && ctx.profile !== '' ? ctx.profile : 'web';
-        const memoKey = ctx.homeDir + '|' + profile;
+        const memoKey = ctx.homeDir + '|' + declaredProfileName(ctx.profile);
         if (this.declaredMemo !== undefined
             && this.declaredMemo.key === memoKey
             && now - this.declaredMemo.at < this.declaredTtlMs) {
             return this.declaredMemo.sources;
         }
-        const base = 'profiles/' + profile;
-        const out = [];
-        let deps = [];
-        try {
-            const raw = await ctx.fs.readFile(base + '/package.json');
-            const parsed = JSON.parse(new TextDecoder().decode(raw));
-            const dep = parsed?.dependencies;
-            if (dep !== null && typeof dep === 'object')
-                deps = Object.keys(dep).slice(0, MAX_DECLARED_PACKAGES);
-        }
-        catch {
-            deps = [];
-        }
-        for (const name of deps) {
-            try {
-                const raw = await ctx.fs.readFile(base + '/node_modules/' + name + '/package.json');
-                const manifest = JSON.parse(new TextDecoder().decode(raw));
-                const source = parseDeclaredDataDirs(name, manifest);
-                if (source !== null)
-                    out.push(source);
-            }
-            catch {
-                // 未安装 / 无 manifest → 无声明，跳过
-            }
-        }
+        const out = await scanDeclaredDataSources(ctx);
         this.declaredMemo = { key: memoKey, at: now, sources: out };
         return out;
     }

package/lib/adapters/plugins.js

@@ -23,6 +23,8 @@ import { isENOENT } from '../utils/guards.js';
 import { PLUGIN_PATCH_REF_PREFIX } from '../core/backup.js';
 import { readEffectivePatchLines, resolveWriteLayer, USER_PATCH_FILE } from '../core/patch-layers.js';
 import { parsePnpmPatchedDependencies, sanitizePnpmWorkspacePatches } from './pnpm-workspace.js';
+import { BUILTIN_PLUGIN_DATA_SOURCES, areasForSection } from '../core/plugin-data-registry.js';
+import { declaredProfileName, scanDeclaredDataSources } from './plugin-data-declared.js';
 import { sectionMeta } from '../schema/section-registry.js';
 import { validateJsonSection } from './json-section.js';
 /**
@@ -126,6 +128,66 @@ function entriesOfRaw(raw) {
  * 导出产物（真实 base64）走另一条分支，行为逐字不变。
  */
 const previewTarballBytes = new WeakMap();
+/**
+ * 「插件包名 → 它声明的数据区域」映射（只有 \`plugin:<包名>\` 单元用；导出选择器「按插件看」的树骨架）。
+ *
+ * 为什么挂 WeakMap 而不是给 PluginsSection 加字段：这是**展示用旁路信息** —— 既不是备份格式的
+ * 一部分（schema 校验与市场防线都不该看见它），也与「导出真的带什么」无关；挂在载荷对象上随对象
+ * 一起回收，载荷本身逐字节不变（与 previewTarballBytes 同一套理由）。
+ */
+const relatedAreasByData = new WeakMap();
+/** 内置来源 + 自述声明的扫描缓存（TTL 内的同一 home/profile 只扫一次；/export-preview 一趟会问两次） */
+const declaredSourcesMemo = { key: '', at: 0, sources: [] };
+const DECLARED_MEMO_TTL_MS = 5_000;
+/**
+ * 本机可归属的插件数据来源 = 内置来源表 + 已安装插件自述声明。
+ *
+ * 缓存键必须带 homeDir + profile：同一台机器换 profile 就是另一批已安装插件，拿旧声明画树
+ * 会让用户看到不属于当前 profile 的数据区域。
+ */
+async function pluginDataSources(ctx) {
+    const key = ctx.homeDir + '|' + declaredProfileName(ctx.profile);
+    const now = Date.now();
+    if (declaredSourcesMemo.key === key && now - declaredSourcesMemo.at < DECLARED_MEMO_TTL_MS) {
+        return declaredSourcesMemo.sources;
+    }
+    const sources = [...BUILTIN_PLUGIN_DATA_SOURCES, ...await scanDeclaredDataSources(ctx)];
+    declaredSourcesMemo.key = key;
+    declaredSourcesMemo.at = now;
+    declaredSourcesMemo.sources = sources;
+    return sources;
+}
+/**
+ * 包名 → 该插件的数据区域引用。
+ *
+ * 口径与 pluginData / pluginAssets 的收集面**同源**（同一个 areasForSection）：role=config 进
+ * pluginData、role=assets 进 pluginAssets；role=cache 的区域不属于任何分区，因此**绝不进树**
+ * （缓存是可再生产物，列出来只会诱导用户把它带走）。
+ *
+ * 只产出「注册表说它应该在哪儿」，不代表磁盘上真有 —— 界面必须把两者分开渲染。
+ */
+async function relatedAreasOf(ctx) {
+    const sources = await pluginDataSources(ctx);
+    const map = new Map();
+    for (const source of sources) {
+        const refs = [];
+        for (const section of ['pluginData', 'pluginAssets']) {
+            for (const entry of areasForSection([source], section)) {
+                refs.push({ section, relPath: entry.area.relPath, role: entry.area.role === 'assets' ? 'assets' : 'config' });
+            }
+        }
+        if (refs.length === 0)
+            continue;
+        for (const pkg of source.packages) {
+            const cur = map.get(pkg);
+            if (cur === undefined)
+                map.set(pkg, [...refs]);
+            else
+                cur.push(...refs);
+        }
+    }
+    return map;
+}
 /**
  * 零 spawn 推导本地源插件的体积（预览专用）。
  *
@@ -179,7 +241,7 @@ async function measureLocalSources(plugins, ctx) {
  * `tarballBytes` = 预览路径登记到的本地源体积（见 measureLocalSources，0 = 体积未知但仍随包携带）；
  * 缺省时体积与文件数完全按导出产物里的 base64 计算 —— 与改造前逐字一致。
  */
-function unitsOf(data, tarballBytes) {
+function unitsOf(data, tarballBytes, related) {
     const wsId = 'plugins:pnpm-workspace';
     const patchFileIds = (data.patchFiles ?? []).map((pf) => `plugins:patch:${normalizePath(pf.relativePath)}`);
     const group = [wsId, ...patchFileIds];
@@ -187,6 +249,7 @@ function unitsOf(data, tarballBytes) {
     for (const pl of data.plugins) {
         const tarball = tarballOf(data, pl.name);
         const measured = tarballBytes?.get(pl.name);
+        const areas = related?.get(pl.name);
         units.push({
             id: `plugin:${pl.name}`,
             label: pl.name,
@@ -194,6 +257,8 @@ function unitsOf(data, tarballBytes) {
             // base64 长度 → 原始字节数（仅用于展示体积，不求精确）；预览路径没有字节，用 stat 量到的源体积
             sizeBytes: tarball !== undefined ? Math.floor((tarball.base64.length * 3) / 4) : measured ?? 0,
             ...(tarball !== undefined || measured !== undefined ? { fileCount: 1 } : {}),
+            // 「按插件看」的树骨架：该插件声明的数据区域（零数据目录 I/O）
+            ...(areas !== undefined && areas.length > 0 ? { relatedAreas: areas } : {}),
         });
     }
     for (const line of data.patch) {
@@ -260,7 +325,7 @@ export class PluginsAdapter {
             section: collected,
             // 与 src/index.ts 对 JSON 分区现算体积的口径一致（utf8 字节数）
             sizeBytes: new TextEncoder().encode(stringifyJsonSafe(data)).length,
-            items: unitsOf(data, tarballBytes),
+            items: unitsOf(data, tarballBytes, relatedAreasByData.get(data)),
         };
     }
     /**
@@ -401,16 +466,30 @@ export class PluginsAdapter {
             const alive = new Set(keptPlugins.map((pl) => pl.name));
             keptTarballs = localTarballs?.filter((t) => alive.has(t.packageName));
         }
+        const data = {
+            version: 1,
+            plugins: keptPlugins,
+            patch: keptPatch,
+            pnpmWorkspace: keptWorkspace,
+            ...(keptTarballs !== undefined ? { localTarballs: keptTarballs } : {}),
+            ...(keptPatchFiles !== undefined ? { patchFiles: keptPatchFiles } : {}),
+        };
+        /**
+         * 「按插件看」的树骨架（导出选择器）：登记每个插件声明的数据区域。
+         * 只登记「至少有一个区域」的插件 —— 其余插件单元保持无该字段，界面据此不显示空壳节点。
+         * 归属信息是**附加**信息：扫描失败不得影响导出/预览本身（与 pluginData 同一纪律）。
+         */
+        try {
+            const related = await relatedAreasOf(ctx);
+            if (related.size > 0)
+                relatedAreasByData.set(data, related);
+        }
+        catch {
+            // 读不到声明就不登记（界面按「没有已知关联」渲染，绝不猜）
+        }
         return {
             sectionId: 'plugins',
-            data: {
-                version: 1,
-                plugins: keptPlugins,
-                patch: keptPatch,
-                pnpmWorkspace: keptWorkspace,
-                ...(keptTarballs !== undefined ? { localTarballs: keptTarballs } : {}),
-                ...(keptPatchFiles !== undefined ? { patchFiles: keptPatchFiles } : {}),
-            },
+            data,
             counts: {
                 plugins: keptPlugins.length,
                 patchLines: keptPatch.length,
@@ -429,8 +508,9 @@ export class PluginsAdapter {
      * 由选择模型保证勾选/取消同步。
      */
     listUnits(section) {
-        // 预览产物没有 tarball 字节，体积来自 measureLocalSources 挂上的统计（导出产物走 base64 分支）
-        return unitsOf(section.data, previewTarballBytes.get(section.data));
+        // 预览产物没有 tarball 字节，体积来自 measureLocalSources 挂上的统计（导出产物走 base64 分支）；
+        // 「按插件看」的数据区域骨架同样由 collect() 登记在载荷对象上（两条路径逐字一致，units.test 钉住）
+        return unitsOf(section.data, previewTarballBytes.get(section.data), relatedAreasByData.get(section.data));
     }
     /**
      * 导入后目标机**可能**存在的 patch 文件集合（相对 profile 目录）——issue #35。

package/lib/client.d.ts

@@ -185,6 +185,24 @@ interface ExportUnit {
    * 只下发**事实**，不下发文案 —— 界面按当前语言显示（与 DSH 同口径），绝不用 uuid 冒充标题。
    */
   blank?: boolean;
+  /**
+   * 该插件**声明的第三方数据区域**（只有 \`plugin:<包名>\` 单元可能有值；导出选择器「按插件看」用）。
+   *
+   * 用途：选择器要在**不读任何数据目录**的前提下画出「插件 → 数据目录 / 大文件」的树骨架 ——
+   * 区域清单来自来源注册表（内置来源表 + 插件自述 dsh.dataDirs），是静态知识，零额外 I/O；
+   * 体积与「实际有没有内容」等该分区的清单到货后再填。
+   *
+   * 语义：**纯展示**，不参与勾选/导出契约（契约只认 id）。这里是「注册表说它应该在哪儿」，
+   * **不是**「磁盘上确实有」—— 界面必须把两者分开渲染（unread / 无内容 / 已读到）。
+   */
+  relatedAreas?: readonly PluginAreaRef[];
+}
+/** 插件数据区域引用（pluginData / pluginAssets；只读展示用，不参与勾选契约）。 */
+interface PluginAreaRef {
+  section: 'pluginData' | 'pluginAssets';
+  /** home 相对 POSIX 路径 —— 就是该分区单元的 id 后缀（\`pluginData:.mnemon/runtime\` 的末段） */
+  relPath: string;
+  role: 'config' | 'assets';
 }
 type PlanItemKind = 'Create' | 'Update' | 'Skip' | 'Conflict' | 'Install' | 'MissingSecret' | 'MissingDependency' | 'PathMapping' | 'Warning' | 'Error';
 type ItemResolution = 'keepCurrent' | 'useImported' | 'review';
@@ -647,6 +665,12 @@ interface SnapshotMeta {
  * （maxLines / maxD）时**降级为整块替换**（全删 + 全增），保证任何输入都有确定
  * 耗时的输出 —— 大文件不会卡死宿主。
  *
+ * 预算怎么定（2026-10-15 真机实测，本仓 rollback-point.ts 的一对版本）：
+ *  · 时间是 (N+M)·D 量级：D=4000、两侧合计 ~7500 行时 ≈ 70 ms（D=8000 ≈ 115 ms）；
+ *  · 内存是 O(D²)·4B（回溯要逐轮留 V 快照）：D=2000 时 RSS +~30 MB、D=4000 +~100 MB、D=8000 +~175 MB。
+ *  ⇒ 缺省取 2000（覆盖「大文件只改了几处」这一大类）；单文件按需查看的调用方可以往上调，
+ *    到 4000 仍是一次点击可接受的开销；再大就该换线性空间算法，而不是继续加预算。
+ *
  * 行为约定：
  *  - 行尾 \r\n 归一为 \n；文本末尾的换行不产生"空行"（行数 = 换行符语义）。
  *  - 仅空白差异同样是差异（不做 ignoreWhitespace）。
@@ -1523,7 +1547,7 @@ 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': '导入未确认';
@@ -1948,10 +1972,10 @@ 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': '其他插件放在 ~/.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.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）';
@@ -4158,6 +4182,23 @@ interface RollbackPreviewFile {
   removed: number | null;
   /** true = 本次没有可信行数（added/removed 均为 null）。**宁可说「不知道」，也绝不谎报行数。** */
   truncated: boolean;
+  /**
+   * true = 该文件在留点**之后**是**别的会话**写的（写入归属台账证明；见 core/rollback-attribution.ts）。
+   * 界面据此默认不勾选它（用户仍可勾上）。缺字段 / false = **没有归属证据**，
+   * 而不是「本会话写的」——「未判定」与「确知是本会话」必须分开。
+   */
+  foreign?: boolean;
+  /** 那些「别的会话」的会话 id（仅当 foreign 为 true） */
+  foreignSessionId?: string;
+  /** 那次写入的时间（毫秒；仅当 foreign 为 true） */
+  foreignAt?: number;
+  /**
+   * true = 这次回退**不会改动它**（与其它对话的改动冲突 / 无法安全合并）。行级统计为 null ——
+   * 「不改动」不是「0 行变化」，界面必须分开说。
+   */
+  skipped?: boolean;
+  /** 不改动的机器原因（界面映射成字典键，绝不裸渲染） */
+  mergeReason?: string;
 }
 interface RollbackWorkspacePreview {
   /** 将被写回（覆盖）的条目数 */
@@ -4279,6 +4320,12 @@ interface RollbackFileDiffResult {
   identical: boolean;
   degraded: boolean;
   reason?: RollbackFileDiffReason;
+  /** true = 「回退后」一侧显示的是三方合并的结果（不是记录里的原文） */
+  merged?: boolean;
+  /** true = 这次回退不会改动它（冲突 / 无法安全合并）——此时两侧相同 */
+  mergeSkipped?: boolean;
+  /** 不改动的机器原因（界面映射成字典键） */
+  mergeReason?: string;
 }
 interface RollbackSegmentResult {
   state: string;
@@ -4304,6 +4351,22 @@ interface RollbackSegmentResult {
   createdRefusedReason?: string | null;
   /** 工作区段：实际写回的字节数（宿主回传才有） */
   writtenBytes?: number;
+  /** 因归属隔离（B）跳过的记录条目数：该文件在留点后被**别的会话**写过（宿主回传才有） */
+  foreignSkipped?: number;
+  /** 因路径选择（A）跳过的记录条目数（宿主回传才有） */
+  selectionSkipped?: number;
+  /** 三方合并成功、写回「撤销本会话 + 保留对方改动」的条目数（宿主回传才有） */
+  mergedCount?: number;
+  mergedPaths?: string[];
+  /** 冲突：两侧改到同一处 ⇒ 未写（宿主回传才有） */
+  conflictCount?: number;
+  conflictPaths?: string[];
+  /** 无法安全撤销 ⇒ 未写（宿主回传才有） */
+  unavailableCount?: number;
+  unavailablePaths?: string[];
+  /** 写入前发现又被改过（并发）⇒ 未写（宿主回传才有） */
+  concurrentCount?: number;
+  concurrentPaths?: string[];
   /** 兼容形态：宿主只回传计数时也算得出来 */
   createdAfter?: RollbackCount;
   createdAfterTruncated?: boolean;
@@ -4342,6 +4405,13 @@ interface RollbackRewindOptions {
   segments?: readonly RollbackState[];
   allowPartial?: boolean;
   preRewindGuard?: RollbackGuardPolicy;
+  /**
+   * 路径级选择性恢复（2026-10-17 定案 A）：只恢复这些路径。
+   *
+   * 缺省 = 全量口径（一字不变）。**空数组是无效输入**（宿主 400）—— 「一个都没勾」由界面拦住，
+   * 绝不让它变成「整次回退静默 noop」。
+   */
+  onlyPaths?: readonly string[];
 }
 /** 端口：由 src/client/recovery/recovery-api.ts 实现（Partial 消费，缺失时界面如实说能力缺失）。 */
 interface RollbackPointPort {
@@ -4683,20 +4753,20 @@ declare const zh$4: {
   readonly 'section.settings': '设置';
   readonly 'section.ui': 'UI 偏好';
   readonly 'section.providers': 'Provider 与模型';
-  readonly 'section.plugins': '插件';
+  readonly 'section.plugins': '插件清单';
   readonly 'section.mcp': 'MCP 服务器';
   readonly 'section.prompts': '提示词';
   readonly 'section.skills': '技能';
   readonly 'section.agentPresets': 'Agent 预设';
   readonly 'section.agentInstructions': '全局指令';
   readonly 'section.workspaces': '工作区';
-  readonly 'section.pluginFiles': '其他插件零散文件';
+  readonly 'section.pluginFiles': '插件散落配置';
   readonly 'section.credentialsStatus': '凭据状态';
   readonly 'section.secrets': '密钥';
   readonly 'section.sessions': '历史会话';
-  readonly 'section.self': '本插件自身配置';
-  readonly 'section.pluginData': '其他插件数据';
-  readonly 'section.pluginAssets': '其他插件大文件';
+  readonly 'section.self': '配置管理器设置';
+  readonly 'section.pluginData': '插件数据目录';
+  readonly 'section.pluginAssets': '插件大文件';
   readonly 'view.about': '关于';
   readonly 'about.snippet.environment': '### 环境 / Environment';
   readonly 'about.releaseNotes.rateLimited': 'GitHub API 速率限制（Rate limit exceeded），请稍后再试或直接在 GitHub 上查看。';
@@ -4836,6 +4906,26 @@ declare const zh$4: {
   readonly 'picker.sensitive': '敏感';
   readonly 'picker.showAll': '显示全部（共 {count} 条）';
   readonly 'picker.summaryImport': '将导入 {sections} 个分区 · {units} 个条目';
+  readonly 'picker.pluginRoot': '插件';
+  readonly 'picker.pluginLeafPlugin': '插件清单条目';
+  readonly 'picker.pluginLeafConfig': '数据目录（配置）';
+  readonly 'picker.pluginLeafAssets': '大文件（壁纸 / 数据库）';
+  readonly 'picker.pluginAreaUnread': '未读取';
+  readonly 'picker.pluginAreaAbsent': '无内容';
+  readonly 'picker.pluginViewEmpty': '插件清单还没读到，先读取「插件」分区。';
+  readonly 'picker.bucketPlugins': '插件分区的其他条目（补丁行 / pnpm-workspace.yaml）';
+  readonly 'picker.bucketLooseFiles': '未归属到插件的配置（~/.dsh 根）';
+  readonly 'picker.bucketHint': '这些条目没有可证明的插件归属，不猜；展开可逐条勾选。';
+  readonly 'picker.groupHint.extensions': '这一组里的插件分区合并成一棵按插件分组的树：默认只显示一个「插件」区块，展开它才列出各个插件，插件名下面是它的清单条目、数据目录与大文件。只显示能证明的归属（内置来源表 + 插件自述 dsh.dataDirs）——「插件散落配置」没有包名信息，因此留在「未归属」里；带「设备相关」的分区默认不勾选，跨设备导入时可能不适用。';
+  readonly 'group.general': '通用';
+  readonly 'group.ai': 'AI';
+  readonly 'group.extensions': '插件与扩展';
+  readonly 'group.mcp': 'MCP / 工具';
+  readonly 'group.customization': '定制';
+  readonly 'group.automation': '自动化';
+  readonly 'group.workspace': '工作区';
+  readonly 'group.ui': '界面';
+  readonly 'group.optional': '可选数据';
   readonly 'import.nothingSelected': '当前没有勾选任何要导入的内容，请把需要导入的分区或条目勾上。';
   readonly 'import.excludedByUser': '本次有 {count} 项被你取消勾选：未导入，也未进快照。';
   readonly 'import.consult.hint': '只读分析：先看结论与依据，确认后再选择要导入的内容。';
@@ -4997,7 +5087,6 @@ declare const zh$4: {
   readonly 'snapshots.plan.diffEscape': '路径越界，已拒绝读取';
   readonly 'snapshots.plan.diffNotApplicable': '该动作不是文件内容变更，无逐行对照';
   readonly 'snapshots.plan.diffDegraded': '差异过大，已按整块对比显示';
-  readonly 'snapshots.plan.diffTruncated': '仅显示前 {shown} 行（共 {total} 行）';
   readonly 'snapshots.plan.statSkipped.tooLarge': '体积超上限，未统计';
   readonly 'snapshots.plan.statSkipped.binary': '二进制';
   readonly 'snapshots.plan.statSkipped.budget': '未统计（文件数上限）';
@@ -6485,7 +6574,7 @@ declare const zh$1: {
   readonly 'rollback.code.fork-failed': 'fork 子会话失败，会话段未回退';
   readonly 'rollback.code.capture-failed': '该态留点失败';
   readonly 'rollback.code.capture-truncated': '该态留点到达上限被截断（已如实标注）';
-  readonly 'rollback.code.capture-degraded': '该态留点不完整（有链接或读不到的内容被跳过，已逐条留痕）';
+  readonly 'rollback.code.capture-degraded': '该态留点不完整（有读不到或期间被改写的内容，已逐条留痕）';
   readonly 'rollback.code.no-chunks': '没有给出工作区路径分块';
   readonly 'rollback.code.chunk-not-absolute': '工作区分块必须是绝对路径';
   readonly 'rollback.code.chunk-not-found': '工作区分块不存在或不可用';
@@ -6524,6 +6613,14 @@ declare const zh$1: {
   readonly 'rollback.preview.notice.skipped': '{n} 项在留点时被跳过（未记录；已计入证明名单 ⇒ 不参与删除判据）';
   readonly 'rollback.preview.notice.truncated': '该点捕获被上限截断（超单文件上限 / 字节预算 / 文件数预算）；删除判据另看证明名单（路径索引）是否完整';
   readonly 'rollback.preview.files.title': '将被回退的文件：';
+  readonly 'rollback.preview.select.foreign': '其它对话改过';
+  readonly 'rollback.preview.select.toggle': '「{path}」：勾上则这次回退恢复它';
+  readonly 'rollback.result.foreignSkipped': '{n} 个文件在留点后被其它对话改过，这次没有回退它们';
+  readonly 'rollback.result.merged': '{n} 个文件已合并：撤销本次对话的改动，保留其它对话的改动';
+  readonly 'rollback.result.conflict': '{n} 个文件两侧改到同一处，已保持原样 —— 需要你手工处理';
+  readonly 'rollback.result.unavailable': '{n} 个文件无法安全撤销（缺少中间版本 / 二进制 / 差异过大），已保持原样';
+  readonly 'rollback.result.concurrent': '{n} 个文件在回退过程中又被改过，已保持原样';
+  readonly 'rollback.result.selectionSkipped': '{n} 个文件按你的勾选跳过了';
   readonly 'rollback.preview.files.empty': '工作区与该回退点一致，无需恢复';
   readonly 'rollback.preview.files.unavailable': '该回退点的工作区态没有可用的记录（原因：{reason}），无需恢复';
   readonly 'rollback.preview.files.unavailableSession': '该回退点的工作区态没有可用的记录（原因：{reason}）；会话仍会回退到该点之前';
@@ -6533,6 +6630,9 @@ declare const zh$1: {
   readonly 'rollback.preview.file.removed': '−{n}';
   /** 整文件删除（用户 2026-10-12 第 6 条）：写「删除」而不是 `+0 −N` —— 那是两件事。 */
   readonly 'rollback.preview.file.deleted': '删除';
+  readonly 'rollback.preview.file.skipped': '不会改动（与其它对话的改动冲突，或无法安全合并）';
+  readonly 'rollback.diff.merged': '下面是合并后的结果：撤销本对话的改动、保留其它对话的改动';
+  readonly 'rollback.diff.skipped': '这次回退不会改动它（与其它对话的改动冲突，或无法安全合并）';
   readonly 'rollback.preview.file.unknown': '行数未统计';
   readonly 'rollback.preview.file.unknownHint': '这些文件的行数没有统计出来（文件过大、不是文本或内容副本读不出来）—— 回退仍会照常覆盖它们。';
   readonly 'rollback.diff.viewHint': '查看差异：{path}';
@@ -6541,7 +6641,6 @@ declare const zh$1: {
   readonly 'rollback.diff.after': '回退后';
   readonly 'rollback.diff.identical': '该文件与回退点内容一致，回退不会改动它';
   readonly 'rollback.diff.degraded': '差异规模较大，已按整块替换展示（仍是完整结果，只是不是最小的编辑脚本）';
-  readonly 'rollback.diff.truncated': '只画了前 {shown} 行（共 {total} 行），数据本身是完整的';
   readonly 'rollback.diff.reason.missingBlob': '这份内容副本读不出来，无法逐行对照（回退仍会尝试写回它）';
   readonly 'rollback.diff.reason.binary': '不是文本文件，没有逐行差异可看';
   readonly 'rollback.diff.reason.tooLarge': '文件超过展示上限，没有逐行差异可看（回退仍会照常覆盖它）';