MOD介绍
## 主要功能
- 原版存档与模组存档双向同步
- 四种互通模式,可完全关闭同步
- 只启用 BetterSaves 时自动使用原版兼容模式
- 首次同步前自动创建本地安全备份
- 一键备份、SHA-256 校验、原版/模组两侧精确恢复与备份删除
- 在 profile 界面显示当前使用的存档侧
## 互通模式
可在模组设置界面的 BetterSaves 设置行中切换模式。
| 模式 | 同步范围 |
| `关闭同步` | 停止 BetterSaves 的复制、删除、文件监听、启动对账和首次同步弹窗。之后的新存档只保留在游戏当前使用的一侧。 |
| `仅同步存档` | 同步受支持的单人当前局存档文件。 |
| `仅同步数据` | 同步进度、时间线、发现和历史记录,不同步当前局文件。 |
| `完整同步` | 同时同步受支持的当前局文件与 profile 数据。 |
模式切换会立即生效。若希望两侧在进入 `关闭同步` 前保持一致,请先在主菜单保存,并等待本次同步完成。
只启用 BetterSaves 时,游戏读取原版存档路径;启用其他玩法模组时,游戏读取模组存档路径。
## 首次同步
BetterSaves 第一次接管已有 profile 时,会先创建本地安全备份,再询问要保留哪一侧:
- `保留原版(覆盖模组)`:保留原版存档,并复制到模组侧。
- `保留模组(覆盖原版)`:保留模组存档,并复制到原版侧。
- `稍后决定`:本次启动不修改任何存档,下次启动继续询问。
只有文件复制完成且游戏成功重新加载该 profile 后,首次同步才会被视为完成。Steam 云镜像写入也会延迟到重新加载成功后执行。
如果所选来源的数据明显少于另一侧,第一次点击只会显示风险提示。只有确认需要执行该覆盖时,才应再次点击同一个选项。
如果无法创建安全备份,BetterSaves 会阻止导入,不会修改任一侧存档。如果 profile 重新加载或自动回滚失败,保护状态会跨重启保留,并显示用于恢复的备份路径。
## 备份与恢复
“BetterSaves存档备份”设置行位于互通模式下方。
- `立即备份`:同时备份当前 Steam 账户、当前 profile 的原版与模组目录。
- `恢复备份`:仅能在主菜单使用,列表包含手动备份、恢复前安全备份和兼容的首次同步备份。
- 每次普通恢复前都会自动创建安全备份,然后精确替换两侧 profile 目录、验证结果并重新加载 profile,成功后才恢复同步。
- 每个账户/profile 最多自动保留最近 3 份恢复前安全备份;手动备份和首次同步备份不会被自动清理。
- 正在保护首次同步或失败恢复的备份不能删除。
- 如果恢复或回滚中断,BetterSaves 会暂停自动同步,并将恢复流程锁定到已记录的安全备份。
- 如果本地存在多个账户目录且无法安全匹配当前 Steam 账户,BetterSaves 会拒绝操作,不会猜测账户。
手动 profile 备份不会包含账户级 `profile.save` 和 `settings.save`,因此恢复一个 profile 不会替换其他 profile、当前槽位选择、全局设置或其他 Steam 账户的数据。
选择 `关闭同步` 时仍可执行恢复,恢复操作也不会擅自改变当前互通模式。
## 数据位置
BetterSaves 将配置和备份保存在系统应用数据目录:
| 系统 | BetterSaves 数据目录 |
| --- | --- |
| Windows | `%AppData%/SlayTheSpire2/mods/BetterSaves/` |
| Linux | `${XDG_CONFIG_HOME:-~/.config}/SlayTheSpire2/mods/BetterSaves/` |
| macOS | `~/Library/Application Support/SlayTheSpire2/mods/BetterSaves/` |
Windows 与 Linux 是当前发布目标。macOS 路径仅说明代码使用的应用数据目录结构,目前尚未完成 macOS 运行兼容性验证。
重要路径:
```text
config.json
backups/manual/
backups/first-sync-<时间戳>/
```
完整的首次同步备份包含 `backup-complete.json`;手动备份和恢复前备份包含 `manual-backup.json`。
## Steam 云与兼容性
- 本地同步或恢复成功后,BetterSaves 会根据当前互通模式上传需要镜像的文件。
- BetterSaves 不会删除 Steam 云文件。这样可以保护其他设备,但也意味着云端存在、所选本地备份中不存在的文件之后可能再次出现。
- Steam 云启动时序可能导致另一台设备延迟看到变化。共享同一存档的所有设备应使用相同版本的 BetterSaves。
- 多人当前局互通比单人更难预测,因为原版与模组会话可能使用不同的本机玩家标识。
- 《杀戮尖塔 2》更新可能改变模组依赖的游戏内部方法。游戏更新后请优先使用最新 BetterSaves 版本。
### Linux 运行库错误
如果启动时出现 Harmony 或 `mm-exhelper.so` 错误,并提到 `_Unwind_RaiseException`,请确认游戏进程能够访问 `libgcc-s1`、`libstdc++6` 和 `libunwind8`。
NixOS、Flatpak 等沙箱化 Steam 环境可能需要在 Steam 启动选项中指定:
```text
LD_PRELOAD+=":/path/to/libgcc_s.so.1" %command%
```
使用 nix-ld 的 NixOS 常见路径:
```text
LD_PRELOAD+=":/run/current-system/sw/share/nix-ld/lib/libgcc_s.so.1" %command%
```
## 故障恢复步骤
如果 BetterSaves 提示首次同步或恢复已被阻断:
1. 不要删除或覆盖提示中显示的备份目录。
2. 返回主菜单并打开 `恢复备份`。
3. 恢复警告指定的安全备份。
4. 保持游戏运行,等待 profile 重新加载完成。
5. 如果无法在游戏内恢复,请先复制整个 BetterSaves 数据目录,再尝试手动修复;反馈问题时请同时提供最新游戏日志。
