
纯二进制保存(测试)
使用压缩二进制存储并自动后台备份XML来优化保存和加载时间。安全、可靠且完全可逆。
查看大图[center]
[size=6][b][color=#d48806]PureBinarySave[/color][/b][/size]
[size=4][i]适用于星露谷物语 1.6+ 的轻量、无侵入式存档与读档优化模组[/i][/size]
[b][color=#1890ff]瞬间就寝存档[/color] • [color=#52c41a]亚秒级加载[/color] • [color=#fa8c16]自动同步原版 XML[/color][/b]
[/center]
[line]
[size=5][b]📖 这个模组是做什么的?[/b][/size]
在原版星露谷物语中(尤其是安装了模组后),存档会以大型未压缩的 XML 文本文件形式存储——大小通常可达 [b]15 到 30+ MB[/b]。
每当你的农夫去睡觉时,游戏会在黑屏状态下暂停一切,将这个庞大的文本文件写入磁盘。加载存档时,读取并解析这个大型 XML 文件会导致明显的加载画面等待时间。
[b]PureBinarySave[/b] 精简了这一流程:
[list=1]
[][b]轻量存储[/b]:存档通过零分配流式处理压缩为紧凑的二进制格式([font=Courier New].bin[/font],约 900 KB)。[/]
[][b]平滑的夜晚过渡[/b]:就寝时,游戏优先保存为快速的二进制格式,让你无需忍受漫长的黑屏暂停即可过渡到早晨。[/]
[][b]后台原版备份[/b]:在你早上 6:00 醒来后,后台工作线程会静默地将你的存档镜像回标准的原版 XML 格式。你的存档文件在任何时候都保持为真正的星露谷物语存档。[/]
[/list]
[line]
[center]
[size=5][b]⚡ 性能双雄:与 UltraSmooth 搭配使用[/b][/size]
[/center]
[quote]
如果你想要星露谷物语的完整性能套件,本模组被设计为 [url=https://www.nexusmods.com/stardewvalley/mods/29675][b][color=#1890ff]UltraSmooth[/color][/b][/url] 的直接姊妹搭档:
[list]
[][b]UltraSmooth[/b] 负责渲染引擎:不限帧的高刷新率(144Hz+)、精确的帧节奏、视锥体剔除以及零卡顿的游戏体验。[/]
[][b]PureBinarySave[/b] 负责 I/O 管线:消除就寝存档卡顿和标题画面加载延迟。[/]
[]它们之间无缝通信:当 UltraSmooth 检测到游戏内高帧活动时,PureBinarySave 会节流其后台 XML 同步,以确保零微卡顿。此外,在运行 [b]A/B 测试模式[/b] 时,UltraSmooth 会自动暂停其内部的存档/读档优化,以便你测量 100% 真正的原版基线。[/]
[/list][/quote]
[line]
[size=5][b]✨ 功能特性[/b][/size]
[list]
[][b]更快的就寝存档[/b]:大幅减少睡觉时黑屏保存的延迟。[/]
[][b]更快的加载时间[/b]:读取紧凑的二进制数据,并利用标题画面的空闲时间在内存中准备你的存档。[/]
[][b]自动原版 XML 镜像[/b]:在后台保持一份完整的标准 XML 备份同步。[/]
[][b]自动修复保护[/b]:如果 XML 文件曾被中断(例如突然断电或崩溃),模组会在游戏启动时自动从二进制数据重建健康的 XML 文件。[/]
[][b]原子存档安全[/b]:存档先写入临时文件,并在替换现有文件前通过校验和验证。你前一天的备份始终会被保留。[/]
[][b]安全且干净的可逆性[/b]:你永远不会被锁定在本模组中。内置的一键还原功能可随时恢复干净的原版存档。[/]
[][b]内置 A/B 测试[/b]:通过配置或控制台直接对比原版 XML 与二进制的加载时间,在你自己的机器上查看差异。[/]
[/list]
[line]
[size=5][b]🛡️ 存档完整性与安全性[/b][/size]
我以极其谨慎的态度对待存档数据:
[list]
[]本模组[b]不会修改游戏对象、物品数据或自定义模组数据[/b]。它使用游戏官方的原生 [font=Courier New]SaveGame.serializer[/font] 来生成完全相同的数据——仅对磁盘存储格式进行压缩。[/]
[]兼容 [b]SpaceCore[/b]、[b]Content Patcher[/b]、自定义模组物品以及多人游戏。[/]
[]原子文件替换确保即使在保存过程中断电,前一天的存档也保持原样且安全。[/]
[/list]
[line]
[center]
[size=5][b]⚠️ 注意事项与良好习惯[/b][/size]
[/center]
[quote]
虽然模组具有自动化安全网,但请牢记以下几点:
[list]
[][b]醒来后等待几秒再按 Alt+F4[/b]:在早上 6:00,模组需要约 5–6 秒在后台完成原版 XML 文件的同步。虽然你的 [font=Courier New].bin[/font] 存档已经安全,但等待可确保原版 XML 备份也是最新的。[/]
[][b]分享存档或使用网页工具[/b]:如果你想将存档文件发送给玩原版的朋友,或上传到 [i]Stardew Checkup[/i] 等网站,请先运行控制台命令 [font=Courier New]restore_xml <SaveFolder>[/font],以便外部工具能够读取 XML。[/]
[][b]纯磁盘模式[/b]:如果你选择启用可选的“纯磁盘模式”(完全禁用 XML 写入以节省 SSD 空间),原版星露谷物语将无法看到你的存档,直到你运行 [font=Courier New]restore_xml[/font] 或禁用该选项。[/]
[/list][/quote]
[line]
[size=5][b]📥 安装与菜单支持[/b][/size]
[list=1]
[]安装 [b]SMAPI[/b](版本 4.0+)。[/]
[]下载本模组并将 [font=Courier New]PureBinarySave[/font] 解压到你的 [font=Courier New]Stardew Valley/Mods[/font] 文件夹中。[/]
[]开始游戏!一切开箱即用,无需任何设置。[/]
[/list]
[b]游戏内配置菜单:[/b]
完全兼容 [url=https://www.nexusmods.com/stardewvalley/mods/49437][b]Modern Config Menu (MCM)[/b][/url] 和 [url=https://www.nexusmods.com/stardewvalley/mods/5098][b]Generic Mod Config Menu (GMCM)[/b][/url]。你可以直接在游戏内标题画面配置设置和测试模式。
[color=#d48806][size=4][b]📌 重要:首次设置与存档文件行为[/b][/size][/color]
[list]
[][b]现有存档(在安装 PureBinarySave 之前创建的):[/b]
在安装 [b]PureBinarySave[/b] 后首次加载现有存档时,加载时间将是[b]标准的原版时长[/b]。这完全正常且是预期行为!
因为你的现有存档仅包含原始的原版 XML 文件,[b]PureBinarySave 必须先经过一次正常的原版加载[/b],以便游戏将你的数据读入内存。
一旦你玩过一天并在[b]就寝时睡觉存档[/b],[b]PureBinarySave[/b] 将自动压缩并生成优化后的 [font=Courier New].bin[/font] 二进制文件。
[color=#52c41a][b]从第二次加载开始,以及之后的每一次就寝存档,完整的二进制加速将永久生效![/b][/color]
[/]
[][b]新存档(在安装 PureBinarySave 之后创建的):[/b]
对于安装 [b]PureBinarySave[/b] 后创建的任何新角色或农场,模组从一开始就处于激活状态。一旦你完成第 1 天并去睡觉,[b]PureBinarySave[/b] 会立即写入二进制文件。[color=#52c41a][b]每一次加载和保存都将从第一天起享受最高速度,无需额外步骤。[/b][/color][/]
[/list]
[line]
[size=5][b]💻 控制台命令[/b][/size]
你可以随时在 SMAPI 控制台中运行以下命令:
[list]
[][font=Courier New][b]pbs_status[/b][/font] — 显示当前加载/保存时间明细和文件大小对比。[/]
[][font=Courier New][b]pbs_mode [binary|xml][/b][/font] — 在 PureBinary 加载器和原版 XML 加载器之间切换,用于 A/B 测试。[/]
[][font=Courier New][b]pbs_revert_all[/b][/font] — 将所有存档恢复为干净的原版 XML 并移除所有 [font=Courier New].bin[/font] 文件。[/]
[][font=Courier New][b]pbs_revert <SaveFolder>[/b][/font] — 将指定存档文件夹恢复为原版 XML 并移除其 [font=Courier New].bin[/font] 文件。[/]
[][font=Courier New][b]restore_xml <SaveFolder>[/b][/font] — 从二进制重建 XML 文件,但不移除 [font=Courier New].bin[/font] 文件。[/]
[][font=Courier New][b]pbs_test_roundtrip <SaveFolder>[/b][/font] — 对存档文件夹执行位精确验证测试。[/]
[/list]
[line]
[size=5][b]🧪 如何基准测试并验证速度差异(A/B 测试)[/b][/size]
想在你自己的 PC 上测量真实的加载速度差异?请按照以下分步基准测试指南操作,以确保准确、公平的对比:
[quote]
[color=#f5222d][b]⚠️ 第 0 步:测试前的先决条件[/b][/color]
[list=1]
[][b]暂时移除其他加载/保存模组:[/b] 如果你有涉及加载、快速加载、缓存或保存的模组,请在此测试期间将它们移出你的 [font=Courier New]Mods[/font] 文件夹。启用它们会干扰基线。[/]
[][b]使用一个现有的、已转换的存档文件:[/b]
[b]不要[/b]使用 5 秒前刚创建的全新农场!新存档尚未在就寝时保存过,因此没有二进制数据。
[i]请使用一个已安装 PureBinarySave 后至少加载进入游戏并上床睡过一次的存档(即其 [font=Courier New].bin[/font] 文件已生成)。[/i][/]
[/list][/quote]
[size=4][b]📊 基准测试步骤(之前 vs. 之后):[/b][/size]
[b]第 1 步 — 测试之前(原版 XML 速度):[/b]
[list=1]
[]启动游戏进入标题画面。[/]
[]打开配置菜单([b]MCM[/b] 或 [b]GMCM[/b])> [b]PureBinarySave[/b] > 将 [b]A/B 测试模式:开启[/b](这会强制游戏通过标准原版 XML 加载)。[/]
[]点击 [b]加载[/b] 并选择你的测试存档。记录屏幕上 / SMAPI 控制台中显示的加载时间。[/]
[]退出并[b]完全关闭游戏[/b]。[/]
[/list]
[b]第 2 步 — 测试之后(PureBinarySave 速度):[/b]
[list=1]
[]重新启动游戏进入标题画面。[/]
[]打开配置菜单 > [b]PureBinarySave[/b] > 将 [b]A/B 测试模式:关闭[/b](启用 PureBinary 加速)。[/]
[]选择与第 1 步[b]完全相同的存档文件[/b]并加载进入。[/]
[]查看你的新加载时间![/]
[/list]
[quote]
💡 [b]如何准确验证数字:[/b]
加载后,你可以查看 SMAPI 控制台或输入 [font=Courier New][b]pbs_status[/b][/font] 来查看模组记录的精确毫秒级时间明细![/quote]
[line]
[size=5][b]🗑️ 如何安全卸载[/b][/size]
我相信每个性能模组都应该易于移除:
[list=1]
[]在游戏中,打开你的配置菜单([url=https://www.nexusmods.com/stardewvalley/mods/49437][b]MCM[/b][/url] 或 [url=https://www.nexusmods.com/stardewvalley/mods/5098][b]GMCM[/b][/url])> [b]PureBinarySave[/b] > 滚动到底部并勾选 [b]“将所有存档还原为干净的原版 XML”[/b],然后保存。
[i](或者直接在 SMAPI 控制台中输入 [font=Courier New]pbs_revert_all[/font]。)[/i][/]
[]关闭游戏。[/]
[]从你的 [font=Courier New]Mods[/font] 目录中删除 [font=Courier New]PureBinarySave[/font] 文件夹。[/]
[]你的存档现在是 100% 干净的原版 XML 文件,就如同从未安装过该模组一样。[/]
[/list]
[line]
[size=5][b]❓ 常见问题[/b][/size]
[b]问:这会损坏我的存档或删除我的物品吗?[/b]
答:不会。本模组不会修改游戏逻辑、物品或 NPC。它仅使用游戏的标准序列化器改变存档流在磁盘上的存储和压缩方式。
[b]问:我可以使用存档编辑器或将存档上传到 Stardew Checkup 吗?[/b]
答:可以!由于模组在后台维护标准的原版 XML 文件,外部网页工具和存档编辑器可以正常读取你的存档文件夹。
[b]问:在游戏中途添加安全吗?[/b]
答:安全!现有存档将被正常读取,并在你下次保存时自动转换为二进制格式。
[b]问:为什么我第一次加载现有存档时没有感觉到更快的加载速度?[/b]
答:在安装 [b]PureBinarySave[/b] 之前创建的存档尚无二进制文件——只有游戏原始的 XML 文件。因此,[b]PureBinarySave[/b] 必须通过标准原版方式读取存档[b]一次初始加载[/b]。一旦你上床睡觉并保存,[b]PureBinarySave[/b] 会自动生成高速 [font=Courier New].bin[/font] 文件。从你下一次加载开始,它将通过高速二进制加载。(安装 [b]PureBinarySave[/b] 后开始的任何新农场都将从第一天起拥有二进制加速!)
[line]
[center]
[size=5][b]☕ 支持与捐赠[/b][/size]
[i]如果你喜欢我的模组并愿意支持我的工作,可以在 Ko-fi 上给我打赏。
这完全是可选的——感谢你的支持![/i]
[url=https://ko-fi.com/palmhacker][size=4][b][color=#ff5e5b]☕ 在 Ko-fi 上支持我[/color][/b][/size][/url]
[/center]
[line]
[center]
[size=5][b]📦 前置要求[/b][/size]
[b]Stardew Valley 1.6+[/b] • [b]SMAPI 4.0+[/b]
[/center]
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。