VoxVer Launcher v0.6.4-mac适配+流程优化

发布日期：2026-07-17

概述

本次更新新增 macOS 系统适配，支持 ARM64（Apple Silicon）和 x64（Intel）双架构构建，同时优化了账户管理流程，点击"添加账户"按钮直接跳转到设置页面的"游戏账户与档案"标签页。

新增功能

macOS 系统适配

• 双架构构建：支持 ARM64（Apple Silicon）和 x64（Intel）两种架构的 DMG 安装包
• CI/CD 管道：新建 build-macos.yml GitHub Actions 工作流，自动构建 macOS 安装包
• Node.js 24 LTS：全工作流升级至 Node.js 24 LTS，适配 macOS 26 环境
• 依赖外部化：@aws-sdk/client-s3 外部化，解决 macOS 构建兼容性问题
• 编码修复：pixel-ui.css UTF-8 编码修复

账户管理流程优化

• 入口统一：点击下拉菜单中的"添加账户"/"添加离线账号"按钮，不再弹出独立的 AccountManager 弹窗
• 直接跳转：改为直接跳转到设置页面的"游戏账户与档案"标签页，操作路径更直接
• 体验连贯：用户在同一页面完成账户添加、编辑和管理，避免弹窗与页面之间的切换

修复优化

UI/UX 改进

• 移除了冗余的账户管理弹窗入口，统一到设置页面的账户管理区域

升级指南

从 v0.6.3 升级的用户：

1. "添加账户"按钮行为变更：之前打开弹窗，现在直接跳转到设置页
2. 所有账户管理操作统一在设置页面的"游戏账户与档案"标签页完成

VoxVer Launcher v0.6.3-构建更新

VoxVer Launcher v0.6.3

发布日期：2026-07-09

概述

本次更新新增启动器独立设置分类，将更新通道与自动检查更新从关于页面拆分至独立入口，同时重构更新检测弹窗、修复多项 UI 细节和 i18n 翻译缺失问题，并升级 CI/CD 管道以支持 macOS 双架构构建和 Node.js 24 运行时。

新增功能

启动器设置独立分类

• 侧边栏新入口：版权下方新增"启动器"条目，链路图标
• 更新通道：稳定版 / 测试版分段芯片切换，选中态以绿色（稳定）和黄色（测试）遮罩区分
• 自动检查更新：开启 / 关闭双芯片切换，开启绿色、关闭红色遮罩
• 状态指示：右侧实时显示当前通道和开关状态，带颜色圆点
• 快捷入口：主页新增"启动器设置"快捷卡片

更新弹窗重构

• 检测到新版本自动弹出居中 Modal，展示版本号（绿色高亮）+ 更新日志
• 更新日志支持 Markdown 渲染（标题、粗体、斜体、链接、代码块、列表）
• 弹窗内显示下载进度条（百分比实时更新）
• 下载完成后显示绿色勾 + "立即重启"按钮
• 下载失败在弹窗内显示错误信息

检查更新优化

• 检查更新失败弹出居中 Modal，等宽字体展示完整错误信息
• 移除自定义 channel，使用默认 latest.yml（stable）和 beta.yml（beta）
• 自动根据当前通道选择对应的更新源
• 点击下载后即时反馈（进度条 + downloading 状态），无需等待首次进度回调

修复优化

UI 修复

• vox-chip 浅色模式：未选中文字从 text-muted 改为 text-primary，确保浅色主题下可见
• 激活态样式：实色背景+白字 → 半透明遮罩+纯黑/白文字，浅色/暗色模式均清晰
• 侧边栏遮罩：overflow 移至 .sb-nav，遮罩 ::before 不再跟随内容滚动
• 主题色选择器：移除颜色预设色块，保留主题预设画廊

i18n 补全

• 补充 settings.themePresets、settings.updateChannel.desc 等 11 处缺失翻译
• 新增 update.* 系列 key（检查/下载/重启/错误等 13 条）
• zh-CN 与 en-US 的 key 结构完全对齐
• 快捷入口卡片补全描述文案

类型修复

• external-launcher.ipc.ts：补充 error?: string 返回类型 + data 可选
• download.store.ts：loadMore 的 source 参数从 string 改为 ContentPlatform | 'all'

