dsh-config-manager 0.1.0

package/lib/ui/export-flow.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Export 控制器（规范 §1 / §21，m6-ui）。
+ *
+ * 职责：
+ *  - Quick Export：推荐项 = defaultIncluded 且非 deviceSpecific 的分区（设计 §11.1）；
+ *  - Custom Export：按 §1 分组目录逐项勾选（含默认关闭的可选分区 pluginFiles/sessions）；
+ *  - 进度事件：调用 core 前后按 §29 阶段文案发出（UI 不冻结）；
+ *  - 结果：返回 ExportReport 并渲染 §21 文本报告。
+ *
+ * 依赖注入：ExportPort 由宿主在挂载时接入真实 Exporter（core/exporter.ts），
+ * 测试注入内存 mock —— 本层零依赖 core 实现。
+ */
+import type { Manifest, SectionId } from '../schema/types.ts';
+import type { ExportOptions, ExportReport } from '../core/types.ts';
+import { type ExportCategory, type ExportGroup, type ProgressListener } from './types.ts';
+/** UI → core 的导出端口（宿主注入 Exporter.export；测试注入 mock） */
+export interface ExportPort {
+    export(options: ExportOptions): Promise<{
+        zipPath: string;
+        manifest: Manifest;
+        report: ExportReport;
+    }>;
+}
+export interface ExportFlowOptions {
+    port: ExportPort;
+    /** 分类目录（缺省用内置目录，与 adapters 的 displayName/defaultIncluded/portability 对齐） */
+    categories?: ExportCategory[];
+    onProgress?: ProgressListener;
+}
+export interface ExportRunResult {
+    zipPath: string;
+    manifest: Manifest;
+    report: ExportReport;
+    /** §21 渲染文本（report.ts） */
+    text: string;
+}
+/** 内置分类目录（与 src/adapters/* 的 displayName/defaultIncluded/portability 对齐，研究报告 §2.2） */
+export declare const DEFAULT_CATEGORIES: readonly ExportCategory[];
+export declare class ExportFlow {
+    readonly categories: readonly ExportCategory[];
+    private readonly port;
+    private readonly onProgress;
+    constructor(opts: ExportFlowOptions);
+    /** Quick Export 推荐分区（defaultIncluded 且非 deviceSpecific） */
+    quickSelection(): SectionId[];
+    /** 按 §1 分组返回分类目录（Custom Export 树） */
+    groupedCatalog(): {
+        group: ExportGroup;
+        label: string;
+        note?: string;
+        categories: ExportCategory[];
+    }[];
+    /** 校验 Custom 勾选：未知分区 = invalid；deviceSpecific 分区给提示警告（仍可继续） */
+    validateSelection(selection: readonly SectionId[]): {
+        valid: boolean;
+        warnings: string[];
+    };
+    /** 执行导出：发进度事件 → 调 core → 渲染 §21 报告 */
+    run(mode: 'quick' | 'custom', selection: readonly SectionId[], opts?: {
+        includeSecrets?: boolean;
+    }): Promise<ExportRunResult>;
+}

package/lib/ui/export-flow.js

