存档搜索（由SerpentineShel制作）

保存搜索

为《博德之门 3》的“读取游戏”和“保存游戏”界面添加一个搜索面板。输入几个字母，面板便会按名称、按周目、按地点或按日期筛选你拥有的所有存档。点击一个结果，游戏自带的列表便会跳转到该存档——分组展开、该行高亮、预览更新、读取按钮就绪。本模组只读取游戏的存档列表，从不写入：不会更改任何存档文件、文件夹或名称。

如果你拥有数百个存档、横跨数十个周目，原版“读取”界面就只有一条滚动条和大量耐心。存档按周目分组，分组是折叠的，而且没有搜索框。想找到“去年十一月那场 Durge 周目的营地存档”，就意味着要一个接一个地打开分组。保存搜索把整个列表放入一个扁平、可筛选的面板——输入时 800 个存档收窄到 3 个——然后替你完成滚动。

为什么是搜索面板而不是存档管理器？有一些优秀的外部程序可以在游戏外列出并重命名你的存档文件夹。这是相反的做法：它[ i]位于[ /i]游戏内，就在你已经看着的界面上，而且不更改磁盘上的任何内容。它找到存档，然后把它交给原版的读取按钮。

无需附属程序，无需外部工具。单个 pak 文件。一切都在游戏内运行。