更新器修复

• startDownload() 立即广播 downloading: true + progress: 0，点击下载无延迟
• 下载异常时广播 error 状态，前端弹窗可感知并显示

其他

• Web 模式数据迁移空状态正常显示（externalLaunchersDetected null → false 兜底）
• window.electronAPI?.share 可选链保护，避免 Vite dev 模式下崩溃
• package-lock.json 版本号同步为 0.6.3

CI/CD 升级

Node.js 24 升级

• 4 个 Workflow 文件统一升级 Node 24 LTS（ci.yml / VoxVer.yml / build-macos.yml）
• 新增 .nvmrc + package.json engines.node: ">=24"
• actions/checkout@v4 → @v5（Node 24 运行时），actions/setup-node@v4 → @v5

macOS 构建支持

• 新建 build-macos.yml：GitHub Actions 双架构构建
  • ARM64 (Apple Silicon): macos-latest = macOS 26, npm 11, OpenSSL 3.x
  • x64 (Intel): macos-13（最后一批 Intel Runner）
• electron-builder.yml macOS 段：dmg 输出，arch: [arm64, x64]
• package.json 新增 build:mac:arm64 / build:mac:x64 脚本
• ci.yml + VoxVer.yml matrix 扩展 macOS 平台

macOS-26 适配

• 移除工作流中冗余的 electron-builder install-app-deps（postinstall 已执行）
• 构建修复：@aws-sdk/client-s3 外部化、pixel-ui.css UTF-8 编码修复

代码审查修复 (12 项)

• updater.service.ts：update-available 事件 error 清理、releaseNotes null 守卫、update-downloaded error 清理
• SettingsPage.vue：IPC 监听器 onUnmounted 清理防止内存泄漏、移除死 CSS .update-notes-pre
• zh-CN.ts：backup.selectNone 翻译 "全选" → "全不选"
• en-US.ts：more → group/sidebar 顺序对齐 zh-CN
• preload.ts：新增 UpdaterStatus 接口，消除内联类型重复
• build/：清理 8 个旧安装包（~400MB）

升级指南

从 v0.6.2 升级的用户：

1. 启动器设置入口移至侧边栏"启动器"，原关于页面中的更新选项已迁移
2. 更新通道默认为稳定版，切换后即时生效
3. 自动检查更新默认开启，启动 5 秒后自动检测
4. 检测到新版本时将弹出详情窗口，含完整更新日志和下载进度
5. 浅色主题下芯片文字和状态显示更清晰

VoxVer Launcher v0.6.2-启动器设计系统全面重构

发布日期：2026-07-04

概述

本次更新聚焦于启动器设计系统全面重构，引入 OLED 暗色底座、Neubrutalism 设计风格、磨砂玻璃效果，并优化了启动画面的加载体验。

设计系统重构

Design Token 体系

• src/styles/tokens.scss：定义统一的 CSS 变量驱动设计系统
• OLED 暗色底座：四层黑色阶梯 #0a0a0a → #0d0d0d → #141414 → #1a1a1a，适配 OLED 屏幕
• Neubrutalism 工具类：.nb-card / .nb-btn / .nb-tag — 硬边框 + 纯色偏移阴影
• Bento Grid 布局：.bento-grid + .bento-card + span 工具类，Apple 风格模块化卡片网格

磨砂玻璃效果

• 全局统一磨砂：侧边栏、主内容区、关于页面、版本信息区域统一 backdrop-filter: blur(8px) + color-mix 半透明
• 文字清晰度修复：backdrop-filter 移至 ::before 伪元素，彻底解决模糊问题
• 构建配置：electron.vite.config.ts 新增 html-inject-version 插件

组件重构

• HomePage Bento Grid 优化：修复 grid-auto-rows: minmax(140px, auto) 导致的卡片强制撑开问题；修复第二行空白列；移除启动按钮和统计卡片
• InstanceCard Neubrutalism 重构：硬边框 2px + 偏移阴影 + hover 位移效果
• App.vue 样式拆分：780 行样式提取到独立 src/styles/app.scss，改善代码可维护性

启动画面优化