@@ -0,0 +1,79 @@
+import { EXPORT_GROUPS, isQuickRecommended, } from "./types.js";
+import { EXPORT_STAGES, ProgressTracker } from "./progress.js";
+import { renderExportReport } from "./report.js";
+/** 内置分类目录（与 src/adapters/* 的 displayName/defaultIncluded/portability 对齐，研究报告 §2.2） */
+export const DEFAULT_CATEGORIES = [
+    { id: 'settings', label: 'Settings', description: 'DSH 全局设置（namespace 分区，redacted）', defaultIncluded: true, portability: 'portable', group: 'general' },
+    { id: 'providers', label: 'Providers & Models', description: 'LLM Provider / Model / 默认模型 / BaseURL', defaultIncluded: true, portability: 'portable', group: 'ai' },
+    { id: 'plugins', label: 'Plugins', description: '已安装插件清单与启用状态（不含二进制）', defaultIncluded: true, portability: 'portable', group: 'extensions' },
+    { id: 'pluginFiles', label: 'Plugin Files', description: '插件自有配置文件（dsh-ssh.json 等，白名单）', defaultIncluded: false, portability: 'deviceSpecific', group: 'extensions' },
+    { id: 'mcp', label: 'MCP Servers', description: 'MCP 服务器组合配置（需重启生效）', defaultIncluded: true, portability: 'platformSpecific', group: 'mcp' },
+    { id: 'prompts', label: 'Prompts', description: 'System Prompt / Plan Mode 提示', defaultIncluded: true, portability: 'portable', group: 'customization' },
+    { id: 'skills', label: 'Skills', description: '用户技能文件（~/.dsh/skills）', defaultIncluded: true, portability: 'portable', group: 'customization' },
+    { id: 'agentPresets', label: 'Agent Presets', description: 'Agent 预设（~/.dsh/.agent-presets）', defaultIncluded: true, portability: 'portable', group: 'customization' },
+    { id: 'workspaces', label: 'Workspaces', description: '工作区记录（含绝对路径，需路径映射）', defaultIncluded: true, portability: 'platformSpecific', group: 'workspace' },
+    { id: 'ui', label: 'UI Preferences', description: 'UI 类 settings namespace（localStorage 项仅说明）', defaultIncluded: true, portability: 'portable', group: 'ui' },
+    { id: 'credentialsStatus', label: 'Credentials Status', description: '凭据状态（configured 标记，永不导出值）', defaultIncluded: true, portability: 'deviceSpecific', group: 'optional', sensitive: true },
+    { id: 'sessions', label: 'Sessions', description: '历史会话（默认关闭，含敏感内容）', defaultIncluded: false, portability: 'deviceSpecific', group: 'optional' },
+];
+export class ExportFlow {
+    categories;
+    port;
+    onProgress;
+    constructor(opts) {
+        this.port = opts.port;
+        this.categories = opts.categories ?? DEFAULT_CATEGORIES;
+        this.onProgress = opts.onProgress;
+    }
+    /** Quick Export 推荐分区（defaultIncluded 且非 deviceSpecific） */
+    quickSelection() {
+        return this.categories.filter(isQuickRecommended).map((c) => c.id);
+    }
+    /** 按 §1 分组返回分类目录（Custom Export 树） */
+    groupedCatalog() {
+        return EXPORT_GROUPS.map((g) => ({
+            group: g.id,
+            label: g.label,
+            note: g.note,
+            categories: this.categories.filter((c) => c.group === g.id),
+        }));
+    }
+    /** 校验 Custom 勾选：未知分区 = invalid；deviceSpecific 分区给提示警告（仍可继续） */
+    validateSelection(selection) {
+        const warnings = [];
+        let valid = true;
+        const known = new Set(this.categories.map((c) => c.id));
+        for (const id of selection) {
+            if (!known.has(id)) {
+                warnings.push(`未知分区：${id}`);
+                valid = false;
+            }
+        }
+        for (const c of this.categories) {
+            if (selection.includes(c.id) && c.portability === 'deviceSpecific') {
+                warnings.push(`${c.label} 为设备相关数据（${c.portability}），跨设备导入时可能不适用`);
+            }
+        }
+        return { valid, warnings };
+    }
+    /** 执行导出：发进度事件 → 调 core → 渲染 §21 报告 */
+    async run(mode, selection, opts = {}) {
+        const tracker = new ProgressTracker(EXPORT_STAGES, this.onProgress);
+        const only = mode === 'quick' ? this.quickSelection() : [...selection];
+        if (mode === 'quick' && opts.includeSecrets === undefined)
+            opts = { ...opts, includeSecrets: false };
+        tracker.emit('analyzing');
+        tracker.emit('exporting-settings');
+        tracker.emit('scanning-secrets');
+        tracker.emit('exporting-plugins');
+        tracker.emit('creating-archive');
+        tracker.emit('calculating-checksums');
+        const result = await this.port.export({
+            includeSecrets: opts.includeSecrets ?? false,
+            only,
+        });
+        tracker.emit('done');
+        return { ...result, text: renderExportReport(result.report) };
+    }
+}
+//# sourceMappingURL=export-flow.js.map

