ZeldaWWHDRecomp存档状态与崩溃恢复指南:你的游戏最完整的安全网
ZeldaWWHDRecomp存档状态与崩溃恢复指南:你的游戏最完整的安全网
ZeldaWWHDRecomp 是《塞尔达传说:风之杖 HD》(Zelda Wind Waker HD)的开源原生移植项目。它内置了存档状态(Save States)5 个快速槽位与崩溃恢复(Crash Recovery)自动备份两套机制,让你的冒险进度几乎永不丢失。本文将带你快速掌握这些"安全网"的开启方法与日常用法。
🗂️ 一图看懂:便携存档与完整存档的区别
ZeldaWWHDRecomp 的每个存档槽位都支持两种状态文件,它们互不覆盖、共存于同一个槽位:
| 对比项 | 便携存档(默认) | 完整存档(调试用) |
|---|---|---|
| 文件 | slotN.wwstate |
slotN.bin |
| 体积 | 几 KB(超过 64 KB 会被拒绝) | 约 270–300 MB |
| 内容 | 当前 Quest Log 的进度 + 林克位置等,不含游戏数据 | 全部游戏内存(含代码与资源) |
| 能否分享 | ✅ 可放心附在 Bug 报告里 | ❌ 含游戏代码与数据,切勿分享 |
| 加载范围 | 同一游戏的任意会话、任意构建 | 仅限相同构建、原样恢复 |
| 精确度 | 非精确快照(敌人/过场会重置) | 完全精确 |
💡 加载某个槽位时,程序会自动读取其中较新的那种文件;如果你同时存有新旧两种文件,Saves 标签页也会在槽位下方明确提示"also holds an older full state",避免大文件被遗忘。
完整的格式说明(字段清单、校验规则、加载流程)见官方文档 docs/portable-save-states.md。
⌨️ 存档快捷键速查:30 秒上手 5 个存档槽位
最日常的"秒存秒读"靠键盘即可完成,每个槽位都会显示保存时间和所在区域,重启后依然有效:
| 操作 | 按键 |
|---|---|
| 保存到槽位 1–5 | Shift+F1 – Shift+F5 |
| 读取槽位 2–5 | F2 – F5 |
| 读取槽位 1 | 打开 F1 设置浮层的 Save States 菜单 |
几个容易忽略但很好用的细节:
- 🚢 船上也能存:林克在小船(The Wind Waker)上保存的状态,读取后林克会重新坐上船,船的位置和航向都会还原。
- ⚠️ 便携存档的限制:只有在你控制林克时才能保存——过场动画、对话、换场景、骑乘其他 NPC 时会被拒绝,屏幕会提示"can't save during a cutscene or dialogue",日志里也会写明具体原因。完整存档和崩溃恢复的自动存档则随时可存。
- 🔄 跨 Quest Log 加载:从别的 Quest Log 保存的状态,可以加载进当前正在玩的 Quest Log,画面会提示几句(之后在游戏内存档就会写进当前文件)。
- 📄 报告 Bug 更方便:Saves 标签页的 Copy save for bug report 会一键复制最新便携存档和
cking.sav的路径,直接附给开发者即可复现。
🛡️ 如何开启崩溃恢复(Crash Recovery)自动备份
这是本项目最有特色的一道安全网:每 2 分钟自动保存一次完整状态,并同时记录手柄输入,即使游戏闪退,你最多只损失两分钟的进度。
一键开启步骤
- 打开游戏内 Save States 菜单(或 F1 设置浮层的 Saves 标签页 → Crash Recovery 区域);
- 勾选 Crash Recovery (automatic state every few minutes);
- 选择立即生效,或设置环境变量
WWHD_CRASH_RECOVERY=1启动。
工作细节(实现位于 runtime/src/crashrec.cpp,设计说明见 runtime/src/crashrec.h):
- 自动存档写入
states/auto/目录下的 3 个循环槽位(auto1.bin–auto3.bin,每个约 260 MB),互相轮转覆盖,不会无限增长; - 每次存档会让游戏暂停约 0.1 秒,几乎无感;
- 存档点之后的每一次手柄输入都会被实时写入
autoN.input文件(无缓冲写入,崩溃也不丢); - 自动保存的开关记忆在
crash_recovery.cfg中,重启后依然生效;间隔时间可用WWHD_CRASH_RECOVERY_INTERVAL=<秒>调整(默认 120)。
在 Saves 标签页的 Crash Recovery 区域,你可以随时看到 3 个自动存档的保存时间与所在区域,并直接点击 Load 按钮回档——不一定要等到崩溃才用它。
🔍 崩溃后如何找回进度:日志 + 自动存档 + 输入回放
游戏每次崩溃都会写入 captures/crash-<time>.log,内容包括崩溃地址、寄存器、调用链、最后几行日志。开启崩溃恢复后,日志末尾会直接告诉你哪个自动存档属于本次会话、以及如何复现崩溃。
作为开发者,复现崩溃的标准流程是:
WWHD_REPLAY=<n> ./build/cmake/wwhd
这会自动加载第 n 个自动存档,并按顺序重放崩溃前录下的全部手柄输入——由游戏行为导致的崩溃几乎都能稳定复现(跨线程的时序性崩溃可能无法重现)。WWHD_REPLAY_AT=<帧号> 可指定回放开始的帧(默认 1500)。
🧭 对普通玩家来说更简单:崩溃重启游戏后,直接在 Save States 菜单 → Crash Recovery 里点最近一个自动存档的 Load,回到崩溃前 2 分钟内继续冒险即可。
🧰 实用工具:查看、转换与修复存档
项目自带一套纯 Python 3 的存档工具(tools/savegame/README.md),无需任何依赖:
| 工具 | 用途 |
|---|---|
| hd_save_info.py | 查看存档进度:血量、道具、歌曲、三贤者碎片、岛屿探索度等 |
| wwstate.py | 查看便携存档内容;或把 .wwstate 转成 cking.sav |
| gc2hd.py | 把 GameCube 时代的 .gci 老存档转换成 HD 存档 |
| wwsave.py | 存档修复,例如修复 Medli 剧情 Bug 的早期存档(repair-medli) |
典型用法示例(在存档副本上操作,工具绝不改动原文件):
# 看看某个便携存档里存了什么
python3 tools/savegame/wwstate.py info slot1.wwstate
# 查看 HD 存档的详细进度
python3 tools/savegame/hd_save_info.py path/to/cking.sav
# GameCube 老存档一键转 HD
python3 tools/savegame/gc2hd.py "My Save.gci" -o converted
❓ 常见问题与存档安全小贴士
存档文件放在哪里?
Saves 标签页会显示 states 文件夹的实际路径。macOS 源码构建在 ~/Library/Application Support/wwhd/states/;Windows 为 %LOCALAPPDATA%\WWHD;Linux 为 ~/.config/wwhd。游戏存档 cking.sav 在 data/save(或 save/user/)下。WWHD_STATE_DIR=<目录> 可把存档状态放到别处。
完整存档能不能分享给别人?
❌ 不能。slotN.bin 包含完整游戏代码与数据,分享它属于分发游戏内容。要分享进度请用默认的便携存档 .wwstate(几 KB、纯文本、自带 CRC-32 校验,格式守卫确保它永远不携带内存转储——测试见 runtime/tools/portable_state_test.cpp)。
退出游戏时怕丢进度? 关闭窗口时会弹出 Save State and Quit 选项,它会把当前进度写入槽位 1 再退出,下次直接读取即可。
自动存档占用磁盘太多? 3 个槽位共约 780 MB,且循环覆盖不再增长;如果你用不到,保持崩溃恢复关闭即可(默认就是关闭的)。
✅ 养成两个小习惯,进度就永远不会"真的丢":平时用 Shift+F 键勤存便携存档;遇到不稳定版本或长时间探索前,顺手把 Crash Recovery 打开。
更多机制细节可在 CHANGELOG.md 的"Crash logs and Crash Recovery"条目中追溯完整演进历史。