发布日期：2026-06-25
版本概述
v0.5.5 是项目更名为 VoxVer Launcher 后的首个重要版本。本次更新围绕主题系统、国际化、Mod 生态三大主线展开，完成了浅色/深色主题切换、背景自定义、主题色自定义、i18n 完整接入、Mod 依赖管理、虚拟滚动优化、单元测试覆盖等工作，累计修改 46+ 个文件，是迄今为止功能最丰富的一个版本。
主要更新
🔄 项目更名：MCLA → VoxVer Launcher
本项目正式从 MCLA（Minecraft Launcher Alpha） 更名为 VoxVer Launcher。更名涉及全量代码迁移：
| 迁移项 |
详情 |
| CSS 变量 |
--mcla- → --voxver-，46 个文件约 1400 处 |
| localStorage |
mcla_ → voxver_，8 处 key 迁移 |
| 日志/注释 |
[MCLA] → [VoxVer]，10+ 文件同步更新 |
| 安装包名称 |
MCLA Setup → VoxVer Launcher Setup |
| 品牌资源 |
Logo 及图标替换为 VoxVer 品牌标识 |
| 向下兼容 |
保留旧 key 降级读取，确保已有用户设置不丢失 |
🎨 主题系统
1. 浅色/深色主题切换
- 设置 → 外观 → 主题模式，支持深色/浅色一键切换
- 14+ 组件添加浅色覆盖样式（侧边栏、标题栏、标签页、下拉菜单、进度条、头像组、分割线等）
- 浅色模式下所有渐变色自动切换为柔和色调
2. 背景自定义
- 图片选择：支持选择本地图片作为应用背景
- 模糊调节：滑条控制高斯模糊程度（0-20px）
- 暗化调节：滑条控制背景暗化程度（0-100%）
- 叠加色取色器：自由选择背景叠加颜色
3. 主题色自定义
- 预设色盘：提供 9 种预设颜色供快速选择
- 自定义取色器：支持任意颜色选择
- 自动生成 13 个色阶变量（
-50 至 -900、-light、-hover、-active、-muted）
- 持久化存储，刷新后自动恢复
4. 外观设置
- 字号调节：范围滑条（12-20px）
- 动画开关：全局过渡动画
- 特效开关：全局视觉效果
- 音效开关：全局交互音效
🌐 i18n 国际化
页面翻译接入
- InstancesPage：新建/导入/导出实例弹窗接入翻译
- InstanceDetail：基本信息、Java/内存设置、Mod 列表、配置文件列表
- ReceiveModal / ShareModal：分享/接收功能完整翻译
- VersionSelect：版本选择器组件
翻译资源
- 中文 800+ / 英文 800+ 翻译键值对
- 覆盖模块：common、instance、component、mod、game、settings、theme
- 修复 74 处
title 属性硬编码文本
- 修复
confirm() 弹窗硬编码文本
📦 Mod 生态
Mod 依赖管理
- 依赖检测：通过 Modrinth API 获取 Mod 的完整依赖信息
- 自动安装：自动下载并安装缺失的 required 依赖
- IPC 通道：
mod:check-dependencies + mod:install-dependencies
- 前端交互：依赖检查按钮、缺失依赖角标、安装依赖按钮、进度提示
ModLoader 安装完善
| 加载器 |
状态 |
说明 |
| Fabric |
✅ |
支持指定版本安装 |
| Forge |
✅ |
修复 loaderVersion 参数传递 |
| NeoForge |
✅ |
修复参数签名不匹配 |
| Quilt |
✅ |
修复参数签名不匹配 |
⚡ 性能优化
虚拟滚动
- 通用
VirtualScroll 组件：支持固定高度、overscan 预渲染、自定义 key
- 版本列表：VersionsPage 采用虚拟滚动处理大量数据
- Mod 列表：ModManager 采用虚拟滚动
单元测试
- 9 个测试文件，130 个测试用例，全部通过
- 覆盖：工具函数 format.ts（98.85%）、i18n 翻译、路由配置、Pinia Store（app/accounts/instances/download）、VirtualScroll 组件
- 框架：Vitest + @vue/test-utils + jsdom
🔌 Share API 完善
- preload 接入：
startInstance、stopShare、receiveInstance、importReceived、closeSession、getSession
- 事件监听：
onPackProgress、onSessionUpdate、onProgressUpdate
构建产物
| 平台 |
文件名 |
说明 |
| Windows |
VoxVer Launcher Setup 0.5.5.exe |
NSIS 安装程序 |
| Windows |
VoxVer Launcher Setup 0.5.5.exe.blockmap |
增量更新块映射 |
| Windows |
win-unpacked/ |
绿色免安装版 |
任务完成清单
| 优先级 |
任务 |
状态 |
| P0 |
项目更名（MCLA → VoxVer Launcher） |
✅ |
| P1 |
i18n 国际化接入（410+ 处 $t() 调用） |
✅ |
| P1 |
UI/UX 优化（74 处 title 修复） |
✅ |
| P1 |
Forge/NeoForge/Quilt 安装完善 |
✅ |
| P2 |
Mod 依赖管理（Modrinth API） |
✅ |
| P2 |
虚拟滚动优化（VirtualScroll 组件） |
✅ |
| P2 |
单元测试覆盖（130 用例全部通过） |
✅ |
| P3 |
浅色/深色主题完整切换 |
✅ |
| P3+ |
外观设置（字号/动画/特效/音效） |
✅ |
| P3+ |
背景自定义（图片/模糊/暗化/叠加） |
✅ |
| P3+ |
主题色自定义（13 色阶 + 持久化） |
✅ |
| P3+ |
CSS 变量统一（1400 处 --mcla- → --voxver-） |
✅ |
| P3+ |
localStorage 迁移（8 处 mcla_ → voxver_） |
✅ |
| P3+ |
Share API 完善 |
✅ |
技术栈
- 框架：Electron 33.4.11 + Vite + Vue 3
- UI：像素风设计系统（Press Start 2P 字体）
- 数据库：SQLite（better-sqlite3）
- 构建：electron-builder 25.x
- 测试：Vitest 2.0 + @vue/test-utils + jsdom
- CI/CD：GitHub Actions
- 国际化：vue-i18n 9.x
兼容性说明
| 项目 |
要求 |
| 最低系统 |
Windows 10（64-bit） |
| 推荐内存 |
8GB+ |
| 磁盘空间 |
500MB（不含游戏数据） |
| Java 版本 |
8+（推荐 17+） |
已知问题
- 首次启动：初次运行可能需要等待资源加载
- P2P 连接：部分网络环境下 P2P 分享连接可能不稳定
后续规划
| 版本 |
规划功能 |
| v0.6.x |
资源包管理、Java 自动检测、启动优化 |
| v1.0.0 |
稳定版：完整功能 + 完善文档 |
VoxVer Launcher — 开源 Minecraft 启动器