package/lib/ui/export-flow.js.map

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

package/lib/ui/import-wizard.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Import 向导状态机（规范 §9/§10/§28，m6-ui）。
+ *
+ * 步骤：Select ZIP → Analyzing → Compatibility → Import Preview → Resolve Conflicts
+ *       → Path Mapping → Secrets → Importing → Result。
+ *
+ * 关键安全/正确性约束：
+ *  - analyzeImport / createImportPlan 零写入（Dry Run 复用，规范 §10）；
+ *  - executeImportPlan 必须 confirm=true（core 安全阀），UI 在用户点「确认导入」后传入；
+ *  - **显式传 rollbackOnError**：场景 E（§36）要求导入中途失败整体回滚，
+ *    本向导默认 rollbackOnError=true，UI 可在执行前让用户选择（true=整体回滚 / false=单项失败继续 §34.17）；
+ *  - 秘密补录值仅内存（secretInputs），绝不落日志/落盘。
+ */
+import type { GlobalConflictStrategy, ImportAnalysis, ImportPlan, ImportResult, PathMapping, PlanItem } from '../core/types.ts';
+import type { ImportPort, ImportPreviewSummary, ImportStep, ProgressListener, WizardSnapshot } from './types.ts';
+export interface ImportWizardOptions {
+    port: ImportPort;
+    onProgress?: ProgressListener;
+    /** 默认回滚策略（场景 E：true=整体回滚；UI 可在执行前覆盖） */
+    defaultRollbackOnError?: boolean;
+}
+export declare class ImportWizard {
+    private readonly port;
+    private readonly onProgress;
+    private readonly tracker;
+    private step;
+    private zipPath;
+    private analysis;
+    private plan;
+    private result;
+    private rollbackOnError;
+    private errors;
+    private decisions;
+    private secretInputs;
+    constructor(opts: ImportWizardOptions);
+    /** 当前状态快照（React 绑定 / 测试断言用） */
+    snapshot(): WizardSnapshot;
+    get currentStep(): ImportStep;
+    /** 步骤 1-2：选 ZIP → Analyzing → Compatibility（analyzeImport 零写入） */
+    selectZip(path: string): Promise<ImportAnalysis>;
+    /** 步骤 3→4：用户确认兼容性后进入 Preview（Dry Run：用当前决策生成计划摘要，零写入） */
+    confirmCompatibility(): Promise<ImportPlan>;
+    /** 更新全局冲突策略（merge/replace/skipExisting，规范 §11） */
+    setStrategy(strategy: GlobalConflictStrategy): void;
+    /** 设置逐项冲突决策（keepCurrent/useImported/review） */
+    setResolutions(resolutions: Record<string, 'keepCurrent' | 'useImported' | 'review'>): void;
+    /** 设置路径映射（§12） */
+    setPathMappings(mappings: PathMapping[]): void;
+    /** 设置秘密补录值（仅内存，绝不持久化） */
+    setSecretInputs(inputs: Record<string, string>): void;
+    /** Preview 摘要（规范 §10 数值化；基于当前 plan 与 analysis） */
+    previewSummary(): ImportPreviewSummary;
+    /** 冲突项（供 ConflictCollector 使用） */
+    conflictItems(): PlanItem[];
+    /** 设置回滚策略（场景 E 选择；执行前调用） */
+    setRollbackOnError(enable: boolean): void;
+    /**
+     * 步骤 10-14：确认导入 → 快照 → 执行 → 校验 → 结果。
+     * 用最终决策重建计划（与预览一致），显式传 rollbackOnError。
+     */
+    execute(opts: {
+        confirm: boolean;
+        rollbackOnError?: boolean;
+    }): Promise<ImportResult>;
+    /** 重置向导（可复用实例开始新导入） */
+    reset(): void;
+}

