dsh-config-manager 0.1.67 → 0.1.69

package/lib/adapters/self.js

@@ -1,31 +1,4 @@
-/**
- * self 分区 adapter（插件自身配置，设计「self 分区」）：
- * 数据源 = $DSH_HOME/dsh-config-manager/ 下的插件自身配置文件（白名单收集，非递归）：
- *   - sync/sync-config.json     同步通道配置（git repoUrl / webdav url+username；凭据值走 credentials 槽位，不含 secret）
- *   - sync/sync-autosync.json   自动同步调度配置
- *   - sync/sync-selection.json  同步分区选择（默认/高级模式 + 勾选分区）
- *   - sync/ui-prefs.json        插件 UI 偏好（如上次选择的同步通道；从 localStorage 迁入）
- *   - market/market-config.json 配置市场配置
- *
- * 排除项：sync/sync-history.json（执行记录，属数据非配置）、market/cache/（缓存）、
- * snapshots/（快照）、tmp/ exports/（临时/导出产物）——只备份「配置」，不备份数据。
- *
- * 实现：继承 FileCollectionAdapter 复用 analyzeImport/applyItem/validate（幂等 hash 比对、
- * 快照/回滚路径一致），仅覆写 export() 为白名单收集（self 目录内存在大量非配置子目录，
- * 不能像 skills/sessions 那样整体递归）。
- *
- * relativePath 一律是「相对 baseDir」的路径（如 sync/sync-config.json），与
- * FileCollectionAdapter 的基准目录语义一致：导入时按 path.join(baseDir, rel) 写回
- * $DSH_HOME/dsh-config-manager/<rel>；ZIP 内位于 self/<rel>。
- *
- * 安全不变量：配置文件本身不含凭据值（同步凭据走 DSH credentials 槽位引用），
- * 且文件类分区不进 SecretScanner（与 pluginFiles/skills 同语义）。
- */
-import path from 'node:path';
-import { msgOf } from '../core/messages.js';
-import { sha256Hex } from '../utils/hashing.js';
 import { FileCollectionAdapter } from './file-collection.js';
