maze_python/md/SAVE_SYSTEM_README.md

99 lines
3.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 存档系统使用说明
## 新增功能
### 🎮 完整的存档系统
现在游戏支持完整的存档和读档功能,不仅保存迷宫结构,还会保存路径信息和当前进度。
### 🎯 功能特性
#### 1. 保存功能
- **CSV保存**: 点击 "保存" 按钮保存迷宫结构到CSV文件兼容旧版本
- **完整存档**: 使用 `Ctrl+S` 或点击 "读档" 按钮选择 "新建" 保存完整游戏状态
#### 2. 读档功能
- **存档列表**: 点击 "读档" 按钮查看所有可用存档
- **快速读档**: 使用 `Ctrl+L` 快速打开读档界面
#### 3. 存档管理
- **存档信息**: 显示存档名称、保存时间和迷宫大小
- **删除存档**: 选中存档后按 `Delete` 键删除
- **存档排序**: 按保存时间倒序排列
### 🔧 操作方法
#### 保存游戏
1. **快速保存**: `Ctrl+S` - 使用时间戳自动命名
2. **命名保存**:
- 点击 "读档" 按钮
-`N` 键新建存档
- 输入存档名称
- 按回车确认
#### 加载游戏
1. **打开界面**: 点击 "读档" 按钮或按 `Ctrl+L`
2. **选择存档**: 使用↑↓键选择或直接点击
3. **加载**: 按回车键或双击加载选中的存档
4. **关闭**: 按 `ESC` 关闭界面
#### 管理存档
- **删除存档**: 选中后按 `Delete`
- **查看信息**: 存档列表显示名称和保存时间
### 📁 存档文件结构
存档保存在 `saves/` 目录下:
```
saves/
├── maze_save_20231229_143022.json # 完整存档文件
├── maze_save_20231229_143022_maze.csv # 对应的CSV文件
└── ...
```
#### 存档内容包括:
- **元数据**: 存档名称、时间、迷宫尺寸
- **迷宫数据**: 完整的迷宫结构
- **路径数据**: 完整路径、当前步数、完成状态
### 🎨 界面说明
#### 存档界面控制:
- **↑↓键**: 选择存档
- **回车**: 加载选中的存档
- **Delete**: 删除选中的存档
- **N键**: 新建存档
- **ESC**: 关闭界面
#### 键盘快捷键:
- **Ctrl+S**: 快速保存当前游戏状态
- **Ctrl+L**: 打开读档界面
- **空格**: 路径下一步
- **R键**: 重置路径
- **A键**: 自动播放切换
### 💡 使用技巧
1. **定期保存**: 在路径规划的关键点保存进度
2. **命名规范**: 使用有意义的存档名称便于识别
3. **备份重要存档**: 重要的迷宫解法可以导出CSV备份
4. **清理存档**: 定期删除不需要的存档文件
### 🔄 兼容性
- **向后兼容**: 依然支持CSV格式的迷宫文件
- **数据完整**: 新存档格式包含完整的游戏状态
- **灵活切换**: 可以在新旧保存方式之间自由选择
### 📝 注意事项
1. 存档文件使用JSON格式包含完整的游戏状态
2. 删除存档操作不可撤销,请谨慎操作
3. 存档目录会自动创建,无需手动设置
4. 加载存档会覆盖当前游戏状态
现在你可以:
- 在解谜过程中随时保存进度
- 尝试不同的路径策略
- 保存有趣的迷宫布局
- 与他人分享迷宫存档