package/lib/ui/import-wizard.js

@@ -0,0 +1,169 @@
+import { IMPORT_STAGES, ProgressTracker } from "./progress.js";
+import { formatActionableError, toActionableError } from "./errors.js";
+export class ImportWizard {
+    port;
+    onProgress;
+    tracker;
+    step = 'select';
+    zipPath = null;
+    analysis = null;
+    plan = null;
+    result = null;
+    rollbackOnError;
+    errors = [];
+    decisions = {
+        strategy: 'merge',
+        resolutions: {},
+        pathMappings: [],
+    };
+    secretInputs = {};
+    constructor(opts) {
+        this.port = opts.port;
+        this.onProgress = opts.onProgress;
+        this.tracker = new ProgressTracker(IMPORT_STAGES, this.onProgress);
+        this.rollbackOnError = opts.defaultRollbackOnError ?? true;
+    }
+    /** 当前状态快照（React 绑定 / 测试断言用） */
+    snapshot() {
+        return {
+            step: this.step,
+            zipPath: this.zipPath,
+            analysis: this.analysis,
+            plan: this.plan,
+            result: this.result,
+            rollbackOnError: this.rollbackOnError,
+            errors: [...this.errors],
+        };
+    }
+    get currentStep() {
+        return this.step;
+    }
+    /** 步骤 1-2：选 ZIP → Analyzing → Compatibility（analyzeImport 零写入） */
+    async selectZip(path) {
+        this.zipPath = path;
+        this.step = 'analyzing';
+        this.tracker.emit('validating');
+        this.errors = [];
+        try {
+            this.analysis = await this.port.analyzeImport(path);
+            this.tracker.emit('checking-compatibility');
+            if (!this.analysis.valid) {
+                // 分析失败（完整性/schema/兼容性）：错误进 errors，UI 停在失败态
+                this.errors.push(...this.analysis.errors.map((e) => formatActionableError(toActionableError(new Error(e)))));
+                throw new Error(this.analysis.errors.join('; ') || '备份分析失败');
+            }
+            this.step = 'compatibility';
+            return this.analysis;
+        }
+        catch (err) {
+            // 仅当尚未记录分析错误时才追加（避免重复）
+            if (this.errors.length === 0) {
+                this.errors.push(formatActionableError(toActionableError(err)));
+            }
+            throw err;
+        }
+    }
+    /** 步骤 3→4：用户确认兼容性后进入 Preview（Dry Run：用当前决策生成计划摘要，零写入） */
+    async confirmCompatibility() {
+        if (this.analysis === null || this.zipPath === null) {
+            throw new Error('尚未完成分析，请先选择备份文件');
+        }
+        this.plan = await this.port.createImportPlan(this.zipPath, this.decisions);
+        this.step = 'preview';
+        return this.plan;
+    }
+    /** 更新全局冲突策略（merge/replace/skipExisting，规范 §11） */
+    setStrategy(strategy) {
+        this.decisions = { ...this.decisions, strategy };
+    }
+    /** 设置逐项冲突决策（keepCurrent/useImported/review） */
+    setResolutions(resolutions) {
+        this.decisions = { ...this.decisions, resolutions };
+    }
+    /** 设置路径映射（§12） */
+    setPathMappings(mappings) {
+        this.decisions = { ...this.decisions, pathMappings: mappings };
+    }
+    /** 设置秘密补录值（仅内存，绝不持久化） */
+    setSecretInputs(inputs) {
+        this.secretInputs = inputs;
+    }
+    /** Preview 摘要（规范 §10 数值化；基于当前 plan 与 analysis） */
+    previewSummary() {
+        const items = this.plan?.items ?? [];
+        const analysis = this.analysis;
+        const count = (kinds) => items.filter((i) => kinds.includes(i.kind)).length;
+        return {
+            willChange: count(['Create', 'Update', 'Install', 'Conflict']),
+            unchanged: count(['Skip']),
+            settingsUpdates: count(['Create', 'Update']),
+            pluginsInstalled: analysis?.pluginSummary.installed ?? 0,
+            pluginsToInstall: count(['Install']),
+            mcpAdds: items.filter((i) => i.adapter === 'mcp' && i.kind === 'Create').length,
+            prompts: items.filter((i) => i.adapter === 'prompts' && i.kind !== 'Skip').length,
+            pathMappingsNeeded: analysis?.pathIssues.length ?? 0,
+            secretsNeeded: this.plan?.missingSecrets.length ?? analysis?.secretCount ?? 0,
+            conflicts: count(['Conflict']),
+            needsRestart: this.plan?.needsRestart ?? false,
+        };
+    }
+    /** 冲突项（供 ConflictCollector 使用） */
+    conflictItems() {
+        return (this.plan?.items ?? []).filter((i) => i.kind === 'Conflict');
+    }
+    /** 设置回滚策略（场景 E 选择；执行前调用） */
+    setRollbackOnError(enable) {
+        this.rollbackOnError = enable;
+    }
+    /**
+     * 步骤 10-14：确认导入 → 快照 → 执行 → 校验 → 结果。
+     * 用最终决策重建计划（与预览一致），显式传 rollbackOnError。
+     */
+    async execute(opts) {
+        if (this.zipPath === null || this.analysis === null) {
+            throw new Error('尚未完成分析，请先选择备份文件');
+        }
+        if (opts.confirm !== true) {
+            throw new Error('导入未确认：必须确认后才允许修改任何数据');
+        }
+        const rollbackOnError = opts.rollbackOnError ?? this.rollbackOnError;
+        this.step = 'importing';
+        this.tracker.emit('creating-snapshot');
+        try {
+            // 用最终决策重建计划（与预览逻辑一致，保证 Dry Run 与真实导入一致）
+            this.plan = await this.port.createImportPlan(this.zipPath, this.decisions);
+            this.tracker.emit('restoring-settings');
+            this.tracker.emit('restoring-plugins');
+            this.tracker.emit('restoring-mcp');
+            this.tracker.emit('validating-config');
+            this.result = await this.port.executeImportPlan(this.zipPath, this.plan, {
+                confirm: true,
+                secretInputs: this.secretInputs,
+                rollbackOnError,
+            });
+            // 失败且已整体回滚（场景 E）→ 报告回滚阶段
+            if (!this.result.ok && this.result.rollback) {
+                this.tracker.emit('rolling-back');
+            }
+            this.tracker.emit('done');
+            this.step = 'result';
+            return this.result;
+        }
+        catch (err) {
+            this.errors.push(formatActionableError(toActionableError(err)));
+            throw err;
+        }
+    }
+    /** 重置向导（可复用实例开始新导入） */
+    reset() {
+        this.step = 'select';
+        this.zipPath = null;
+        this.analysis = null;
+        this.plan = null;
+        this.result = null;
+        this.errors = [];
+        this.decisions = { strategy: 'merge', resolutions: {}, pathMappings: [] };
+        this.secretInputs = {};
+    }
+}
+//# sourceMappingURL=import-wizard.js.map