• 版本号动态加载：从 package.json 读取版本号，构建时通过 transformIndexHtml 自动注入，不再硬编码
• 进度条动画：4 秒匀速走完 100%，完成后通过 transitionend 事件 0.8s 缓慢淡出
• 不再闪屏：等淡出动画真正完成后再移除 DOM 元素，解决启动画面闪电般消失的问题
• Logo 替换：启动画面显示 Alogo.png

UI 细节

• 滚动条隐藏：设置页面和侧边栏隐藏滚动条（Chrome/Safari/Firefox/IE 全覆盖）
• 颜色选择器修复：磨砂层 ::before 加 pointer-events: none，确保颜色色块可点击
• Hero 卡片：移除蓝色渐变背景，改为纯 --voxver-bg-tertiary
• Logo 统一：多处 airLogo → Alogo，适配品牌形象
• 侧边栏：移除底部版本信息；分割线移除

升级指南

从 v0.6.1 升级的用户：

1. 所有视觉变化自动生效，无需手动配置
2. 磨砂效果在 Windows 10+ 透明模式下效果最佳
3. 启动画面进度条总时长约 4 秒，完成后平滑过渡到主界面
4. 主题设置和背景自定义功能不受影响

VoxVer Launcher v0.6.1-启动核心修复

发布日期：2026-07-02

概述

本次更新聚焦于游戏启动流程的稳定性修复，解决了多个导致启动失败的关键问题，包括文件完整性校验、下载系统重定向处理、以及启动状态管理优化。

游戏启动修复

JVM 参数与版本解析

• JVM 参数去重修复：移除 buildJvmArguments 中的 Set 去重，避免 --add-opens 参数丢失导致 ClassNotFoundException
• 版本解析修复：extractBaseVersion 正则锚定开头，避免从整合包名（如"你好，新蒸程！V1.4.2"）中错误提取版本号
• 类路径去重：buildClasspath 添加 [...new Set(cp)] 去重，修复版本 JSON 中重复库声明导致的 Duplicate key 错误
• GC 参数兼容性：移除 CMS GC（Java 14+ 已删除），统一使用 G1GC，修复 Unrecognized VM option 'UseConcMarkSweepGC'

启动状态管理

• 启动状态切换修复：spawnProcess 不再阻塞等待进程退出，进程启动 1.5 秒检测通过后立即切换到"运行中"状态，修复启动器一直显示"启动中"的问题
• 游戏进程独立运行：spawn 选项改为 detached: true，游戏在独立进程组运行，关闭启动器后游戏不会被连带终止
• 缺失文件状态处理：前端正确处理 needsFileDownload 状态，弹出确认对话框后调用 confirmDownloadAndLaunch

文件完整性校验

• 库文件大小校验：checkMissingFiles、downloadMissingFiles 添加文件大小校验，检测 0 字节空文件和大小不匹配文件
• 资源文件大小校验：downloadAssets、checkMissingFiles 资源检查添加文件大小校验
• 下载前清理损坏文件：重新下载前删除 0 字节或大小不匹配的文件

下载系统修复

BMCLAPI 兼容性

• 重定向支持：downloadFile 添加 HTTP 301/302/303/307/308 重定向跟随（最多 5 次），修复 BMCLAPI 镜像跳转导致 0 字节文件
• 下载后文件验证：下载完成后校验文件大小不为 0，空文件视为下载失败
• 0 字节文件跳过修复：downloadFile 不再跳过已存在的 0 字节文件

资源文件下载源优化

• 官方源作为主源：资源文件主源改为官方 Minecraft 资源服务器（resources.download.minecraft.net，无速率限制），BMCLAPI 作为备用源
• 修复 403 速率限制：解决 3300+ 资源文件因 BMCLAPI 速率限制（60秒10次请求）全部返回 HTTP 403 的问题
• 并行下载备用源支持：parallelDownload 添加 fallbackUrl 支持，主源失败时自动尝试备用源

UI/UX 优化

• 自定义下载确认弹窗：用 PxModal 组件替代原生 confirm()，包含警告图标、消息文本、取消/下载并启动按钮
• 弹窗国际化：新增 launch.missingFilesTitle、launch.missingFilesMessage、launch.missingFilesHint 等 i18n 条目

Java 管理

• 默认 Java 版本推荐：无法解析版本号时默认推荐 Java 21（适配现代 Forge/NeoForge 整合包）

