VoxVer Launcher

简体中文

English

简体中文

English

Appearance

更新日志 ​

本文档记录了 VoxVer Launcher 各版本的功能变更、修复内容和未来计划。

计划中的功能（v0.8.0+） ​

以下功能正在规划和开发中，将在后续版本中逐步推出：

功能说明预计版本
Linux 支持适配 Linux 平台v0.8.0+
macOS 支持适配 macOS 平台（v0.6.4 曾支持，因 CI 构建问题回退后重新规划）v0.8.0+
CF Mod 下载支持 CurseForge Mod 下载v0.8.0+

说明

以上计划中的功能可能会根据开发进度和优先级进行调整。具体发布时间和功能细节以实际版本发布为准。

v0.7.5 - 2026-10-27 ​

主题：服务联通性测试与下载源策略

✨ 新增 ​

  • 服务联通性测试 — 设置 → 下载与网络 → 服务联通性测试，进入后先列出下载源 / 版本源 / Mod 平台 / 登录与更新共 10 项服务，手动点击「开始检测」后并发探测，逐项展示在线状态与毫秒延迟，失败项给出原因
  • 下载源选择策略 — 原镜像测速入口替换为「自动选择 / 官方源优先 / 镜像源优先」下拉策略，配置写入下载服务并真实作用于下载链路，不再只是界面开关
  • 全局快捷键补全 — 快速启动游戏、打开主页、打开设置、显示 / 隐藏窗口四个动作全部可用，触发时自动唤起并聚焦窗口

✨ 优化 ​

  • 下载与网络设置重构 — 按「服务 / 源 / 下载」分组卡片排版；同时下载数改为下拉框；最大下载线程、下载速度限制、最大重试次数改为开关（开启即自动，关闭后可手动调节）
  • 高级设置控件统一 — 启动游戏时、游戏进程优先级、游戏窗口大小由单选改为下拉框，项描述文字字号调小
  • PxSelect 下拉面板 — 改为 Teleport 到 body + 固定定位，修复被滚动容器裁剪、点击后内容被遮住的问题
  • 调试选项 — 仅在开启调试模式时显示

🔧 修复 ​

  • 全局快捷键保存后按了没反应（主页 / 设置 / 启动动作未在渲染进程处理）
  • 快捷键注册失败时仍提示成功，现明确提示可能被其他程序占用
  • 设置页切换分类后仍停留在上一分类的滚动位置

🏗 工程 ​

  • 新增 download:services:list / download:services:test / download:settings:set-mirror-strategy 三个 IPC 通道
  • 下载服务新增 mirrorStrategy 配置项，shouldMirror 按策略分支
  • 移除 build-macos.yml CI 工作流，macOS 构建仍处于计划中

v0.7.4 - 2026-10-21 ​

主题：多账户卡堆管理与加载器适配器架构

✨ 新增 ​

  • 多在线账户卡堆管理 — 账户页重构为卡堆式多账户管理：多个微软正版账户并存、快速切换、皮肤 3D 预览（SkinViewer3D）；新增独立 MicrosoftLoginModal 登录弹窗
  • 四加载器适配器架构 — Forge / NeoForge / Fabric / Quilt 统一适配器层（BaseLoaderAdapter + 各自实现），modloader 服务模块化重构

⚠️ 变更 ​

  • 实例管理模块暂时停用 — 实例页改为「暂未开放」占位页，相关测试同步重写；已有实例数据不受影响，模块将在后续版本恢复

✨ 优化 ​

  • 暗色主题存在感增强 — 阴影改为品牌蓝辉光（sm / md / lg / xl）；玻璃态提亮（侧边栏 L=14→18、内容区 15→19、浮层 21→24）；hover 遮罩 5%→8%、active 8%→12%；卡片内高光与标题栏辉光改为主题令牌，亮暗双主题自适应
  • 首页 Hero 卡片 — 移除欢迎标题与底色，避免浅 / 深色模式下突兀色块
  • i18n 文案对齐 — 中英文语言包键值补齐与更新