package/lib/ui/import-wizard.js.map

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

package/lib/ui/path-mapping.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 路径映射编辑器（规范 §12，m6-ui）。
+ *
+ * 两种形态（§12 批量映射优先）：
+ *  - 单项映射：某条具体 PathIssue（如 workspace 绝对路径）→ 新路径；
+ *  - 批量前缀映射：oldPrefix → newPrefix，一次替换全部相关路径。
+ *
+ * 输出 core PathMapping[]：newPrefix 非空的映射才进入执行计划
+ * （core mergePathMappings 只保留已解析映射；未解析项保留在 plan.items 供 UI 提示）。
+ * 应用范围 appliesTo 缺省 []（全部相关分区），与 core applyMappingsToSections 语义一致。
+ */
+import type { PathIssue, PathMapping } from '../core/types.ts';
+import type { PathMappingAppliesTo, PathMappingDraft } from './types.ts';
+export interface PathMappingEditorOptions {
+    /** 从分析结果得到的路径问题 */
+    issues?: PathIssue[];
+    /** 预置映射（如上次导入可复用的映射） */
+    existing?: PathMapping[];
+}
+export declare class PathMappingEditor {
+    private readonly issues;
+    private drafts;
+    constructor(opts?: PathMappingEditorOptions);
+    /** 全部草稿（含未解析） */
+    get all(): PathMappingDraft[];
+    /** 已解析（newPrefix 非空）的草稿 */
+    get resolved(): PathMappingDraft[];
+    /** 未解析的问题（UI 需提示用户选择文件夹；按「是否被已解析映射覆盖」判断，批量前缀映射一次覆盖多条） */
+    get unresolved(): PathIssue[];
+    /** 单项/批量设置映射（oldPrefix 已存在则更新；否则新建批量映射） */
+    setMapping(oldPrefix: string, newPrefix: string, appliesTo?: PathMappingAppliesTo[]): void;
+    /** 对某个具体值应用当前映射，返回替换结果（预览用；无映射则原样返回） */
+    preview(value: string): string;
+    /** 未解析项是否可进入执行（false = 有路径问题未解决） */
+    get isComplete(): boolean;
+    /** 输出 core PathMapping[]（仅已解析项） */
+    toPathMappings(): PathMapping[];
+}

