dsh-config-manager 0.1.0

package/lib/adapters/credentials.js

@@ -0,0 +1,121 @@
+import { resolveNamespaces } from "./settings.js";
+/** 缺省 ref 收集：遍历 settings namespace，收集 llm apiKeyEnv / providers[].apiKeyEnv，
+ * 以及 secrets 标记中「引用类字段」（apiKeyEnv/tokenEnv…）的字段值。
+ * 注意 secrets[].path[0] 是 settings 文档内的字段路径（如 ['apiKey']），本身不是凭据 ref（设计 §4.2），
+ * 只有指向 env 名的引用字段才值得收集。 */
+export function defaultCredentialRefs(namespaces) {
+    return async (ctx) => {
+        const refs = new Set();
+        for (const ns of await resolveNamespaces(namespaces, ctx)) {
+            try {
+                const info = await ctx.settings.describe(ns, { redactSecrets: true });
+                const value = (info.value ?? {});
+                // 引用类字段名（值 = env/凭据引用名，非秘密本身）
+                const REFERENCE_REF_FIELDS = new Set([
+                    'apikeyenv', 'api_key_env', 'apikeyname', 'tokenenv', 'accesstokenenv',
+                    'refreshtokenenv', 'clientsecretenv', 'passwordenv',
+                ]);
+                for (const s of info.secrets) {
+                    const first = s.path?.[0];
+                    if (typeof first !== 'string' || first === '')
+                        continue;
+                    const norm = first.toLowerCase().replace(/[^a-z0-9]/g, '');
+                    if (!REFERENCE_REF_FIELDS.has(norm))
+                        continue;
+                    const val = value[first];
+                    if (typeof val === 'string' && val !== '')
+                        refs.add(val);
+                }
+                if (typeof value['apiKeyEnv'] === 'string' && value['apiKeyEnv'] !== '')
+                    refs.add(value['apiKeyEnv']);
+                const providers = value['providers'];
+                if (providers !== null && typeof providers === 'object') {
+                    for (const pv of Object.values(providers)) {
+                        if (pv !== null && typeof pv === 'object' && typeof pv.apiKeyEnv === 'string' && pv.apiKeyEnv !== '') {
+                            refs.add(pv.apiKeyEnv);
+                        }
+                    }
+                }
+            }
+            catch {
+                // namespace 不存在则跳过
+            }
+        }
+        return [...refs];
+    };
+}
+export class CredentialsAdapter {
+    id = 'credentialsStatus';
+    displayName = 'Credentials';
+    defaultIncluded = true;
+    portability = 'deviceSpecific';
+    refs;
+    constructor(options = {}) {
+        this.refs = options.refs ?? defaultCredentialRefs(options.namespaces ?? []);
+    }
+    async export(ctx, _options) {
+        const credentials = [];
+        const warnings = [];
+        for (const ref of await this.refs(ctx)) {
+            try {
+                const status = await ctx.credentials.describe(ref);
+                credentials.push({
+                    ref,
+                    required: true,
+                    configured: status.configured,
+                    source: status.source ?? 'file',
+                    hasValue: false, // 值未导出（安全不变量）
+                });
+            }
+            catch (err) {
+                warnings.push(`凭据 ${ref} 状态读取失败: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return {
+            sectionId: 'credentialsStatus',
+            data: { version: 1, credentials },
+            counts: { credentials: credentials.length },
+            warnings,
+        };
+    }
+    async analyzeImport(_data, _ctx) {
+        // MissingSecret 计划项由引擎在 createImportPlan 兜底生成（analyzer.ensureMissingSecrets），
+        // 依据 = 本分区里 configured=true 的凭据 → 用户补录清单。这里保持零写入纯计算。
+        return [];
+    }
+    async applyItem(item, ctx) {
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: '缺少 target.ref' };
+        const value = ctx.secretInputs[ref] ?? ctx.decryptedCredentials?.get(ref);
+        if (value === undefined || value === '')
+            return { ok: false, message: '凭据值未提供（需补录）' };
+        await ctx.target.credentials.set(ref, value);
+        return { ok: true };
+    }
+    async validate(data) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: 'credentials 数据必须是对象', severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+        }
+        if (!Array.isArray(data.credentials)) {
+            issues.push({ path: 'credentials', message: 'credentials 必须是数组', severity: 'error' });
+        }
+        else {
+            for (const c of data.credentials) {
+                if (c === null || typeof c !== 'object' || typeof c.ref !== 'string' || c.ref === '') {
+                    issues.push({ path: 'credentials[]', message: '凭据记录必须含非空 ref', severity: 'error' });
+                }
+                if (c.hasValue === true) {
+                    // 安全不变量：普通导出恒不携带值；若备份声称有值，视为结构异常
+                    issues.push({ path: `credentials.${c.ref}.hasValue`, message: '值未导出，hasValue 必须为 false', severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=credentials.js.map

package/lib/adapters/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/adapters/credentials.ts"],"names":[],"mappings":"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"}

package/lib/adapters/file-collection.d.ts

@@ -0,0 +1,14 @@
+import type { FilesSection, SectionId } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, Portability, ValidationResult } from '../core/types.ts';
+export declare abstract class FileCollectionAdapter implements ConfigAdapter<FilesSection> {
+    abstract readonly id: SectionId;
+    abstract readonly displayName: string;
+    abstract readonly defaultIncluded: boolean;
+    abstract readonly portability: Portability;
+    /** 相对 homeDir 的基准目录（与 core/backup.ts FILE_BASES 一致） */
+    abstract readonly baseDir: string;
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<FilesSection>>;
+    analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: FilesSection): Promise<ValidationResult>;
+}

package/lib/adapters/file-collection.js

@@ -0,0 +1,102 @@
+/**
+ * 文件类分区共享 adapter 基类（skills / agentPresets / sessions 复用）。
+ * 基准目录与 core/backup.ts 的 FILE_BASES 保持一致（skills→'skills'、agentPresets→'.agent-presets'、sessions→'sessions'），
+ * 保证引擎通用快照/回滚（resolveFileTarget）与 applyItem 的写入路径完全一致。
+ *
+ * 文件内容以真实文件进入 ZIP（custom/skills/… 等前缀由 exporter 按 SECTION_FILE_PREFIXES 处理）。
+ * 幂等：相对路径 + 内容 SHA-256 hash 比对（重复导入 → Skip）。
+ */
+import path from 'node:path';
+import { sha256Hex } from "../utils/hashing.js";
+export class FileCollectionAdapter {
+    async export(ctx, _options) {
+        const files = [];
+        const warnings = [];
+        let rels = [];
+        try {
+            rels = await ctx.fs.listRecursive(this.baseDir);
+        }
+        catch {
+            // 目录不存在视为空
+        }
+        for (const rel of rels) {
+            const data = await ctx.fs.readFile(rel);
+            const relPath = this.baseDir === '' ? rel : rel.replace(new RegExp(`^${escapeRegExp(this.baseDir)}[\\/]`), '');
+            files.push({ relativePath: relPath, data, contentHash: sha256Hex(data) });
+        }
+        if (rels.length === 0)
+            warnings.push(`${this.displayName} 目录为空或不存在`);
+        return {
+            sectionId: this.id,
+            data: { version: 1, files },
+            counts: { files: files.length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const items = [];
+        for (const file of data.files) {
+            const id = `${this.id}:${file.relativePath}`;
+            let current = null;
+            try {
+                current = await ctx.target.fs.readFile(path.join(this.baseDir, file.relativePath));
+            }
+            catch {
+                current = null;
+            }
+            if (current === null) {
+                items.push({
+                    id, kind: 'Create', adapter: this.id,
+                    description: `创建${this.displayName}文件 ${file.relativePath}`, severity: 'info',
+                    target: { adapter: this.id, ref: file.relativePath },
+                });
+            }
+            else if (sha256Hex(current) === file.contentHash) {
+                items.push({ id, kind: 'Skip', adapter: this.id, description: `文件 ${file.relativePath} 已一致`, severity: 'info' });
+            }
+            else {
+                items.push({
+                    id, kind: 'Conflict', adapter: this.id,
+                    description: `文件 ${file.relativePath} 内容不同`, severity: 'warning',
+                    target: { adapter: this.id, ref: file.relativePath },
+                });
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: '缺少 target.ref' };
+        const data = ctx.sections.get(this.id);
+        const file = data?.files.find((f) => f.relativePath === ref);
+        if (!file)
+            return { ok: false, message: `导入数据缺少文件 ${ref}` };
+        await ctx.target.fs.writeFile(path.join(this.baseDir, ref), file.data);
+        return { ok: true };
+    }
+    async validate(data) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: '文件分区数据必须是对象', severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+        }
+        if (!Array.isArray(data.files)) {
+            issues.push({ path: 'files', message: '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: '文件记录必须含非空 relativePath', severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=file-collection.js.map

package/lib/adapters/file-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-collection.js","sourceRoot":"","sources":["../../src/adapters/file-collection.ts"],"names":[],"mappings":"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"}

package/lib/adapters/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 适配器 registry（设计 §12.1 / §3.3）：
+ * 组装全部 ConfigAdapter（导出顺序参考 APPLY_ORDER：settings → ui → providers → prompts
+ * → skills → agentPresets → workspaces → pluginFiles → mcp → plugins → credentialsStatus）。
+ *
+ * 明确不实现的 adapter（研究报告 §2.2 确认 DSH 无对应概念）：keybindings / workflows / commands / rules ——
+ * manifest 中不出现这些 section，产品 UI 说明「DSH 当前无此配置」。
+ */
+import type { ConfigAdapter } from '../core/types.ts';
+import { type NamespaceProvider } from './settings.ts';
+import { type CredentialRefsProvider } from './credentials.ts';
+export interface AdapterRegistryOptions {
+    /** settings namespace 清单（宿主从 settings.yaml 顶层 key 解析注入；缺省 [] → settings/ui/credentials 为空） */
+    namespaces?: string[] | NamespaceProvider;
+    /** 凭据 ref 收集器（缺省从 settings secrets 标记 + llm apiKeyEnv 推断） */
+    credentialsRefs?: CredentialRefsProvider;
+    /** pluginFiles 白名单（相对 ~/.dsh 根；缺省 dsh-ssh.json + pet.json） */
+    pluginFiles?: string[];
+    /** 是否包含 sessions 分区（默认关，研究报告 §4.9） */
+    includeSessions?: boolean;
+}
+/** 组装默认 adapter 列表（pluginFiles/sessions 恒挂载但 defaultIncluded=false，用户勾选才导出） */
+export declare function createAdapters(options?: AdapterRegistryOptions): ConfigAdapter[];
+export type { NamespaceProvider } from './settings.ts';
+export type { CredentialRefsProvider } from './credentials.ts';
+export { SettingsAdapter } from './settings.ts';
+export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, UI_MIGRATION_NOTES } from './ui.ts';
+export { ProvidersAdapter, DEFAULT_PROVIDER_NAMESPACES, type ProviderExportEntry, type ProviderExportSection } from './providers.ts';
+export { PluginsAdapter, USER_PATCH_FILE } from './plugins.ts';
+export { McpAdapter, extractMcpServers, buildMcpPatchLine, type McpExportEntry, type McpExportSection } from './mcp.ts';
+export { PromptsAdapter, extractPrompts, mergePromptIntoLine, buildPromptLine, type PromptExportEntry, type PromptsExportSection } from './prompts.ts';
+export { SkillsAdapter } from './skills.ts';
+export { AgentPresetsAdapter } from './agent-presets.ts';
+export { WorkspacesAdapter } from './workspaces.ts';
+export { CredentialsAdapter, defaultCredentialRefs } from './credentials.ts';
+export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from './plugin-files.ts';
+export { SessionsAdapter } from './sessions.ts';
+export { FileCollectionAdapter } from './file-collection.ts';

package/lib/adapters/index.js

@@ -0,0 +1,46 @@
+import { SettingsAdapter } from "./settings.js";
+import { UiAdapter } from "./ui.js";
+import { ProvidersAdapter } from "./providers.js";
+import { PluginsAdapter } from "./plugins.js";
+import { McpAdapter } from "./mcp.js";
+import { PromptsAdapter } from "./prompts.js";
+import { SkillsAdapter } from "./skills.js";
+import { AgentPresetsAdapter } from "./agent-presets.js";
+import { WorkspacesAdapter } from "./workspaces.js";
+import { CredentialsAdapter } from "./credentials.js";
+import { PluginFilesAdapter } from "./plugin-files.js";
+import { SessionsAdapter } from "./sessions.js";
+/** 组装默认 adapter 列表（pluginFiles/sessions 恒挂载但 defaultIncluded=false，用户勾选才导出） */
+export function createAdapters(options = {}) {
+    const namespaces = options.namespaces ?? [];
+    const adapters = [
+        new SettingsAdapter(namespaces),
+        new UiAdapter(namespaces),
+        new ProvidersAdapter(),
+        new PluginsAdapter(),
+        new McpAdapter(),
+        new PromptsAdapter(),
+        new SkillsAdapter(),
+        new AgentPresetsAdapter(),
+        new WorkspacesAdapter(),
+        new CredentialsAdapter({ namespaces, refs: options.credentialsRefs }),
+        new PluginFilesAdapter(options.pluginFiles),
+    ];
+    if (options.includeSessions)
+        adapters.push(new SessionsAdapter());
+    return adapters;
+}
+export { SettingsAdapter } from "./settings.js";
+export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, UI_MIGRATION_NOTES } from "./ui.js";
+export { ProvidersAdapter, DEFAULT_PROVIDER_NAMESPACES } from "./providers.js";
+export { PluginsAdapter, USER_PATCH_FILE } from "./plugins.js";
+export { McpAdapter, extractMcpServers, buildMcpPatchLine } from "./mcp.js";
+export { PromptsAdapter, extractPrompts, mergePromptIntoLine, buildPromptLine } from "./prompts.js";
+export { SkillsAdapter } from "./skills.js";
+export { AgentPresetsAdapter } from "./agent-presets.js";
+export { WorkspacesAdapter } from "./workspaces.js";
+export { CredentialsAdapter, defaultCredentialRefs } from "./credentials.js";
+export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from "./plugin-files.js";
+export { SessionsAdapter } from "./sessions.js";
+export { FileCollectionAdapter } from "./file-collection.js";
+//# sourceMappingURL=index.js.map

package/lib/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,eAAe,EAA0B,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAA+B,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAahD,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,UAAkC,EAAE;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAoB;QAChC,IAAI,eAAe,CAAC,UAAU,CAAC;QAC/B,IAAI,SAAS,CAAC,UAAU,CAAC;QACzB,IAAI,gBAAgB,EAAE;QACtB,IAAI,cAAc,EAAE;QACpB,IAAI,UAAU,EAAE;QAChB,IAAI,cAAc,EAAE;QACpB,IAAI,aAAa,EAAE;QACnB,IAAI,mBAAmB,EAAE;QACzB,IAAI,iBAAiB,EAAE;QACvB,IAAI,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QACrE,IAAI,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC;KAC5C,CAAC;IACF,IAAI,OAAO,CAAC,eAAe;QAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAKD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAwD,MAAM,gBAAgB,CAAC;AACrI,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAA8C,MAAM,UAAU,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAqD,MAAM,cAAc,CAAC;AACvJ,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/adapters/mcp.d.ts

@@ -0,0 +1,27 @@
+import type { McpServerEntry } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+/** 导出记录：McpServerEntry 之外附加来源 patch 行 id（导入写回定位用） */
+export interface McpExportEntry extends McpServerEntry {
+    sourceLineId: string;
+}
+export interface McpExportSection {
+    version: 1;
+    servers: McpExportEntry[];
+}
+/** 从 patch 行数组中提取 MCP server 条目（以 config.serverName 存在为判定） */
+export declare function extractMcpServers(lines: {
+    lineId: string;
+    raw: unknown;
+}[]): McpExportEntry[];
+/** 由导出条目构造写回 patch 行 raw（单行形态，与 dsh-mcp-client 组合 config 语义一致） */
+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";
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<McpExportSection>>;
+    analyzeImport(data: McpExportSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: McpExportSection): Promise<ValidationResult>;
+}

package/lib/adapters/mcp.js

@@ -0,0 +1,175 @@
+/**
+ * mcp 分区 adapter（设计 §3.3/§1.2/§15）：
+ * 数据源 = 组合 patch 中 dsh-mcp-client 行的 config（研究报告 §2.2：MCP 无 settings 面/无管理 API）。
+ * 导入 = 写 profile cordis.patch.yml 插行（needsRestart 生效）；依赖检测（npx 等）由 analyzer 的
+ * dependencyChecker 执行（§15：缺失不阻塞，标记 Requires Attention）。
+ *
+ * patch 行 raw 支持两种形态：单行 { id, name, config } 与块 { insert: [{ id, name, config }] }。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { USER_PATCH_FILE } from "./plugins.js";
+/** 从 patch 行数组中提取 MCP server 条目（以 config.serverName 存在为判定） */
+export function extractMcpServers(lines) {
+    const servers = [];
+    for (const line of lines) {
+        for (const entry of entriesOf(line.raw)) {
+            const config = entry.config;
+            if (config === null || typeof config !== 'object')
+                continue;
+            const c = config;
+            const serverName = c['serverName'];
+            if (typeof serverName !== 'string' || serverName === '')
+                continue;
+            const type = typeof c['url'] === 'string' && c['url'] !== '' ? 'streamable-http' : 'stdio';
+            servers.push({
+                serverName,
+                type,
+                command: typeof c['command'] === 'string' ? c['command'] : undefined,
+                args: Array.isArray(c['args']) ? c['args'] : undefined,
+                env: c['env'] !== null && typeof c['env'] === 'object' ? c['env'] : undefined,
+                cwd: typeof c['cwd'] === 'string' ? c['cwd'] : undefined,
+                url: typeof c['url'] === 'string' ? c['url'] : undefined,
+                headers: c['headers'] !== null && typeof c['headers'] === 'object' ? c['headers'] : undefined,
+                sourceLineId: line.lineId,
+            });
+        }
+    }
+    return servers;
+}
+/** patch 行 → 可枚举的 entry 列表（兼容单行与 insert 块） */
+function entriesOf(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return [];
+    const obj = raw;
+    if (Array.isArray(obj['insert'])) {
+        return obj['insert']
+            .filter((e) => e !== null && typeof e === 'object')
+            .map((e) => e);
+    }
+    if (obj['id'] !== undefined || obj['name'] !== undefined) {
+        return [obj];
+    }
+    return [];
+}
+/** 由导出条目构造写回 patch 行 raw（单行形态，与 dsh-mcp-client 组合 config 语义一致） */
+export function buildMcpPatchLine(lineId, server) {
+    const config = { serverName: server.serverName };
+    if (server.type === 'streamable-http') {
+        config['url'] = server.url;
+        if (server.headers !== undefined)
+            config['headers'] = server.headers;
+    }
+    else {
+        config['command'] = server.command;
+        if (server.args !== undefined)
+            config['args'] = server.args;
+        if (server.env !== undefined)
+            config['env'] = server.env;
+        if (server.cwd !== undefined)
+            config['cwd'] = server.cwd;
+    }
+    return { id: lineId, name: 'dsh-mcp-client', config };
+}
+function newLineId(serverName) {
+    const slug = serverName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    return `mcp-${slug || 'server'}`;
+}
+export class McpAdapter {
+    id = 'mcp';
+    displayName = 'MCP Servers';
+    defaultIncluded = true;
+    portability = 'platformSpecific';
+    async export(ctx, _options) {
+        const warnings = [];
+        let lines = [];
+        try {
+            lines = await ctx.patchFile.readPatchLines(USER_PATCH_FILE);
+        }
+        catch (err) {
+            warnings.push(`patch 文件读取失败，无法提取 MCP: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const servers = extractMcpServers(lines);
+        return {
+            sectionId: 'mcp',
+            data: { version: 1, servers },
+            counts: { servers: servers.length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const items = [];
+        const targetLines = await ctx.target.patchFile.readPatchLines(USER_PATCH_FILE);
+        const targetServers = extractMcpServers(targetLines);
+        for (const server of data.servers) {
+            const id = `mcp:${server.serverName}`;
+            const existing = targetServers.find((s) => s.serverName === server.serverName);
+            const comparable = { ...server };
+            delete comparable.sourceLineId;
+            if (!existing) {
+                const lineId = server.sourceLineId && targetLines.some((l) => l.lineId === server.sourceLineId)
+                    ? `${server.sourceLineId}-imported`
+                    : (server.sourceLineId ?? newLineId(server.serverName));
+                items.push({
+                    id, kind: 'Create', adapter: 'mcp',
+                    description: `创建 MCP server ${server.serverName}`,
+                    detail: `${server.type === 'stdio' ? `${server.command} ${(server.args ?? []).join(' ')}` : server.url}`,
+                    severity: 'info',
+                    target: { adapter: 'mcp', ref: lineId },
+                });
+            }
+            else {
+                const existingComparable = { ...existing };
+                delete existingComparable.sourceLineId;
+                if (isDeepStrictEqual(existingComparable, comparable)) {
+                    items.push({ id, kind: 'Skip', adapter: 'mcp', description: `MCP server ${server.serverName} 已一致`, severity: 'info' });
+                }
+                else {
+                    items.push({
+                        id, kind: 'Conflict', adapter: 'mcp',
+                        description: `MCP server ${server.serverName} 与目标不同`,
+                        detail: `current=${JSON.stringify(existingComparable)} imported=${JSON.stringify(comparable)}`.slice(0, 200),
+                        severity: 'warning',
+                        target: { adapter: 'mcp', ref: existing.sourceLineId },
+                    });
+                }
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const serverName = item.id.replace(/^mcp:/, '');
+        const data = ctx.sections.get('mcp');
+        const server = data?.servers.find((s) => s.serverName === serverName);
+        if (!server)
+            return { ok: false, message: `导入数据缺少 MCP server ${serverName}` };
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: '缺少 target.ref' };
+        const raw = buildMcpPatchLine(ref, server);
+        await ctx.target.patchFile.applyPatchChanges(USER_PATCH_FILE, [
+            { lineId: ref, raw, action: item.kind === 'Create' ? 'insert' : 'update' },
+        ]);
+        return { ok: true, needsRestart: true, message: `MCP server ${serverName} 已写入 patch，重启后生效` };
+    }
+    async validate(data) {
+        const issues = [];
+        if (data === null || typeof data !== 'object') {
+            return { valid: false, issues: [{ path: '$', message: 'mcp 数据必须是对象', severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+        }
+        if (!Array.isArray(data.servers)) {
+            issues.push({ path: 'servers', message: '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: 'server 记录必须含非空 serverName', severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/lib/adapters/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/adapters/mcp.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+import type { FilesSection } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+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";
+    private readonly whitelist;
+    constructor(whitelist?: string[]);
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<FilesSection>>;
+    analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: FilesSection): Promise<ValidationResult>;
+}