升级指南

从 v0.6.0 升级的用户：

1. 启动器会自动应用所有修复，无需手动操作
2. 如之前遇到游戏启动失败，请重新尝试启动，文件完整性校验会自动检测并修复损坏文件
3. 资源文件下载已切换至官方源，下载速度和稳定性显著提升
4. 关闭启动器后游戏将继续运行，无需保持启动器打开

VoxVer Launcher v0.6.0-UI重构

发布日期：2026-06-28

概述

本次更新为 VoxVer Launcher 带来了设置页面的全面重构、全局 UI 控件统一、以及完整的主题系统升级。

UI 重构

设置页分类拆分

• 设置页面按功能分类拆分为多个子页面，提升导航效率与可维护性

控件统一

• 全局 UI 控件使用 .vox-* 类前缀（.vox-btn、.vox-input、.vox-card 等），统一样式规范

主题系统重构

• 浅色/深色主题完整切换
• 背景自定义功能
• 主题色自定义功能

升级指南

从 v0.5.x 升级的用户：

1. 启动器会自动迁移配置，无需手动操作
2. 如遇主题异常，可在「设置 → 外观」中重置主题
3. 全局控件样式已统一，自定义皮肤可能需要适配 .vox-* 类名

VoxVer-v0.5.5 — 主题系统 · i18n · Mod 依赖管理 · 虚拟滚动 · 项目更名

发布日期：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 启动器

MCLA v0.5.4 修复了两个lssues等之前版本未修复的问题

发布日期：2026-06-20

版本概述

v0.5.4 是一个重要的架构优化版本，修复了多个长期存在的问题，并引入了开发工具链支持。本次更新为 v0.6.x 的大版本迭代奠定了坚实基础。

主要更新

架构优化

1. Windows Squirrel 安装器支持

• 安装 electron-squirrel-startup 依赖
• 在 main.ts 顶部添加 Squirrel 事件处理
• 确保 Windows 安装/更新/卸载时快捷方式和注册表正确处理
• 支持安装后自动启动、卸载时清理

2. 启动器统一

• 删除 electron/services/starlight.launcher.ts（662 行代码）
• 统一使用 game.launcher.service.ts
• 消除两套启动器并存带来的维护负担
• 减少代码冗余，提升可维护性

3. watcher.service.ts 完善

• 实现 findCrashReport 方法
• 添加 gameDir 参数支持
• 为崩溃日志分析提供基础支持
• 支持多游戏目录崩溃报告查找

4. P2P 自定义信令服务器配置

• 支持自定义信令服务器配置（p2p_signaling_server）
• 优先使用用户配置的服务器
• 提高国内用户 P2P 连接稳定性
• 支持私有化部署场景

5. IPC 通道文档化

• 创建 IPC_DOCUMENTATION.md
• 记录 19 个模块、130+ handle 通道、16 条推送事件
• 包含用途描述、参数列表、返回值类型、调用方页面
• 便于后续开发和维护

性能优化

1. 并行下载

• 库文件/资源文件下载改为 5 并发
• 下载速度提升 3-5 倍
• 支持断点续传
• 自动重试失败任务

2. JVM GC 优化

• 根据系统内存大小动态选择 G1 参数
• 小内存（<4GB）：保守配置，避免 OOM
• 中等内存（4-8GB）：平衡配置
• 大内存（>8GB）：激进配置，最大化性能
• 减少 GC 停顿，提升游戏体验

3. 缺失文件检测与提示

• 启动时自动检测缺失文件
• 弹窗提示用户缺失文件列表
• 用户确认后自动下载缺失文件
• 下载完成后自动继续启动流程

Bug 修复

1. archiver ESM 兼容性

• 问题：archiver 模块在打包后的 Electron 主进程中无法加载
• 错误：Error [ERR_REQUIRE_ESM]: require() of ES Module archiver/index.js not supported
• 修复：改为动态导入 const archiver = (await import('archiver')).default
• 影响文件：electron/services/game.launcher.service.ts

2. i18n 导入方式

• 问题：Vite 打包时 zhCN is not defined 错误
• 原因：间接导入导致变量未定义
• 修复：在 i18n.ts 中直接导入翻译文件
• 影响文件：src/locale/i18n.ts