package/lib/ui/path-mapping.js

@@ -0,0 +1,75 @@
+import { applyPrefixMappings } from "../utils/paths.js";
+export class PathMappingEditor {
+    issues;
+    drafts = new Map();
+    constructor(opts = {}) {
+        this.issues = opts.issues ?? [];
+        for (const issue of this.issues) {
+            this.drafts.set(issue.value, {
+                oldPrefix: issue.value,
+                newPrefix: issue.mappedTo ?? '',
+                issue,
+                appliesTo: [],
+            });
+        }
+        // 批量映射按 oldPrefix 聚合（一个 oldPrefix 一条 draft）
+        for (const m of opts.existing ?? []) {
+            const prev = this.drafts.get(m.oldPrefix);
+            this.drafts.set(m.oldPrefix, {
+                oldPrefix: m.oldPrefix,
+                newPrefix: m.newPrefix,
+                appliesTo: [...m.appliesTo],
+            });
+            void prev;
+        }
+    }
+    /** 全部草稿（含未解析） */
+    get all() {
+        return [...this.drafts.values()];
+    }
+    /** 已解析（newPrefix 非空）的草稿 */
+    get resolved() {
+        return this.all.filter((d) => d.newPrefix !== '');
+    }
+    /** 未解析的问题（UI 需提示用户选择文件夹；按「是否被已解析映射覆盖」判断，批量前缀映射一次覆盖多条） */
+    get unresolved() {
+        const mappings = this.toPathMappings();
+        return (this.issues ?? []).filter((issue) => {
+            const mapped = applyPrefixMappings(issue.value, mappings);
+            return mapped === issue.value;
+        });
+    }
+    /** 单项/批量设置映射（oldPrefix 已存在则更新；否则新建批量映射） */
+    setMapping(oldPrefix, newPrefix, appliesTo = []) {
+        const existing = this.drafts.get(oldPrefix);
+        this.drafts.set(oldPrefix, {
+            oldPrefix,
+            newPrefix,
+            appliesTo,
+            issue: existing?.issue,
+        });
+    }
+    /** 对某个具体值应用当前映射，返回替换结果（预览用；无映射则原样返回） */
+    preview(value) {
+        const resolved = this.resolved.map((d) => ({
+            oldPrefix: d.oldPrefix,
+            newPrefix: d.newPrefix,
+            appliesTo: d.appliesTo,
+        }));
+        const mapped = applyPrefixMappings(value, resolved);
+        return typeof mapped === 'string' ? mapped : value;
+    }
+    /** 未解析项是否可进入执行（false = 有路径问题未解决） */
+    get isComplete() {
+        return this.unresolved.length === 0;
+    }
+    /** 输出 core PathMapping[]（仅已解析项） */
+    toPathMappings() {
+        return this.resolved.map((d) => ({
+            oldPrefix: d.oldPrefix,
+            newPrefix: d.newPrefix,
+            appliesTo: d.appliesTo,
+        }));
+    }
+}
+//# sourceMappingURL=path-mapping.js.map

