@logictan/dsh-config-manager 0.1.60

package/lib/adapters/pnpm-workspace.js

@@ -0,0 +1,147 @@
+/**
+ * pnpm-workspace.yaml 的 `patchedDependencies` 处理（issue #35）。
+ *
+ * 背景：plugins 分区会**整段搬运** pnpm-workspace.yaml，但 `patchedDependencies` 引用的
+ * `patches/*.patch` 文件不在任何被同步的分区里。目标机因此拿到「声明存在、文件不存在」的
+ * 组合，此后**任何** `pnpm add`（含 dsh plugin add）都失败于
+ * `Failed to read patch file ... (os error 2)` —— 用户实测 13/13 插件安装全灭。
+ *
+ * 本模块做两件事，且**不做整文件重写**（保留用户注释与格式）：
+ *  1. `parsePnpmPatchedDependencies`：按行解析声明（供导出侧收集 patch 文件）；
+ *  2. `sanitizePnpmWorkspacePatches`：把「目标机没有对应文件」的条目整行删掉
+ *     （含其上方注释），全部被删时连键一起删 —— 宁可少迁移一条 patch 声明，
+ *     也不让目标机的 pnpm 从此拒绝一切安装。
+ */
+import { isPathSafe, normalizePath } from '../utils/paths.js';
+const KEY_RE = /^patchedDependencies\s*:(.*)$/;
+const ENTRY_RE = /^([ \t]+)([^\s#][^:]*?)\s*:\s*(.*)$/;
+/** 去引号 + 去行尾注释（保守：只在引号外找 ` #`） */
+function cleanScalar(raw) {
+    let v = raw.trim();
+    if (v.startsWith("'") || v.startsWith('"')) {
+        const quote = v[0];
+        const end = v.indexOf(quote, 1);
+        if (end > 0)
+            return v.slice(1, end);
+    }
+    const hash = v.indexOf(' #');
+    if (hash >= 0)
+        v = v.slice(0, hash);
+    return v.trim();
+}
+/** 解析 patchedDependencies 的声明（纯函数；不校验文件是否存在）。 */
+export function parsePnpmPatchedDependencies(text) {
+    const declared = [];
+    if (text === '')
+        return { declared, unsupported: null };
+    const lines = text.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const m = KEY_RE.exec(lines[i] ?? '');
+        if (m === null)
+            continue;
+        const inline = (m[1] ?? '').trim();
+        // 单行 flow 形态（patchedDependencies: {a: b}）无法按行安全删条目 → 不改写，交给调用方告警
+        if (inline !== '' && !inline.startsWith('#')) {
+            return { declared, unsupported: lines[i] ?? '' };
+        }
+        for (let j = i + 1; j < lines.length; j++) {
+            const line = lines[j] ?? '';
+            if (line.trim() === '' || /^[ \t]*#/.test(line))
+                continue;
+            const e = ENTRY_RE.exec(line);
+            if (e === null)
+                break; // 缩进块结束（回到顶层键）
+            declared.push({ name: (e[2] ?? '').trim(), path: cleanScalar(e[3] ?? '') });
+        }
+        break; // patchedDependencies 只处理第一处（YAML 重复键本就非法）
+    }
+    return { declared, unsupported: null };
+}
+/**
+ * 删除 patchedDependencies 中「目标机不存在对应 patch 文件」的条目。
+ * @param available 判断某相对路径（相对 profile 目录）在**导入后**是否存在
+ */
+export function sanitizePnpmWorkspacePatches(text, available) {
+    const parsed = parsePnpmPatchedDependencies(text);
+    if (parsed.unsupported !== null) {
+        return { text, declared: parsed.declared, dropped: [], unsupported: parsed.unsupported };
+    }
+    if (parsed.declared.length === 0)
+        return { text, declared: [], dropped: [], unsupported: null };
+    const droppedNames = new Set();
+    for (const d of parsed.declared) {
+        const rel = normalizePath(d.path);
+        // 越界/绝对路径的声明在目标机同样不可读（pnpm 也会拒绝）→ 一并移除
+        if (rel === '' || !isPathSafe(rel) || !available(rel))
+            droppedNames.add(d.name);
+    }
+    if (droppedNames.size === 0)
+        return { text, declared: parsed.declared, dropped: [], unsupported: null };
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const lines = text.split(/\r?\n/);
+    const out = [];
+    let removed = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const m = KEY_RE.exec(line);
+        if (m === null) {
+            out.push(line);
+            continue;
+        }
+        const inline = (m[1] ?? '').trim();
+        if (inline !== '' && !inline.startsWith('#')) {
+            out.push(line);
+            continue;
+        }
+        // 收集整块（键 + 缩进条目 + 其上的注释）
+        const block = [];
+        let j = i + 1;
+        for (; j < lines.length; j++) {
+            const l = lines[j] ?? '';
+            if (l.trim() === '' || /^[ \t]*#/.test(l)) {
+                block.push(l);
+                continue;
+            }
+            if (ENTRY_RE.exec(l) === null)
+                break;
+            block.push(l);
+        }
+        // 逐条判定：保留/删除（注释与空行随其**下一条**条目一起处置；尾部孤立注释一律保留）
+        const kept = [];
+        let pending = [];
+        let keptEntries = 0;
+        for (const bl of block) {
+            const e = ENTRY_RE.exec(bl);
+            if (e === null) {
+                pending.push(bl);
+                continue;
+            }
+            const name = (e[2] ?? '').trim();
+            if (droppedNames.has(name)) {
+                removed += 1;
+                pending = [];
+                continue;
+            }
+            kept.push(...pending, bl);
+            pending = [];
+            keptEntries += 1;
+        }
+        kept.push(...pending);
+        if (keptEntries > 0) {
+            out.push(line); // 键保留
+            out.push(...kept);
+        }
+        else {
+            removed += 1; // 键本身也删（没有任何条目留下）
+        }
+        i = j - 1;
+    }
+    // 全部条目都没了 → 键与块一起消失；否则写回（保留原 EOL）
+    return {
+        text: out.join(eol),
+        declared: parsed.declared,
+        dropped: parsed.declared.filter((d) => droppedNames.has(d.name)),
+        unsupported: null,
+    };
+}
+//# sourceMappingURL=pnpm-workspace.js.map

package/lib/adapters/prompts.d.ts

@@ -0,0 +1,30 @@
+import type { MsgFunc } from '../core/messages.ts';
+import type { PromptEntry } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+/** 导出记录：PromptEntry 之外记录来源行名（导入需要重建行时使用） */
+export interface PromptExportEntry extends PromptEntry {
+    sourceLineName?: string;
+}
+export interface PromptsExportSection {
+    version: 1;
+    prompts: PromptExportEntry[];
+}
+/** 从 patch 行 config 中提取 prompt 条目（systemPrompt.persona / planMode.sections[].text） */
+export declare function extractPrompts(lines: {
+    lineId: string;
+    raw: unknown;
+}[]): PromptExportEntry[];
+/** 把 prompt 文本合并进目标行 config（systemPrompt.persona 或 planMode.sections） */
+export declare function mergePromptIntoLine(raw: unknown, prompt: PromptExportEntry): Record<string, unknown>;
+/** 由导出条目构造「重建行」raw（Create 导入用；行名取自来源行，缺失时用占位名） */
+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';
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<PromptsExportSection>>;
+    analyzeImport(data: PromptsExportSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: PromptsExportSection, msg?: MsgFunc): Promise<ValidationResult>;
+}