3. CSP 策略修复

• 问题：Splash Screen 启动画面卡住无法隐藏
• 原因：Content Security Policy 阻止内联脚本执行
• 修复：
  • 添加 'unsafe-inline' 允许内联脚本执行
  • 添加超时强制隐藏机制（5秒）
• 影响文件：index.html

4. CurseForge API Key 配置项移除

• 问题：设置页面中的 CurseForge API Key 用户配置项不必要
• 原因：API Key 应由开发者在开发时通过环境变量配置
• 修复：移除设置页面中的相关 UI 配置项
• 影响文件：src/pages/SettingsPage.vue

开发工具

1. Vitest 测试框架

• 新增 vitest.config.ts 配置文件
• 新增 tests/setup.ts 测试环境 mock
• 新增 tests/i18n.test.ts i18n 翻译完整性测试
• 新增 npm 脚本：
  • npm run test - 运行测试
  • npm run test:watch - 监听模式
  • npm run test:coverage - 覆盖率报告

2. GitHub Actions CI/CD

• 创建 .github/workflows/ci.yml
• 支持：
  • Lint 检查（ESLint）
  • 构建（Vite + electron-builder）
  • 单元测试（Vitest）
  • 打包（Windows NSIS 安装程序）
  • 发布（GitHub Release）
• 自动缓存 Electron 和 electron-builder 依赖

3. i18n 翻译资源

• 完善中英文翻译资源
• 覆盖 5 个模块：common、settings、game、modpack、p2p
• 每个语言 745+ 键值对
• 支持动态语言切换

构建产物

平台	文件名	大小	说明
Windows	MCLA Setup 0.5.4.exe	~98.7 MB	NSIS 安装程序
Windows	MCLA Setup 0.5.4.exe.blockmap	~100 KB	增量更新块映射文件
Windows	win-unpacked/	-	免安装解压版

技术栈

• 框架：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

变更统计

指标	数值
修改文件数	22 个
新增代码	+2,383 行
删除代码	-799 行
净增代码	+1,584 行
新增文件	5 个（测试配置、i18n、CI/CD）
删除文件	1 个（starlight.launcher.ts）

文件变更详情

新增文件

文件	说明
vitest.config.ts	Vitest 测试框架配置
tests/setup.ts	测试环境 mock 设置
tests/i18n.test.ts	i18n 翻译完整性测试
src/locale/zh-CN.ts	中文翻译资源
src/locale/en-US.ts	英文翻译资源
src/locale/i18n.ts	vue-i18n 配置
src/locale/index.ts	翻译资源导出

修改文件

文件	变更说明
electron/main.ts	添加 Squirrel 事件处理
electron/preload.ts	添加 IPC 通道暴露
electron/ipc/game.ipc.ts	缺失文件检测 IPC
electron/services/game.launcher.service.ts	并行下载、JVM GC 优化、缺失文件检测
electron/services/p2pShare.service.ts	自定义信令服务器配置
electron/services/watcher.service.ts	崩溃报告查找功能
src/pages/SettingsPage.vue	移除 CurseForge API Key 配置项
index.html	CSP 策略修复、超时隐藏脚本
package.json	新增依赖和测试脚本

删除文件

文件	说明
electron/services/starlight.launcher.ts	启动器统一，删除冗余实现

兼容性说明

项目	要求
最低系统要求	Windows 10 (64-bit)
最低内存	4GB RAM（推荐 8GB+）
磁盘空间	500MB（不含游戏数据）
Java	Java 8+（推荐 Java 17+）

已知问题

• 首次启动可能需等待资源加载
• 深色主题切换需重启生效
• 部分网络环境下 P2P 连接可能不稳定

下一步计划

v0.6.x

• i18n 界面接入：将 vue-i18n 集成到所有页面
• 性能优化：虚拟滚动、Web Worker 离线计算
• 测试覆盖：完善单元测试和 E2E 测试
• 代码签名：提升安全性

v1.0.0

• 第一个生产就绪版本
• 完整的国际化支持
• 完善的测试覆盖
• 稳定性保障

感谢

感谢所有反馈问题和建议的用户！

MCLA - Minecraft Launcher Alpha