dsh-config-manager 0.1.0

package/src/adapters/plugins.test.ts

@@ -0,0 +1,72 @@
+/**
+ * plugins adapter 测试：插件清单 + 用户 patch 行导出、
+ * 已装同版本 Skip / 未装 Install / patch 行 Create，applyItem（install → needsRestart；patch 写回）。
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { PluginsAdapter, USER_PATCH_FILE } from './plugins.ts';
+import { makeContext, makeImportContext } from './test-helpers.ts';
+
+test('plugins: 导出清单与 patch 行', async () => {
+  const ctx = makeContext('win32', 'C:\\Users\\alice');
+  ctx.plugins.installed.set('@linxin666/dsh-ssh', { name: '@linxin666/dsh-ssh', version: '0.1.12', enabled: true, isBundle: true, inBundles: ['@linxin666/dsh-web-ui-all'] });
+  ctx.plugins.installed.set('@deepseek-ai/dsh-base', { name: '@deepseek-ai/dsh-base', version: '0.1.0-rc.6', enabled: true });
+  ctx.patchFile.lines.set('skill-badge', { lineId: 'skill-badge', raw: { id: 'skill-badge', disabled: true } });
+
+  const adapter = new PluginsAdapter();
+  const out = await adapter.export(ctx, { includeSecrets: false });
+  assert.equal(out.data.version, 1);
+  assert.equal(out.data.plugins.length, 2);
+  assert.equal(out.data.patch.length, 1);
+  assert.equal(out.data.patch[0]?.lineId, 'skill-badge');
+  const ssh = out.data.plugins.find((p) => p.name === '@linxin666/dsh-ssh');
+  assert.equal(ssh?.isBundle, true);
+  assert.deepEqual(ssh?.inBundles, ['@linxin666/dsh-web-ui-all']);
+
+  const v = await adapter.validate(out.data);
+  assert.equal(v.valid, true);
+});
+
+test('plugins: 已装同版本 Skip / 未装 Install / 版本不同 Conflict / patch Create', async () => {
+  const src = makeContext('win32', 'C:\\Users\\alice');
+  src.plugins.installed.set('pkg-a', { name: 'pkg-a', version: '1.0.0', enabled: true });
+  src.plugins.installed.set('pkg-b', { name: 'pkg-b', version: '2.0.0', enabled: true });
+  src.patchFile.lines.set('my-line', { lineId: 'my-line', raw: { id: 'my-line', name: 'pkg-c', config: { x: 1 } } });
+  const adapter = new PluginsAdapter();
+  const exported = await adapter.export(src, { includeSecrets: false });
+  const sections = new Map([['plugins', exported.data]]);
+
+  const dst = makeContext('linux', '/home/bob');
+  dst.plugins.installed.set('pkg-a', { name: 'pkg-a', version: '1.0.0', enabled: true }); // 同版本
+  dst.plugins.installed.set('pkg-b', { name: 'pkg-b', version: '1.5.0', enabled: true }); // 不同版本
+  const items = await adapter.analyzeImport(exported.data, makeImportContext(dst, sections));
+  const byId = new Map(items.map((i) => [i.id, i]));
+  assert.equal(byId.get('plugin:pkg-a')?.kind, 'Skip');
+  assert.equal(byId.get('plugin:pkg-b')?.kind, 'Conflict');
+  assert.equal(byId.get('patch:my-line')?.kind, 'Create');
+  assert.equal(byId.get('patch:my-line')?.target?.ref, 'my-line');
+
+  // patch 行写入（Create）
+  const r = await adapter.applyItem(byId.get('patch:my-line')!, makeImportContext(dst, sections));
+  assert.equal(r.ok, true);
+  assert.equal(r.needsRestart, true);
+  assert.deepEqual(dst.patchFile.lines.get('my-line')?.raw, { id: 'my-line', name: 'pkg-c', config: { x: 1 } });
+});
+
+test('plugins: applyItem Install → needsRestart（官方机制，不打包二进制）', async () => {
+  const src = makeContext('win32', 'C:\\Users\\alice');
+  src.plugins.installed.set('need-install', { name: 'need-install', version: '3.0.0', enabled: true });
+  const adapter = new PluginsAdapter();
+  const exported = await adapter.export(src, { includeSecrets: false });
+  const sections = new Map([['plugins', exported.data]]);
+
+  const dst = makeContext('linux', '/home/bob');
+  const items = await adapter.analyzeImport(exported.data, makeImportContext(dst, sections));
+  const installItem = items.find((i) => i.id === 'plugin:need-install');
+  assert.equal(installItem?.kind, 'Install');
+  assert.equal(installItem?.target, undefined, 'Install 项不做快照（不可回滚，如实报告）');
+  const r = await adapter.applyItem(installItem!, makeImportContext(dst, sections));
+  assert.equal(r.ok, true);
+  assert.equal(r.needsRestart, true);
+  assert.ok(dst.plugins.installed.has('need-install'), '经 installPlugin 门面写入');
+});

package/src/adapters/plugins.ts

@@ -0,0 +1,176 @@
+/**
+ * plugins 分区 adapter（设计 §3.3/§8）：
+ * 数据源 = ctx.plugins.listInstalled()（插件清单）+ 用户 patch 层（profile cordis.patch.yml）。
+ *
+ * 安全不变量：绝不打包插件二进制；导入走 DSH 官方机制（installPlugin → needsRestart 提示）。
+ * patch 行导入（用户自定义行：启用/禁用/插入）写回 cordis.patch.yml，同样 needsRestart。
+ */
+import { isDeepStrictEqual } from 'node:util';
+import type { PatchLine, PluginEntry, PluginsSection } from '../schema/types.ts';
+import type {
+  ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext,
+  ImportContext, PlanItem, ValidationResult,
+} from '../core/types.ts';
+
+export const USER_PATCH_FILE = 'cordis.patch.yml';
+
+/** patch 行 raw 是否由其他 adapter 管理（mcp-client 行 / systemPrompt / planMode 行）。
+ * 这些行的导入归 mcp.ts / prompts.ts，plugins 分区只负责普通用户行（启用/禁用/插入插件等）。 */
+function isManagedElsewhere(raw: unknown): boolean {
+  for (const entry of entriesOfRaw(raw)) {
+    const config = entry.config;
+    if (config === null || typeof config !== 'object') continue;
+    const c = config as Record<string, unknown>;
+    if (typeof c['serverName'] === 'string' && c['serverName'] !== '') return true;
+    if (c['systemPrompt'] !== undefined) return true;
+    if (c['planMode'] !== undefined) return true;
+  }
+  return false;
+}
+
+/** patch 行 → entry 列表（兼容单行与 insert 块；与 mcp/prompts 共用形态） */
+function entriesOfRaw(raw: unknown): { config?: unknown }[] {
+  if (raw === null || typeof raw !== 'object') return [];
+  const obj = raw as Record<string, unknown>;
+  if (Array.isArray(obj['insert'])) {
+    return obj['insert']
+      .filter((e): e is Record<string, unknown> => e !== null && typeof e === 'object')
+      .map((e) => e as { config?: unknown });
+  }
+  if (obj['id'] !== undefined || obj['name'] !== undefined) {
+    return [obj as { config?: unknown }];
+  }
+  return [];
+}
+
+export class PluginsAdapter implements ConfigAdapter<PluginsSection> {
+  readonly id = 'plugins' as const;
+  readonly displayName = 'Plugins';
+  readonly defaultIncluded = true;
+  readonly portability = 'portable' as const;
+
+  async export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<PluginsSection>> {
+    const plugins: PluginEntry[] = [];
+    const warnings: string[] = [];
+    try {
+      const installed = await ctx.plugins.listInstalled();
+      for (const p of installed) {
+        plugins.push({
+          name: p.name,
+          version: p.version,
+          isBundle: p.isBundle ?? false,
+          inBundles: p.inBundles ?? [],
+          enabled: p.enabled,
+        });
+      }
+    } catch (err) {
+      warnings.push(`插件清单读取失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const patch: PatchLine[] = [];
+    try {
+      const lines = await ctx.patchFile.readPatchLines(USER_PATCH_FILE);
+      for (const l of lines) patch.push({ file: USER_PATCH_FILE, lineId: l.lineId, raw: l.raw });
+    } catch (err) {
+      warnings.push(`patch 文件读取失败: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return {
+      sectionId: 'plugins',
+      data: { version: 1, plugins, patch },
+      counts: { plugins: plugins.length, patchLines: patch.length },
+      warnings,
+    };
+  }
+
+  async analyzeImport(data: PluginsSection, ctx: ImportContext): Promise<PlanItem[]> {
+    const items: PlanItem[] = [];
+    const targetInstalled = await ctx.target.plugins.listInstalled();
+
+    // 插件：包名唯一键；同版本 Skip / 未装 Install / 版本不同 Conflict
+    for (const p of data.plugins) {
+      const id = `plugin:${p.name}`;
+      const tp = targetInstalled.find((t) => t.name === p.name);
+      if (!tp) {
+        items.push({
+          id, kind: 'Install', adapter: 'plugins',
+          description: `安装插件 ${p.name}@${p.version}`,
+          detail: p.isBundle ? '（bundle 成员，经聚合包安装）' : undefined,
+          severity: 'info',
+        });
+      } else if (tp.version === p.version) {
+        items.push({ id, kind: 'Skip', adapter: 'plugins', description: `插件 ${p.name} 已安装且版本一致`, severity: 'info' });
+      } else {
+        items.push({
+          id, kind: 'Conflict', adapter: 'plugins',
+          description: `插件 ${p.name} 版本不同`,
+          detail: `当前 ${tp.version} vs 导入 ${p.version}`,
+          severity: 'warning',
+        });
+      }
+    }
+
+    // 用户 patch 行：lineId 唯一键；存在且同 → Skip；存在不同 → Conflict；不存在 → Create。
+    // mcp-client 行与 systemPrompt/planMode 行由 mcp/prompts adapter 管理，此处跳过（避免重复写入覆盖）。
+    const targetLines = await ctx.target.patchFile.readPatchLines(USER_PATCH_FILE);
+    for (const pl of data.patch) {
+      if (isManagedElsewhere(pl.raw)) continue;
+      const id = `patch:${pl.lineId}`;
+      const tl = targetLines.find((l) => l.lineId === pl.lineId);
+      if (!tl) {
+        items.push({
+          id, kind: 'Create', adapter: 'plugins',
+          description: `写入 patch 行 ${pl.lineId}`, severity: 'info',
+          target: { adapter: 'plugins', ref: pl.lineId },
+        });
+      } else if (isDeepStrictEqual(tl.raw, pl.raw)) {
+        items.push({ id, kind: 'Skip', adapter: 'plugins', description: `patch 行 ${pl.lineId} 已一致`, severity: 'info' });
+      } else {
+        items.push({
+          id, kind: 'Conflict', adapter: 'plugins',
+          description: `patch 行 ${pl.lineId} 与目标不同`, severity: 'warning',
+          target: { adapter: 'plugins', ref: pl.lineId },
+        });
+      }
+    }
+    return items;
+  }
+
+  async applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult> {
+    // 插件安装：官方机制 installPlugin；needsRestart 提示（设计 §8：不打包二进制）
+    if (item.kind === 'Install') {
+      const name = item.id.replace(/^plugin:/, '');
+      const result = await ctx.target.plugins.install(name);
+      return {
+        ok: true,
+        needsRestart: true,
+        message: result.needsRestart ? `插件 ${name} 已安装，重启 dsh 后生效` : `插件 ${name} 已安装`,
+      };
+    }
+    // patch 行：Create → insert，Update/Conflict(useImported) → update
+    const ref = item.target?.ref;
+    if (!ref) return { ok: false, message: '缺少 target.ref' };
+    const data = ctx.sections.get('plugins') as PluginsSection | undefined;
+    const pl = data?.patch.find((p) => p.lineId === ref);
+    if (!pl) return { ok: false, message: `导入数据缺少 patch 行 ${ref}` };
+    await ctx.target.patchFile.applyPatchChanges(pl.file, [
+      { lineId: ref, raw: pl.raw, action: item.kind === 'Create' ? 'insert' : 'update' },
+    ]);
+    return { ok: true, needsRestart: true, message: `patch 行 ${ref} 已写入，重启后生效` };
+  }
+
+  async validate(data: PluginsSection): Promise<ValidationResult> {
+    const issues: ValidationResult['issues'] = [];
+    if (data === null || typeof data !== 'object') {
+      return { valid: false, issues: [{ path: '$', message: 'plugins 数据必须是对象', severity: 'error' }] };
+    }
+    if (data.version !== 1) {
+      issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+    }
+    if (!Array.isArray(data.plugins)) {
+      issues.push({ path: 'plugins', message: 'plugins 必须是数组', severity: 'error' });
+    }
+    if (data.patch !== undefined && !Array.isArray(data.patch)) {
+      issues.push({ path: 'patch', message: 'patch 必须是数组', severity: 'error' });
+    }
+    return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+  }
+}

package/src/adapters/prompts.test.ts

@@ -0,0 +1,110 @@
+/**
+ * prompts adapter 测试：patch config 提取（systemPrompt persona / planMode sections）、
+ * 同行 Skip/Conflict、目标无来源行 → Warning（诚实降级）、applyItem 合并写回。
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { PromptsAdapter, extractPrompts, mergePromptIntoLine } from './prompts.ts';
+import { makeContext, makeImportContext } from './test-helpers.ts';
+import type { PromptsExportSection } from './prompts.ts';
+import type { PlanItem } from '../core/types.ts';
+
+const LINES = [
+  {
+    lineId: 'persona-line',
+    raw: { id: 'persona-line', name: '@deepseek-ai/dsh-web', config: { systemPrompt: { persona: 'You are a helpful coding assistant.' } } },
+  },
+  {
+    lineId: 'plan-line',
+    raw: { id: 'plan-line', name: 'plan-mode', config: { planMode: { sections: [{ name: 'plan', order: 1, text: 'Plan first, then code.' }] } } },
+  },
+];
+
+test('prompts: extractPrompts 提取 persona 与 planMode sections', () => {
+  const prompts = extractPrompts(LINES);
+  assert.equal(prompts.length, 2);
+  const persona = prompts.find((p) => p.kind === 'systemPrompt');
+  assert.equal(persona?.name, 'persona-line:persona');
+  assert.equal(persona?.text, 'You are a helpful coding assistant.');
+  assert.equal(persona?.sourceLineId, 'persona-line');
+  const plan = prompts.find((p) => p.kind === 'planMode');
+  assert.equal(plan?.name, 'plan');
+  assert.equal(plan?.text, 'Plan first, then code.');
+});
+
+test('prompts: mergePromptIntoLine 合并 persona / planMode 文本', () => {
+  // persona 更新（原为对象形态）
+  const merged = mergePromptIntoLine(LINES[0]!.raw, {
+    id: 'prompt:persona-line:persona', name: 'persona-line:persona', kind: 'systemPrompt',
+    text: 'New persona.', sourceLineId: 'persona-line',
+  });
+  const config = (merged as Record<string, unknown>)['config'] as Record<string, unknown>;
+  assert.equal((config['systemPrompt'] as Record<string, unknown>)['persona'], 'New persona.');
+
+  // planMode 新增 section
+  const planMerged = mergePromptIntoLine(LINES[1]!.raw, {
+    id: 'prompt:plan-line:step2', name: 'step2', kind: 'planMode',
+    text: 'Step two text.', sourceLineId: 'plan-line',
+  });
+  const planConfig = (planMerged as Record<string, unknown>)['config'] as Record<string, unknown>;
+  const sections = (planConfig['planMode'] as Record<string, unknown>)['sections'] as Record<string, unknown>[];
+  assert.equal(sections.length, 2);
+  assert.equal(sections[1]?.['text'], 'Step two text.');
+});
+
+test('prompts: 同行同内容 Skip / 不同 Conflict(update) / 目标无 → Warning', async () => {
+  const src = makeContext('win32', 'C:\\Users\\alice');
+  for (const l of LINES) src.patchFile.lines.set(l.lineId, { lineId: l.lineId, raw: l.raw });
+  const adapter = new PromptsAdapter();
+  const exported = await adapter.export(src, { includeSecrets: false });
+  assert.equal(exported.data.prompts.length, 2);
+  const sections = new Map([['prompts', exported.data]]);
+
+  const dst = makeContext('linux', '/home/bob');
+  for (const l of LINES) dst.patchFile.lines.set(l.lineId, { lineId: l.lineId, raw: l.raw });
+  let items = await adapter.analyzeImport(exported.data, makeImportContext(dst, sections));
+  assert.ok(items.every((i) => i.kind === 'Skip'), '目标一致 → 全部 Skip');
+
+  // 目标 persona 不同 → Conflict（target.ref = 来源行）
+  dst.patchFile.lines.set('persona-line', {
+    lineId: 'persona-line',
+    raw: { id: 'persona-line', name: '@deepseek-ai/dsh-web', config: { systemPrompt: { persona: 'Old persona.' } } },
+  });
+  items = await adapter.analyzeImport(exported.data, makeImportContext(dst, sections));
+  const conflict = items.find((i) => i.id === 'prompt:persona-line:persona');
+  assert.equal(conflict?.kind, 'Conflict');
+  assert.equal(conflict?.target?.ref, 'persona-line');
+  const useItem: PlanItem = { ...conflict!, kind: 'Update' };
+  const r = await adapter.applyItem(useItem, makeImportContext(dst, sections));
+  assert.equal(r.ok, true);
+  assert.equal(r.needsRestart, true);
+  const raw = dst.patchFile.lines.get('persona-line')?.raw as Record<string, unknown>;
+  const sp = (raw['config'] as Record<string, unknown>)['systemPrompt'] as Record<string, unknown>;
+  assert.equal(sp['persona'], 'You are a helpful coding assistant.', 'Conflict useImported 应合并更新 persona');
+
+  // 目标无来源行但有行名 → Create（重建行）
+  const dst2 = makeContext('darwin', '/Users/bob');
+  items = await adapter.analyzeImport(exported.data, makeImportContext(dst2, sections));
+  assert.ok(items.every((i) => i.kind === 'Create'), '目标无来源行但有行名 → Create 重建');
+  for (const item of items) {
+    const rc = await adapter.applyItem(item, makeImportContext(dst2, sections));
+    assert.equal(rc.ok, true);
+  }
+  const created = dst2.patchFile.lines.get('persona-line')?.raw as Record<string, unknown>;
+  assert.equal(((created['config'] as Record<string, unknown>)['systemPrompt'] as Record<string, unknown>)['persona'], 'You are a helpful coding assistant.');
+
+  // 无行名的 prompt（来源信息缺失）→ Warning，不编造自动创建
+  const orphan: PromptsExportSection = { version: 1, prompts: [{ id: 'p1', name: 'orphan', kind: 'systemPrompt', text: 'x' }] };
+  const itemsNoName = await adapter.analyzeImport(orphan, makeImportContext(dst2, new Map([['prompts', orphan]])));
+  assert.ok(itemsNoName.every((i) => i.kind === 'Warning'), '来源行名缺失 → Warning 提示手动配置');
+  const w = await adapter.applyItem(itemsNoName[0]!, makeImportContext(dst2, sections));
+  assert.equal(w.ok, true, 'Warning 项 applyItem 无副作用');
+});
+
+test('prompts: validate', async () => {
+  const adapter = new PromptsAdapter();
+  const ok = await adapter.validate({ version: 1, prompts: [{ id: 'a', name: 'n', kind: 'systemPrompt', text: 't' }] });
+  assert.equal(ok.valid, true);
+  const bad = await adapter.validate({ version: 1, prompts: [{ id: 'a', name: 1 as never, kind: 'systemPrompt', text: 't' }] });
+  assert.equal(bad.valid, false);
+});

package/src/adapters/prompts.ts

@@ -0,0 +1,226 @@
+/**
+ * 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 type { PromptEntry, PromptsSection } from '../schema/types.ts';
+import type {
+  ApplyResult, ConfigAdapter, ExportOptions, ExportSection, HostContext,
+  ImportContext, PlanItem, ValidationResult,
+} from '../core/types.ts';
+import { USER_PATCH_FILE } from './plugins.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 function extractPrompts(lines: { lineId: string; raw: unknown }[]): PromptExportEntry[] {
+  const prompts: PromptExportEntry[] = [];
+  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 as Record<string, unknown>;
+      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 as Record<string, unknown>)['persona'] === 'string') {
+        const persona = (sp as Record<string, unknown>)['persona'] as string;
+        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 as Record<string, unknown>)['sections'])) {
+        const sections = (pm as Record<string, unknown>)['sections'] as Record<string, unknown>[];
+        for (const [i, s] of sections.entries()) {
+          if (s === null || typeof s !== 'object' || typeof s['text'] !== 'string' || (s['text'] as string).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'] as string, sourceLineId: line.lineId, sourceLineName });
+        }
+      }
+    }
+  }
+  return prompts;
+}
+
+/** patch 行 → 可枚举 entry（兼容单行与 insert 块；与 mcp.ts 共用形态） */
+function entriesOf(raw: unknown): { id?: unknown; name?: unknown; config?: unknown }[] {
+  if (raw === null || typeof raw !== 'object') return [];
+  const obj = raw as Record<string, unknown>;
+  if (Array.isArray(obj['insert'])) {
+    return obj['insert']
+      .filter((e): e is Record<string, unknown> => e !== null && typeof e === 'object')
+      .map((e) => e as { id?: unknown; name?: unknown; config?: unknown });
+  }
+  if (obj['id'] !== undefined || obj['name'] !== undefined) {
+    return [obj as { id?: unknown; name?: unknown; config?: unknown }];
+  }
+  return [];
+}
+
+/** 把 prompt 文本合并进目标行 config（systemPrompt.persona 或 planMode.sections） */
+export function mergePromptIntoLine(raw: unknown, prompt: PromptExportEntry): Record<string, unknown> {
+  const cloned = structuredClone(raw) as Record<string, unknown>;
+  if (cloned['config'] === null || typeof cloned['config'] !== 'object') cloned['config'] = {};
+  const config = cloned['config'] as Record<string, unknown>;
+  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'] as Record<string, unknown>)['persona'] = prompt.text;
+  } else {
+    if (config['planMode'] === null || typeof config['planMode'] !== 'object') config['planMode'] = {};
+    const pm = config['planMode'] as Record<string, unknown>;
+    if (!Array.isArray(pm['sections'])) pm['sections'] = [];
+    const sections = pm['sections'] as Record<string, unknown>[];
+    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: string, prompt: PromptExportEntry): Record<string, unknown> {
+  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 implements ConfigAdapter<PromptsExportSection> {
+  readonly id = 'prompts' as const;
+  readonly displayName = 'Prompts';
+  readonly defaultIncluded = true;
+  readonly portability = 'portable' as const;
+
+  async export(ctx: HostContext, _options: ExportOptions): Promise<ExportSection<PromptsExportSection>> {
+    const warnings: string[] = [];
+    let lines: { lineId: string; raw: unknown }[] = [];
+    try {
+      lines = await ctx.patchFile.readPatchLines(USER_PATCH_FILE);
+    } catch (err) {
+      warnings.push(`patch 文件读取失败，无法提取 prompts: ${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: PromptsExportSection, ctx: ImportContext): Promise<PlanItem[]> {
+    const items: PlanItem[] = [];
+    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: `提示词 ${p.name} 已一致`, severity: 'info' });
+        } else {
+          items.push({
+            id, kind: 'Conflict', adapter: 'prompts',
+            description: `提示词 ${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: `提示词 ${p.name} 已一致`, severity: 'info' });
+        } else {
+          items.push({
+            id, kind: 'Conflict', adapter: 'prompts',
+            description: `提示词 ${p.name} 与目标不同（目标位于行 ${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: `创建提示词 ${p.name}（行 ${lineId}）`, severity: 'info',
+          target: { adapter: 'prompts', ref: lineId },
+        });
+      } else {
+        items.push({
+          id, kind: 'Warning', adapter: 'prompts',
+          description: `提示词 ${p.name} 在目标无对应来源，请手动配置（DSH 无独立 prompt 存储）`,
+          severity: 'info',
+        });
+      }
+    }
+    return items;
+  }
+
+  async applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult> {
+    if (item.kind === 'Warning') return { ok: true, message: '提示项，无需写入' };
+    const ref = item.target?.ref;
+    if (!ref) return { ok: false, message: '缺少 target.ref' };
+    const data = ctx.sections.get('prompts') as PromptsExportSection | undefined;
+    const prompt = data?.prompts.find((p) => p.id === item.id);
+    if (!prompt) return { ok: false, message: `导入数据缺少提示词 ${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: `提示词 ${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: `目标 patch 行 ${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: `提示词 ${prompt.name} 已写入 patch 行 ${ref}` };
+  }
+
+  async validate(data: PromptsExportSection): Promise<ValidationResult> {
+    const issues: ValidationResult['issues'] = [];
+    if (data === null || typeof data !== 'object') {
+      return { valid: false, issues: [{ path: '$', message: 'prompts 数据必须是对象', severity: 'error' }] };
+    }
+    if (data.version !== 1) {
+      issues.push({ path: 'version', message: `version 必须为 1（收到 ${String(data.version)}）`, severity: 'error' });
+    }
+    if (!Array.isArray(data.prompts)) {
+      issues.push({ path: 'prompts', message: '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: 'prompt 记录必须含字符串 name 与 text', severity: 'error' });
+        }
+      }
+    }
+    return { valid: issues.filter((i) => i.severity === 'error').length === 0, issues };
+  }
+}