跳到主要内容

配置导入

功能说明​

配置导入用于把旧版本 Mint/MintCat 的本地配置迁移到当前版本，帮助你快速恢复：

  • 配置文件（Profile）结构
  • 已保存的部分设置（如主题、语言等）
  • 历史模组列表（按旧版本格式可迁移）

建议：导入前先备份当前配置，避免误覆盖。

使用入口​

在应用内进入：

设置 -> MintCat Settings -> Import Config -> Open

首次启动时的新手引导里，也可以通过“配置导入”按钮打开该窗口。

操作步骤​

  1. 打开“配置管理（Configuration Management）”窗口。
  2. 在检测到的历史配置列表中，勾选要导入的配置（单次仅支持选一个）。
  3. 可先点击文件夹图标，确认目录内容无误。
  4. 点击 Import Config 开始导入。
  5. 导入完成后窗口会自动关闭，应用会刷新相关界面数据。

支持的历史版本​

当前支持从以下历史配置迁移：

  • 0.2
  • 0.3
  • 0.4

导入规则（你需要知道）​

  • 应用会自动扫描固定的历史目录，不支持手动选择任意目录导入。
  • 不支持直接导入 ZIP/PAK 等压缩包或二进制包。
  • 导入过程中如果遇到格式错误或读取失败，可能提示 Import Failed。
  • 导入后建议先检查当前激活的 Profile 和模组数量是否符合预期。

注意事项（强烈建议先看）​

1) 先做备份​

导入可能改变当前本地数据，建议提前：

  • 备份当前配置目录，或
  • 使用云备份（如果已配置）先创建一份备份。

2) v0.4 导入会重建数据​

从 0.4 导入时，会先清空并重建相关模组/配置数据，以避免重复和冲突。
如果你当前环境已有重要新数据，务必先备份再导入。

3) 跨电脑导入时，本地模组路径可能失效​

如果历史配置引用了另一台电脑上的本地文件路径，导入后可能出现“本地路径不存在”。
这种情况需要手动重新选择本地模组文件。

4) 删除按钮是永久删除​

配置管理窗口中的删除操作会删除对应历史配置目录，删除后不可恢复，请谨慎操作。

导入后建议执行​

导入完成后，建议按下面顺序检查：

  1. 首页确认当前 Profile 是否正确。
  2. 检查模组总数和启用状态是否符合预期。
  3. 执行一次“检查 Mod 更新”，补齐在线元数据。
  4. 需要时点击“保存”并重新整合安装到游戏。

常见问题（FAQ）​

Q1：为什么没有检测到任何可导入配置？​

通常是因为旧版本配置不在应用支持的历史目录中，或目录内缺少必要配置文件。

Q2：提示 Import Failed 怎么办？​

可按下面顺序排查：

  1. 确认旧配置目录可访问（无权限/无占用问题）。
  2. 检查历史配置文件是否损坏（JSON 内容异常）。
  3. 重启应用后重试。
  4. 仍失败时，建议先保留现场并反馈日志。

Q3：导入后看不到部分 Mod？​

常见原因：

  • 旧数据里该 Mod 信息不完整；
  • 本地 Mod 文件路径已失效；
  • 需要执行一次“检查 Mod 更新”刷新元数据。