dsh-config-manager 0.1.78 → 0.1.80

package/lib/adapters/skills.d.ts

@@ -1,8 +1,21 @@
 import { FileCollectionAdapter } from './file-collection.ts';
-import type { HostContext, SkillDefinitionView } from '../core/types.ts';
+import type { HostContext, ImportContext, PlanItem, SkillDefinitionView } from '../core/types.ts';
+import type { FilesSection } from '../schema/types.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
 /** 技能服务技能的虚拟路径（相对 baseDir）：`<name>/SKILL.md`。 */
 export declare function skillServiceRel(name: string): string;
+/**
+ * 该来源的技能能否进本分区备份（issue #102）。
+ *
+ * `bundled` = 插件包 / DSH 内置目录里随插件发行的技能（宿主的 `SkillSummaryView.source`）。
+ * 技能服务端口只暴露 **SKILL.md 文本**（`ctx.skills.get()` 返回 name/description/content），
+ * 技能的 `scripts/`、模板、资源文件一律拿不到 —— 备份出来必然是**残缺影子**；导入后它还会以
+ * 同名同 rank 落在 `$DSH_HOME/skills`，跟插件自己的版本争谁生效，且不随插件升级更新。
+ * 正确姿势是「装/升级对应的插件」，不是搬 SKILL.md。
+ *
+ * `source === undefined`（旧宿主不报来源）必须当**可迁移**：否则旧宿主上一个技能都备份不到。
+ */
+export declare function isMigratableSkillSource(source?: string): boolean;
 /**
  * 由技能定义重建 `SKILL.md` 文本。
  *
@@ -42,4 +55,15 @@ export declare class SkillsAdapter extends FileCollectionAdapter {
         sizeBytes: number;
         contentHash: string;
     }>;
+    /**
+     * 导入侧：备份里的 bundled 技能一律跳过（issue #102）。
+     *
+     * 旧备份（本修复之前导出的）会把插件内置技能写成残缺影子，导入后落在 `$DSH_HOME/skills`，
+     * 与插件自己的同名技能争生效顺序。这里在**计划阶段**就把它们降级成 Skip（不写盘、不进
+     * 冲突收集器），并给出可理解的说明；不是静默丢弃。
+     *
+     * 目标机技能清单只查一次（`ctx.target.skills.list()`）—— 逐文件调 `get()` 会是 O(n²)；
+     * 查不到（旧宿主 / 服务抛错）就**原样放行**，绝不因为判不出而少导入用户真正的技能。
+     */
+    analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]>;
 }

package/lib/adapters/skills.js

@@ -31,6 +31,20 @@ import { sectionMeta } from '../schema/section-registry.js';
 export function skillServiceRel(name) {
     return normalizePath(path.join(name, 'SKILL.md'));
 }
+/**
+ * 该来源的技能能否进本分区备份（issue #102）。
+ *
+ * `bundled` = 插件包 / DSH 内置目录里随插件发行的技能（宿主的 `SkillSummaryView.source`）。
+ * 技能服务端口只暴露 **SKILL.md 文本**（`ctx.skills.get()` 返回 name/description/content），
+ * 技能的 `scripts/`、模板、资源文件一律拿不到 —— 备份出来必然是**残缺影子**；导入后它还会以
+ * 同名同 rank 落在 `$DSH_HOME/skills`，跟插件自己的版本争谁生效，且不随插件升级更新。
+ * 正确姿势是「装/升级对应的插件」，不是搬 SKILL.md。
+ *
+ * `source === undefined`（旧宿主不报来源）必须当**可迁移**：否则旧宿主上一个技能都备份不到。
+ */
+export function isMigratableSkillSource(source) {
+    return source !== 'bundled';
+}
 /**
  * YAML 标量编码（issue #71 真机验收发现的缺陷修复）。
  *
@@ -184,6 +198,9 @@ export class SkillsAdapter extends FileCollectionAdapter {
             // 名字要能当路径用：DSH 的 SKILL_NAME 是 [a-z0-9-]，这里再做一道通用安全校验（拒 `..`/绝对路径）
             if (typeof summary.name !== 'string' || !isPathSafe(summary.name) || summary.name.includes('/'))
                 continue;
+            // issue #102：bundled 技能不进备份（残缺影子，见 isMigratableSkillSource）
+            if (!isMigratableSkillSource(summary.source))
+                continue;
             const rel = skillServiceRel(summary.name);
             if (onDisk.has(rel))
                 continue; // 文件系统优先
@@ -231,5 +248,48 @@ export class SkillsAdapter extends FileCollectionAdapter {
         }
         return { data, sizeBytes: data.byteLength, contentHash: sha256Hex(data) };
     }
+    /**
+     * 导入侧：备份里的 bundled 技能一律跳过（issue #102）。
+     *
+     * 旧备份（本修复之前导出的）会把插件内置技能写成残缺影子，导入后落在 `$DSH_HOME/skills`，
+     * 与插件自己的同名技能争生效顺序。这里在**计划阶段**就把它们降级成 Skip（不写盘、不进
+     * 冲突收集器），并给出可理解的说明；不是静默丢弃。
+     *
+     * 目标机技能清单只查一次（`ctx.target.skills.list()`）—— 逐文件调 `get()` 会是 O(n²)；
+     * 查不到（旧宿主 / 服务抛错）就**原样放行**，绝不因为判不出而少导入用户真正的技能。
+     */
+    async analyzeImport(data, ctx) {
+        const items = await super.analyzeImport(data, ctx);
+        if (ctx.target.skills === undefined)
+            return items;
+        let bundled;
+        try {
+            const summaries = await ctx.target.skills.list();
+            bundled = new Set(summaries.filter((s) => !isMigratableSkillSource(s.source)).map((s) => s.name));
+        }
+        catch (err) {
+            ctx.log.warn(`技能服务列举失败（无法识别 bundled 技能，按旧行为导入）: ${err instanceof Error ? err.message : String(err)}`);
+            return items;
+        }
+        if (bundled.size === 0)
+            return items;
+        return items.map((item) => {
+            if (item.kind === 'Error')
+                return item;
+            const ref = item.target?.ref;
+            if (ref === undefined)
+                return item;
+            const name = this.unitIdOf(ref);
+            if (!bundled.has(name))
+                return item;
+            return {
+                ...item,
+                kind: 'Skip',
+                severity: 'info',
+                target: undefined,
+                description: ctx.msg('adapter.skillBundledSkipped', { name }),
+            };
+        });
+    }
 }
 //# sourceMappingURL=skills.js.map