package/lib/ui/path-mapping.js.map

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

package/lib/ui/progress.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 进度阶段文案与进度追踪（规范 §29，m6-ui）。
+ *
+ * 纯文本层：每个阶段 id 有默认文案；未知阶段回退显示 id 本身。
+ * ProgressTracker 供导出/导入控制器在调用 core 前后发出阶段事件（UI 不冻结）。
+ */
+import type { ProgressListener } from './types.ts';
+/** 导出阶段文案（规范 §29 Export 示例） */
+export declare const EXPORT_STAGES: readonly string[];
+/** 导入阶段文案（规范 §29 Import 示例 + 快照/回滚阶段） */
+export declare const IMPORT_STAGES: readonly string[];
+/** 阶段 id → 用户可读文案（未知阶段回退 id） */
+export declare function stageText(stage: string): string;
+/**
+ * 进度追踪器：按给定阶段序列在回调时附带 step/total 序号。
+ * 控制器调用 core 前后 emit()，UI 侧渲染进度条/阶段文字。
+ */
+export declare class ProgressTracker {
+    private readonly listener;
+    private readonly stages;
+    private readonly emitted;
+    constructor(stages: readonly string[], listener?: ProgressListener);
+    /** 发出某阶段事件（可携带 detail）；未在序列中的阶段 step/total 缺省 */
+    emit(stage: string, detail?: string): void;
+    /** 已发出阶段的快照（测试与日志用） */
+    get events(): readonly string[];
+}

package/lib/ui/progress.js

@@ -0,0 +1,76 @@
+/** 导出阶段文案（规范 §29 Export 示例） */
+export const EXPORT_STAGES = [
+    'analyzing', // Analyzing configuration...
+    'exporting-settings', // Exporting settings...
+    'scanning-secrets', // Scanning secrets...
+    'exporting-plugins', // Exporting plugins...
+    'creating-archive', // Creating archive...
+    'calculating-checksums', // Calculating checksums...
+    'done',
+];
+/** 导入阶段文案（规范 §29 Import 示例 + 快照/回滚阶段） */
+export const IMPORT_STAGES = [
+    'validating', // Validating backup...
+    'checking-compatibility', // Checking compatibility...
+    'creating-snapshot', // Creating safety snapshot...
+    'restoring-settings', // Restoring settings...
+    'restoring-plugins', // Restoring plugins...
+    'restoring-mcp', // Restoring MCP...
+    'validating-config', // Validating configuration...
+    'rolling-back', // Rolling back...（仅失败回滚时）
+    'done',
+];
+const STAGE_TEXTS = {
+    // export
+    'analyzing': 'Analyzing configuration...',
+    'exporting-settings': 'Exporting settings...',
+    'scanning-secrets': 'Scanning secrets...',
+    'exporting-plugins': 'Exporting plugins...',
+    'creating-archive': 'Creating archive...',
+    'calculating-checksums': 'Calculating checksums...',
+    // import
+    'validating': 'Validating backup...',
+    'checking-compatibility': 'Checking compatibility...',
+    'creating-snapshot': 'Creating safety snapshot...',
+    'restoring-settings': 'Restoring settings...',
+    'restoring-plugins': 'Restoring plugins...',
+    'restoring-mcp': 'Restoring MCP...',
+    'validating-config': 'Validating configuration...',
+    'rolling-back': 'Rolling back...',
+    // common
+    'done': 'Done',
+};
+/** 阶段 id → 用户可读文案（未知阶段回退 id） */
+export function stageText(stage) {
+    return STAGE_TEXTS[stage] ?? stage;
+}
+/**
+ * 进度追踪器：按给定阶段序列在回调时附带 step/total 序号。
+ * 控制器调用 core 前后 emit()，UI 侧渲染进度条/阶段文字。
+ */
+export class ProgressTracker {
+    listener;
+    stages;
+    emitted = [];
+    constructor(stages, listener) {
+        this.stages = stages;
+        this.listener = listener;
+    }
+    /** 发出某阶段事件（可携带 detail）；未在序列中的阶段 step/total 缺省 */
+    emit(stage, detail) {
+        const idx = this.stages.indexOf(stage);
+        const event = {
+            stage,
+            detail,
+            step: idx >= 0 ? idx + 1 : undefined,
+            total: idx >= 0 ? this.stages.length : undefined,
+        };
+        this.emitted.push(stage);
+        this.listener?.(event);
+    }
+    /** 已发出阶段的快照（测试与日志用） */
+    get events() {
+        return [...this.emitted];
+    }
+}
+//# sourceMappingURL=progress.js.map