🏗 工程 ​

  • 新增 electron/utils/version-meta.ts、electron/services/i18n.mod.service.ts、scripts/diagnose.mjs 诊断脚本
  • gh CLI 接入发布流程

v0.7.3 质量修复批次 - 2026-10-11 ​

主题：质量修复与工程基线对齐

🔧 修复 ​

  • i18n 相对时间显示原始键名 — 补齐 time.* 时间段词条与实例删除确认文案，界面不再显示 time.minutesAgo 等原始键名
  • 中英文文案键不一致 — 补齐 en-US 约 58 个仅存在于 zh-CN 的差异键（common / version / instance / download / types 五组），英文界面不再出现键名
  • share_history 表 schema 冲突 — 删除重复的第一版建表语句，保留与实际写入值一致且含 status CHECK 约束的正确 schema
  • tsc 真实类型错误 — 修复 game.ipc.ts 类型自引用断言导致的 never 类型收窄与隐式 any，新增 VersionManifest 接口显式标注
  • PxConfirmProps 无法具名导入 — 类型从 <script setup> 外移至独立的 PxConfirm.types.ts
  • 单元测试 36 例失败 → 278/278 全绿 — 测试基建初始化 i18n、测试断言对齐真实 IPC 契约

✨ 优化 ​

  • 动画样式精简 — animations.scss 从 480 行精简至约 90 行，删除 19 组零引用 @keyframes 与全部零引用工具类，prefers-reduced-motion 去重
  • 样式死代码清理 — 删除无对应模板元素的样式，合并重复定义
  • 冗余逻辑清理 — 删除 App.vue 空转 watch、重复空判断与重复 store 声明
  • loader 显示语义对齐 — vanilla 显示值与 i18n loaderLabels 统一

🏗 工程 ​

  • tsc 双配置恢复 exit 0 — .vue shim 从 env.d.ts 抽出为独立的 shims-vue.d.ts 全局声明，修复约 25 处 TS2307
  • 类型基线对齐 — @types/node 升级至 ^24，与 engines node>=24 一致
  • eslint 环境修复（补装 vue-eslint-parser）

v0.7.3 - 2026-09-26 ​

主题：独立版本更新页与更新体验重做

✨ 新增功能 ​

  • 独立版本更新页 — 设置页「检查更新」改为跳转独立全屏更新页（/update）：顶栏支持拖拽移动与窗口控制、横幅（Logo + 版本号 + 状态胶囊：检查中 / 已是最新版本 / 有新版本可用）、GitHub Release 发布说明 Markdown 渲染（白名单过滤）、底部操作栏（检查更新 / 下载更新 / 取消下载 / 安装更新 / GitHub Releases 外链）
  • 水波纹横幅 — 新增 SilkBackground 组件，零依赖 WebGL 丝绸波纹动画渲染横幅，颜色跟随主题色
  • 取消下载 — 下载更新支持随时取消（CancellationToken），取消后状态即时复位
  • 下载进度详情 — 进度条显示已传输 / 总大小与实时速度（MB/s）

🔧 修复 ​

  • 设置页「检查更新」按钮点击无反应的问题
  • 已是最新版本时无任何提示的问题（状态胶囊明确展示）
  • 下载过程无状态反馈的问题

✨ 优化 ​

  • 检查更新双链路仲裁：GitHub API 版本对比结论优先，latest.yml 滞后时以 API 结论兜底
  • 检测到更新后状态可恢复：退出重进更新页仍可继续下载或安装
  • builder-util-runtime 固定 9.5.1 精确版本，与 electron-updater 内嵌副本同源，修复跨副本 CancellationToken 失效

v0.7.2 - 2026-09-26 ​

主题：更新检查双链路与反馈完善

✨ 新增功能 ​

  • 更新检查双链路 — 检查更新改为 GitHub API 版本对比链路，直接比对本地版本与 GitHub 最新 Release 版本号，不再依赖 latest.yml；检出更新后联动 electron-updater 执行下载 / 安装