package/lib/adapters/prompts.js

@@ -0,0 +1,231 @@
+/**
+ * prompts 分区 adapter（设计 §3.3/§1.2）：
+ * 数据源 = 组合 patch config 中的 systemPrompt persona / plan-mode section（研究报告 §2.2：
+ * DSH 无独立 prompt/rules 文件，persona 与 plan-mode 均经 patch config 注入）。
+ *
+ * v1 策略（诚实降级）：
+ *  - 目标存在同 lineId 行 → 同内容 Skip / 不同 Conflict（更新该行 config）；
+ *  - 目标无该行但存在同名 prompt → Conflict（更新其所在行）；
+ *  - 均不存在 → Warning（不编造行名自动创建，提示手动配置）。
+ * rules/commands 无独立存储（研究报告 §2.2），不实现。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { msgOf, zhMsg } from '../core/messages.js';
+import { USER_PATCH_FILE } from './plugins.js';
+/** 从 patch 行 config 中提取 prompt 条目（systemPrompt.persona / planMode.sections[].text） */
+export function extractPrompts(lines) {
+    const prompts = [];
+    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 sourceLineName = typeof entry.name === 'string' ? entry.name : undefined;
+            const sp = c['systemPrompt'];
+            if (typeof sp === 'string' && sp.trim() !== '') {
+                prompts.push({ id: `prompt:${line.lineId}:persona`, name: `${line.lineId}:persona`, kind: 'systemPrompt', text: sp, sourceLineId: line.lineId, sourceLineName });
+            }
+            else if (sp !== null && typeof sp === 'object' && typeof sp['persona'] === 'string') {
+                const persona = sp['persona'];
+                if (persona.trim() !== '') {
+                    prompts.push({ id: `prompt:${line.lineId}:persona`, name: `${line.lineId}:persona`, kind: 'systemPrompt', text: persona, sourceLineId: line.lineId, sourceLineName });
+                }
+            }
+            const pm = c['planMode'];
+            if (pm !== null && typeof pm === 'object' && Array.isArray(pm['sections'])) {
+                const sections = pm['sections'];
+                for (const [i, s] of sections.entries()) {
+                    if (s === null || typeof s !== 'object' || typeof s['text'] !== 'string' || s['text'].trim() === '')
+                        continue;
+                    const name = typeof s['name'] === 'string' && s['name'] !== '' ? s['name'] : `${line.lineId}:section${i}`;
+                    prompts.push({ id: `prompt:${line.lineId}:${name}`, name, kind: 'planMode', text: s['text'], sourceLineId: line.lineId, sourceLineName });
+                }
+            }
+        }
+    }
+    return prompts;
+}
+/** patch 行 → 可枚举 entry（兼容单行与 insert 块；与 mcp.ts 共用形态） */
+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 [];
+}
+/** 把 prompt 文本合并进目标行 config（systemPrompt.persona 或 planMode.sections） */
+export function mergePromptIntoLine(raw, prompt) {
+    const cloned = structuredClone(raw);
+    if (cloned['config'] === null || typeof cloned['config'] !== 'object')
+        cloned['config'] = {};
+    const config = cloned['config'];
+    if (prompt.kind === 'systemPrompt') {
+        const sp = config['systemPrompt'];
+        if (typeof sp === 'string')
+            config['systemPrompt'] = { persona: sp };
+        else if (sp === null || typeof sp !== 'object')
+            config['systemPrompt'] = { persona: prompt.text };
+        else
+            config['systemPrompt']['persona'] = prompt.text;
+    }
+    else {
+        if (config['planMode'] === null || typeof config['planMode'] !== 'object')
+            config['planMode'] = {};
+        const pm = config['planMode'];
+        if (!Array.isArray(pm['sections']))
+            pm['sections'] = [];
+        const sections = pm['sections'];
+        const sec = sections.find((s) => s !== null && typeof s === 'object' && s['name'] === prompt.name);
+        if (sec)
+            sec['text'] = prompt.text;
+        else
+            sections.push({ name: prompt.name, text: prompt.text });
+    }
+    return cloned;
+}
+/** 由导出条目构造「重建行」raw（Create 导入用；行名取自来源行，缺失时用占位名） */
+export function buildPromptLine(lineId, prompt) {
+    const name = prompt.sourceLineName ?? 'dsh-config-manager';
+    if (prompt.kind === 'planMode') {
+        return { id: lineId, name, config: { planMode: { sections: [{ name: prompt.name, text: prompt.text }] } } };
+    }
+    return { id: lineId, name, config: { systemPrompt: { persona: prompt.text } } };
+}
+export class PromptsAdapter {
+    id = 'prompts';
+    displayName = 'Prompts';
+    defaultIncluded = true;
+    portability = 'portable';
+    async export(ctx, _options) {
+        const warnings = [];
+        let lines = [];
+        try {
+            lines = await ctx.patchFile.readPatchLines(USER_PATCH_FILE);
+        }
+        catch (err) {
+            warnings.push(msgOf(ctx)('adapter.patchReadFailedPrompts', { reason: err instanceof Error ? err.message : String(err) }));
+        }
+        const prompts = extractPrompts(lines);
+        return {
+            sectionId: 'prompts',
+            data: { version: 1, prompts },
+            counts: { prompts: prompts.length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const msg = ctx.msg;
+        const items = [];
+        const targetLines = await ctx.target.patchFile.readPatchLines(USER_PATCH_FILE);
+        const targetPrompts = extractPrompts(targetLines);
+        for (const p of data.prompts) {
+            const id = p.id;
+            const sameName = targetPrompts.find((t) => t.name === p.name);
+            const targetLine = targetLines.find((l) => l.lineId === p.sourceLineId);
+            if (targetLine && sameName && sameName.sourceLineId === p.sourceLineId) {
+                if (sameName.text === p.text && sameName.kind === p.kind) {
+                    items.push({ id, kind: 'Skip', adapter: 'prompts', description: msg('adapter.promptSame', { name: p.name }), severity: 'info' });
+                }
+                else {
+                    items.push({
+                        id, kind: 'Conflict', adapter: 'prompts',
+                        description: msg('adapter.promptDiff', { name: p.name }),
+                        detail: `行 ${p.sourceLineId} current=${JSON.stringify(sameName.text).slice(0, 80)} imported=${JSON.stringify(p.text).slice(0, 80)}`,
+                        severity: 'warning',
+                        target: { adapter: 'prompts', ref: p.sourceLineId ?? '' },
+                    });
+                }
+            }
+            else if (sameName) {
+                // 目标存在同名 prompt（不同来源行）→ 更新其所在行
+                if (sameName.text === p.text && sameName.kind === p.kind) {
+                    items.push({ id, kind: 'Skip', adapter: 'prompts', description: msg('adapter.promptSame', { name: p.name }), severity: 'info' });
+                }
+                else {
+                    items.push({
+                        id, kind: 'Conflict', adapter: 'prompts',
+                        description: msg('adapter.promptDiffWithLine', { name: p.name, line: sameName.sourceLineId ?? '' }),
+                        severity: 'warning',
+                        target: { adapter: 'prompts', ref: sameName.sourceLineId ?? '' },
+                    });
+                }
+            }
+            else if (p.sourceLineName) {
+                // 目标无来源行但记录到行名 → 重建行（Create）；幂等键 = 行 id
+                const lineId = p.sourceLineId ?? `prompt-${p.name}`;
+                items.push({
+                    id, kind: 'Create', adapter: 'prompts',
+                    description: msg('adapter.promptCreate', { name: p.name, line: lineId }), severity: 'info',
+                    target: { adapter: 'prompts', ref: lineId },
+                });
+            }
+            else {
+                items.push({
+                    id, kind: 'Warning', adapter: 'prompts',
+                    description: msg('adapter.promptManual', { name: p.name }),
+                    severity: 'info',
+                });
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const msg = ctx.msg;
+        if (item.kind === 'Warning')
+            return { ok: true, message: msg('adapter.promptWarningNoWrite') };
+        const ref = item.target?.ref;
+        if (!ref)
+            return { ok: false, message: msg('adapter.missingTargetRef') };
+        const data = ctx.sections.get('prompts');
+        const prompt = data?.prompts.find((p) => p.id === item.id);
+        if (!prompt)
+            return { ok: false, message: msg('adapter.promptMissing', { id: item.id }) };
+        // Create：目标无来源行 → 用记录的行名重建 patch 行（insert）
+        if (item.kind === 'Create') {
+            const raw = buildPromptLine(ref, prompt);
+            await ctx.target.patchFile.applyPatchChanges(USER_PATCH_FILE, [
+                { lineId: ref, raw, action: 'insert' },
+            ]);
+            return { ok: true, needsRestart: true, message: msg('adapter.promptCreated', { name: prompt.name, ref }) };
+        }
+        // Update / Conflict(useImported)：合并进目标行 config
+        const lines = await ctx.target.patchFile.readPatchLines(USER_PATCH_FILE);
+        const line = lines.find((l) => l.lineId === ref);
+        if (!line)
+            return { ok: false, message: msg('adapter.patchLineMissing', { ref }) };
+        const newRaw = mergePromptIntoLine(line.raw, prompt);
+        await ctx.target.patchFile.applyPatchChanges(USER_PATCH_FILE, [
+            { lineId: ref, raw: newRaw, action: 'update' },
+        ]);
+        return { ok: true, needsRestart: true, message: msg('adapter.promptWritten', { name: prompt.name, 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: 'prompts' }), 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.prompts)) {
+            issues.push({ path: 'prompts', message: msg('adapter.validate.array', { subject: 'prompts' }), severity: 'error' });
+        }
+        else {
+            for (const p of data.prompts) {
+                if (p === null || typeof p !== 'object' || typeof p.name !== 'string' || typeof p.text !== 'string') {
+                    issues.push({ path: 'prompts[]', message: msg('adapter.validate.promptIdentity'), severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/lib/adapters/providers.d.ts

@@ -0,0 +1,34 @@
+import type { MsgFunc } from '../core/messages.ts';
+import type { ProviderEntry } from '../schema/types.ts';
+import type { ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext, ImportContext, PlanItem, ValidationResult } from '../core/types.ts';
+import { type NamespaceProvider } from './settings.ts';
+/** 导出记录：ProviderEntry 之外附加 namespace 级元数据（导入写回用），满足 ProvidersSection 形状 */
+export interface ProviderExportEntry extends ProviderEntry {
+    /** 来源 settings namespace（llm-deepseek / llm-pi-ai） */
+    namespace: string;
+    /** 乐观锁 revision（导入时检测并发修改） */
+    revision: number;
+    secrets?: {
+        path: string[];
+        set: boolean;
+    }[];
+    /** 该 namespace 的完整 redacted 值（导入整体写回，避免按字段重建丢失结构） */
+    raw?: Record<string, unknown>;
+}
+export interface ProviderExportSection {
+    version: 1;
+    providers: Record<string, ProviderExportEntry>;
+}
+export declare const DEFAULT_PROVIDER_NAMESPACES: readonly string[];
+export declare class ProvidersAdapter implements ConfigAdapter<ProviderExportSection> {
+    readonly id: 'providers';
+    readonly displayName = "Providers & Models";
+    readonly defaultIncluded = true;
+    readonly portability: 'portable';
+    private readonly namespaces;
+    constructor(namespaces?: string[] | NamespaceProvider);
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<ProviderExportSection>>;
+    analyzeImport(data: ProviderExportSection, ctx: ImportContext): Promise<PlanItem[]>;
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
+    validate(data: ProviderExportSection, msg?: MsgFunc): Promise<ValidationResult>;
+}

package/lib/adapters/providers.js

@@ -0,0 +1,155 @@
+/**
+ * providers 分区 adapter（设计 §3.3/§13.1）：
+ * 数据源 = settings.yaml 的 llm-deepseek / llm-pi-ai section（providers 与 models 天然同 section，不拆文件）。
+ *
+ * 导入走 settings 写通道（replace llm-* namespace + 乐观锁）：
+ * 每项携带 raw（该 namespace 的完整 redacted 值）用于整体写回，apiKey 值经 credentials 状态占位（不导出值）。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import { msgOf, zhMsg } from '../core/messages.js';
+import { resolveNamespaces, isEmptyValue } from './settings.js';
+export const DEFAULT_PROVIDER_NAMESPACES = ['llm-deepseek', 'llm-pi-ai'];
+/** 无 raw 时的兜底重建：只取 ProviderEntry 已知字段 */
+function stripEntry(entry) {
+    const out = {};
+    for (const key of ['apiKeyEnv', 'displayName', 'baseURL', 'models', 'modelOverrides', 'reasoning', 'transport', 'retryPolicy']) {
+        if (entry[key] !== undefined)
+            out[key] = entry[key];
+    }
+    return out;
+}
+export class ProvidersAdapter {
+    id = 'providers';
+    displayName = 'Providers & Models';
+    defaultIncluded = true;
+    portability = 'portable';
+    namespaces;
+    constructor(namespaces = DEFAULT_PROVIDER_NAMESPACES) {
+        this.namespaces = namespaces;
+    }
+    async export(ctx, _options) {
+        const providers = {};
+        const warnings = [];
+        for (const ns of await resolveNamespaces(this.namespaces, ctx)) {
+            let info;
+            try {
+                info = await ctx.settings.describe(ns, { redactSecrets: true });
+            }
+            catch (err) {
+                warnings.push(msgOf(ctx)('adapter.providerNsReadFailed', { ns, reason: err instanceof Error ? err.message : String(err) }));
+                continue;
+            }
+            const value = (info.value ?? {});
+            // llm-pi-ai 形态：value.providers = { route: {...} }；llm-deepseek 形态：value 即单 provider 配置
+            const routes = value.providers !== null && typeof value.providers === 'object'
+                ? Object.entries(value.providers)
+                : [[ns, value]];
+            for (const [route, pv] of routes) {
+                // 每个 route 独立深拷贝 secrets / pv / raw：同一 namespace 的多 route 若共享引用，
+                // m4 强化版 createSecretScanner 的 visited 循环检测会误判「检测到循环引用」（见 providers.test.ts）。
+                providers[route] = {
+                    route,
+                    namespace: ns,
+                    revision: info.revision,
+                    secrets: structuredClone(info.secrets),
+                    ...structuredClone(pv),
+                    raw: structuredClone(value),
+                };
+            }
+        }
+        return {
+            sectionId: 'providers',
+            data: { version: 1, providers },
+            counts: { providers: Object.keys(providers).length },
+            warnings,
+        };
+    }
+    async analyzeImport(data, ctx) {
+        const msg = ctx.msg;
+        const items = [];
+        for (const [route, entry] of Object.entries(data.providers)) {
+            const id = `provider:${route}`;
+            let current = null;
+            let targetUnavailable = false;
+            try {
+                current = await ctx.target.settings.describe(entry.namespace, { redactSecrets: true });
+            }
+            catch {
+                // 目标未注册该 namespace（缺少提供它的插件）→ 写入必失败，按依赖缺失处理（§15）
+                targetUnavailable = true;
+            }
+            if (targetUnavailable) {
+                items.push({
+                    id, kind: 'MissingDependency', adapter: 'providers',
+                    description: msg('adapter.providerUnregistered', { route, ns: entry.namespace }),
+                    severity: 'warning', target: { adapter: 'providers', ref: entry.namespace },
+                });
+            }
+            else if (current === null || isEmptyValue(current.value)) {
+                // 目标已注册但为空 → 初始化（Create）
+                items.push({
+                    id, kind: 'Create', adapter: 'providers',
+                    description: msg('adapter.providerCreate', { route, ns: entry.namespace }), severity: 'info',
+                    target: { adapter: 'providers', ref: entry.namespace },
+                });
+            }
+            else if (isDeepStrictEqual(current.value, entry.raw ?? stripEntry(entry))) {
+                items.push({ id, kind: 'Skip', adapter: 'providers', description: msg('adapter.providerSame', { route }), severity: 'info' });
+            }
+            else {
+                items.push({
+                    id, kind: 'Conflict', adapter: 'providers',
+                    description: msg('adapter.providerDiff', { route }),
+                    detail: `namespace=${entry.namespace} current=${JSON.stringify(current.value)} imported=${JSON.stringify(entry.raw ?? stripEntry(entry))}`.slice(0, 200),
+                    severity: 'warning', target: { adapter: 'providers', ref: entry.namespace },
+                });
+            }
+        }
+        return items;
+    }
+    async applyItem(item, ctx) {
+        const route = item.id.replace(/^provider:/, '');
+        const data = ctx.sections.get('providers');
+        const entry = data?.providers[route];
+        if (!entry)
+            return { ok: false, message: ctx.msg('adapter.providerMissing', { route }) };
+        const value = entry.raw ?? stripEntry(entry);
+        let expected;
+        try {
+            expected = (await ctx.target.settings.describe(entry.namespace, { redactSecrets: true })).revision;
+        }
+        catch {
+            expected = undefined; // 目标 namespace 不存在（Create）
+        }
+        await ctx.target.settings.replace(entry.namespace, value, expected);
+        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: 'providers' }), severity: 'error' }] };
+        }
+        if (data.version !== 1) {
+            issues.push({ path: 'version', message: msg('adapter.validate.version', { value: String(data.version) }), severity: 'error' });
+        }
+        if (data.providers === null || typeof data.providers !== 'object') {
+            issues.push({ path: 'providers', message: msg('adapter.validate.missingObject', { subject: 'providers' }), severity: 'error' });
+        }
+        else {
+            for (const [route, entry] of Object.entries(data.providers)) {
+                if (entry === null || typeof entry !== 'object') {
+                    issues.push({ path: `providers.${route}`, message: msg('adapter.validate.recordObject', { subject: 'provider' }), severity: 'error' });
+                    continue;
+                }
+                if (typeof entry.namespace !== 'string' || entry.namespace === '') {
+                    issues.push({ path: `providers.${route}.namespace`, message: msg('adapter.validate.sourceNamespace'), severity: 'error' });
+                }
+                if (typeof entry.revision !== 'number') {
+                    issues.push({ path: `providers.${route}.revision`, message: msg('adapter.validate.number', { subject: 'revision' }), severity: 'error' });
+                }
+            }
+        }
+        return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+    }
+}
+//# sourceMappingURL=providers.js.map

package/lib/adapters/self.d.ts

@@ -0,0 +1,17 @@
+import type { ExportOptions, ExportSection, HostContext } from '../core/types.ts';
+import type { FilesSection } from '../schema/types.ts';
+import { FileCollectionAdapter } from './file-collection.ts';
+/** self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。 */
+export declare const SELF_CONFIG_FILES: readonly string[];
+export declare class SelfAdapter extends FileCollectionAdapter {
+    readonly id: 'self';
+    readonly displayName = "Plugin Self Config";
+    readonly defaultIncluded = true;
+    readonly portability: 'portable';
+    /** 插件自身配置目录（相对 homeDir；宿主按 dataDir 解析注入，缺省 dsh-config-manager） */
+    readonly baseDir: string;
+    constructor(baseDir?: string);
+    /** 白名单收集：只导出配置类文件（存在才收），不递归（排除快照/历史/缓存/临时产物）。
+     *  relativePath 产出相对 baseDir 的路径（与 analyzeImport/applyItem 的 path.join(baseDir, ref) 匹配）。 */
+    export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<FilesSection>>;
+}