package/lib/ui/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/ui/progress.ts"],"names":[],"mappings":"AAQA,+BAA+B;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,WAAW,EAAY,6BAA6B;IACpD,oBAAoB,EAAG,wBAAwB;IAC/C,kBAAkB,EAAK,sBAAsB;IAC7C,mBAAmB,EAAI,uBAAuB;IAC9C,kBAAkB,EAAK,sBAAsB;IAC7C,uBAAuB,EAAE,2BAA2B;IACpD,MAAM;CACE,CAAC;AAEX,yCAAyC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,YAAY,EAAW,uBAAuB;IAC9C,wBAAwB,EAAE,4BAA4B;IACtD,mBAAmB,EAAI,8BAA8B;IACrD,oBAAoB,EAAG,wBAAwB;IAC/C,mBAAmB,EAAI,uBAAuB;IAC9C,eAAe,EAAQ,mBAAmB;IAC1C,mBAAmB,EAAI,8BAA8B;IACrD,cAAc,EAAS,0BAA0B;IACjD,MAAM;CACE,CAAC;AAEX,MAAM,WAAW,GAA2B;IAC1C,SAAS;IACT,WAAW,EAAE,4BAA4B;IACzC,oBAAoB,EAAE,uBAAuB;IAC7C,kBAAkB,EAAE,qBAAqB;IACzC,mBAAmB,EAAE,sBAAsB;IAC3C,kBAAkB,EAAE,qBAAqB;IACzC,uBAAuB,EAAE,0BAA0B;IACnD,SAAS;IACT,YAAY,EAAE,sBAAsB;IACpC,wBAAwB,EAAE,2BAA2B;IACrD,mBAAmB,EAAE,6BAA6B;IAClD,oBAAoB,EAAE,uBAAuB;IAC7C,mBAAmB,EAAE,sBAAsB;IAC3C,eAAe,EAAE,kBAAkB;IACnC,mBAAmB,EAAE,6BAA6B;IAClD,cAAc,EAAE,iBAAiB;IACjC,SAAS;IACT,MAAM,EAAE,MAAM;CACf,CAAC;AAEF,gCAAgC;AAChC,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,QAAQ,CAA+B;IACvC,MAAM,CAAoB;IAC1B,OAAO,GAAa,EAAE,CAAC;IAExC,YAAY,MAAyB,EAAE,QAA2B;QAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC,KAAa,EAAE,MAAe;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,KAAK,GAAkB;YAC3B,KAAK;YACL,MAAM;YACN,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YACpC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACjD,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF"}