SaveState 的安装和配置教程

项目基础介绍

SaveState 是一个用户友好的图形界面应用程序，适用于 Windows 和 Linux 系统，用于轻松备份和恢复视频游戏保存文件。该项目特别适用于没有云存档功能的游戏，或者需要管理多个保存位置的情况。SaveState 通过压缩备份选定的游戏配置文件，并提供随时恢复的功能，来防止因文件损坏、意外删除或系统更改而丢失珍贵的游戏进度。

该项目主要使用 Python 编程语言开发，并利用 PySide6 构建图形用户界面。

项目使用的关键技术和框架

• PySide6：一个用于创建桌面应用程序的跨平台工具集，它是 Qt 框架的 Python 绑定。
• 图形用户界面：提供直观的交互方式，让用户可以轻松管理游戏存档。
• 压缩算法：使用 .zip 格式压缩备份文件，以节省存储空间。
• 自动化管理：自动删除旧备份，保持设定数量的备份。
• Steam 集成：自动检测 Steam 安装和库，识别游戏存档路径。
• 拖放操作：支持拖放游戏快捷方式来创建配置文件。

安装和配置准备工作

在开始安装 SaveState 之前，请确保您的系统满足以下要求：

• 操作系统：Windows（经过 Windows 10/11 测试）或 Linux（经过 Ubuntu 24.x LTS 测试）。
• Python：推荐版本 3.10 或更高版本（3.13 运行良好）。
• Pip：Python 包管理器（通常随 Python 一起安装）。

安装步骤

选项一：使用发布版本（推荐大部分用户）

Windows 用户

1. 访问 GitHub 的发布页面。
2. 下载最新版本中的 SaveState.exe 文件。
3. 将 SaveState.exe 放置在您喜欢的任何文件夹中，直接运行即可。无需安装！

Linux 用户

1. 访问 GitHub 的发布页面。
2. 下载最新版本中的 SaveState-linux.zip 文件。
3. 将 SaveState 解压到您喜欢的任何文件夹中，直接运行即可。无需安装！

选项二：从源代码运行（适用于开发或高级用户）

1. 确保您已安装 Python 3.10+ 和 Git。
2. 克隆仓库：git clone https://github.com/Matteo842/SaveState.git
3. 导航到项目目录：cd SaveState
4. （推荐）创建并激活虚拟环境：python -m venv venv（在 Windows 上使用 \venv\Scripts\activate，在 Linux/macOS 上使用 source venv/bin/activate）
5. 安装所需的依赖：pip install -r requirements.txt（注意：您需要先创建 requirements.txt 文件！）
6. 运行应用程序：python main.py

安装完成后，您可以按照应用程序的指示配置设置和添加配置文件。