loz-tmc-save-editor

塞尔达传说：缩小帽 存档编辑器
Legend of Zelda: The Minish Cap Save Editor

---

编辑器预览

• 亮色主题

• 暗色主题

---

功能特性

一个现代化的 GBA 存档编辑器，支持《塞尔达传说：缩小帽》的存档文件编辑。

核心功能

• 存档管理: 打开/保存 .sav 和 .SaveRAM 格式文件
• 多槽位支持: 支持编辑 3 个存档槽位
• 保存确认: 保存时提供保存/另存为/取消选项
• 校验和计算: 自动更新存档校验和

可编辑内容

类别	功能
基础状态	名称、生命值、心之碎片、三角力量、帽子状态
金钱物资	卢比、箭矢、炸弹及其容量等级
武器装备	剑（4级）、盾（2级）、弓（2级）、回旋镖（2级）、炸弹（2种）
道具	风之壶、帕奇之杖、鼹鼠手套、提灯、飞马靴、洛克披风、风之陶笛
瓶子	4 个瓶子及 16 种内容物
位置	区域（88种）、房间、坐标、出生动画（12种）
设置	亮度、文字速度

特色功能

• 🌍 多语言: 中文（默认）/ English / 日本語
• 🎨 主题切换: 亮色 / 暗色 / 跟随系统
• ⚡ 快捷功能: 一键全部最大化、解锁全部道具
• 🔍 区域检测: 自动检测存档版本

安装

方式一：直接下载

从 Releases 页面下载对应平台的可执行文件：

平台	文件名	说明
Windows	loz-tmc-save-editor-x.x.x-windows-x64.zip	64位 Windows
macOS (Apple Silicon)	loz-tmc-save-editor-x.x.x-macos-arm64.zip	M1/M2/M3 芯片
macOS (Intel)	loz-tmc-save-editor-x.x.x-macos-x64.zip	Intel 芯片
Linux	loz-tmc-save-editor-x.x.x-linux-x64.tar.gz	64位 Linux

方式二：从源码运行

# 克隆仓库
git clone https://github.com/your-username/loz-tmc-save-editor.git
cd loz-tmc-save-editor

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 运行
python main.py

构建

环境要求

• Python 3.10+
• pip
• 网络连接（用于下载依赖）

macOS / Linux

# 添加执行权限
chmod +x build.sh

# 标准构建
./build.sh

# 清理后重新构建
./build.sh --clean

# 使用系统 Python（跳过虚拟环境）
./build.sh --no-venv

# 查看帮助
./build.sh --help

Windows

REM 标准构建
build-windows.bat

REM 清理后重新构建
build-windows.bat --clean

REM 使用系统 Python
build-windows.bat --no-venv

构建产物

构建完成后，产物位于 dist/ 目录：

平台	产物
Windows	loz-tmc-save-editor.exe + .zip 压缩包
macOS	loz-tmc-save-editor.app 或单文件 + .zip 压缩包
Linux	loz-tmc-save-editor 单文件 + .tar.gz 压缩包

GitHub Actions 自动构建

项目配置了 GitHub Actions 自动构建，支持：

• 自动构建: 推送到 main/master 分支或 PR 时自动构建
• 多平台: Windows x64, macOS (arm64 + x64), Linux x64
• 自动发布: 推送 v* 标签时自动创建 Release

发布新版本

# 打标签并推送
git tag v1.0.0
git push origin v1.0.0

使用说明

基本操作

1. 打开文件: 文件 > 打开 或 Ctrl+O (macOS: Cmd+O)
2. 选择槽位: 从顶部下拉框选择存档槽位 (1/2/3)
3. 编辑数据: 修改各项属性值
4. 保存文件: 文件 > 保存 或 Ctrl+S (macOS: Cmd+S)

快捷功能

• 全部最大化: 生命、卢比、箭矢、炸弹全部设为最大值
• 解锁全部道具: 解锁所有武器、道具、瓶子

切换语言

语言 菜单 > 选择 中文 / English / 日本語

切换主题

主题 菜单 > 选择 亮色 / 暗色 / 跟随系统

支持的文件格式

模拟器	格式	扩展名
mGBA	SRAM	.sav
Bizhawk	SaveRAM	.SaveRAM
VBA-M	SRAM	.sav
NO$GBA	SRAM	.sav

技术架构

loz-tmc-save-editor/
├── main.py                  # 入口点
├── src/
│   ├── core/                # 核心逻辑
│   │   ├── constants.py     # 游戏常量（偏移地址、枚举值）
│   │   ├── models.py        # 存档数据模型（dataclass）
│   │   └── sram.py          # SRAM 读写操作
│   ├── ui/                  # 用户界面
│   │   ├── main_window.py   # 主窗口
│   │   ├── styles.py        # 样式管理（主题）
│   │   └── widgets/         # 自定义组件
│   └── i18n/                # 国际化
│       ├── manager.py       # 语言管理器
│       └── strings/         # 翻译文本 (zh/en/ja)
├── resources/               # 资源文件
├── .github/workflows/       # CI/CD 配置
├── requirements.txt         # Python 依赖
├── pyproject.toml           # 项目元数据
├── build.sh                 # macOS/Linux 构建脚本
└── build-windows.bat        # Windows 构建脚本

开发

技术栈

• Python 3.10+
• PySide6 (Qt for Python) - GUI 框架
• PyInstaller - 跨平台打包

代码规范

• PEP 8
• Type hints
• Docstrings

运行测试

python -m pytest tests/

开发依赖

pip install -e ".[dev]"

致谢

• 原项目 TMC-Save-Editor - Python/PyQt5 实现
• 缩小帽存档偏移文档

许可证

MIT License - 详见 LICENSE

---

Made with ❤️ for Zelda fans