STS2存档

在 https://github.com/nyaoouo/sts-2-saves

# 杀戮尖塔2 存档

《杀戮尖塔2》存档管理模组，可更灵活地控制游戏存档。支持自动存档备份，在暂停菜单中创建手动快照，并内置存档管理器，方便读取、备份及删除已有存档快照。

## 本模组功能简介

- 每当游戏保存当前进度时，自动抓取并归档备份存档。
- 在暂停菜单中添加手动保存按钮。
- 新增存档浏览功能，支持恢复早期快照，不再依赖原版仅存的当前进度存档。
按运行次数及存档类型（自动存档与手动存档）分隔截图。
允许你将单个快照或整个存档运行导出到磁盘上的文件夹中。
- 在覆盖当前存档之前，先创建回滚副本。
支持单人及多人主机存档。

## 主要功能

### 1. 自动存档归档

当《杀戮尖塔2》写入当前存档时，STS2Saves会将该存档复制到自己的归档中。

单人模式的自动存档会自动归档。
多人游戏主机的自动存档默认会自动归档。
- 自动存档按所属局次归类。
默认存档模式每轮仅保留最近10个自动存档。

### 2. 手动存档快照

在游戏过程中，暂停菜单会额外增加两个操作：

- `存档`：为当前游戏进程创建手动保存点。
加载：打开当前模式的存档浏览器。

手动存档适合在危险事件、精英战、首领战或路线变更前使用。

### 3. 存档浏览器

存档浏览器是管理游戏存档的主界面。

从以下位置打开：

单人模式已存档的存档中，主菜单的“继续”按钮。
多人游戏存档回放的“加载”流程。
- 暂停菜单中的「读取」按钮（当你在游戏进行中时）

在浏览器中，你可以：

- 浏览存档记录。
展开冒险，即可查看「自动」和「手动」存档分组。
在右侧面板中查看存档详情。
- 加载选中的快照。
- 备份选中的快照。
- 备份整个通关存档。
删除选中的快照。
- 删除整个归档记录。

### 4. 安全回档恢复

当你还原某个快照时，模组会先为当前已有的活跃存档文件创建回滚副本。之后，它会将选定的归档快照写入到当前游戏存档位置。

这为你在恢复错误快照或想查看被替换内容时，提供了一层安全保障。

### 5. 导出 / 备份

`备份`操作将文件导出到磁盘上的普通文件夹中。

备份快照将导出 `.save` 文件及其元数据 `.json`。
- 备份存档时，将导出整个归档运行文件夹。

这有助于共享测试状态、在清理前保留存档进度，或在不同设备间迁移保存文件。

## 安装

### 选项1：安装打包好的版本

若已有编译好的发布压缩包，请将其解压至《杀戮尖塔2》的 `mods` 文件夹内，确保模组清单与DLL文件最终存放于如下格式的文件夹中：

请提供需要翻译的文本内容。
杀戮尖塔2
  mods/
    STS2存档/
      STS2Saves.dll
      STS2Saves.json
好的，请提供您需要翻译的文本内容。

### 方式二：从源代码编译

此项目面向Godot .NET，并直接引用本地《杀戮尖塔2》安装目录中的游戏DLL文件。

建造指令：

```powershell ```
在本地化上下文中，这行文本属于**命令行脚本或构建指令**，在游戏中通常不会直接出现给玩家看，而是作为开发者文档、调试工具内的说明或mod加载器使用的命令。 根据游戏语境，最自然的译文应是： **构建** D:\Games\SteamLibrary\steamapps\common\Slay the Spire 2\tools\sts-2-saves\STS2Saves.csproj 如果是在UI按钮或状态提示里，可简化为： **正在构建存档工具…** 但严格按照要求（保持原意且为中文），最终输出为： ``` 构建 D:\Games\SteamLibrary\steamapps\common\Slay the Spire 2\tools\sts-2-saves\STS2Saves.csproj ```
好的，请提供需要翻译的文本。

该项目配置为：

- 生成 DLL 文件。
将模组文件复制至游戏本地目录：`mods/STS2Saves/`。
将 `dist/STS2Saves.zip` 打包成压缩包。

## 使用方法

### 创建手动存档

1. 开始或继续冒险。
2. 打开暂停菜单。
3. 点击「保存」。
4. 存档中新增了手动快照。

### 载入旧存档

1. 从主菜单、多人模式加载流程或暂停菜单中打开存档浏览器。
2. 选择你想要进行的冒险。
3. 展开「自动」或「手动」存档。
4. 选择快照。
5. 按下“读取存档”。

该模组会将所选快照还原至当前存档位置，并加载该局游戏。

### 导出备份

1. 打开存档浏览器。
2. 选择快照或运行记录。
3. 按下“备份”。
4. 模组会在磁盘上生成一个导出文件夹。

### 删除旧存档

1. 打开存档浏览器。
2. 选择快照可删除单个存档，选择流程可删除全部存档。
3. 使用相应的删除操作。

## 保存储存布局

已归档文件存储在《杀戮尖塔2》当前存档路径下的模组专属文件夹中。

逻辑清晰

请提供需要翻译的文本内容。
<档案 作用域路径>/nymod.saves/
  档案/
    单人游戏/
      运行/
      回滚/
      exports/ （保留原样，作为路径或标识符）
    多人游戏/
      runs/ 奔跑/
      回滚/
      导出/
  config.json
好的，请提供需要翻译的文本内容。

备注：

`runs/` 目录包含自动存档和手动存档。
- `rollback/` 目录包含执行恢复操作前已有的活跃存档副本。
`exports/` 目录包含从浏览器生成的快照或运行备份。
`config.json` 存储了留存与行为设置。

## 设置

此模组当前无游戏内设置界面。配置信息保存在 `config.json` 文件中，若该文件不存在，则使用默认设置。

当前设置：

- `autosave_retention_mode`: `全部保留` 或 `仅保留最新`
- `autosave_cap_per_run`：使用“仅保留最近存档”时，每轮保留的最大自动存档数
- `capture_multiplayer_autosaves`：启用多人主机自动存档
- `manual_names_include_sequence`
确认删除运行记录

示例：

```json { "language": "中文", "translation": { "text": "请输入您要翻译的游戏文本，我会自动识别源语言并完成专业本地化。" } } ```
{
  "schema_version": 1
  "autosave_retention_mode": "保留最新存档"
  "单次自动存档上限": 10
  "capture_multiplayer_autosaves": true,
  "manual_names_include_sequence": true
  "confirm_run_deletion": true
}
好的，请提供需要翻译的文本内容。

## 当前行为备注

多人模式下的存档/读档操作仅限主机进行，客户端无法执行。
- 存档文件与当前游戏进行中的进度分开存放。
本地化内容在运行时直接嵌入至DLL中，而非以零散的JSON文件形式发布。