🔧 修复优化 ​

  • 检查更新无反馈修复 — 点击按钮后所有结果均有可见反馈：有新版本弹「新版本可用」弹窗、版本一致弹「已是最新版本」弹窗、失败弹错误详情；按钮增加「检查中」禁用态与 12 秒超时自动恢复
  • 启动自动检查改进 — 启动时的自动检查同样走版本对比链路，检测结果在设置页挂载时可恢复展示
  • 下载时序保障 — 点击下载时元数据未就绪自动补检后再下载；latest.yml 滞后时以 API 对比结论为准
  • 开发模式下版本检测同样可用

v0.7.1 - 2026-09-26 ​

主题：崩溃分析系统 + XMCL 启动核心 + Lumin UI/UX 设计系统

🩺 崩溃分析系统 ​

  • 崩溃报告解析 — 游戏异常退出后自动捕获并解析崩溃报告（10 类崩溃特征识别）
  • 崩溃分析页面 — 新增独立「崩溃分析」页面（/crash-analysis），提供历史报告列表、严重程度标签、异常类型与堆栈详情
  • 崩溃面板 — 启动页崩溃面板展示错误描述、可能原因与建议解决方案

🚀 启动核心与 Mod 生态 ​

  • XMCL 启动核心集成 — 基于 @xmcl/* 工具链重写启动流程，修复 1.16 崩溃与 1.20.1 Forge 自包含版本启动问题
  • Java 自动选择 — 按 MC 版本匹配 Java 8/11/17/21/25；LWJGL 2（1.17-）用 java.exe、LWJGL 3（1.18+）用 javaw.exe
  • ModLoader 系统 — Forge / NeoForge / Fabric / Quilt 一键安装与互斥切换；OptiFine 与 Fabric API 自动匹配兼容版本；智能动态版本命名
  • Mod 管理 — CurseForge + Modrinth 双源搜索/下载、批量操作、兼容性检查与角标、排序、图标缓存、导出 zip
  • 下载系统 — 多源切换（BMCLAPI 镜像）与超时控制、IPC 实时进度、全局下载进度面板、缓存

🎨 Lumin UI/UX 设计系统合并 ​

  • Modal 弹窗（4 档尺寸 + 响应式）、Toast 通知（4 种状态）、Badge 渐变变体、modal/overlay 动画关键帧与过渡工具类
  • PxSelect 组件统一替换原生下拉框
  • 全局颜色 Token 化（--voxver-* CSS 变量），修复大量深浅色主题下的硬编码颜色
  • 页面切换统一 250ms 淡入淡出动画

🧩 实例与联机 ​

  • 实例管理增强 — 检测本地版本并支持导入为托管实例；实例自动导入
  • P2P 分享与联机 — 6 位分享码 + WebRTC 直连分享实例；设置侧栏拆分 P2P / 联机独立分区

🌍 国际化与其他 ​

  • i18n 体系 — 修复 560+ 处硬编码中文文本，新增约 300 个 locale key，覆盖 33 个文件
  • 修复关于页空白（打包版） — i18n 词条中 @ 字符触发 Invalid linked format 导致设置组件卸载，改用字面量转义（中英文同步修复）
  • JVM 参数不再用 Set 去重，保留全部 --add-opens，统一 G1GC；类路径去重修复 Duplicate key
  • 游戏进程日志捕获（[Game-STDOUT] / [Game-STDERR]），异常退出转储最后 200 行
  • GitHub 链接迁移至 MeowY-Studios 组织，文档站迁移至 voxver.meow-studio.tech
  • Electron 42 + better-sqlite3 12，GitHub Actions 升级 Node.js 24
  • 集成 @openai/codex-security 提交前安全扫描

v0.7.0 - 开发阶段（内容并入 v0.7.1 发布） ​

主题：设计系统完善 + 组件库 + 多人游戏设置 + 启动流程增强

🎨 设计系统完善 ​

  • 组件库完成 — 完成设计系统与组件库建设，统一组件类型定义，消除 any 类型
  • 主题变量修复 — 全面替换硬编码颜色为 CSS 变量 token，确保深色/浅色模式正确切换
  • 主题色盘优化 — 减少主题色色阶间距，颜色选择器左对齐

⚔️ 多人游戏设置 ​

  • 设置页多人游戏入口 — 新增设置侧边栏「多人游戏」分类入口
  • P2P 与联机设置分离 — 将 P2P 分享和多人游戏设置独立为单独的设置区域

🌐 国际化完善 ​

  • i18n 全面补全 — 修复约 560+ 处硬编码中文文本，新增约 300 个 locale key，覆盖 33 个文件
  • P2P 分享改进 — 修复导入配置丢失、传输中取消、解压进度推送、磁盘空间检查，英文错误信息完善

🚀 启动流程增强 ​

  • 停止立即中断 — 启动过程中点击停止不再等待 90s 超时，依赖下载/诊断/版本解析阶段立即中断并回写状态
  • 停止弹窗详情 — JVM 退出非零时渲染端弹窗显示友好错误摘要，不再只显示「stopped」
  • 假 JAR 精准定位 — 优化损坏文件检测策略，防止 0 字节 HTML 被误判为有效库
  • 自动修复损坏文件 — JVM 退出时自动扫描并列出损坏 JAR 路径+大小+原因

📦 下载系统优化 ​

  • 多源切换超时控制 — 下载时支持多源自动切换与超时控制
  • 全局进度面板 — 全局下载进度面板 UI 优化

v0.6.4 - 2026-07-17 ​

主题：macOS 系统适配与账户管理优化

🍎 macOS 系统适配 ​

  • macOS 双架构构建 — 新增 ARM64 / x64 双架构构建支持，macOS 用户可直接下载 DMG 安装包
  • CI/CD 升级 — GitHub Actions 自动构建 macOS DMG 安装包
  • Node.js 24 LTS — 运行时适配 macOS 26，确保兼容性

👤 账户管理优化 ​

  • 添加账户流程优化 — 点击「添加账户」按钮直接跳转到设置页面的「游戏账户与档案」标签页，不再弹出独立的账户管理弹窗，操作更直观流畅

🔧 构建 ​

  • 版本号升级至 v0.6.4

v0.6.2 - 2026-07-04 ​

主题：设计系统重构与启动画面优化

🎨 设计系统重构 ​

  • Design Token 体系 — 新增 tokens.scss，定义 OLED 暗色底座（#0a0a0a → #0d0d0d → #141414 → #1a1a1a 四层阶梯）、Neubrutalism 工具类
  • 磨砂玻璃效果 — 侧边栏、主内容区、版本信息区域统一 backdrop-filter: blur(8px) + color-mix 半透明效果
  • 磨砂层级修复 — backdrop-filter 移至 ::before 伪元素，解决文字模糊问题
  • HomePage 简化 — 移除启动按钮和统计卡片，Hero 卡片仅展示 Logo + 引导文字
  • Bento Grid 布局优化 — 修复卡片高度强制撑开和空白列问题

🖥️ 启动画面优化 ​

  • 版本号动态加载 — 从 package.json 读取版本号，构建时通过 transformIndexHtml 注入，启动画面实时显示当前版本
  • 进度条动画 — 4 秒匀速走完，完成后通过 transitionend 事件 0.8s 缓慢淡出，不再闪屏
  • Logo 替换 — 启动画面显示 Alogo.png 替代文字标题

🎨 UI 细节 ​

  • 设置页面 — 隐藏滚动条（Chrome / Safari / Firefox / IE 全覆盖）
  • 侧边栏 — 隐藏滚动条；移除底部版本信息
  • 关于页面 — 适配磨砂质感；Alogo 替换 airLogo
  • 颜色选择器 — 修复磨砂层遮挡点击（pointer-events: none）
  • 主题色 — 移除 Hero 卡片的蓝色渐变背景，改为纯背景色

🔧 构建 ​

  • 版本注入 — electron.vite.config.ts 新增 html-inject-version 插件，支持构建时动态注入版本号

v0.6.1 - 2026-07-02 ​

主题：启动稳定性与下载可靠性重大修复

🔧 游戏启动修复 ​

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

📦 文件完整性校验 ​

  • 库文件大小校验 — 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 作为备用源，修复 3300+ 资源文件因 BMCLAPI 速率限制（60秒10次）全部返回 403 的问题
  • 并行下载备用源支持 — parallelDownload 添加 fallbackUrl 支持，主源失败时自动尝试备用源

🎨 UI/UX 优化 ​

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

☕ Java 管理 ​

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

v0.6.0 - 2026-06-28 ​

主题：UI 架构重构与主题系统完善

🎨 UI 重构 ​

  • 设置页分类拆分 — 设置页面按功能分类拆分为多个子页面，提升导航效率
  • 控件统一 — 全局 UI 控件使用 .vox-* 类前缀（.vox-btn、.vox-input、.vox-card 等），统一样式规范
  • 主题系统重构 — 浅色/深色主题完整切换 + 背景自定义 + 主题色自定义，提供更完善的视觉体验

v0.5.5 - 2026-06-25 ​

主题：国际化完善与 UI 优化

✨ 新增功能 ​

  • i18n 国际化全面接入 — 设置页面侧边栏、下载页面侧边栏、更多页面侧边栏、首页账号区域、启动按钮等核心 UI 组件全面支持多语言切换
  • 语言切换功能 — 用户可在设置中切换简体中文和英文，界面实时更新

🔧 TypeScript 类型全面修复 ​

  • IPC 返回类型 — 完善所有 IPC 通道的 TypeScript 类型定义，消除类型警告
  • electronAPI 接口 — 规范 preload 暴露的 API 接口，提升类型安全
  • ModLoader 参数类型 — 修复 ModLoader 安装参数的类型定义

🎨 UI/UX 优化 ​

  • 顶部导航栏图标对齐 — 修复导航栏图标与文字的对齐问题
  • 主内容区域渲染优化 — 优化主内容区域的布局和渲染性能

🔧 ModLoader 安装完善 ​

  • Forge 安装优化 — 完善 Forge ModLoader 的安装流程
  • NeoForge 安装优化 — 新增 NeoForge ModLoader 的完整安装支持
  • Quilt 安装优化 — 完善 Quilt ModLoader 的安装流程
  • Fabric 安装优化 — 修复 Fabric 安装过程中的问题

📝 文档更新 ​

  • 启动器名称变更 — 项目正式从「MC Launcher Alpha（MCLA）」更名为「VoxVer Launcher」，代码仓库从 MC-Launcher-Alpha 更名为 VoxVer-Launcher，文档仓库从 MC-Launcher-Alpha-docs 更名为 VoxVer-Launcher-docs，所有相关文档内容同步更新
  • 仓库链接更新 — 更新所有 GitHub 链接指向新的 VoxVer-Launcher 和 VoxVer-Launcher-docs 仓库
  • 错别字修复 — 修复「BMC Launcher AlphaPI」等错别字，统一为「BMCLAPI」
  • 补充缺失功能文档 — 新增 P2P 实例分享、Mod 自动更新、主题自定义、全局快捷键、皮肤管理等章节

v0.5.4 - 2026-06-20 ​

主题：架构优化与性能提升

✨ 新增功能 ​

  • Squirrel 安装器 — 采用 Squirrel 自动更新框架，支持增量更新和自动回滚
  • 并行下载优化 — 多文件同时下载，提升下载效率
  • JVM GC 动态参数 — 根据系统内存自动配置最佳垃圾回收参数
  • Vitest 测试框架 — 引入单元测试，保障代码质量
  • GitHub Actions CI/CD — 自动化构建、测试和发布流程

🔧 核心修复 ​

  • archiver ESM 问题 — 修复 archiver 库的 ESM 导入问题
  • i18n 导入问题 — 修复国际化模块的导入路径问题
  • CSP 策略问题 — 优化内容安全策略，允许正确的资源加载

⚡ 性能优化 ​

  • 启动速度提升 — 优化主进程启动流程
  • 内存占用降低 — 减少不必要的内存分配

v0.5.3 - 2026-06-09 ​

主题：稳定性更新与体验优化

✨ 新增功能 ​

  • 全局快捷键系统 — 支持自定义全局快捷键，快速启动游戏、切换窗口
  • 通知系统增强 — 优化通知推送逻辑，支持更多通知类型
  • 主题系统优化 — 完善深色/浅色主题切换

🔧 核心修复 ​

修复项影响
实例列表刷新修复实例列表刷新后数据不更新的问题
下载队列同步修复下载队列状态同步问题
主题切换问题修复主题切换后样式不生效的问题

🎨 UI/UX 优化 ​

  • 版本列表双层缓存 — 内存缓存 + 磁盘缓存，加快列表加载
  • 骨架屏优化 — 数据加载时显示骨架屏，提升用户体验

v0.5.2 - 2026-06-07 ​

主题：P2P 分享与主题自定义

✨ 新增功能 ​

  • P2P 实例分享 — 基于 WebRTC 直连技术，通过 6 位分享码实现实例一键分享
  • 主题自定义 — 色盘编辑器，支持自定义主题配色方案
  • CSS 变量动态计算 — 根据主题色自动计算相关颜色值

🔧 核心修复 ​

  • 版本列表缓存优化 — 减少版本列表请求次数
  • 通知系统增强 — 支持更多通知类型和自定义通知

⚡ 性能优化 ​

  • 列表渲染优化 — 虚拟列表技术，提升大数据量渲染性能

v0.5.0 - 2026-06-05 ​

主题：启动核心修复与用户体验优化

本版本聚焦于解决游戏启动失败问题，增强下载稳定性，优化 UI 交互体验，并完成启动器自身热更新功能。

✨ 新增功能 ​

  • 启动器热更新 — 基于 electron-updater 实现自动检测与安装更新，用户无需手动下载即可获取最新版本
  • 下载管理页面 — 在左侧边栏新增下载管理选项，点击可进入下载管理页面，统一管理所有下载任务
  • 多镜像下载源 — 版本文件下载时自动尝试 BMCLAPI、MCBBS、官方源三个镜像，解决单一源不可用导致的下载失败
  • 智能 Java 版本匹配 — 根据游戏版本自动推荐最佳 Java 版本（1.20.5+ → Java 21，1.17+ → Java 17，1.16- → Java 8），并对自定义 Java 路径进行验证和兼容性警告
  • 控制台中文支持 — 新增 npm run dev:zh 脚本，支持中文编码启动开发环境，解决控制台中文乱码问题

🔧 核心修复 ​

修复项影响
类路径传递spawnProcess 方法未接收 classpathStr，导致 Java 进程启动时 -cp 参数为空，触发"类文件缺失"错误
版本文件 404单一镜像源（BMCLAPI）缺少所需文件导致下载失败
版本清单超时缺少超时和重试机制，BMCLAPI 网络波动导致版本列表加载失败
启动游戏显示空版本实例仍显示旧内容，而非提示下载版本
JavaInfo 类型接口缺少 isDefault 属性，TypeScript 编译报错
桌面图标显示安装后桌面快捷方式、任务栏、开始菜单图标不正确

🎨 UI/UX 优化 ​

  • 移除通知弹窗 — 移除右上角 PxNotification 组件，简化 UI，避免干扰用户使用
  • 下载管理入口 — 在左侧边栏添加下载管理选项，提供独立的下载管理页面
  • 版本下载提示 — 空版本实例点击启动时，提示用户先去下载版本，而非显示旧内容

📊 启动日志增强 ​

  • 添加类路径构建统计日志（总计/有效/缺失文件数）
  • 添加版本 JAR 文件缺失检查和明确错误提示
  • 添加完整的启动参数分隔日志（Java路径、工作目录、主类、JVM参数、游戏参数）
  • 长类路径列表自动缩略显示，避免日志溢出

🔒 可靠性改进 ​

  • 版本清单获取添加 30 秒超时 + 3 次重试
  • 版本文件下载添加多镜像自动切换（失败自动降级到下一个镜像）
  • AbortController 替代不支持的 timeout 参数，符合 fetch 标准

📦 构建与发布 ​

  • 版本号更新至 v0.5.0
  • 图标配置优化，确保桌面图标正确显示
  • NSIS 安装程序配置完善（桌面快捷方式、开始菜单、卸载程序）

✅ 构建状态 ​

  • npm run build — ✅ 通过
  • npm run build:win — ✅ 通过
  • TypeScript 类型检查 — ✅ 通过

v0.4.3 - 2026-06-04 ​

主题：启动核心修复与下载增强

本版本聚焦于解决用户反馈的游戏启动失败问题，增强类路径构建逻辑，添加多镜像下载支持，并优化 UI 体验。

✨ 新增功能 ​

  • 多镜像下载源支持 — 版本文件下载时自动尝试 BMCLAPI、MCBBS、官方源三个镜像，解决单一源不可用导致的下载失败
  • 智能 Java 版本匹配 — 根据游戏版本自动推荐最佳 Java 版本 （1.20.5+ → Java 21，1.17+ → Java 17，1.16- → Java 8），并对自定义 Java 路径进行验证和兼容性警告
  • ModLoader 继承版本解析 — 正确处理 Forge/Fabric/NeoForge/Quilt 等 ModLoader 版本的继承关系，合并基础版本的库和配置

🔧 核心修复 ​

修复项影响
类路径传递spawnProcess 方法未接收 classpathStr，导致 Java 进程启动时 -cp 参数为空，触发"类文件缺失"错误
Forge 模块系统参数${library_directory} / ${classpath_separator} 变量未正确替换，导致新版本 Forge 启动失败
库规则处理checkLibRules 的规则判断逻辑有误，导致 jopt-simple 等必需库被错误过滤
版本清单获取缺少超时和重试机制，BMCLAPI 网络波动导致版本列表加载失败
JavaInfo 类型接口缺少 isDefault 属性，TypeScript 编译报错

🎨 UI/UX 优化 ​

  • 移除通知铃铛 — 移除右上角 PxNotification 组件，简化 UI，避免干扰用户使用

📊 启动日志增强 ​

  • 添加类路径构建统计日志（总计/有效/缺失文件数）
  • 添加版本 JAR 文件缺失检查和明确错误提示
  • 添加完整的启动参数分隔日志（Java路径、工作目录、主类、JVM参数、游戏参数）
  • 长类路径列表自动缩略显示，避免日志溢出

🔒 可靠性改进 ​

  • 版本清单获取添加 30 秒超时 + 3 次重试
  • 版本文件下载添加多镜像自动切换（失败自动降级到下一个镜像）
  • AbortController 替代不支持的 timeout 参数，符合 fetch 标准

📦 开发者体验 ​

bash
# 新增：使用中文编码启动开发环境
npm run dev:zh
# 等同于：chcp 65001 > nul && npm run build && cross-env NODE_ENV=development electron .

✅ 构建状态 ​

  • npm run build — ✅ 通过
  • TypeScript 类型检查 — ✅ 通过

v0.4.2 - 2026-06-02 ​

主题：代码规范与稳定性提升

新增功能 ​

  • ESLint v9 配置 — 统一代码风格，配合 Prettier 格式化
  • 安全配置模板 — .env.example 提供 API Key 配置模板（CurseForge 等）

修复 ​

  • 修复 IPC handler 注册中的日志级别误用问题
  • 修复 ModLoader 安装状态无法正确显示的问题
  • 修复全局下载弹窗在某些场景未触发的问题

v0.3.1 - 2026-05-19 ​

修复 ​

  • 站点配置修复 — 将站点基础路径改为 / 以支持自定义域名，添加 CNAME 记录支持 mcla.imipork.top 域名

文档更新 ​

  • 完整文档重写 — 文档网站全面升级，支持简体中文和英文双语
  • 新增鸣谢 — 在首页添加了 PCL2 项目的致谢（UI 布局参考）

v0.3.0 ​

新增功能 ​

  • Mod 配置编辑 UI — 内置配置文件编辑器，支持 .toml 和 .json 格式的 Mod 配置文件直接编辑，无需使用外部文本编辑器
  • 实例导入 / 导出 — 支持将实例打包为压缩文件进行分享或备份，也支持从现有 .minecraft 目录导入为实例
  • ModLoader 安装进度 — ModLoader 安装过程实时推送进度到前端，安装状态一目了然
  • 全局下载进度弹窗 — 右下角悬浮弹窗统一展示所有下载任务的进度，支持查看和管理多个并发下载
  • 通知系统前端接入 — 重要操作（下载完成、安装成功、错误提示等）通过通知系统实时反馈

修复 ​

  • 修复 ModLoader IPC 通信缺失导致安装状态无法正确显示的问题
  • 修复全局下载进度弹窗在某些情况下未正确显示的问题

v0.2.0 ​

新增功能 ​

  • CurseForge + Modrinth 双源 Mod 下载 — 接入两大主流 Mod 仓库，支持关键词搜索、分类浏览和版本筛选
  • Mod 管理 — 支持已安装 Mod 的启用/禁用切换、配置文件编辑和删除操作
  • 崩溃监控与日志分析 — 游戏崩溃时自动捕获日志，分析错误原因并给出修复建议
  • 皮肤管理 — 支持查看和管理玩家皮肤

修复 ​

  • 修复微软登录 token 自动刷新失败导致需要重复登录的问题
  • 修复部分游戏版本启动参数拼装错误导致无法启动的问题

v0.1.0 ​

首个版本 ​

VoxVer Launcher 的首个公开版本，包含以下核心功能：

  • 微软账号登录 — 基于 OAuth 2.0 Device Code Flow 的微软正版登录，安全便捷
  • 离线模式 — 支持自定义用户名的离线登录，适合单机游玩
  • 游戏版本管理 — 基于 BMCLAPI 镜像源，支持正式版、快照、远古版和愚人节版的安装与管理
  • ModLoader 安装 — 支持 Fabric / Forge / NeoForge / Quilt 四大主流 ModLoader 的一键安装
  • 基础实例系统 — 支持创建独立实例，实现版本隔离和 Mod 隔离
  • 深色主题 UI — 现代化的深色界面设计，基于 Vue 3 + TypeScript 构建

✅ 已完成的功能 ​

完成版本功能
v0.5.2P2P 实例分享、主题自定义（色盘选择）、整合包创建工具
v0.5.3全局快捷键系统
v0.5.5i18n 国际化、语言切换、Mod 自动更新检测
v0.6.0UI 架构重构（设置页分类拆分）、主题系统重构
v0.6.1启动稳定性修复、下载可靠性增强、文件完整性校验
v0.6.2Design Token 设计体系、磨砂玻璃 UI 效果、启动画面优化、HomePage 重构
v0.6.4macOS 支持（⚠️ 后因 CI 构建问题回退，当前状态见上方「计划中」）
v0.7.0设计系统完善 + 组件库、多人游戏设置、i18n 全面补全、启动流程增强（停止中断 + 损坏文件检测）
v0.7.1崩溃分析系统、XMCL 启动核心集成、Java 自动选择（8/11/17/21/25）、Lumin UI/UX 设计系统
v0.7.2更新检查双链路（GitHub API 版本对比）
v0.7.3独立版本更新页 + 取消下载
v0.7.4多账户卡堆 + 四加载器适配器 + 暗色主题增强
v0.7.5服务联通性测试（10 项服务并发探测）+ 下载源选择策略 + 全局快捷键补全

参与贡献

如果你希望为 VoxVer Launcher 贡献代码或提出功能建议，欢迎前往 GitHub 提交 Pull Request 或 Issue。