@logictan/dsh-config-manager 0.1.60

package/lib/core/messages.d.ts

@@ -0,0 +1,310 @@
+/**
+ * 核心引擎双语消息目录（zh 源语言 / en 镜像）。
+ *
+ * 背景：核心引擎（src/core、src/adapters、src/sync）是「零 DSH 运行时依赖」的
+ * 纯引擎层，不能使用 ctx.locale（客户端服务）。所有会流到 UI 报告 / 错误 / 手动提示
+ * 的动态字符串集中于本目录：引擎代码经注入的 MsgFunc 生成消息，宿主按 DSH 应用
+ * 语言（settings `locale` 命名空间的 preference）注入 zh/en 目录。
+ *
+ * 纪律：
+ *  - zh 值 = 既有中文文案原样（缺省行为/测试断言不变）；
+ *  - en 值类型为 Record<keyof typeof zh, string> —— 缺键/多键即编译错误；
+ *  - 消息以 {param} 插值，缺失参数原样保留，便于排查；
+ *  - 未知键回退 zh，再回退键名本身（绝不抛错）。
+ */
+import type { MsgFunc } from './msg-types.ts';
+export type { MsgFunc, MsgParams } from './msg-types.ts';
+export declare const zh: {
+    readonly 'export.encryptionRequired': '导出包含秘密需要注入 EncryptionProvider（m4 实现），拒绝明文导出秘密';
+    readonly 'export.sectionFailed': '分区 {adapter} 导出失败: {reason}';
+    readonly 'export.credentialsReadFailed': '读取凭据文件失败，跳过秘密导出: {reason}';
+    readonly 'export.vaultRefreshed': '凭据明文未进入备份，已镜像到本机 vault（{count} 个文件，恢复时可回填）';
+    readonly 'export.vaultRefreshSkipped': 'vault 镜像跳过 {rel}: {reason}';
+    readonly 'export.vaultRefreshFailed': 'vault 镜像刷新失败（不影响导出）: {reason}';
+    readonly 'export.fileSectionSecrets': '文件类分区 {section} 中检测到疑似凭据: {path}';
+    readonly 'import.readFailed': '无法读取备份文件 "{zip}": {reason}';
+    readonly 'import.noManifest': '备份缺少 manifest.json，不是有效的 DSH Config Manager 备份';
+    readonly 'import.manifestParseFailed': 'manifest.json 解析失败: {reason}';
+    readonly 'import.integrityFailed': '备份完整性校验失败: {entries}';
+    readonly 'import.schemaUnsupported': '备份 {version}，无法导入（当前支持 v1）';
+    readonly 'import.executableWarning': '备份包含可执行文件 "{name}"，本插件不会执行它';
+    readonly 'import.sectionParseFailed': '分区 {section} 数据解析失败: {reason}';
+    readonly 'import.sectionInvalid': '分区 {section} 数据无效: {issues}';
+    readonly 'import.adapterAnalyzeFailed': '{adapter}: 分析失败 {reason}';
+    readonly 'import.adapterValidationIssue': '{adapter}: {message}';
+    readonly 'import.versionUnsupported': '{version}：无法导入';
+    readonly 'import.missingSections': '备份声明了但缺少的分区: {sections}';
+    readonly 'import.unsupportedSections': '备份包含本版本不支持的分区: {sections}（已跳过，未导入）';
+    readonly 'import.unsupportedSectionVersion': '分区 {section} 的数据版本 {version} 高于本版本支持的 1（已跳过该分区）';
+    readonly 'import.checksumsMissing': '备份未提供完整性校验表，全部条目未被校验';
+    readonly 'import.extraEntries': 'ZIP 内含未登记进校验表的条目: {entries}（未被校验）';
+    readonly 'import.migrated': '备份 schema 已从 v{from} 迁移到 v{to}';
+    readonly 'import.migrateInvalidManifest': '迁移后的 manifest 不合法: {issues}';
+    readonly 'import.postValidationIssue': '导入后校验 {adapter}: {message}';
+    readonly 'import.postValidationFailed': '导入后校验 {adapter} 失败: {reason}';
+    readonly 'import.conflictKeepCurrent': '（用户选择保留当前）';
+    readonly 'import.conflictSkipExisting': '（skipExisting 策略）';
+    readonly 'import.conflictReplace': '（replace 策略）';
+    readonly 'import.secretMissingDesc': '凭据 {ref} 需要补录';
+    readonly 'import.secretNotProvided': '凭据未提供，需补录';
+    readonly 'import.notConfirmed': '导入未确认：必须显式 confirm 后才允许修改任何数据';
+    readonly 'import.encryptedPasswordRequired': '该备份已加密，必须提供解密密码才能导入（拒绝无密码导入）';
+    readonly 'import.encryptedPasswordWrong': '解密密码错误，请重试';
+    readonly 'import.notEncryptedContainer': '该文件不是加密备份容器，无法解锁';
+    readonly 'import.userSkipped': '用户跳过（导入中点击「跳过当前插件」）';
+    readonly 'import.userSkippedDetail': '插件 {name} 已由用户跳过，未安装';
+    readonly 'import.vaultRestored': '凭据文件 {rel} 已从本机 vault 回填';
+    readonly 'import.vaultMissing': '凭据文件 {rel} 不在本机 vault（跨机恢复需人工重填）';
+    readonly 'import.vaultBackfillFailed': 'vault 凭据回填失败（不影响导入结果）: {reason}';
+    readonly 'rollback.ns.createdNoDelete': '该 namespace 由导入创建，DSH settings 无删除语义';
+    readonly 'rollback.ns.manualHint': 'namespace "{ref}" 需人工删除或合并';
+    readonly 'rollback.ns.conflictHint': 'settings namespace "{ref}" 需人工核对';
+    readonly 'rollback.cred.noReadback': 'DSH 不回读凭据值，无法自动恢复';
+    readonly 'rollback.cred.manualHint': '凭据 "{ref}" 请人工重新填写';
+    readonly 'rollback.patch.manualHint': 'patch 行 "{ref}" 需人工核对';
+    readonly 'rollback.file.manualHint': '文件 "{ref}" 需人工恢复';
+    readonly 'rollback.workspace.manualHint': 'workspace "{ref}" 需人工核对';
+    readonly 'rollback.unknownEntry': '未知快照条目类型 {kind}';
+    readonly 'restore.snapshotInvalid': '快照 {dir} 的 snapshot.json 不是合法对象';
+    readonly 'restore.invalidSnapshotId': 'snapshotId 非法（禁止路径分隔符）/ invalid snapshotId';
+    readonly 'restore.pathEscape': '路径越界: {path}';
+    readonly 'restore.snapshotUntrusted': '快照不可信，拒绝恢复（{verdict}）：{reason}';
+    readonly 'restore.blobPathEscape': 'blob 路径越界: {path}';
+    readonly 'restore.hostSkipEscape': '宿主文件路径越界，跳过: {path}';
+    readonly 'restore.hostSkipEscapeDetail': '快照登记路径越界，拒绝恢复';
+    readonly 'restore.hostNoBlobInfo': '宿主文件 {path} 缺少 blob 副本，跳过';
+    readonly 'restore.hostBlobMissing': '宿主文件 {path} 的 blob 缺失，跳过';
+    readonly 'restore.hostRestore': '整文件还原 {path}';
+    readonly 'restore.backupBeforeWrite': '还原前将备份当前文件到 pre-restore/';
+    readonly 'restore.writeDirect': '当前文件不存在，直接写入';
+    readonly 'restore.hostRemove': '移除快照时不存在、现已出现的文件 {path}';
+    readonly 'restore.backupBeforeRemove': '删除前将备份当前文件到 pre-restore/';
+    readonly 'restore.hostSkipAbsent': '宿主文件 {path} 快照时不存在且当前也不存在，无动作';
+    readonly 'restore.settingsNotBacked': 'settings 文件 {path} 未被快照登记，无法整文件还原';
+    readonly 'restore.settingsNotBackedDetail': '该快照未备份此 settings 文件（可能当时不存在或宿主未暴露 profile）';
+    readonly 'restore.noBaseline': '旧快照无 beforePlugins 基线，无法自动卸载插件';
+    readonly 'restore.noBaselineDetail': '请人工核对导入期间新增的插件并逐个移除';
+    readonly 'restore.pluginRemove': '卸载导入期间新增插件 {name}';
+    readonly 'restore.pluginRemoveEmptyBaseline': '快照基线为空（导入前可能未捕获插件清单），请确认后执行';
+    readonly 'restore.noAddedPlugins': '无导入期间新增插件（当前已装插件 ⊆ 快照基线）';
+    readonly 'restore.fileSkipEscape': '文件条目路径越界，跳过: {adapter}:{ref}';
+    readonly 'restore.fileBlobMissing': '文件 {path} 的 blob 缺失，跳过';
+    readonly 'restore.fileRestore': '还原文件 {path}（{adapter}）';
+    readonly 'restore.fileRemove': '删除导入写入的文件 {path}（{adapter}）';
+    readonly 'restore.fileSkipAbsent': '文件 {path} 快照时不存在且当前也不存在，无动作';
+    readonly 'restore.fileNoBlobInfo': '文件 {path} 缺少 blob 副本信息，跳过';
+    readonly 'restore.credentialHint': '凭据 {ref} 需人工补录';
+    readonly 'restore.credentialManualHint': '凭据 "{ref}" 请人工重新填写（DSH 不回读凭据值）';
+    readonly 'restore.nsAggregate': '{count} 条 settings namespace 条目：快照无 settings 整文件备份，离线无法恢复';
+    readonly 'restore.nsAggregateDetail': '需经在线回滚（rollback.ts）或人工核对 settings.yaml';
+    readonly 'restore.patchAggregate': '{count} 条 patch 行条目：快照无 cordis.patch.yml 整文件备份，离线无法恢复';
+    readonly 'restore.patchAggregateDetail': '需经在线回滚（rollback.ts）或人工核对 patch 文件';
+    readonly 'restore.workspaceAggregate': '{count} 条 workspace 记录条目：离线无法恢复（数据在 DSH storages）';
+    readonly 'restore.workspaceAggregateDetail': '需经在线回滚（rollback.ts）或人工核对 workspace 注册表';
+    readonly 'restore.credentialAbsentAggregate': '{count} 条凭据快照时未配置：若导入已创建，需人工在 DSH 中删除';
+    readonly 'restore.uninstallFailedCode': 'dsh plugin remove {name} 失败（{code}）：{message}';
+    readonly 'restore.uninstallFailedExit': 'dsh plugin remove {name} 失败（exit {code}）：{tail}';
+    readonly 'restore.noOutput': '无输出';
+    readonly 'restore.pluginRemoveFailed': '卸载失败';
+    readonly 'restore.unknownAction': '未知动作 {kind}: {description}';
+    readonly 'restore.missingTargetBlob': '恢复动作缺少 target/blobPath';
+    readonly 'restore.missingTarget': '恢复动作缺少 target';
+    readonly 'restore.missingPluginName': '恢复动作缺少插件名';
+    readonly 'restore.ghostSweepSummary': '发现 {count} 个幽灵会话（备份有记录、磁盘无文件），需人工在 DSH 确认清理：{keys}';
+    readonly 'run.conflict.export': '已有进行中的导出任务（{runId}），请等待其完成后再试';
+    readonly 'run.conflict.import': '已有进行中的导入任务（{runId}），请等待其完成后再试';
+    readonly 'run.notFound': 'run {runId} not found（可能已过保留期被清理）';
+    readonly 'host.exportTimeout': '导出超时（5 分钟）：导出过程未完成，请重试；若反复超时请检查 profile 依赖状态';
+    readonly 'host.syncPushTimeout': '同步推送超时（5 分钟）：请检查网络与仓库可达性后重试';
+    readonly 'host.syncPullTimeout': '同步拉取超时（5 分钟）：请检查网络与仓库可达性后重试';
+    readonly 'host.workspaceUnavailable': 'workspaceRegistry 服务不可用，无法写入工作区';
+    readonly 'host.patchUnsupported': 'dsh-config-manager 仅支持管理 {user} 与 profile 的 {profile}（收到 {file}）';
+    readonly 'host.fsPathEscape': '路径越界: {path}';
+    readonly 'host.activationRowFailed': '插件 {pkg} 已安装，但激活行写入 profile 补丁失败：{reason}（重启后该插件可能未激活；修复后重试安装即可幂等补行）';
+    readonly 'host.syncTokenWriteFailed': 'token 写入 DSH credentials 失败：{reason}（请在 DSH 凭据管理里配置 {ref} 后重试）';
+    readonly 'host.githubMissingClientId': '未配置 GitHub OAuth client_id：请在插件配置中设置 githubClientId（GitHub → Settings → Developer settings → OAuth Apps 注册应用获取）';
+    readonly 'host.githubFlowGone': 'GitHub 登录流程不存在或已过期，请重新开始';
+    readonly 'host.restoreBlobEscape': 'blob 路径越界: {blob}';
+    readonly 'host.restoreUninstallFailed': 'dsh plugin remove {name} 失败（exit {code}）：{tail}';
+    readonly 'host.restoreNoOutput': '无输出';
+    readonly 'adapter.pluginListReadFailed': '插件清单读取失败: {reason}';
+    readonly 'adapter.patchReadFailed': 'patch 文件读取失败: {reason}';
+    readonly 'adapter.patchReadFailedPrompts': 'patch 文件读取失败，无法提取 prompts: {reason}';
+    readonly 'adapter.patchReadFailedMCP': 'patch 文件读取失败，无法提取 MCP: {reason}';
+    readonly 'adapter.pnpmReadFailed': 'pnpm-workspace.yaml 读取失败: {reason}';
+    readonly 'adapter.localPackFailed': '本地插件打包失败（已跳过，其余插件不受影响）: {reason}';
+    readonly 'adapter.pluginLocalTarballHint': '（本地源插件，将用备份内自带的 tarball 安装）';
+    readonly 'adapter.providerNsReadFailed': 'provider namespace {ns} 读取失败（可能未配置）: {reason}';
+    readonly 'adapter.credStatusReadFailed': '凭据 {ref} 状态读取失败: {reason}';
+    readonly 'adapter.settingsNsReadFailed': '设置 namespace {name} 读取失败: {reason}';
+    readonly 'adapter.dirEmpty': '{type} 目录为空或不存在';
+    readonly 'adapter.linksFollowed': '{type} 分区：已跟随 {count} 个链接目录收集内容（导入时按普通目录还原，链接结构不会重建）';
+    readonly 'adapter.linksSkipped': '{type} 分区：{count} 个链接被跳过，其内容**未进备份** —— {detail}';
+    readonly 'adapter.dirsUnreadable': '{type} 分区：{count} 个目录读取失败（权限/竞态），其内容**未进备份** —— {detail}';
+    readonly 'adapter.linkReason.loop': '自引用/重复链接';
+    readonly 'adapter.linkReason.outsideHome': '目标在 DSH home 之外';
+    readonly 'adapter.linkReason.broken': '断链';
+    readonly 'adapter.linkReason.unreadable': '目标既非文件也非目录';
+    readonly 'adapter.linkReason.tooDeep': '层级过深';
+    readonly 'adapter.noSettingsNamespaces': '未配置 settings namespace 清单，settings 分区为空';
+    readonly 'adapter.fileCreate': '创建{type}文件 {path}';
+    readonly 'adapter.fileSame': '文件 {path} 已一致';
+    readonly 'adapter.fileDiff': '文件 {path} 内容不同';
+    readonly 'adapter.pluginFileCreate': '创建插件配置文件 {path}';
+    readonly 'adapter.pluginFileReserved': '拒绝：{path} 落在内部 recovery/control-plane 保留区（快照/事务/锁/同步存储）';
+    readonly 'adapter.fileReserved': '拒绝：{path} 落在内部 recovery/control-plane 保留区（快照/事务/锁/同步存储）';
+    readonly 'adapter.mcpCreate': '创建 MCP server {serverName}';
+    readonly 'adapter.mcpSame': 'MCP server {serverName} 已一致';
+    readonly 'adapter.mcpDiff': 'MCP server {serverName} 与目标不同';
+    readonly 'adapter.pwCreate': '写入 pnpm-workspace.yaml（插件构建白名单/冷静期配置）';
+    readonly 'adapter.pwUpdate': '更新 pnpm-workspace.yaml（插件构建白名单/冷静期配置）';
+    readonly 'adapter.pluginInstall': '安装插件 {name}@{version}';
+    readonly 'adapter.pluginSame': '插件 {name} 已安装且版本一致';
+    readonly 'adapter.pluginDiff': '插件 {name} 版本不同';
+    readonly 'adapter.pluginVersionDetail': '当前 {current} vs 导入 {imported}';
+    readonly 'adapter.pluginBundleMember': '（bundle 成员，经聚合包安装）';
+    readonly 'adapter.pluginInstallOk': '插件 {name} 已安装{suffix}';
+    readonly 'adapter.pluginUpdateTriggered': '插件 {name} 已触发更新（npm 最新版）{suffix}';
+    readonly 'adapter.pluginRestartSuffix': '，重启 dsh 后生效';
+    readonly 'adapter.pwMissing': '导入数据缺少 pnpm-workspace.yaml 内容';
+    readonly 'adapter.pluginInstallFailed': '插件 {name} 安装失败：{msg}。可手动安装：dsh plugin --profile {profile} add {name}（其余配置已导入；可修复依赖后在设置页重试或手动安装）';
+    readonly 'adapter.pluginUpdateFailed': '插件 {name} 更新失败：{msg}。可手动安装：dsh plugin --profile {profile} add {name}（其余配置已导入；可修复依赖后在设置页重试或手动安装）';
+    readonly 'adapter.patchLineCreate': '写入 patch 行 {lineId}';
+    readonly 'adapter.patchLineSame': 'patch 行 {lineId} 已一致';
+    readonly 'adapter.patchLineDiff': 'patch 行 {lineId} 与目标不同';
+    readonly 'adapter.promptSame': '提示词 {name} 已一致';
+    readonly 'adapter.promptDiff': '提示词 {name} 与目标不同';
+    readonly 'adapter.promptDiffWithLine': '提示词 {name} 与目标不同（目标位于行 {line}）';
+    readonly 'adapter.promptCreate': '创建提示词 {name}（行 {line}）';
+    readonly 'adapter.promptManual': '提示词 {name} 在目标无对应来源，请手动配置（DSH 无独立 prompt 存储）';
+    readonly 'adapter.providerUnregistered': 'Provider {route} 的命名空间 {ns} 在目标未注册（可能需要安装对应插件）';
+    readonly 'adapter.providerCreate': '创建 Provider {route}（namespace {ns}）';
+    readonly 'adapter.providerSame': 'Provider {route} 已一致';
+    readonly 'adapter.providerDiff': 'Provider {route} 与目标不同';
+    readonly 'adapter.settingsUnregistered': '设置命名空间 {ns} 在目标未注册（可能需要安装提供它的插件）';
+    readonly 'adapter.settingsCreate': '创建设置 {name}';
+    readonly 'adapter.settingsSame': '设置 {name} 已一致';
+    readonly 'adapter.settingsDiff': '设置 {name} 与目标不同';
+    readonly 'adapter.workspaceCreate': '创建工作区 {title}（{path}）';
+    readonly 'adapter.workspaceSame': '工作区 {id} 已一致';
+    readonly 'adapter.workspaceDiff': '工作区 {id} 与目标不同';
+    readonly 'adapter.workspacePathMapping': '路径需映射: {path}';
+    readonly 'adapter.workspaceMissing': '导入数据缺少工作区 {ref}';
+    readonly 'adapter.credentialDescription': '凭据补录';
+    readonly 'adapter.missingTargetRef': '缺少 target.ref';
+    readonly 'adapter.dataMissingFile': '导入数据缺少文件 {ref}';
+    readonly 'adapter.patchMissing': '导入数据缺少 patch 行 {ref}';
+    readonly 'adapter.pwWritten': 'pnpm-workspace.yaml 已写入（插件安装将按该配置执行）';
+    readonly 'adapter.pwWriteFailed': 'pnpm-workspace.yaml 写入失败：{msg}（插件安装可能因此受阻，可修复后在设置页重试）';
+    readonly 'adapter.patchFileCreate': '写入 pnpm patch 文件 {path}';
+    readonly 'adapter.patchFileWriteFailed': 'pnpm patch 文件 {path} 写入失败：{reason}（对应的 patchedDependencies 声明会被移除）';
+    readonly 'adapter.patchFileMissing': 'pnpm patch 文件缺失，无法随备份迁移：{name} → {path}（该 patchedDependencies 条目导入时会被移除）';
+    readonly 'adapter.patchFileUnsafe': 'pnpm patch 路径不安全，已跳过：{name} → {path}';
+    readonly 'adapter.patchFileReadFailed': 'pnpm patch 文件读取失败：{name} → {path}（{reason}）';
+    readonly 'adapter.patchFileTooLarge': 'pnpm patch 文件过大，未随备份迁移：{name} → {path}（上限 {limit}）';
+    readonly 'adapter.pwPatchesDropped': '已移除 {count} 条 patchedDependencies 声明（目标机没有对应 patch 文件，保留会让 pnpm 拒绝一切插件安装）：{names}';
+    readonly 'adapter.pwPatchesDroppedDetail': '导入时会移除 {count} 条无法满足的 patchedDependencies 声明：{names}';
+    readonly 'adapter.pwPatchesUnsupported': 'patchedDependencies 为单行 flow 写法，无法安全剔除缺失条目；若目标机没有对应 patch 文件，pnpm 可能拒绝安装：{line}';
+    readonly 'adapter.pwWrittenPatchesDropped': 'pnpm-workspace.yaml 已写入，但移除了 {count} 条 patchedDependencies 声明（目标机没有对应 patch 文件）：{names}';
+    readonly 'adapter.patchWritten': 'patch 行 {ref} 已写入（宿主热重载 patch，无需重启）';
+    readonly 'adapter.credentialValueMissing': '凭据值未提供（需补录）';
+    readonly 'adapter.promptWarningNoWrite': '提示项，无需写入';
+    readonly 'adapter.promptMissing': '导入数据缺少提示词 {id}';
+    readonly 'adapter.promptCreated': '提示词 {name} 已创建（行 {ref}）';
+    readonly 'adapter.patchLineMissing': '目标 patch 行 {ref} 不存在，无法写入';
+    readonly 'adapter.promptWritten': '提示词 {name} 已写入 patch 行 {ref}';
+    readonly 'adapter.mcpMissing': '导入数据缺少 MCP server {serverName}';
+    readonly 'adapter.mcpWritten': 'MCP server {serverName} 已写入 patch（宿主热重载 patch，无需重启）';
+    readonly 'adapter.workspaceWriteFailed': '工作区 {ref} 未能写入：{msg}（需映射路径或先在目标创建目录）';
+    readonly 'adapter.providerMissing': '导入数据缺少 provider {route}';
+    readonly 'adapter.namespaceMissing': '导入数据缺少 namespace {ref}';
+    readonly 'adapter.validate.object': '{subject} 数据必须是对象';
+    readonly 'adapter.validate.fileSection': '文件分区数据必须是对象';
+    readonly 'adapter.validate.version': 'version 必须为 1（收到 {value}）';
+    readonly 'adapter.validate.array': '{subject} 必须是数组';
+    readonly 'adapter.validate.string': '{subject} 必须是字符串';
+    readonly 'adapter.validate.localTarballPath': '本地插件 tarball 路径非法（须位于 local-plugins/ 之下且不含 ..）: {path}';
+    readonly 'adapter.validate.missingObject': '缺少 {subject} 对象';
+    readonly 'adapter.validate.recordObject': '{subject} 记录必须是对象';
+    readonly 'adapter.validate.requiredField': '缺少 {subject}';
+    readonly 'adapter.validate.sourceNamespace': '缺少来源 namespace';
+    readonly 'adapter.validate.number': '{subject} 必须是数字';
+    readonly 'adapter.validate.nonEmptyRef': '{subject} 记录必须含非空 ref';
+    readonly 'adapter.validate.credentialRef': '凭据记录必须含非空 ref';
+    readonly 'adapter.validate.fileRelativePath': '文件记录必须含非空 relativePath';
+    readonly 'adapter.validate.promptIdentity': 'prompt 记录必须含字符串 name 与 text';
+    readonly 'adapter.validate.hasValueFalse': '值未导出，hasValue 必须为 false';
+    readonly 'adapter.validate.serverName': 'server 记录必须含非空 serverName';
+    readonly 'adapter.validate.workspaceIdentity': 'workspace 记录必须含字符串 id 与 path';
+    readonly 'adapter.validate.missingValue': '缺少 value';
+    readonly 'sync.denySensitiveSection': '同步拒绝携带敏感分区 {section}（secret 值永不参与同步）';
+    readonly 'sync.sectionFailed': '分区 {adapter} 导出失败: {reason}';
+    readonly 'sync.unknownSection': '分区 {section} 不存在，已跳过，不参与同步';
+    readonly 'sync.noSections': '没有可同步的分区（全部导出失败）';
+    readonly 'sync.legacyEncryptedSnapshot': '快照 {id} 是旧版加密快照，当前同步通道不产生也不读取加密快照（请在旧版本中改用明文通道重新推送）';
+    readonly 'sync.remoteEmpty': '远端无快照';
+    readonly 'sync.missingImporter': 'SyncEngine 缺少 importer：pull 需要注入 Importer（analyzeImport/createImportPlan）';
+    readonly 'sync.missingCtx': 'SyncEngine 需要 ctx';
+    readonly 'sync.missingTransport': 'SyncEngine 需要完整 SyncTransport（list/upload/download/delete）';
+    readonly 'sync.missingStateDir': 'SyncEngine 需要 stateDir';
+    readonly 'sync.unchanged': '远端快照与本地一致（无变更）';
+    readonly 'sync.changesSummary': 'compatibility={compatibility}，共 {count} 项变更';
+    readonly 'sync.configWhitespace': '仓库地址不能包含空白字符';
+    readonly 'sync.configUnparseable': '无法解析仓库地址: {url}';
+    readonly 'sync.configUserinfo': '请勿在仓库地址中包含用户名/密码（认证 token 请使用凭据字段，不会拼入地址）';
+    readonly 'sync.state.notObject': 'sync-state.json 损坏：必须是对象';
+    readonly 'sync.state.schemaUnsupported': 'sync-state.json schemaVersion 不支持: {version}（期望 {expected}）';
+    readonly 'sync.state.lastSyncAt': 'sync-state.json 损坏：lastSyncAt 必须是字符串';
+    readonly 'sync.state.sections': 'sync-state.json 损坏：sections 必须是对象';
+    readonly 'sync.state.sectionRecord': 'sync-state.json 损坏：分区 {section} 记录必须是对象';
+    readonly 'sync.state.sectionFields': 'sync-state.json 损坏：分区 {section} 记录必须含字符串 hash/updatedAt';
+    readonly 'sync.state.transport': 'sync-state.json 损坏：transport 必须含字符串 type/ref';
+    readonly 'sync.git.repoUrlRequired': 'repoUrl 必须是非空字符串';
+    readonly 'sync.git.workDirRequired': 'workDir 必须是非空字符串';
+    readonly 'sync.git.credentialsRequired': 'credentials 必须提供 getToken()';
+    readonly 'sync.git.snapshotMissing': '快照 {id} 不存在（本地工作副本 {dir}）';
+    readonly 'sync.git.snapshotCorrupt': '加密快照 {id} 损坏（{dir}）: {err}';
+    readonly 'sync.git.repoUnreachable': '仓库不可达或认证失败: {url}';
+    readonly 'sync.git.workDirNotRepo': 'workDir 不是 git 仓库（缺少 .git）且目录非空，无法 clone: {dir}';
+    readonly 'sync.git.pullFailed': 'git pull 失败: {err}';
+    readonly 'sync.git.cmdFailed': 'git {args} 失败 (exit {code}): {err}';
+    readonly 'sync.git.repoUrlInvalid': '无法解析 repoUrl（http(s) 仓库必须为合法 URL）: {url}';
+    readonly 'sync.git.invalidSnapshotId': '非法快照 id: {id}（仅允许字母数字开头，字符限 . _ -）';
+    readonly 'sync.webdav.baseUrlRequired': 'baseUrl 必须是非空字符串';
+    readonly 'sync.webdav.baseUrlInvalid': '无法解析 baseUrl（必须为合法 http(s) URL）: {url}';
+    readonly 'sync.webdav.baseUrlUserinfo': '请勿在 baseUrl 中包含用户名/密码（认证走凭据字段，不会拼入地址）';
+    readonly 'sync.webdav.usernameRequired': 'username 必须是非空字符串';
+    readonly 'sync.webdav.credentialsRequired': 'credentials 必须提供 getPassword()';
+    readonly 'sync.webdav.invalidSnapshotId': '非法快照 id: {id}（仅允许字母数字开头，字符限 . _ -）';
+    readonly 'sync.webdav.snapshotMissing': '快照 {id} 不存在（{url}）';
+    readonly 'sync.webdav.requestFailed': '{method} {url} 失败 (HTTP {status}): {err}';
+    readonly 'sync.webdav.requestError': '{method} {url} 请求出错: {err}';
+    readonly 'sync.webdav.timeout': '{method} {url} 请求超时（{timeout}ms）';
+    readonly 'sync.webdav.tooManyRedirects': '{method} {url} 重定向超过 {n} 次上限，疑似跳转循环';
+    readonly 'sync.webdav.indexInvalid': '{url} 解析失败或结构非法: {err}';
+    readonly 'sync.webdav.snapshotInvalid': '快照 {id} 解析失败或结构非法: {err}';
+    readonly 'sync.pruneListFailed': '远端快照裁剪失败：无法列出远端快照，{reason}';
+    readonly 'sync.pruneDeleteFailed': '远端快照裁剪失败：删除快照 {id} 失败，{reason}';
+    readonly 'market.invalidItemId': '非法市场条目 id: {id}（仅允许字母数字开头，字符限 . _ -）';
+    readonly 'market.urlWhitespace': '市场仓库地址不能包含空白字符';
+    readonly 'market.urlUnparseable': '无法解析市场仓库地址: {url}';
+    readonly 'market.urlUserinfo': '请勿在市场仓库地址中包含用户名/密码（公开市场无需凭据；token 不会拼入地址）';
+    readonly 'market.repoUnreachable': '市场仓库不可达: {url}';
+    readonly 'market.cloneFailed': '市场仓库拉取（clone）失败: {err}';
+    readonly 'market.pullFailed': '市场仓库同步（pull）失败: {err}';
+    readonly 'market.workDirNotRepo': '市场工作目录非空且不是 git 仓库，无法 clone: {dir}';
+    readonly 'market.missingIndex': '市场缺少 index.json: {url}';
+    readonly 'market.missingManifest': '条目 {id} 缺少 manifest.json';
+    readonly 'market.missingZip': '条目 {id} 缺少 config.zip';
+    readonly 'market.zipTooLarge': 'config.zip 体积 {size} 超过上限 {limit} 字节';
+    readonly 'market.invalid': '条目 {id} 校验未通过: {errors}';
+};
+export declare const en: Record<keyof typeof zh, string>;
+/** 构造 MsgFunc：en → en 目录（缺键回退 zh）；其余 → zh。 */
+export declare function makeMsg(lang: 'zh' | 'en' | string | undefined): MsgFunc;
+/** 缺省目录（zh）：未注入 msg 的引擎/测试路径使用，行为与改造前完全一致。 */
+export declare const zhMsg: MsgFunc;
+/** 从「可能携带 msg 的对象」取翻译器；缺省 zh。 */
+export declare function msgOf(ctx: {
+    msg?: MsgFunc;
+} | undefined): MsgFunc;