dsh-config-manager 0.1.63 → 0.1.65

package/lib/adapters/file-collection.js

@@ -6,6 +6,10 @@
  *
  * 文件内容以真实文件进入 ZIP（custom/skills/… 等前缀由 exporter 按 SECTION_FILE_PREFIXES 处理）。
  * 幂等：相对路径 + 内容 SHA-256 hash 比对（重复导入 → Skip）。
+ *
+ * 导出的**单分区字节闸门**（审计 core-flow F-12 / sync#F-12）：累计到 MAX_FILE_SECTION_BYTES 后，
+ * 放不下的单元**整块**剔除并写进告警（见 export()）。覆盖 skills / agentPresets / sessions；
+ * agentInstructions（单文件 AGENTS.md）与 self（白名单配置小文件）各自覆写 export，不在本闸门射程内。
  */
 import path from 'node:path';
 import { sha256Hex } from '../utils/hashing.js';
@@ -13,7 +17,40 @@ import { isReservedInternalRel, normalizePath } from '../utils/paths.js';
 import { msgOf, zhMsg } from '../core/messages.js';
 import { linkWarnings, listFilesDetailed } from './link-report.js';
 import { defaultUnitId, unitAllowed, unitsFromFiles } from './units.js';
+import { validateJsonSection } from './json-section.js';
+/**
+ * 文件类分区导出的**单分区累计字节闸门**：分区内文件内容合计放不下的单元整块剔除（见 export()）。
+ *
+ * 取值依据（不是随手拍的数）：
+ *  1) **对称性** —— 导入侧对上传的备份包有硬上限 256 MiB（MAX_UPLOAD_BYTES，src/index.ts 与
+ *     src/routes/kit.ts 的上传路径）；导出侧此前**没有任何体积约束**，于是会出现「导出成功、
+ *     传不回来」（审计 core-flow F-12 / sync#F-12）。取同一个 256 MiB 作**单分区**上限：
+ *     任何单个分区都落在导入侧上传路径能收的范围内。
+ *  2) **内存峰值** —— 导出时文件内容以完整 Uint8Array 驻留内存（ZIP 组装前全量在内存里），同步通道
+ *     还要再写一份。闸门把「单分区常驻」钳在 256 MiB 以内（峰值 ≈ 上限 + 正在读的那个单元），
+ *     不再是「会话附件多大就多吃多少」。
+ *  3) **与既有同类上限同量级** —— MAX_MARKET_ZIP_BYTES = 64 MiB、DEFAULT_MAX_JSON_BYTES = 64 MiB、
+ *     MAX_LOCAL_TARBALL_BYTES = 100 MiB、MAX_PATCH_FILE_BYTES = 2 MiB。文件类分区装的是**用户真实
+ *     文件**，所以取「导入侧能收」的 256 MiB，而不是为省内存随意调小（那会平白少带用户数据）。
+ *  4) **为什么按分区而不是按整包** —— 整包体积由用户勾选跨分区决定；闸门要能给出「哪些分区、哪些
+ *     单元没进去」的可执行信息，落在分区/单元层才可解释。
+ *
+ * 超限时**绝不静默**：被整块剔除的单元清单进 ExportSection.warnings（导出报告可见）。
+ */
+export const MAX_FILE_SECTION_BYTES = 256 * 1024 * 1024;
+/** 字节闸门告警里最多列出的单元数（其余折叠成 "(+ N)"，避免大分区把报告撑爆；与 link-report 同口径） */
+const MAX_UNITS_PER_GATE_WARNING = 5;
+/** 告警文案里的体积（人类可读；纯数值格式化，不含用户可见散文） */
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+}
 export class FileCollectionAdapter {
+    /** 文件集合：`relativePath` 是身份而非配置 → 永不被导入时的前缀映射改写（见 ConfigAdapter.fileCollection） */
+    fileCollection = true;
     /**
      * 最小可拆单元的 id（相对 baseDir 的路径）。
      *
@@ -31,6 +68,16 @@ export class FileCollectionAdapter {
         const prefix = this.baseDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
         return rel.replace(new RegExp('^' + prefix + '[\\\\/]'), '');
     }
+    /**
+     * 单分区累计字节上限（缺省 MAX_FILE_SECTION_BYTES = 256 MiB，见该常量注释）。
+     *
+     * 生产代码不覆写；留成受保护方法只为让测试能构造「超限」场景（真实阈值 256 MiB 无法在单测里
+     * 造出来而不吃掉 256 MiB 内存）。若要给用户配置入口，应走 ExportOptions（src/core/types.ts），
+     * 而不是在子类里飘一个隐式默认值。
+     */
+    sectionByteLimit() {
+        return MAX_FILE_SECTION_BYTES;
+    }
     /**
      * 条目级选择（Phase 1）：只导出白名单命中的单元。
      *
@@ -66,6 +113,12 @@ export class FileCollectionAdapter {
         if (restricted !== null)
             warnings.push(...restricted.warnings);
         const keep = restricted?.keep ?? null;
+        // ① 先按「单元」分组（零 I/O：只看路径）。单元的成员文件**不保证**在遍历结果里连续，
+        //    必须整组一起判定，否则同一单元会被拦腰劈开（半个技能目录 / 半个会话目录）。
+        //    `considered` 保序记录，收尾按它还原改造前的文件顺序（未触发闸门时逐项一致）。
+        const considered = [];
+        const unitOrder = [];
+        const unitEntries = new Map();
         for (const rel of rels) {
             const relPath = this.relPathOf(rel);
             const unitId = this.unitIdOf(relPath);
@@ -73,8 +126,59 @@ export class FileCollectionAdapter {
                 continue;
             if (!unitAllowed(allow, `${this.id}:${unitId}`))
                 continue;
-            const data = await ctx.fs.readFile(rel);
-            files.push({ relativePath: relPath, data, contentHash: sha256Hex(data) });
+            let members = unitEntries.get(unitId);
+            if (members === undefined) {
+                members = [];
+                unitEntries.set(unitId, members);
+                unitOrder.push(unitId);
+            }
+            members.push({ rel, relPath });
+            considered.push(rel);
+        }
+        // ② 逐单元读取 + 累计字节闸门（审计 core-flow F-12 / sync#F-12）。超出 sectionByteLimit() 的
+        //    单元**整块**不进备份（仓库语义：单元不可拆分 —— 宁可少带，不可半带）；一旦判定该单元放不下，
+        //    它的剩余文件不再读盘（省 I/O，也不为「统计精确」多吃内存）。放不下的单元跳过后**继续尝试
+        //    后面的单元**：一个巨型会话不该把它之后的所有内容一起带走（后面的小单元仍可能入选）。
+        const limit = this.sectionByteLimit();
+        let usedBytes = 0;
+        const droppedUnits = [];
+        const keptByRel = new Map();
+        for (const unitId of unitOrder) {
+            const room = limit - usedBytes;
+            const pending = [];
+            let unitBytes = 0;
+            for (const member of unitEntries.get(unitId) ?? []) {
+                const data = await ctx.fs.readFile(member.rel);
+                unitBytes += data.byteLength;
+                if (unitBytes > room)
+                    break;
+                pending.push({ rel: member.rel, file: { relativePath: member.relPath, data, contentHash: sha256Hex(data) } });
+            }
+            if (unitBytes > room) {
+                droppedUnits.push(unitId);
+                continue;
+            }
+            usedBytes += unitBytes;
+            for (const p of pending)
+                keptByRel.set(p.rel, p.file);
+        }
+        // ③ 按 ① 的顺序落盘（未触发闸门时与改造前的文件顺序逐项一致）
+        for (const rel of considered) {
+            const file = keptByRel.get(rel);
+            if (file !== undefined)
+                files.push(file);
+        }
+        // 绝不静默：被整块剔除的单元写进告警（导出报告可见），并给出上限与实际保留量
+        if (droppedUnits.length > 0) {
+            const shown = droppedUnits.slice(0, MAX_UNITS_PER_GATE_WARNING);
+            const rest = droppedUnits.length - shown.length;
+            warnings.push(msgOf(ctx)('adapter.fileSectionByteLimit', {
+                type: this.displayName,
+                limit: formatBytes(limit),
+                kept: formatBytes(usedBytes),
+                count: String(droppedUnits.length),
+                detail: (rest > 0 ? [...shown, `(+ ${rest})`] : shown).join(', '),
+            }));
         }
         if (rels.length === 0)
             warnings.push(msgOf(ctx)('adapter.dirEmpty', { type: this.displayName }));
@@ -152,25 +256,33 @@ export class FileCollectionAdapter {
         await ctx.target.fs.writeFile(path.join(this.baseDir, ref), file.data);
         return { ok: true };
     }
+    /**
+     * 结构校验（5 个文件类分区共用：skills / agentPresets / agentInstructions / sessions / self）。
+     *
+     * **整段样板都接入共享骨架 `validateJsonSection`** —— t7 接入 version 守卫与形状检查收尾，t11 接入
+     * object 守卫；dataVersion 由注册表按 `this.id` 派生，等价于此前的字面量 `!== 1`
+     * （SECTION_DATA_VERSION = 1）。本类里已无手写样板。
+     *
+     * object 守卫的**文案**为什么还要参数：文件类分区历史上用的是**专用消息键**
+     * `adapter.validate.fileSection`（'文件分区数据必须是对象'，不含 `{subject}` 占位符），与骨架缺省的
+     * `adapter.validate.object` + `{subject}` 是**键**级差异 —— 第 5 参 subject 补不了它。t11 给骨架加了
+     * 可选第 6 参 `objectMessageKey`，这里传专用键：5 个分区的用户可见报错文案与改造前**逐字相同**，
+     * 同时不放任何手写样板。等价由 src/adapters/file-collection.test.ts 与 outputs/t7-equiv/ 的差分脚本钉住。
+     */
     async validate(data, msg = zhMsg) {
-        const issues = [];
-        if (data === null || typeof data !== 'object') {
-            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.fileSection'), severity: 'error' }] };
-        }
-        if (data.version !== 1) {
-            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
-        }
-        if (!Array.isArray(data.files)) {
-            issues.push({ path: 'files', message: msg('adapter.validate.array', { subject: 'files' }), severity: 'error' });
-        }
-        else {
-            for (const f of data.files) {
-                if (f === null || typeof f !== 'object' || typeof f.relativePath !== 'string' || f.relativePath === '') {
-                    issues.push({ path: 'files[]', message: msg('adapter.validate.fileRelativePath'), severity: 'error' });
+        // 第 5 参 subject 传 this.id 即骨架缺省语义（专用键不含 {subject}，取值不影响输出）
+        return validateJsonSection(this.id, data, msg, (section, issues) => {
+            if (!Array.isArray(section.files)) {
+                issues.push({ path: 'files', message: msg('adapter.validate.array', { subject: 'files' }), severity: 'error' });
+            }
+            else {
+                for (const f of section.files) {
+                    if (f === null || typeof f !== 'object' || typeof f.relativePath !== 'string' || f.relativePath === '') {
+                        issues.push({ path: 'files[]', message: msg('adapter.validate.fileRelativePath'), severity: 'error' });
+                    }
                 }
             }
-        }
-        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+        }, this.id, 'adapter.validate.fileSection');
     }
 }
 //# sourceMappingURL=file-collection.js.map

package/lib/adapters/index.d.ts

@@ -55,3 +55,4 @@ export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from './plugin-file
 export { SessionsAdapter } from './sessions.ts';
 export { SelfAdapter, SELF_CONFIG_FILES } from './self.ts';
 export { FileCollectionAdapter } from './file-collection.ts';
+export { validateJsonSection, type SectionIssues } from './json-section.ts';

package/lib/adapters/index.js

@@ -52,4 +52,15 @@ export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from './plugin-file
 export { SessionsAdapter } from './sessions.js';
 export { SelfAdapter, SELF_CONFIG_FILES } from './self.js';
 export { FileCollectionAdapter } from './file-collection.js';
+/* JSON 分区共享校验骨架（本导出是其接入点）。收敛轨迹：
+ *  · t31 抽出骨架，settings / ui / providers / plugins / mcp / prompts / credentials /
+ *    pluginFiles 八个分区的样板并入；
+ *  · t7 接上 workspaces.ts 与 file-collection.ts 基类的 version 守卫 + 形状检查收尾；
+ *  · t11 给骨架加了可选第 6 参 `objectMessageKey`（object 错误的文案键，缺省
+ *    `adapter.validate.object`），file-collection 的 object 守卫也并入并沿用文件类分区原专用键
+ *    `adapter.validate.fileSection`，故 5 个文件类分区的用户可见报错文案逐字不变。
+ * 现状：**9 个分区全部走共享骨架**（settings / ui / providers / plugins / mcp / prompts /
+ * credentialsStatus / pluginFiles / workspaces），文件类基类（skills / agentPresets /
+ * agentInstructions / sessions / self）同样走它 —— src/adapters 下不再有任何手写 validate 样板。 */
+export { validateJsonSection } from './json-section.js';
 //# sourceMappingURL=index.js.map

package/lib/adapters/json-section.d.ts

@@ -0,0 +1,32 @@
+import type { SectionId } from '../schema/types.ts';
+import type { MsgFunc, zh } from '../core/messages.ts';
+import type { ValidationResult } from '../core/types.ts';
+/** 校验问题列表（各 adapter 的形状检查直接 push 到这里，与历史 `issues` 数组同一形状）。 */
+export type SectionIssues = ValidationResult['issues'];
+/**
+ * JSON 分区通用结构校验骨架。
+ *
+ * 执行顺序（与改造前逐字一致，保证行为等价）：
+ *  1. object 守卫：非对象 → **直接返回**单条 `objectMessageKey` 错误（缺省 `adapter.validate.object`；后续检查不再执行）；
+ *  2. version 守卫：`version !== sectionMeta(sectionId).dataVersion` → push 一条 `version` 错误，
+ *     **不提前返回**（继续做形状检查，与历史实现一致）；
+ *  3. `shape` 回调：分区特有的载荷形状检查（可选）。
+ *
+ * @param sectionId 分区 id —— 同时是 object 错误的默认 subject 与 dataVersion 的查表键
+ * @param data 反序列化后的分区载荷（来自不可信备份 → 必须按 unknown 处理）
+ * @param msg 文案翻译器（adapter 的 `validate(data, msg = zhMsg)` 原样传入）
+ * @param shape 分区特有的形状检查（在 version 守卫之后调用）
+ * @param subject object 错误里的显示名；缺省 = sectionId。历史上 credentials 用的是
+ *   `'credentials'`（而非分区 id `credentialsStatus`），此参数为保留该原文案而存在 ——
+ *   改文案属独立的行为变更，不在本任务射程内。
+ * @param objectMessageKey object 错误的**消息键**（t11 新增，可选）；缺省 `adapter.validate.object`
+ *   （`'{subject} 数据必须是对象'`）。为什么需要它：文件类分区历史上用的是专用键
+ *   `adapter.validate.fileSection`（`'文件分区数据必须是对象'`，**不含** `{subject}` 占位符），
+ *   那是**键**级差异 —— `subject` 参数补不了它（把 subject 拼成"文件分区"后中文模板仍多一个空格），
+ *   而硬换键会让 skills / agentPresets / agentInstructions / sessions / self 五个分区的用户可见
+ *   报错文案一起变。有了这个可选键，那处也能并入骨架而文案逐字不变。
+ *   键必须存在于 `src/core/messages.ts` 目录（`MsgFunc` 形参是 string，编译器只能校验到键名集合）。
+ */
+export declare function validateJsonSection<S extends {
+    version?: unknown;
+}>(sectionId: SectionId, data: unknown, msg: MsgFunc, shape?: (section: S, issues: SectionIssues) => void, subject?: string, objectMessageKey?: keyof typeof zh): ValidationResult;

package/lib/adapters/json-section.js

@@ -0,0 +1,61 @@
+/**
+ * JSON 分区 adapter 的共享骨架（t31，批次 4）。
+ *
+ * 为什么存在：改动前 9 个「有 JSON 载荷」的分区的 `validate()` 都以**同一段样板**开头 ——
+ * 先是 object 守卫，再是 `data.version !== 1` 守卫，最后才是各分区自己的载荷形状检查；
+ * 这段样板在每个文件里逐字抄了一遍（审计 sync#F-08 / infra#C1）。本模块把它收敛为一份，
+ * 并让「期望版本」直接取自注册表 `dataVersion`（不再各写 `!== 1` 字面量）。
+ *
+ * 与注册表的分工：结构校验的**描述符**（zipPath / 载荷形态 / dataVersion）在
+ * `src/schema/section-registry.ts`；本模块只提供「按该描述符执行校验」的通用算法，
+ * 各 adapter 仍负责自己特有的形状检查（用 `shape` 回调注入）。
+ *
+ * 分层：只 import schema 与 core 的类型 —— 不 import node 内置模块（client bundle 自包含铁律）。
+ */
+import { sectionMeta } from '../schema/section-registry.js';
+/**
+ * JSON 分区通用结构校验骨架。
+ *
+ * 执行顺序（与改造前逐字一致，保证行为等价）：
+ *  1. object 守卫：非对象 → **直接返回**单条 `objectMessageKey` 错误（缺省 `adapter.validate.object`；后续检查不再执行）；
+ *  2. version 守卫：`version !== sectionMeta(sectionId).dataVersion` → push 一条 `version` 错误，
+ *     **不提前返回**（继续做形状检查，与历史实现一致）；
+ *  3. `shape` 回调：分区特有的载荷形状检查（可选）。
+ *
+ * @param sectionId 分区 id —— 同时是 object 错误的默认 subject 与 dataVersion 的查表键
+ * @param data 反序列化后的分区载荷（来自不可信备份 → 必须按 unknown 处理）
+ * @param msg 文案翻译器（adapter 的 `validate(data, msg = zhMsg)` 原样传入）
+ * @param shape 分区特有的形状检查（在 version 守卫之后调用）
+ * @param subject object 错误里的显示名；缺省 = sectionId。历史上 credentials 用的是
+ *   `'credentials'`（而非分区 id `credentialsStatus`），此参数为保留该原文案而存在 ——
+ *   改文案属独立的行为变更，不在本任务射程内。
+ * @param objectMessageKey object 错误的**消息键**（t11 新增，可选）；缺省 `adapter.validate.object`
+ *   （`'{subject} 数据必须是对象'`）。为什么需要它：文件类分区历史上用的是专用键
+ *   `adapter.validate.fileSection`（`'文件分区数据必须是对象'`，**不含** `{subject}` 占位符），
+ *   那是**键**级差异 —— `subject` 参数补不了它（把 subject 拼成"文件分区"后中文模板仍多一个空格），
+ *   而硬换键会让 skills / agentPresets / agentInstructions / sessions / self 五个分区的用户可见
+ *   报错文案一起变。有了这个可选键，那处也能并入骨架而文案逐字不变。
+ *   键必须存在于 `src/core/messages.ts` 目录（`MsgFunc` 形参是 string，编译器只能校验到键名集合）。
+ */
+export function validateJsonSection(sectionId, data, msg, shape, subject = sectionId, objectMessageKey = 'adapter.validate.object') {
+    if (data === null || typeof data !== 'object') {
+        return {
+            valid: false,
+            issues: [{ path: '$', message: msg(objectMessageKey, { subject }), severity: 'error' }],
+        };
+    }
+    const section = data;
+    const issues = [];
+    const expectedVersion = sectionMeta(sectionId).dataVersion;
+    if (section.version !== expectedVersion) {
+        issues.push({
+            path: 'version',
+            message: msg('adapter.validate.version', { value: String(section.version) }),
+            severity: 'error',
+        });
+    }
+    if (shape !== undefined)
+        shape(section, issues);
+    return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+}
+//# sourceMappingURL=json-section.js.map

package/lib/adapters/mcp.d.ts

@@ -18,9 +18,9 @@ export declare function extractMcpServers(lines: {
 export declare function buildMcpPatchLine(lineId: string, server: McpServerEntry): Record<string, unknown>;
 export declare class McpAdapter implements ConfigAdapter<McpExportSection> {
     readonly id: 'mcp';
-    readonly displayName = "MCP Servers";
-    readonly defaultIncluded = true;
-    readonly portability: 'platformSpecific';
+    readonly displayName: string;
+    readonly defaultIncluded: boolean;
+    readonly portability: import("../schema/section-registry.ts").SectionPortability;
     export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<McpExportSection>>;
     analyzeImport(data: McpExportSection, ctx: ImportContext): Promise<PlanItem[]>;
     applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;

package/lib/adapters/mcp.js

@@ -8,6 +8,8 @@
  */
 import { isDeepStrictEqual } from 'node:util';
 import { msgOf, zhMsg } from '../core/messages.js';
+import { sectionMeta } from '../schema/section-registry.js';
+import { validateJsonSection } from './json-section.js';
 import { USER_PATCH_FILE } from './plugins.js';
 /** 从 patch 行数组中提取 MCP server 条目（以 config.serverName 存在为判定） */
 export function extractMcpServers(lines) {
@@ -77,9 +79,10 @@ function newLineId(serverName) {
 }
 export class McpAdapter {
     id = 'mcp';
-    displayName = 'MCP Servers';
-    defaultIncluded = true;
-    portability = 'platformSpecific';
+    // 元数据唯一来源 = 注册表（t31）：不再与 ui/export-flow.ts 的导出目录各写一份
+    displayName = sectionMeta('mcp').displayName;
+    defaultIncluded = sectionMeta('mcp').defaultIncluded;
+    portability = sectionMeta('mcp').portability;
     async export(ctx, _options) {
         const warnings = [];
         let lines = [];
@@ -155,24 +158,18 @@ export class McpAdapter {
         return { ok: true, needsRestart: true, message: msg('adapter.mcpWritten', { serverName }) };
     }
     async validate(data, msg = zhMsg) {
-        const issues = [];
-        if (data === null || typeof data !== 'object') {
-            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.object', { subject: 'mcp' }), severity: 'error' }] };
-        }
-        if (data.version !== 1) {
-            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
-        }
-        if (!Array.isArray(data.servers)) {
-            issues.push({ path: 'servers', message: msg('adapter.validate.array', { subject: 'servers' }), severity: 'error' });
-        }
-        else {
-            for (const s of data.servers) {
-                if (s === null || typeof s !== 'object' || typeof s.serverName !== 'string' || s.serverName === '') {
-                    issues.push({ path: 'servers[]', message: msg('adapter.validate.serverName'), severity: 'error' });
+        return validateJsonSection('mcp', data, msg, (section, issues) => {
+            if (!Array.isArray(section.servers)) {
+                issues.push({ path: 'servers', message: msg('adapter.validate.array', { subject: 'servers' }), severity: 'error' });
+            }
+            else {
+                for (const s of section.servers) {
+                    if (s === null || typeof s !== 'object' || typeof s.serverName !== 'string' || s.serverName === '') {
+                        issues.push({ path: 'servers[]', message: msg('adapter.validate.serverName'), severity: 'error' });
+                    }
                 }
             }
-        }
-        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+        });
     }
 }
 //# sourceMappingURL=mcp.js.map

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

@@ -4,9 +4,9 @@ import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, ExportUn
 export declare const DEFAULT_PLUGIN_FILE_WHITELIST: readonly string[];
 export declare class PluginFilesAdapter implements ConfigAdapter<FilesSection> {
     readonly id: 'pluginFiles';
-    readonly displayName = "Plugin Files";
-    readonly defaultIncluded = false;
-    readonly portability: 'deviceSpecific';
+    readonly displayName: string;
+    readonly defaultIncluded: boolean;
+    readonly portability: import("../schema/section-registry.ts").SectionPortability;
     private readonly whitelist;
     /** 约定配置目录（相对 ~/.dsh 根，如 'plugin-config'）；递归收集其下所有文件。undefined = 不收集。 */
     private readonly collectDir?;

package/lib/adapters/plugin-files.js

@@ -11,12 +11,15 @@ import { msgOf, zhMsg } from '../core/messages.js';
 import { linkWarnings, listFilesDetailed } from './link-report.js';
 import { isPathSafe, isReservedInternalRel } from '../utils/paths.js';
 import { unitAllowed, unitsFromFiles } from './units.js';
+import { sectionMeta } from '../schema/section-registry.js';
+import { validateJsonSection } from './json-section.js';
 export const DEFAULT_PLUGIN_FILE_WHITELIST = ['dsh-ssh.json', 'pet.json'];
 export class PluginFilesAdapter {
     id = 'pluginFiles';
-    displayName = 'Plugin Files';
-    defaultIncluded = false;
-    portability = 'deviceSpecific';
+    // 元数据唯一来源 = 注册表（t31）：不再与 ui/export-flow.ts 的导出目录各写一份
+    displayName = sectionMeta('pluginFiles').displayName;
+    defaultIncluded = sectionMeta('pluginFiles').defaultIncluded;
+    portability = sectionMeta('pluginFiles').portability;
     whitelist;
     /** 约定配置目录（相对 ~/.dsh 根，如 'plugin-config'）；递归收集其下所有文件。undefined = 不收集。 */
     collectDir;
@@ -138,17 +141,11 @@ export class PluginFilesAdapter {
         return { ok: true };
     }
     async validate(data, msg = zhMsg) {
-        const issues = [];
-        if (data === null || typeof data !== 'object') {
-            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.object', { subject: 'pluginFiles' }), severity: 'error' }] };
-        }
-        if (data.version !== 1) {
-            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
-        }
-        if (!Array.isArray(data.files)) {
-            issues.push({ path: 'files', message: msg('adapter.validate.array', { subject: 'files' }), severity: 'error' });
-        }
-        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+        return validateJsonSection('pluginFiles', data, msg, (section, issues) => {
+            if (!Array.isArray(section.files)) {
+                issues.push({ path: 'files', message: msg('adapter.validate.array', { subject: 'files' }), severity: 'error' });
+            }
+        });
     }
 }
 //# sourceMappingURL=plugin-files.js.map

package/lib/adapters/plugins.d.ts

@@ -20,9 +20,9 @@ export declare const PNPM_WORKSPACE_REL: (profile: string | undefined) => string
 export declare const MAX_PATCH_FILE_BYTES: number;
 export declare class PluginsAdapter implements ConfigAdapter<PluginsSection> {
     readonly id: 'plugins';
-    readonly displayName = "Plugins";
-    readonly defaultIncluded = true;
-    readonly portability: 'portable';
+    readonly displayName: string;
+    readonly defaultIncluded: boolean;
+    readonly portability: import("../schema/section-registry.ts").SectionPortability;
     /** 插件自身包名：导出 plugins 分区时不列自己（避免备份里出现「当前正在生成备份的插件」的自引用条目） */
     private readonly selfName;
     /** T1：本地源（link:/file:）插件打包钩子；未注入 = 不打包（保持改造前行为） */

package/lib/adapters/plugins.js

@@ -13,11 +13,13 @@
 import { isDeepStrictEqual } from 'node:util';
 import { sha256Hex } from '../utils/hashing.js';
 import { installSpecFor, resolveProfileNameFromArgv } from '../core/plugin-cli.js';
-import { isLocalPluginSpec, isPackedLocalSpec, LOCAL_PLUGIN_DIR } from '../core/local-plugin-pack.js';
+import { LOCAL_PLUGIN_DIR } from '../core/local-plugin-pack.js';
 import { msgOf, zhMsg } from '../core/messages.js';
 import { isPathSafe, normalizePath } from '../utils/paths.js';
 import { PLUGIN_PATCH_REF_PREFIX } from '../core/backup.js';
 import { parsePnpmPatchedDependencies, sanitizePnpmWorkspacePatches } from './pnpm-workspace.js';
+import { sectionMeta } from '../schema/section-registry.js';
+import { validateJsonSection } from './json-section.js';
 export const USER_PATCH_FILE = 'cordis.patch.yml';
 /** tarball 字节 → base64（零依赖，避免 Buffer 在浏览器侧类型问题） */
 function bytesToBase64(data) {
@@ -108,9 +110,10 @@ function entriesOfRaw(raw) {
 }
 export class PluginsAdapter {
     id = 'plugins';
-    displayName = 'Plugins';
-    defaultIncluded = true;
-    portability = 'portable';
+    // 元数据唯一来源 = 注册表（t31）：不再与 ui/export-flow.ts 的导出目录各写一份
+    displayName = sectionMeta('plugins').displayName;
+    defaultIncluded = sectionMeta('plugins').defaultIncluded;
+    portability = sectionMeta('plugins').portability;
     /** 插件自身包名：导出 plugins 分区时不列自己（避免备份里出现「当前正在生成备份的插件」的自引用条目） */
     selfName;
     /** T1：本地源（link:/file:）插件打包钩子；未注入 = 不打包（保持改造前行为） */
@@ -629,47 +632,41 @@ export class PluginsAdapter {
         return { ok: true, needsRestart: true, message: msg('adapter.patchWritten', { ref }) };
     }
     async validate(data, msg = zhMsg) {
-        const issues = [];
-        if (data === null || typeof data !== 'object') {
-            return { valid: false, issues: [{ path: '$', message: msg('adapter.validate.object', { subject: 'plugins' }), severity: 'error' }] };
-        }
-        if (data.version !== 1) {
-            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
-        }
-        if (!Array.isArray(data.plugins)) {
-            issues.push({ path: 'plugins', message: msg('adapter.validate.array', { subject: 'plugins' }), severity: 'error' });
-        }
-        if (data.patch !== undefined && !Array.isArray(data.patch)) {
-            issues.push({ path: 'patch', message: msg('adapter.validate.array', { subject: 'patch' }), severity: 'error' });
-        }
-        if (data.pnpmWorkspace !== undefined && data.pnpmWorkspace !== null && typeof data.pnpmWorkspace !== 'string') {
-            issues.push({ path: 'pnpmWorkspace', message: msg('adapter.validate.string', { subject: 'pnpmWorkspace' }), severity: 'error' });
-        }
-        // T1：本地插件 tarball 载荷（缺省合法；存在时逐条校验形状与路径安全）
-        if (data.localTarballs !== undefined) {
-            if (!Array.isArray(data.localTarballs)) {
-                issues.push({ path: 'localTarballs', message: msg('adapter.validate.array', { subject: 'localTarballs' }), severity: 'error' });
+        return validateJsonSection('plugins', data, msg, (section, issues) => {
+            if (!Array.isArray(section.plugins)) {
+                issues.push({ path: 'plugins', message: msg('adapter.validate.array', { subject: 'plugins' }), severity: 'error' });
             }
-            else {
-                data.localTarballs.forEach((t, i) => {
-                    if (t === null || typeof t !== 'object') {
-                        issues.push({ path: `localTarballs[${i}]`, message: msg('adapter.validate.object', { subject: 'localTarballs[]' }), severity: 'error' });
-                        return;
-                    }
-                    for (const field of ['packageName', 'version', 'relativePath', 'base64']) {
-                        if (typeof t[field] !== 'string' || t[field] === '') {
-                            issues.push({ path: `localTarballs[${i}].${field}`, message: msg('adapter.validate.string', { subject: field }), severity: 'error' });
+            if (section.patch !== undefined && !Array.isArray(section.patch)) {
+                issues.push({ path: 'patch', message: msg('adapter.validate.array', { subject: 'patch' }), severity: 'error' });
+            }
+            if (section.pnpmWorkspace !== undefined && section.pnpmWorkspace !== null && typeof section.pnpmWorkspace !== 'string') {
+                issues.push({ path: 'pnpmWorkspace', message: msg('adapter.validate.string', { subject: 'pnpmWorkspace' }), severity: 'error' });
+            }
+            // T1：本地插件 tarball 载荷（缺省合法；存在时逐条校验形状与路径安全）
+            if (section.localTarballs !== undefined) {
+                if (!Array.isArray(section.localTarballs)) {
+                    issues.push({ path: 'localTarballs', message: msg('adapter.validate.array', { subject: 'localTarballs' }), severity: 'error' });
+                }
+                else {
+                    section.localTarballs.forEach((t, i) => {
+                        if (t === null || typeof t !== 'object') {
+                            issues.push({ path: `localTarballs[${i}]`, message: msg('adapter.validate.object', { subject: 'localTarballs[]' }), severity: 'error' });
+                            return;
                         }
-                    }
-                    // 相对路径必须落在 LOCAL_PLUGIN_DIR 之下且不含穿越段（防写 homeDir 外）
-                    const rel = typeof t.relativePath === 'string' ? t.relativePath.replace(/\\/g, '/') : '';
-                    if (rel !== '' && (!rel.startsWith(`${LOCAL_PLUGIN_DIR}/`) || rel.includes('..'))) {
-                        issues.push({ path: `localTarballs[${i}].relativePath`, message: msg('adapter.validate.localTarballPath', { path: rel }), severity: 'error' });
-                    }
-                });
+                        for (const field of ['packageName', 'version', 'relativePath', 'base64']) {
+                            if (typeof t[field] !== 'string' || t[field] === '') {
+                                issues.push({ path: `localTarballs[${i}].${field}`, message: msg('adapter.validate.string', { subject: field }), severity: 'error' });
+                            }
+                        }
+                        // 相对路径必须落在 LOCAL_PLUGIN_DIR 之下且不含穿越段（防写 homeDir 外）
+                        const rel = typeof t.relativePath === 'string' ? t.relativePath.replace(/\\/g, '/') : '';
+                        if (rel !== '' && (!rel.startsWith(`${LOCAL_PLUGIN_DIR}/`) || rel.includes('..'))) {
+                            issues.push({ path: `localTarballs[${i}].relativePath`, message: msg('adapter.validate.localTarballPath', { path: rel }), severity: 'error' });
+                        }
+                    });
+                }
             }
-        }
-        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+        });
     }
 }
 //# sourceMappingURL=plugins.js.map

package/lib/adapters/prompts.d.ts

@@ -20,9 +20,9 @@ export declare function mergePromptIntoLine(raw: unknown, prompt: PromptExportEn
 export declare function buildPromptLine(lineId: string, prompt: PromptExportEntry): Record<string, unknown>;
 export declare class PromptsAdapter implements ConfigAdapter<PromptsExportSection> {
     readonly id: 'prompts';
-    readonly displayName = "Prompts";
-    readonly defaultIncluded = true;
-    readonly portability: 'portable';
+    readonly displayName: string;
+    readonly defaultIncluded: boolean;
+    readonly portability: import("../schema/section-registry.ts").SectionPortability;
     export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<PromptsExportSection>>;
     analyzeImport(data: PromptsExportSection, ctx: ImportContext): Promise<PlanItem[]>;
     applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;