Limo备份系统揭秘：.lmmbak备份机制如何自动保护你的游戏原文件

Limo 是一款基于 Qt 的游戏 Mod 管理器，其 .lmmbak 备份机制能自动保护游戏原文件：每次 Mod 覆盖原文件时，原文件会被原地重命名为 .lmmbak 备份，停用 Mod 后自动还原，全程无需手动备份、不额外占用磁盘空间。本文将从源码角度带你彻底搞懂这套自动备份机制的工作原理。

Limo 两大核心概念：自动备份机制的地基 💾

要理解备份机制，先了解 Limo 的两个基础概念：

• Staging Directory（暂存目录）：安装 Mod 时，文件不会直接写入游戏目录，而是统一存放在暂存目录中；
• Deployer（部署器）：负责把 Mod 文件通过硬链接、软链接或复制的方式"投放"到游戏目标目录。

每次点击Deploy，Limo 都可能覆盖游戏原文件——这正是备份机制必须存在的理由。

.lmmbak 备份机制原理：零成本保护游戏原文件

Limo 的自动备份采用了一个非常聪明的策略：重命名，而不是复制。

这种设计有三个天然优势：

1. 毫秒级完成：只是改变文件名（元数据操作），不移动、不拷贝任何数据；
2. 不占用额外空间：文件原地保留，磁盘占用不增加；
3. 零丢失风险：备份与原文件同目录、同卷，不存在跨盘复制失败的问题。

在测试数据目录中就能看到真实的配对示例：tests/data/app/0.txt 与 tests/data/app/0.txt.lmmbak，后者就是被 Mod 覆盖前保留的原文件备份。备份扩展名.lmmbak在 src/core/deployer.h 中定义，核心逻辑位于 src/core/deployer.cpp。

完整流程：部署时自动备份，停用时自动还原

每次调用Deployer::deploy()时，Limo 会按以下 4 步执行（见 src/core/deployer.cpp）：

1. 读取台账：从目标目录的.lmmfiles文件读取"当前已部署文件"清单；
2. 备份与还原（backupOrRestoreFiles）：
   • 本次不再需要部署的文件 → 删除 Mod 链接的文件，并把.lmmbak备份重命名回原文件名；
   • 本次新覆盖的原文件 → 原文件被重命名为.lmmbak，完成自动备份；
   • 还原后为空的目录 → 清理（保留.lmm_managed_dir标记文件）；
3. 部署 Mod 文件：按选择的部署模式创建硬链接 / 软链接 / 复制；
4. 写入台账：把最新的已部署文件清单保存回.lmmfiles。

整个过程完全自动——你只需要点击 Deployer 界面右上角的Deploy按钮：

.lmmfiles 台账：精确还原的基石

自动备份之所以敢"只重命名不复制"，靠的是.lmmfiles这个 JSON 台账文件：

• 它记录每个已部署文件的路径及其所属 Mod ID；
• 没有它，Limo 就无法区分"Mod 部署的文件"和"游戏原文件"，也就无法在停用 Mod 时精确地删掉前者、还原后者；
• 同目录下还有一个.lmm_managed_dir标记文件，用于告知系统该目录由 Deployer 管理。

这三个文件常量同样定义在 src/core/deployer.h 中，相关行为可通过 tests/test_deployer.cpp 中的测试用例验证。

.lmmbak 与 .lmmbakman 有何区别？

Limo 其实有两套备份系统，命名相近但用途完全不同：

手动备份系统（BackupManager，见 src/core/backupmanager.h）支持添加备份目标（src/ui/addbackuptargetdialog.cpp）、创建与重命名备份、在备份与 Profile 之间切换，列表展示逻辑位于 src/ui/backuplistmodel.cpp。💡 简单记忆：.lmmbak保游戏原文件，.lmmbakman保你自己加的文件。

常见问题（FAQ）

❓ 可以手动删除.lmmbak文件吗？⚠️ 不建议。只要对应 Mod 仍处于启用状态，原文件只以.lmmbak形式存在，手动删除将导致游戏原文件永久丢失。

❓ 自动备份会占用额外磁盘空间吗？不会。.lmmbak只是重命名，文件本身没有移动，磁盘占用不变。

❓ 删除某个 Mod 后，备份会怎样？该 Mod 部署的文件会被移除，被其覆盖过的原文件会自动从.lmmbak还原，一切恢复原状。

❓ 目录为什么没有.lmmbak备份？.lmmbak只针对单个文件。目录由.lmm_managed_dir标记管理，还原后若目录为空则整体清理，避免残留空目录。

总结：.lmmbak 如何守护你的游戏 ✅

• .lmmbak：重命名式自动备份，零成本、零感知，让"覆盖原文件"变得可逆；
• .lmmfiles：部署台账，是精确备份与还原的依据；
• .lmmbakman：手动多版本备份，负责游戏原文件之外的自有文件管理。

有了这套机制，你可以放心地随意启用/停用 Mod——Limo 始终在背后守护着游戏的原始状态。