[line]
[size=4][b]
使用方法——请阅读
保存搜索需要模组配置菜单（MCM），并且加载顺序在它之上。热键和所有选项都在那里。
[/b][/size]
[list]
[ *][size=4][b]打开“读取游戏”界面（主菜单，或游戏中按 ESC → 读取）——或游戏中的“保存游戏”界面。[ /b][ /size][/*]
[ *][size=4][b]按 Ctrl+Shift+F。面板会打开。在任何其他界面，该热键都不会有任何反应，静默无响应。[ /b][ /size][/*]
[ *][size=4][b]输入。顶部框匹配任何内容：存档名称、周目、地点、显示日期。第二个框仅匹配周目（角色）名称。三个日期框分别接受日、月、年；任意留空表示“任意”。[ /b][ /size][/*]
[ *][size=4][b]点击一个结果。该存档会在原版列表中被选中，就像你在那里点击了它一样：预览窗格更新，“读取游戏”按钮变为可用，该存档的周目分组展开，列表滚动到高亮行。[ /b][ /size][/*]
[ *][size=4][b]按游戏自带的“读取游戏”按钮。保存搜索自身从不加载任何内容——这是有意为之。[ /b][ /size][/*]
[/list][size=4][b]在“保存游戏”界面上要小心。在那里选择一个现有存档会把游戏主按钮变为“覆盖”，从而替换该存档。只要你在该界面上，面板就会在状态行中警告你。保存搜索自身从不覆盖任何内容。

[/b][ /size]
[line]
[size=4][b]
功能
[/b][/size]
[list]
[ *][size=4][b]一个扁平、可搜索的列表，包含你拥有的每一个存档，按最新优先排序，带编号，横跨每个周目——包括原版界面保持折叠的那些。自动存档、快速存档、手动存档和荣誉模式存档都在其中。[ /b][ /size][/*]
[ *][size=4][b]搜索任何内容。主框同时匹配存档标题、周目、地点和日期文本，多个词必须全部匹配，因此 [ i]karlach camp[ /i] 比任一单词单独筛选更严格。[ /b][ /size][/*]
[ *][size=4][b]按周目搜索。专用框仅匹配原版界面用作分组标题的角色/战役名称——这是从数十个周目中分离出一个的最快方式。[ /b][ /size][/*]
[ *][size=4][b]按日期搜索。独立的日、月、年框。在月框输入 [ i]11[ /i]、在年框输入 [ i]2024[ /i]，即可得到 2024 年 11 月的所有存档，横跨每个周目。[ /b][ /size][/*]
[ *][size=4][b]跳转到原版列表中的该存档。BG3 延迟构建存档列表，且未向模组暴露任何“滚动到此项”的调用，因此保存搜索通过滚动和检查来定位该行，然后将其放在靠近顶部的位置。落点位置可在 MCM 中调整。[ /b][ /size][/*]
[ *][size=4][b]逐条浏览匹配项。“上一个/下一个”遍历筛选后的结果，依次选中每个，让你可以在预览窗格中查看多个候选，而无需自己翻找列表。除非你关闭 [ i]将游戏列表滚动到所选存档[ /i]，否则列表会跟随。[ /b][ /size][/*]
[ *][size=4][b]荣誉模式和损坏的存档会在结果中被标记，并带有游戏自身的有效性标记（一个简短的引擎标签，例如 [ i]ModsMissing[ /i]），用于存档过旧、过新或无法加载的情况。[ /b][ /size][/*]
[ *][size=4][b]它只读取，不写入。保存搜索不触碰任何存档文件、文件夹、.lsv、截图或名称。它自己的设置保存在 MCM 的按配置文件存储中，而非你的存档中。[ /b][ /size][/*]
[ *][size=4][b]无轮询。没有每帧运行的内容。面板在首次打开时构建。[ /b][ /size][/*]
[ *][size=4][b]不替换任何游戏文件。保存搜索不附带 XAML，也不覆盖任何内容，因此不会与其他界面模组冲突。[ /b][ /size][/*]
[/list]

[line]
[size=4][b]
需求
[/b][/size]
[list]
[ *][size=4][b]《博德之门 3》，第 8 版补丁或更高版本。[ /b][ /size][/*]
[ *][size=4][b]BG3 脚本扩展器，版本 29 或更高——必需。https://github.com/Norbyte/bg3se[ /b][ /size][/*]
[ *][size=4][b]模组配置菜单（Nexus 9162）——必需，v1.40.1 或更高（pak 将其声明为硬依赖），并且加载顺序必须在保存搜索之上。[ /b][ /size][/*]
[ *][size=4][b]模组管理器，例如 BG3 Mod Manager——保存搜索必须在你的加载顺序中处于激活状态。[ /b][ /size][/*]
[ *][size=4][b]Windows。脚本扩展器仅支持 Windows。[ /b][ /size][/*]
[/list][size=4][b]仅限键盘和鼠标。面板不支持控制器导航；原版界面未被改动。

[/b][ / size]
[line]
[size=4][b]
安装
[/b][/size]
[list=1]
[ *][size=4][b]解压并将 SaveSearch.pak 复制到 %LocalAppData%\Larian Studios\Baldur's Gate 3\Mods。[ /b][ /size][/*]
[ *][size=4][b]在 BG3 Mod Manager 中，刷新，将保存搜索拖入“激活”列表，并把模组配置菜单放在它上面。[ /b][ /size][/*]
[ *][size=4][b]点击“保存加载顺序到文件”，然后启动。[ /b][ /size][/*]
[ *][size=4][b]进入“读取游戏”并按 Ctrl+Shift+F。[ /b][ /size][/*]
[/list][size=4][b]卸载时，请在删除 pak 之前先在模组管理器中停用它并导出加载顺序。删除仍在加载顺序中列出的 pak 会导致 BG3 拒绝整个列表——这是 BG3 的标准行为，适用于所有模组。

完整详情、故障排除和设置参考都在随附的 README 和 INSTALL 文档中。

[/b][ / size]
[line]
[size=4][b]
设置
全部在 MCM 中，位于“保存搜索”下。热键出现在 MCM 自己的“热键”页面上。
[/b][/size]
[list]
[ *][size=4][b]启用保存搜索——总开关。[ /b][ /size][/*]
[ *][size=4][b]切换搜索面板——默认 Ctrl+Shift+F，可重新绑定。[ /b][ /size][/*]
[ *][size=4][b]立即打开保存搜索——一个与热键功能相同的按钮。[ /b][ /size][/*]
[ *][size=4][b]将游戏列表滚动到所选存档——默认开启。[ /b][ /size][/*]
[ *][size=4][b]同时搜索地点名称——默认开启。[ /b][ /size][/*]
[ *][size=4][b]游戏显示的日期顺序——日/月/年或月/日/年。[ /b][ /size][/*]
[ *][size=4][b]滚动落点位置——所选存档最终停在列表顶部下方多远。[ /b][ /size][/*]
[ *][size=4][b]最大结果行数——面板绘制多少行。[ /b][ /size][/*]
[/list]

[line]
[size=4][b]
已知限制
[/b][/size]
[list]
[ *][size=4][b]仅限键盘和鼠标。[ /b][ /size][/*]
[ *][size=4][b]列表在搜索时可能可见地滚动——BG3 未暴露直接跳转到某一项的方法。通常一两秒内会稳定下来，而且总会自行停止，但在目标位于很长的列表深处时，可能需要长达约半分钟。在此期间存档一直是选中且可加载的。[ /b][ /size][/*]
[ *][size=4][b]自动存档、快速存档和荣誉模式存档的行标题无论你的游戏语言为何都显示为英文；这些标题由引擎生成，而非存储在存档中。手动存档名称、周目名称和地点会完全按游戏显示的方式显示。[ /b][ /size][/*]
[ *][size=4][b]保存搜索从不加载或覆盖存档。这是设计使然：它只选择，由你按游戏按钮。在“保存游戏”界面上，该按钮是“覆盖”——按之前请看清楚。[ /b][ /size][/*]
[ *][size=4][b]主框按游戏报告的日期进行匹配。如果你将 [ i]日期顺序[ /i]设为月/日/年，面板会重新排列它显示的日期，因此输入显示的日期可能无法匹配；请使用日/月/年框按日期筛选。[ /b][ /size][/*]
[/list]

[line]
[size=4][b]
兼容性
保存搜索不替换任何游戏界面文件，因此不会与界面模组冲突。它是客户端侧的，不添加服务器或 Osiris 代码，也不向存档中写入任何内容——随时可安全添加或移除。

[/b][ / size]
[line]
[size=4][b]
鸣谢
[/b][/size]
[list]
[ *][size=4][b]作者——Serpentine（NexusMods：SerpentineShel）。[ /b][ /size][/*]
[ *][size=4][b]BG3 脚本扩展器——Norbyte。保存搜索完全构建于其上。[ /b][ /size][/*]
[ *][size=4][b]模组配置菜单——Volitio（AtilioA）及贡献者。[ /b][ /size][/*]
[ *][size=4][b]Larian Studios——感谢其“读取”和“保存”界面，本模组礼貌地从其肩后读取。[ /b][ /size][/*]
[/list][size=4][b]
AI 使用披露
保存搜索在开发过程中得到了 AI 编程助手（Anthropic 的 Claude）的大量协助，用于代码编写（脚本扩展器 Lua 和 MCM 蓝图）、研究和文档。本模组不包含任何 AI 生成的图像、图片、音频或其他媒体——只有代码和文本。所有设计决策、游戏内测试和最终发布均由作者完成。

许可证
MIT。保存搜索不捆绑任何第三方文件；完整源代码以纯文本形式随附在 pak 内。说明[ /b][ /size]