maze_python/md/SAVE_SYSTEM_README.md

存档系统使用说明

新增功能

🎮 完整的存档系统

现在游戏支持完整的存档和读档功能，不仅保存迷宫结构，还会保存路径信息和当前进度。

🎯 功能特性

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. 加载存档会覆盖当前游戏状态

现在你可以：

• 在解谜过程中随时保存进度
• 尝试不同的路径策略
• 保存有趣的迷宫布局
• 与他人分享迷宫存档