package/lib/adapters/ui.d.ts

@@ -5,7 +5,7 @@
  */
 import type { UiSection } from '../schema/types.ts';
 import type { MsgFunc } from '../core/messages.ts';
-import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, ExportUnit, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
 import { type NamespaceProvider } from './settings.ts';
 /** UI 类 namespace 前缀名单（设计 §4.1；随新插件扩展，只影响「某一 namespace 归哪一边」，不影响数据完整性） */
 export declare const KNOWN_UI_NAMESPACE_PREFIXES: readonly string[];
@@ -20,7 +20,11 @@ export declare class UiAdapter implements ConfigAdapter<UiSection> {
     readonly portability: import("../schema/section-registry.ts").SectionPortability;
     private readonly namespaces;
     constructor(namespaces?: string[] | NamespaceProvider);
-    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<UiSection>>;
+    export(ctx: HostContext, options: ExportOptions): Promise<ExportSection<UiSection>>;
+    /** 单元 id：`ui:<namespace>` */
+    private unitId;
+    /** 条目级单元清单（零 I/O）：一个 UI namespace = 一个单元 */
+    listUnits(section: ExportSection<UiSection>): ExportUnit[];
     analyzeImport(data: UiSection, ctx: ImportContext): Promise<PlanItem[]>;
     applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
     validate(data: UiSection, msg?: MsgFunc): Promise<ValidationResult>;

package/lib/adapters/ui.js

@@ -3,6 +3,7 @@ import { engineMsg } from './messages.js';
 import { collectNamespaceRecords, planNamespaceItems, applyNamespaceItem, resolveNamespaces } from './settings.js';
 import { sectionMeta } from '../schema/section-registry.js';
 import { validateJsonSection } from './json-section.js';
+import { pickRecord, recordUnits } from './units.js';
 /** UI 类 namespace 前缀名单（设计 §4.1；随新插件扩展，只影响「某一 namespace 归哪一边」，不影响数据完整性） */
 export const KNOWN_UI_NAMESPACE_PREFIXES = [
     'pet',
@@ -53,11 +54,13 @@ export class UiAdapter {
     constructor(namespaces = []) {
         this.namespaces = namespaces;
     }
-    async export(ctx, _options) {
+    async export(ctx, options) {
         const warnings = [];
         const all = await resolveNamespaces(this.namespaces, ctx);
         const uiNames = all.filter((n) => isUiNamespace(n));
-        const namespaces = await collectNamespaceRecords(ctx, uiNames, warnings);
+        const collected = await collectNamespaceRecords(ctx, uiNames, warnings);
+        // 条目级白名单：未勾选的 namespace 整条不带走；迁移说明（纯说明、不含值）与选择无关，始终保留
+        const namespaces = pickRecord(collected, options.includeItems?.[this.id], (ns) => this.unitId(ns));
         const notes = uiMigrationNotes(ctx.msg);
         return {
             sectionId: 'ui',
@@ -66,6 +69,14 @@ export class UiAdapter {
             warnings,
         };
     }
+    /** 单元 id：`ui:<namespace>` */
+    unitId(namespace) {
+        return this.id + ':' + namespace;
+    }
+    /** 条目级单元清单（零 I/O）：一个 UI namespace = 一个单元 */
+    listUnits(section) {
+        return recordUnits(this.id, section.data.namespaces ?? {});
+    }
     async analyzeImport(data, ctx) {
         return planNamespaceItems(data.namespaces, 'ui', ctx);
     }

package/lib/adapters/units.d.ts

@@ -40,3 +40,21 @@ export declare function unitsFromEntries(sectionId: string, entries: readonly {
     relativePath: string;
     sizeBytes: number;
 }[], unitIdOf: (rel: string) => string): ExportUnit[];
+/**
+ * JSON / 记录型分区的单元体积 = 该条目在包里的 UTF-8 字节数。
+ *
+ * 与文件类不同，这里不需要读盘：条目本身就是 export() 的产物，直接量它的序列化长度，
+ * 预览与导出因此天然同口径（同一个函数量同一个对象）。
+ */
+export declare function entryByteSize(value: unknown): number;
+/**
+ * 按单元白名单过滤条目（JSON / 记录型分区共用）。
+ *
+ * allow === undefined = 未指定 → 全量（旧调用方 / 旧备份零改动）；空数组 = 一条都不留。
+ * 与 unitAllowed 同一判据，只是作用在整批条目上。
+ */
+export declare function filterByUnits<T>(items: readonly T[], allow: readonly string[] | undefined, idOf: (item: T) => string): T[];
+/** 记录型分区的单元清单：一个顶层键 = 一个单元（零 I/O；体积 = 条目序列化长度）。 */
+export declare function recordUnits<V>(sectionId: string, record: Record<string, V>, detailOf?: (value: V, key: string) => string | undefined): ExportUnit[];
+/** 记录型分区的白名单过滤（键 → 单元 id 由 idOf 决定，与 recordUnits 同一规则）。 */
+export declare function pickRecord<V>(record: Record<string, V>, allow: readonly string[] | undefined, idOf: (key: string) => string): Record<string, V>;

package/lib/adapters/units.js

@@ -43,4 +43,43 @@ export function unitsFromEntries(sectionId, entries, unitIdOf) {
         sizeBytes: agg.size,
     }));
 }
+/**
+ * JSON / 记录型分区的单元体积 = 该条目在包里的 UTF-8 字节数。
+ *
+ * 与文件类不同，这里不需要读盘：条目本身就是 export() 的产物，直接量它的序列化长度，
+ * 预览与导出因此天然同口径（同一个函数量同一个对象）。
+ */
+export function entryByteSize(value) {
+    return new TextEncoder().encode(JSON.stringify(value) ?? '').byteLength;
+}
+/**
+ * 按单元白名单过滤条目（JSON / 记录型分区共用）。
+ *
+ * allow === undefined = 未指定 → 全量（旧调用方 / 旧备份零改动）；空数组 = 一条都不留。
+ * 与 unitAllowed 同一判据，只是作用在整批条目上。
+ */
+export function filterByUnits(items, allow, idOf) {
+    if (allow === undefined)
+        return [...items];
+    return items.filter((item) => allow.includes(idOf(item)));
+}
+/** 记录型分区的单元清单：一个顶层键 = 一个单元（零 I/O；体积 = 条目序列化长度）。 */
+export function recordUnits(sectionId, record, detailOf) {
+    return Object.entries(record).map(([key, value]) => {
+        const unit = { id: sectionId + ':' + key, label: key, sizeBytes: entryByteSize(value) };
+        const detail = detailOf?.(value, key);
+        if (detail !== undefined && detail !== '')
+            unit.detail = detail;
+        return unit;
+    });
+}
+/** 记录型分区的白名单过滤（键 → 单元 id 由 idOf 决定，与 recordUnits 同一规则）。 */
+export function pickRecord(record, allow, idOf) {
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (unitAllowed(allow, idOf(key)))
+            out[key] = value;
+    }
+    return out;
+}
 //# sourceMappingURL=units.js.map

package/lib/adapters/workspaces.js

@@ -94,7 +94,8 @@ export class WorkspacesAdapter {
     }
     /** 单元清单（零 I/O）：一条工作区记录 = 一个单元；标题缺失时退回 id。 */
     listUnits(section) {
-        return section.data.workspaces.map((rec) => ({
+        // workspaces 可能缺省（空分区 / 手写 section）：按空表处理，不抛错 —— 选择器对任何分区都会调 listUnits
+        return (section.data.workspaces ?? []).map((rec) => ({
             id: `workspace:${rec.id}`,
             label: rec.title !== undefined && rec.title !== '' ? rec.title : rec.id,
             detail: rec.path,