@logictan/dsh-config-manager 0.1.60

package/lib/ui/errors.js

@@ -0,0 +1,81 @@
+/**
+ * 可操作错误模型（规范 §23，m6-ui）。
+ *
+ * 绝不只有 "Something went wrong."：
+ *  - 解析错误 → Reason + Suggested action（可操作）；
+ *  - 输出前强制脱敏（redact），Secret 永不进入 UI/日志；
+ *  - 文案经 UiT 注入（zh 源 / en 镜像，见 i18n.ts）。
+ */
+import { redact } from '../security/redaction.js';
+import { zhUiT } from './i18n.js';
+function buildErrorRules(t) {
+    return [
+        {
+            match: (m) => /SETTINGS_CONFLICT|revision.*conflict/i.test(m),
+            title: t('error.settingsConflict.title'),
+            suggestedAction: t('error.settingsConflict.action'),
+            retryable: true,
+        },
+        {
+            match: (m) => /ImportNotConfirmed|未确认/i.test(m),
+            title: t('error.notConfirmed.title'),
+            suggestedAction: t('error.notConfirmed.action'),
+            retryable: true,
+        },
+        {
+            match: (m) => /backup integrity|完整性校验失败|checksum/i.test(m),
+            title: t('error.integrity.title'),
+            suggestedAction: t('error.integrity.action'),
+            retryable: false,
+        },
+        {
+            match: (m) => /schema.*(不支持|超出)|无法导入|Unsupported|schemaUnsupported|无法导入/i.test(m),
+            title: t('error.schema.title'),
+            suggestedAction: t('error.schema.action'),
+            retryable: false,
+        },
+        {
+            match: (m) => /ENOENT|not found|无法读取|不存在|readFailed/i.test(m),
+            title: t('error.notFound.title'),
+            suggestedAction: t('error.notFound.action'),
+            retryable: true,
+        },
+        {
+            match: (m) => /EACCES|permission|权限/i.test(m),
+            title: t('error.permission.title'),
+            suggestedAction: t('error.permission.action'),
+            retryable: true,
+        },
+        {
+            match: (m) => /install.*(plugin|插件)|needsRestart|重启/i.test(m),
+            title: t('error.needsRestart.title'),
+            suggestedAction: t('error.needsRestart.action'),
+            retryable: false,
+        },
+    ];
+}
+/** 将任意错误转换为可操作错误（消息已脱敏，不泄漏 Secret） */
+export function toActionableError(err, opts) {
+    const t = opts?.t ?? zhUiT;
+    const raw = err instanceof Error ? err.message : String(err ?? t('commonUnknownError'));
+    const message = redact(raw);
+    const rule = buildErrorRules(t).find((r) => r.match(message));
+    return {
+        title: rule?.title ?? opts?.fallbackTitle ?? t('error.fallback'),
+        reason: message,
+        suggestedAction: rule?.suggestedAction,
+        item: opts?.item !== undefined ? redact(opts.item) : undefined,
+        retryable: rule?.retryable ?? true,
+    };
+}
+/** 格式化为用户可读的多行文本（Reason / Suggested action） */
+export function formatActionableError(e, t = zhUiT) {
+    const lines = [e.title];
+    lines.push(`${t('error.reason')}: ${e.reason}`);
+    if (e.suggestedAction)
+        lines.push(`${t('error.suggestedAction')}: ${e.suggestedAction}`);
+    if (e.item)
+        lines.push(`${t('error.item')}: ${e.item}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1,82 @@
+/**
+ * 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';
+import { type UiT } from './i18n.ts';
+/** UI → core 的导出端口（宿主注入 Exporter.export；测试注入 mock） */
+export interface ExportPort {
+    export(options: ExportOptions): Promise<{
+        zipPath: string;
+        manifest: Manifest;
+        report: ExportReport;
+    }>;
+}
+/**
+ * 自定义导出文件名的归一化（P0-④ 体验优化）：无需用户手动输入 `.zip`。
+ * - trim 首尾空白；空串 → ''（宿主自动命名）；
+ * - 非空且未以 `.zip` 结尾 → 自动补全 `.zip`（大小写不敏感判定，统一补小写后缀）；
+ * - 已以 `.zip` 结尾 → 原样返回（含首字符为字母数字的校验由调用方/宿主把关）。
+ */
+export declare function normalizeExportFileName(raw: string): string;
+/** 导出附加选项（P0-④：自定义文件名/备注——经 ExportFlow.run 透传给 host /export） */
+export interface ExportExtraOptions {
+    /** 自定义导出文件名（.zip；缺省宿主自动命名） */
+    fileName?: string;
+    /** 导出备注（写入 exports/.backup-notes.json；缺省无） */
+    note?: string;
+}
+export interface ExportFlowOptions {
+    port: ExportPort;
+    /** 分类目录（缺省用内置目录，与 adapters 的 displayName/defaultIncluded/portability 对齐） */
+    categories?: ExportCategory[];
+    onProgress?: ProgressListener;
+    /** 报告渲染翻译器（zh/en，见 i18n.ts） */
+    t?: UiT;
+}
+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;
+    private readonly t;
+    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;
+        fileName?: string;
+        note?: string;
+    }): Promise<ExportRunResult>;
+}

package/lib/ui/export-flow.js

@@ -0,0 +1,98 @@
+import { EXPORT_GROUPS, isQuickRecommended, } from './types.js';
+import { EXPORT_STAGES, ProgressTracker } from './progress.js';
+import { renderExportReport } from './report.js';
+import { zhUiT } from './i18n.js';
+/**
+ * 自定义导出文件名的归一化（P0-④ 体验优化）：无需用户手动输入 `.zip`。
+ * - trim 首尾空白；空串 → ''（宿主自动命名）；
+ * - 非空且未以 `.zip` 结尾 → 自动补全 `.zip`（大小写不敏感判定，统一补小写后缀）；
+ * - 已以 `.zip` 结尾 → 原样返回（含首字符为字母数字的校验由调用方/宿主把关）。
+ */
+export function normalizeExportFileName(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return '';
+    return /\.zip$/i.test(trimmed) ? trimmed : `${trimmed}.zip`;
+}
+/** 内置分类目录（与 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: '插件自有配置文件（白名单 + plugin-config/ 目录，整文件复制）', defaultIncluded: false, portability: 'deviceSpecific', group: 'extensions' },
+    { id: 'self', label: 'Plugin Self Config', description: '本插件自身配置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）', defaultIncluded: true, portability: 'portable', 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: 'agentInstructions', label: 'Agent Instructions', description: '全局指令文件（~/.dsh/AGENTS.md，注入每个会话）', 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;
+    t;
+    constructor(opts) {
+        this.port = opts.port;
+        this.categories = opts.categories ?? DEFAULT_CATEGORIES;
+        this.onProgress = opts.onProgress;
+        this.t = opts.t ?? zhUiT;
+    }
+    /** 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 };
+        // 导出工作全部发生在 port.export() 的单次请求内，客户端无法逐阶段上报真实进度。
+        // 旧实现把整串阶段一次性 emit，请求期间 UI 会静止在假的「Calculating checksums... 86%」，
+        // 任何慢请求/挂起请求看起来都像卡死。改为：请求期间只发一个不带 step/total 的 in-flight
+        // 阶段（ProgressBar 显示不定态动画），完成后发 done（100%）。超时/失败由 api 层显式抛出。
+        tracker.emit('exporting');
+        const result = await this.port.export({
+            includeSecrets: opts.includeSecrets ?? false,
+            only,
+            // P0-④：透传自定义文件名/备注（非敏感；host 做安全校验与持久化）
+            ...(opts.fileName !== undefined && opts.fileName !== '' ? { outPath: opts.fileName } : {}),
+            ...(opts.note !== undefined ? { note: opts.note } : {}),
+        });
+        tracker.emit('done');
+        return { ...result, text: renderExportReport(result.report, this.t) };
+    }
+}
+//# sourceMappingURL=export-flow.js.map

package/lib/ui/i18n.d.ts

@@ -0,0 +1,289 @@
+/**
+ * 客户端展示层（src/ui/*、src/client/common/*）的渲染文案目录（zh 源语言 / en 镜像）。
+ *
+ * 与 core 的 messages.ts 分工：本目录负责「客户端纯渲染层」（ReportView / ErrorBanner /
+ * ProgressBar / sync-view）产生的中文文案；core 侧引擎消息已随 API 数据源翻译。
+ * 这些纯函数原先直接内嵌中文，现经 UiDict 注入：Client 挂载时按 ctx.locale 提供。
+ *
+ * 纪律：
+ *  - TextKey 类型 = keyof typeof uiZh，en 缺键/多键即编译错误；
+ *  - {param} 插值，缺参原样保留。
+ */
+export declare const uiZh: {
+    readonly commonClose: '关闭';
+    readonly commonCancel: '取消';
+    readonly commonRetry: '重试';
+    readonly commonLoading: '加载中…';
+    readonly commonUnknownError: '未知错误';
+    readonly commonNext: '下一步';
+    readonly commonBack: '上一步';
+    readonly commonDone: '完成';
+    readonly 'export.download': '下载备份文件';
+    readonly 'export.running': '正在导出…';
+    readonly 'export.run': '开始导出';
+    readonly 'export.selectionWarnings': '以下分区为设备相关数据，跨设备导入时可能不适用：';
+    readonly 'export.included': '已包含';
+    readonly 'export.excluded': '未包含';
+    readonly 'export.unknownSection': '未知分区：{id}';
+    readonly 'export.deviceSpecific': '{label} 为设备相关数据（{portability}），跨设备导入时可能不适用';
+    readonly 'report.backupCreated': '备份已创建';
+    readonly 'report.importComplete': '导入完成';
+    readonly 'report.importFailed': '导入失败';
+    readonly 'report.tombstonedSkipped': '已按删除记录跳过 {count} 项';
+    readonly 'report.included': '已包含：';
+    readonly 'report.excluded': '未包含：';
+    readonly 'report.security': '安全：';
+    readonly 'report.apiKeysExcluded': 'API 密钥已排除：';
+    readonly 'report.containsSecrets': '包含密钥：';
+    readonly 'report.encrypted': '已加密：';
+    readonly 'report.redacted': '{count} 个敏感字段已脱敏';
+    readonly 'report.file': '文件：';
+    readonly 'report.yes': '是';
+    readonly 'report.yesEncrypted': '是（加密）';
+    readonly 'report.no': '否';
+    readonly 'report.importedRestored': '已导入/恢复';
+    readonly 'report.skipped': '跳过';
+    readonly 'report.needAttention': '需注意';
+    readonly 'report.failed': '失败';
+    readonly 'report.noChanges': '无变更';
+    readonly 'report.reason': '原因';
+    readonly 'report.note': '说明';
+    readonly 'report.unknownReason': '未知原因';
+    readonly 'report.secrets': '密钥：';
+    readonly 'report.credentialsNeedEntry': '{count} 个凭据需要补录';
+    readonly 'report.restartRequired': '重启 DSH 后生效：{detail}';
+    readonly 'report.restartPluginsMcp': '插件/MCP 更改将在重启 DSH 后生效';
+    readonly 'report.rollbackFull': '回滚：已完整恢复导入前的配置。';
+    readonly 'report.rollbackPartial': '回滚部分完成。';
+    readonly 'report.rollbackManual': '以下项目可能需要人工恢复：';
+    readonly 'report.restored': '已恢复：{count} 项';
+    readonly 'error.notMounted': 'config-manager 服务未挂载（插件未加载）：请确认 profile 中已安装 dsh-config-manager 并重启 DSH';
+    readonly 'error.httpInvalidJson': 'HTTP {status}: 无效的 JSON 响应';
+    readonly 'error.fallback': '操作失败';
+    readonly 'error.downloadFailed': '下载失败：HTTP {status}';
+    readonly 'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态';
+    readonly 'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试';
+    readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态';
+    readonly 'error.lifecycleTimeout': '灾备请求超时（{minutes} 分钟）：撤销/重做未完成，请重试；若反复超时请检查 DSH 状态';
+    readonly 'error.settingsConflict.title': '配置已被并发修改';
+    readonly 'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。';
+    readonly 'error.notConfirmed.title': '导入未确认';
+    readonly 'error.notConfirmed.action': '请在预览页确认导入内容后重试。';
+    readonly 'error.integrity.title': '备份完整性校验失败';
+    readonly 'error.integrity.action': '备份文件可能已损坏或被篡改，请重新导出备份后再试。';
+    readonly 'error.schema.title': '备份格式版本不受支持';
+    readonly 'error.schema.action': '请升级 DSH Config Manager 或使用相同版本的备份文件。';
+    readonly 'error.notFound.title': '文件或路径不存在';
+    readonly 'error.notFound.action': '请检查文件路径是否正确、文件是否已被移动或删除。';
+    readonly 'error.permission.title': '权限不足';
+    readonly 'error.permission.action': '请检查目标目录的读写权限后重试。';
+    readonly 'error.needsRestart.title': '插件代码更新需要重启生效';
+    readonly 'error.needsRestart.action': '导入已完成；patch / settings 由宿主热重载即时生效，但被覆盖安装的插件包代码需重启 DSH 后才生效。';
+    readonly 'error.reason': '原因';
+    readonly 'error.suggestedAction': '建议操作';
+    readonly 'error.item': '相关项';
+    readonly 'progress.analyzing': '正在分析配置…';
+    readonly 'progress.exportingSettings': '正在导出设置…';
+    readonly 'progress.scanningSecrets': '正在扫描密钥…';
+    readonly 'progress.exportingPlugins': '正在导出插件…';
+    readonly 'progress.creatingArchive': '正在创建归档…';
+    readonly 'progress.calculatingChecksums': '正在核对文件完整性…';
+    readonly 'progress.exporting': '正在导出配置…';
+    readonly 'progress.validating': '正在校验备份…';
+    readonly 'progress.checkingCompatibility': '正在检查兼容性…';
+    readonly 'progress.creatingSnapshot': '正在创建安全快照…';
+    readonly 'progress.restoringSettings': '正在恢复设置…';
+    readonly 'progress.restoringPlugins': '正在恢复插件…';
+    readonly 'progress.restoringMcp': '正在恢复 MCP…';
+    readonly 'progress.validatingConfig': '正在校验配置…';
+    readonly 'progress.rollingBack': '正在回滚…';
+    readonly 'progress.executing': '正在应用配置（插件安装可能需要较长时间）…';
+    readonly 'progress.done': '完成';
+    readonly 'snapshots.createdAt': '创建时间';
+    readonly 'snapshots.sourceZip': '来源';
+    readonly 'snapshots.status': '状态';
+    readonly 'snapshots.entries': '条目';
+    readonly 'snapshots.plugins': '插件';
+    readonly 'snapshots.statusPending': '待处理';
+    readonly 'snapshots.statusDone': '已完成';
+    readonly 'snapshots.statusRolledback': '已回滚';
+    readonly 'snapshots.statusUnknown': '未知';
+    readonly 'snapshots.planTitle': '恢复计划预览';
+    readonly 'snapshots.confirmRestore': '确认恢复？会先把当前文件备份到一个安全位置，再删除导入期间新增的插件。';
+    readonly 'snapshots.execute': '执行恢复';
+    readonly 'snapshots.executing': '正在恢复…';
+    readonly 'snapshots.restored': '已恢复';
+    readonly 'snapshots.removedPlugins': '已卸载插件';
+    readonly 'snapshots.manualHints': '需人工处理';
+    readonly 'snapshots.failed': '失败';
+    readonly 'snapshots.skipped': '跳过';
+    readonly 'snapshots.noActions': '该快照无可恢复动作（或全部跳过）。';
+    readonly 'snapshots.empty': '暂无快照。导入时会自动创建安全快照。';
+    readonly 'snapshots.loading': '正在加载快照…';
+    readonly 'snapshots.selectHint': '选择一个快照预览其恢复计划（只读预览，不会改动任何设置）：';
+    readonly 'snapshots.reportTitle': '恢复报告';
+    readonly 'sync.privateRepoHint': '安全要求：同步仓库必须为私有仓库（public 仓库会公开你的配置内容）。认证 token 仅用于仓库访问，绝不写入同步文件、提交内容或日志。';
+    readonly 'sync.kind.create': '新增';
+    readonly 'sync.kind.update': '更新';
+    readonly 'sync.kind.skip': '跳过';
+    readonly 'sync.kind.conflict': '冲突';
+    readonly 'sync.kind.install': '安装';
+    readonly 'sync.kind.missingSecret': '缺密钥';
+    readonly 'sync.kind.missingDependency': '缺依赖';
+    readonly 'sync.kind.pathMapping': '路径映射';
+    readonly 'sync.kind.warning': '警告';
+    readonly 'sync.kind.error': '错误';
+    readonly 'sync.severity.error': '错误';
+    readonly 'sync.severity.warning': '警告';
+    readonly 'sync.severity.info': '信息';
+    readonly 'sync.pushLabel': '推送到远端';
+    readonly 'sync.pullLabel': '拉取差异预览';
+    readonly 'sync.pushing': '正在推送…';
+    readonly 'sync.pulling': '正在拉取…';
+    readonly 'sync.statusLoading': '正在读取同步状态…';
+    readonly 'sync.statusUnconfigured': '尚未配置同步仓库（请填写仓库地址并推送一次以保存配置）';
+    readonly 'sync.credConfigured': '凭据已配置';
+    readonly 'sync.credMissing': '未配置凭据（token 将在首次推送/拉取时写入 DSH credentials）';
+    readonly 'sync.lastSync': '上次同步：{time}';
+    readonly 'sync.neverSynced': '尚未同步过';
+    readonly 'sync.neverSyncedShort': '从未同步';
+    readonly 'sync.pushFailed': '推送失败';
+    readonly 'sync.pushOk': '推送成功（快照 {id}）';
+    readonly 'sync.pushPreviewHeadline': '将推送 {total} 个分区（{changed} 个有变化）';
+    readonly 'sync.pushPreviewHint': '以上为只读预览，不会写入远端。确认后点击「推送」才真正上传。';
+    readonly 'sync.pushPreviewEncrypted': '加密快照：载荷将整体加密，各分区相对基线的变化不可比对。';
+    readonly 'sync.pullFailed': '拉取失败';
+    readonly 'sync.pullOk': '远端快照 {id} 差异预览：共 {count} 项变更';
+    readonly 'sync.pullEmpty': '远端快照与本地一致（无变更）';
+    readonly 'sync.previewHint': '以上为只读差异预览，不会执行导入。当前版本暂不支持一键导入；如需应用远端配置，请使用「导入恢复」向导手动导入导出的备份。';
+    readonly 'sync.syncTitle': '一键同步';
+    readonly 'sync.syncButton': '一键同步';
+    readonly 'sync.syncing': '正在同步…';
+    readonly 'sync.syncHeadline': '远端快照 {id} 差异确认：共 {count} 项';
+    readonly 'sync.syncEmpty': '远端快照与本地一致（无变更）';
+    readonly 'sync.syncFailed': '同步失败';
+    readonly 'sync.confirmAdopt': '采用远端';
+    readonly 'sync.confirmSkip': '跳过';
+    readonly 'sync.confirmRequired': '需要人工决策';
+    readonly 'sync.needsReviewBadge': '需人工决策';
+    readonly 'sync.selectSnapshot': '选择历史快照';
+    readonly 'sync.latestSnapshot': '最新快照';
+    readonly 'sync.noSnapshots': '远端暂无快照';
+    readonly 'sync.confirmImport': '确认导入';
+    readonly 'sync.cancelConfirm': '取消';
+    readonly 'sync.conflictResolve': '冲突解决';
+    readonly 'sync.conflictUseLocal': '用本地';
+    readonly 'sync.conflictUseRemote': '用远端';
+    readonly 'sync.conflictSkip': '跳过';
+    readonly 'sync.conflictResolvedLocal': '已选：本地';
+    readonly 'sync.conflictResolvedRemote': '已选：远端';
+    readonly 'sync.conflictResolvedSkip': '已选：跳过';
+    readonly 'sync.importDone': '已导入 {n} 个分区';
+    readonly 'sync.importSkipped': '已跳过 {n} 项';
+    readonly 'sync.importFailed': '导入失败（已整体回滚）';
+    readonly 'sync.rollbackButton': '回滚到应用前';
+    readonly 'sync.rollingBack': '正在回滚…';
+    readonly 'sync.rollbackDone': '已回滚到应用前';
+    readonly 'sync.appliedSections': '已写入';
+    readonly 'sync.importWarnings': '导入告警';
+    readonly 'sync.autosyncTitle': '自动同步';
+    readonly 'sync.autosyncDesc': '开启后，DSH 将按固定间隔自动执行双向同步（拉取合并 + 上传）；DSH 启动时还会触发一次「自动下载合并（不上传）」以保持本地为最新。仅在无冲突且无需人工干预时才自动写入。';
+    readonly 'sync.autosyncEnabled': '启用自动同步';
+    readonly 'sync.autosyncInterval': '同步间隔';
+    readonly 'sync.autosyncIntervalHint': 'DSH 启动时自动下载合并不上传。';
+    readonly 'sync.autosyncNever': '从未运行';
+    readonly 'sync.autosyncLastRun': '上次运行：{time}';
+    readonly 'sync.autosyncNextIn': '下次约 {time} 后';
+    readonly 'sync.autosyncSuccess': '成功';
+    readonly 'sync.autosyncSkipped': '已跳过';
+    readonly 'sync.autosyncFailed': '失败';
+    readonly 'sync.autosyncPartial': '部分成功';
+    readonly 'sync.autosyncFailCount': '连续失败 {n} 次';
+    readonly 'sync.autosyncSyncing': '自动同步进行中…';
+    readonly 'sync.interval.5m': '5 分钟';
+    readonly 'sync.interval.15m': '15 分钟';
+    readonly 'sync.interval.30m': '30 分钟';
+    readonly 'sync.interval.60m': '60 分钟';
+    readonly 'sync.interval.6h': '6 小时';
+    readonly 'sync.interval.12h': '12 小时';
+    readonly 'sync.interval.24h': '24 小时';
+    readonly 'sync.duration.min': '{n} 分钟';
+    readonly 'sync.duration.hour': '{n} 小时';
+    readonly 'sync.duration.day': '{n} 天';
+    readonly 'sync.hist.autosync': '自动同步';
+    readonly 'sync.hist.directionPull': '下载';
+    readonly 'sync.hist.directionPush': '上传';
+    readonly 'sync.hist.directionBoth': '双向';
+    readonly 'sync.hist.skipReasonConflict': '冲突项被跳过';
+    readonly 'sync.hist.skipReasonNoRemote': '远端无快照';
+    readonly 'sync.hist.skipReasonNotConfigured': '未配置仓库';
+    readonly 'sync.hist.skipReasonNetwork': '网络问题';
+    readonly 'sync.hist.conflictedSections': '跳过冲突分区：{sections}';
+    readonly 'sync.hist.appliedSections': '应用分区：{sections}';
+    readonly 'sync.hist.failedError': '错误：{error}';
+    readonly 'sync.hist.notifiedAt': '已通知';
+    readonly 'sync.github.starting': '正在发起 GitHub 授权…';
+    readonly 'sync.github.waitingNoCode': '请在浏览器中打开授权页面并完成授权…';
+    readonly 'sync.github.waiting': '请在浏览器中打开授权页面，输入一次性代码 {code} 完成授权（自动等待确认）。';
+    readonly 'sync.github.polling': '正在确认 GitHub 授权状态…';
+    readonly 'sync.github.success': 'GitHub 登录成功：token 已安全写入 DSH credentials，可直接推送/拉取。';
+    readonly 'sync.github.failed': 'GitHub 登录失败';
+    readonly 'sync.github.defaultStatus': '通过 GitHub OAuth 设备码流程登录，token 自动写入 DSH credentials（无需手动输入）。';
+    readonly 'sync.github.login': '使用 GitHub 登录';
+    readonly 'sync.github.relogin': '重新登录';
+    readonly 'sync.github.pollSuccess': 'GitHub 登录成功：token 已安全写入 DSH credentials。';
+    readonly 'sync.github.pollDenied': 'GitHub 授权被拒绝（access_denied）。可重新发起登录，或改用下方手动 token 输入。';
+    readonly 'sync.github.pollExpired': 'GitHub 授权已过期（expired_token）。请重新发起登录。';
+    readonly 'sync.github.pollError': 'GitHub OAuth 错误：{detail}';
+    readonly 'sync.github.unknownError': '未知错误';
+    readonly 'market.statusLoading': '正在读取市场状态…';
+    readonly 'market.statusUnconfigured': '尚未添加市场（请输入公开 Git 仓库地址）';
+    readonly 'market.statusConfigured': '已添加 {count} 个市场';
+    readonly 'market.supplyUnofficial': '来自公共网络、非官方审核';
+    readonly 'market.supplySource': '来源仓库：{url}';
+    readonly 'market.supplyDownloadedAt': '下载时间：{time}';
+    readonly 'market.supplyAuthor': '作者：{author}';
+    readonly 'market.supplyProvenanceSource': '作者声明来源：{source}';
+    readonly 'market.supplyProvenanceNote': '作者自述：{note}';
+    readonly 'market.detail.sections': '包含分区：{sections}';
+    readonly 'market.detail.sectionsEmpty': '未声明分区';
+    readonly 'market.detail.statusValid': '校验通过';
+    readonly 'market.detail.statusInvalid': '校验未通过';
+    readonly 'myConfigs.autoField': '系统自动';
+    readonly 'myConfigs.field.id': '条目 ID';
+    readonly 'myConfigs.field.author': '作者';
+    readonly 'myConfigs.field.version': '版本';
+    readonly 'myConfigs.field.updatedAt': '更新时间';
+    readonly 'myConfigs.status.notListed': '未收录';
+    readonly 'myConfigs.status.pendingPr': 'PR 待审核';
+    readonly 'myConfigs.status.listed': '已收录';
+    readonly 'myConfigs.form.errorName': '名称不能为空';
+    readonly 'consult.dim.compatibility': '版本/平台兼容性';
+    readonly 'consult.dim.integrity': '结构完整性';
+    readonly 'consult.dim.sections': '分区完整性';
+    readonly 'consult.dim.consistency': '一致性';
+    readonly 'consult.dim.sensitive': '敏感暴露';
+    readonly 'consult.dim.migratability': '可迁移性';
+    readonly 'consult.recommendation.proceed': '建议：可继续';
+    readonly 'consult.recommendation.review': '建议：需人工确认';
+    readonly 'consult.recommendation.block': '建议：阻止执行';
+    readonly 'consult.title': '迁移前咨询';
+    readonly 'consult.healthScore': '健康评分 {score}';
+    readonly 'consult.dryRun': '只读分析';
+    readonly 'consult.reasons': '建议依据';
+    readonly 'consult.willApply': '将应用';
+    readonly 'consult.sections': '{count} 个分区';
+    readonly 'consult.items': '{count} 项';
+    readonly 'consult.conflicts': '{count} 个冲突';
+    readonly 'consult.risks': '{count} 个风险';
+    readonly 'consult.dimensions': '评分维度';
+    readonly 'consult.loading': '正在生成咨询报告…';
+};
+export type UiTextKey = keyof typeof uiZh;
+export declare const uiEn: Record<UiTextKey, string>;
+/** UI 翻译函数：key → 当前语言文案（{param} 插值；未知键回退 zh/键名）。 */
+export type UiT = (key: UiTextKey, params?: Record<string, string | number>) => string;
+/** 构造 翻译函数（zh 源 / en 镜像；缺 key 回退）。 */
+export declare function makeUiT(lang: 'zh' | 'en'): UiT;
+/** 缺省 UI 翻译（zh）：未注入的渲染路径行为与改造前完全一致。 */
+export declare const zhUiT: UiT;