-import { unitAllowed } from './units.js';
 /** self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。 */
 export const SELF_CONFIG_FILES = [
     'sync/sync-config.json',
@@ -49,35 +22,47 @@ export class SelfAdapter extends FileCollectionAdapter {
         super();
         this.baseDir = baseDir;
     }
-    /** 白名单收集：只导出配置类文件（存在才收），不递归（排除快照/历史/缓存/临时产物）。
-     *  relativePath 产出相对 baseDir 的路径（与 analyzeImport/applyItem 的 path.join(baseDir, ref) 匹配）。 */
     /** self 的白名单文件彼此独立（同步配置 / 市场配置 / UI 偏好…），不构成 bundle
      *  → 覆写为「逐文件单元」，用户可以只带走其中几项。 */
     unitIdOf(relativePath) {
         return relativePath;
     }
-    async export(ctx, options) {
-        const files = [];
-        const warnings = [];
-        const allow = options.includeItems?.[this.id];
+    /**
+     * 清单枚举 = **白名单文件**（覆写基类的目录递归）。
+     *
+     * 为什么必须覆写：self 目录下并存着插件自身的数据（snapshots/、config-snapshots/、
+     * sync/work/ 的 Git 工作副本与远端快照、transactions/、exports/、遗留 profiles/），
+     * 整目录递归会把它们全部当成「可勾选单元」（实测本机 2460 个文件 / 11.44 MB）。
+     * 覆写后 export()（基类 collect，content 模式）与 preview()（size 模式）拿到**同一份清单**，
+     * 选择器显示的条目/体积与真实导出逐项一致。
+     *
+     * 存在性判定优先 statSize（只 stat；白名单最多 7 个文件）；旧宿主未实现时退回读一次文件
+     * （单文件代价可忽略，且 collect 之后还要读它）。读不到 / 未创建 → 跳过，
+     * 与「文件不存在 = 非白名单命中」同语义（如从未配置市场/同步）。
+     *
+     * 路径一律用 POSIX 分隔符拼：relativePath 是**备份格式的一部分**（ZIP 内为 self/<rel>），
+     * 同时是单元 id（self:<rel>）与 includeItems 的比对键 —— 不能随平台漂移成反斜杠。
+     */
+    async listRelPaths(ctx) {
+        const empty = { paths: [], skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+        const found = [];
         for (const rel of SELF_CONFIG_FILES) {
-            if (!unitAllowed(allow, `${this.id}:${this.unitIdOf(rel)}`))
-                continue;
-            // ctx.fs.readFile 语义 = 相对 homeDir 的完整路径 → 拼接 baseDir；产出仍为相对 baseDir
-            const data = await ctx.fs.readFile(path.join(this.baseDir, rel)).catch(() => null);
-            if (data === null)
-                continue; // 未创建过的配置文件跳过（如从未配置市场/同步）
-            files.push({ relativePath: rel, data, contentHash: sha256Hex(data) });
+            const full = `${this.baseDir}/${rel}`;
+            try {
+                if (ctx.fs.statSize !== undefined) {
+                    if ((await ctx.fs.statSize(full)) === null)
+                        continue;
+                }
+                else {
+                    await ctx.fs.readFile(full);
+                }
+                found.push(full);
+            }
+            catch {
+                // 未创建过的配置文件跳过
+            }
         }
-        if (files.length === 0) {
-            warnings.push(msgOf(ctx)('adapter.dirEmpty', { type: this.displayName }));
-        }
-        return {
-            sectionId: this.id,
-            data: { version: 1, files },
-            counts: { files: files.length },
-            warnings,
-        };
+        return { ...empty, paths: found };
     }
 }
 //# sourceMappingURL=self.js.map

package/lib/adapters/sessions.d.ts

@@ -8,7 +8,7 @@
  * core/session-select.ts（单位 = 会话目录、文件名判据不写死、按日志最新 mtime 倒序）。
  */
 import { FileCollectionAdapter } from './file-collection.ts';
-import type { ApplyResult, ExportOptions, ExportSection, HostContext, ImportContext } from '../core/types.ts';
+import type { ApplyResult, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem } from '../core/types.ts';
 import type { FilesSection } from '../schema/types.ts';
 export declare class SessionsAdapter extends FileCollectionAdapter {
     readonly id: 'sessions';
@@ -66,8 +66,12 @@ export declare class SessionsAdapter extends FileCollectionAdapter {
      * 返回键 = `sessionIdKey(目录名)`（`session-<uuid>` 与裸 `<uuid>` 归一化成同一个会话，取较大者）；
      * 时间读不到的会话**不进 Map**（调用方按「时间未知」处理，绝不把未知当成 0 —— 那会把它排到最旧）。
      * 宿主不提供 `mtimeMs` 门面 → 返回空 Map（调用方退回元数据缓存时间，行为与改造前一致）。
+     *
+     * @param precomputed 预览**顺带**取到的时间（`SectionPreview.statTimes`：homeDir 相对路径 → mtime）。
+     *   给了就**不再逐文件 stat**（这正是「合并成一次 stat」的落点）；只认那些确实是会话日志的路径。
+     *   缺省（旧宿主 / 未实现 `statInfo`）→ 走原来的逐文件 `mtimeMs`。
      */
-    unitActivityTimes(ctx: HostContext, section: ExportSection<FilesSection>): Promise<Map<string, number>>;
+    unitActivityTimes(ctx: HostContext, section: ExportSection<FilesSection>, precomputed?: ReadonlyMap<string, number>): Promise<Map<string, number>>;
     /**
      * 分区收尾（issue #45）：把用户填的路径映射**同时**作用到会话日志首帧 cwd 与目录位置。
      *
@@ -130,5 +134,6 @@ export declare class SessionsAdapter extends FileCollectionAdapter {
      * 挂在本地父对话之下 —— 无脑告警会把正常情况说成「看不到」，比不告警更糟。
      */
     private orphanSubagentWarnings;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
     finalizeApply(ctx: ImportContext): Promise<ApplyResult[]>;
 }

package/lib/adapters/sessions.js

@@ -19,6 +19,16 @@ import { readLogHeaderFromBytes } from '../utils/session-log.js';
 import { toPosixRel } from './units.js';
 /** 逐批并发 stat 的批大小：会话树可能有上千个日志文件，一次性开满 Promise 会打爆 libuv 线程池 */
 const MTIME_BATCH = 16;
+/**
+ * 「本次导入真正写入了几个会话文件」的计数（T2）。
+ *
+ * 为什么用 WeakMap<ImportContext, number> 而不是适配器实例字段：宿主**每个插件进程只
+ * createAdapters 一次**（makeImporter() 复用同一批适配器实例），实例字段会跨导入累积 ——
+ * 第二次导入即使一个会话都没勾，也会因为「上次写过」而提示「需重启 DSH」。
+ * ImportContext 是**每次导入新建**的，用它当键天然按导入隔离；WeakMap 不阻止回收，
+ * 请求结束后计数随之消失（不会把会话内容或路径长期留在内存里）。
+ */
+const writtenSessionFiles = new WeakMap();
 export class SessionsAdapter extends FileCollectionAdapter {
     id = 'sessions';
     displayName = 'Sessions';
@@ -135,8 +145,12 @@ export class SessionsAdapter extends FileCollectionAdapter {
      * 返回键 = `sessionIdKey(目录名)`（`session-<uuid>` 与裸 `<uuid>` 归一化成同一个会话，取较大者）；
      * 时间读不到的会话**不进 Map**（调用方按「时间未知」处理，绝不把未知当成 0 —— 那会把它排到最旧）。
      * 宿主不提供 `mtimeMs` 门面 → 返回空 Map（调用方退回元数据缓存时间，行为与改造前一致）。
+     *
+     * @param precomputed 预览**顺带**取到的时间（`SectionPreview.statTimes`：homeDir 相对路径 → mtime）。
+     *   给了就**不再逐文件 stat**（这正是「合并成一次 stat」的落点）；只认那些确实是会话日志的路径。
+     *   缺省（旧宿主 / 未实现 `statInfo`）→ 走原来的逐文件 `mtimeMs`。
      */
-    async unitActivityTimes(ctx, section) {
+    async unitActivityTimes(ctx, section, precomputed) {
         const out = new Map();
         const logRels = [];
         const homeRelOf = new Map();
@@ -153,7 +167,13 @@ export class SessionsAdapter extends FileCollectionAdapter {
             homeRelOf.set(relPath, toPosixRel(this.baseDir + '/' + relPath));
             keyOfRel.set(relPath, sessionIdKey(dir));
         }
-        const mtimes = await this.logMtimes(ctx, logRels, homeRelOf);
+        // 预览已 stat 过 → 直接按 homeRel 取时间（过滤掉非日志路径），不再发起第二趟 I/O。
+        const mtimes = precomputed !== undefined
+            ? new Map(logRels.map((rel) => {
+                const at = precomputed.get(homeRelOf.get(rel) ?? rel);
+                return [rel, at === undefined ? null : at];
+            }))
+            : await this.logMtimes(ctx, logRels, homeRelOf);
         for (const [rel, at] of mtimes) {
             if (at === null)
                 continue;
@@ -414,10 +434,28 @@ export class SessionsAdapter extends FileCollectionAdapter {
                 }),
             }];
     }
+    async applyItem(item, ctx) {
+        const result = await super.applyItem(item, ctx);
+        // 只累计「本次导入（同一 ImportContext）」写成功的数量 —— 见 writtenSessionFiles 的说明。
+        if (result.ok)
+            writtenSessionFiles.set(ctx, (writtenSessionFiles.get(ctx) ?? 0) + 1);
+        return result;
+    }
     async finalizeApply(ctx) {
         const data = ctx.sections.get('sessions');
         if (data === undefined || !Array.isArray(data.files))
             return [];
+        // T2：DSH 的会话列表在**启动期**读取（会话注册表 + 工作区投影都在进程启动时建立），
+        // 所以写入会话后必须显式提示「重启 DSH 才会出现」。生态同类插件（dsh-chatsync）同结论。
+        // 位置放在收尾结果的最前：它是本次会话导入的**唯一必读提示**，不该被逐会话明细淹没。
+        const writtenCount = writtenSessionFiles.get(ctx) ?? 0;
+        const restartNotice = writtenCount > 0
+            ? [{
+                    ok: true,
+                    needsRestart: true,
+                    message: ctx.msg('import.sessionsNeedRestart', { count: String(writtenCount) }),
+                }]
+            : [];
         const byUnit = new Map();
         for (const file of data.files) {
             const unit = toPosixRel(this.unitIdOf(file.relativePath));
@@ -426,7 +464,7 @@ export class SessionsAdapter extends FileCollectionAdapter {
             byUnit.set(unit, list);
         }
         // 父对话缺席的子代理会话：先如实告警（这是数据层面的结论，与本机有没有归位能力无关）
-        const results = await this.orphanSubagentWarnings(ctx, byUnit);
+        const results = [...restartNotice, ...await this.orphanSubagentWarnings(ctx, byUnit)];
         const store = ctx.target.sessions;
         if (store?.readLogCwd === undefined || store.relocateDir === undefined)
             return results;

package/lib/adapters/test-helpers.d.ts

@@ -26,6 +26,13 @@ export declare class MemFs implements FileSystemFacade {
     /** 测试助手：登记某文件的 mtime（null = 恢复为「读不到」） */
     setMtime(relPath: string, ms: number | null): void;
     mtimeMs(relPath: string): Promise<number | null>;
+    /**
+     * 文件字节数（只读预览用）。
+     *
+     * 语义与真实门面一致：**读不到 → null**（不返回 0）—— 0 会让字节闸门少算，
+     * 让预览把本该剔除的单元也列出来，与真实导出分叉。
+     */
+    statSize(relPath: string): Promise<number | null>;
     listRecursive(dir: string): Promise<string[]>;
     mkdir(): Promise<void>;
 }

package/lib/adapters/test-helpers.js

@@ -57,6 +57,16 @@ export class MemFs {
     async mtimeMs(relPath) {
         return this.mtimes.get(this.key(relPath)) ?? null;
     }
+    /**
+     * 文件字节数（只读预览用）。
+     *
+     * 语义与真实门面一致：**读不到 → null**（不返回 0）—— 0 会让字节闸门少算，
+     * 让预览把本该剔除的单元也列出来，与真实导出分叉。
+     */
+    async statSize(relPath) {
+        const v = this.files.get(this.key(relPath));
+        return v === undefined ? null : v.byteLength;
+    }
     async listRecursive(dir) {
         const base = normalizePath(this.homeDir);
         const prefix = normalizePath(dir) === '' ? base : `${base}/${normalizePath(dir)}`;

package/lib/adapters/units.d.ts

@@ -23,10 +23,20 @@ export declare function defaultUnitId(rel: string): string;
  * 空数组 = 什么都不允许（调用方应把该分区整体视为未勾选，见 Exporter.export）。
  */
 export declare function unitAllowed(allow: readonly string[] | undefined, id: string): boolean;
-/** 白名单是否让该分区整体为空（= 用户取消了整个分区，不是「导出空分区」）。 */
-export declare function allowListEmptiesSection(allow: readonly string[] | undefined): boolean;
 /** 由「成员文件」归并出单元清单（体积 = 成员文件字节合计；零 I/O）。 */
 export declare function unitsFromFiles(sectionId: string, files: readonly {
     relativePath: string;
     data: Uint8Array;
 }[], unitIdOf: (rel: string) => string): ExportUnit[];
+/**
+ * 由「路径 + 已知体积」归并出单元清单（零 I/O）。
+ *
+ * 为什么要有这一份：只读预览（`/export-preview`）拿不到文件内容（也不该读），体积来自
+ * `ctx.fs.statSize`。若预览改用「data 为空的 FilesSection」喂 `unitsFromFiles`，
+ * 每个单元的体积会变成 0，选择器显示的体积全错。两份实现必须**同一套聚合规则**，
+ * 否则预览与导出会算出不同的单元体积（`file-collection.test.ts` 钉住两者逐项相等）。
+ */
+export declare function unitsFromEntries(sectionId: string, entries: readonly {
+    relativePath: string;
+    sizeBytes: number;
+}[], unitIdOf: (rel: string) => string): ExportUnit[];

package/lib/adapters/units.js

@@ -15,18 +15,25 @@ export function defaultUnitId(rel) {
 export function unitAllowed(allow, id) {
     return allow === undefined || allow.includes(id);
 }
-/** 白名单是否让该分区整体为空（= 用户取消了整个分区，不是「导出空分区」）。 */
-export function allowListEmptiesSection(allow) {
-    return allow !== undefined && allow.length === 0;
-}
 /** 由「成员文件」归并出单元清单（体积 = 成员文件字节合计；零 I/O）。 */
 export function unitsFromFiles(sectionId, files, unitIdOf) {
+    return unitsFromEntries(sectionId, files.map((f) => ({ relativePath: f.relativePath, sizeBytes: f.data.byteLength })), unitIdOf);
+}
+/**
+ * 由「路径 + 已知体积」归并出单元清单（零 I/O）。
+ *
+ * 为什么要有这一份：只读预览（`/export-preview`）拿不到文件内容（也不该读），体积来自
+ * `ctx.fs.statSize`。若预览改用「data 为空的 FilesSection」喂 `unitsFromFiles`，
+ * 每个单元的体积会变成 0，选择器显示的体积全错。两份实现必须**同一套聚合规则**，
+ * 否则预览与导出会算出不同的单元体积（`file-collection.test.ts` 钉住两者逐项相等）。
+ */
+export function unitsFromEntries(sectionId, entries, unitIdOf) {
     const byUnit = new Map();
-    for (const f of files) {
+    for (const f of entries) {
         const unit = unitIdOf(f.relativePath);
         const cur = byUnit.get(unit) ?? { count: 0, size: 0 };
         cur.count += 1;
-        cur.size += f.data.length;
+        cur.size += f.sizeBytes;
         byUnit.set(unit, cur);
     }
     return [...byUnit.entries()].map(([unit, agg]) => ({