大家好，我是 豆杰，一名独立开发者，也是 Minecraft 的多年老玩家。
为什么想做这个作品： 玩了这么多年 Minecraft，每次都要经历翻论坛、配置 Java、解决各种兼容性问题……这个过程对新手来说门槛太高，对老玩家来说也够折腾。我就想，能不能做一个像手机应用商店一样好用的启动器，点一下就能下载、点一下就能启动？
我的背景： 之前做过一些 Web 前端开发，但桌面端应用是从零开始学的。这次参赛是我第一次用 TRAE Work 做完整项目，从一行代码不会到做出能用的产品，全靠 TRAE 的 AI 助手一步步带着写。
Vibe Coding 年限： 应该说是 1 年，但这次参赛让我在 3 个月里学会了 Electron、Node.js 后端、Windows 安装包构建等一系列技能。
一句话标签： 一个被 Minecraft 启动器折腾了十年的老玩家，决定自己动手造一个
它是什么
VersePC 是一款桌面端 Minecraft 整合包启动器（Windows 应用，支持 macOS / Linux），核心解决一个问题：
让玩家像逛应用商店一样，一键下载、管理、启动 Minecraft 整合包，包括开服、联机等十分方便的功能，彻底告别手动配置的繁琐。
面向谁
- 核心目标用户：Minecraft 玩家，尤其是喜欢玩整合包但不想手动折腾的用户
- 典型使用场景：
- 想玩某个整合包 → 打开 VersePC → 搜索/浏览 → 一键下载 → 自动配置 → 点击启动
- 想管理多个版本/整合包 → 在版本列表里一目了然，随时切换
- 整合包出了问题 → 内置诊断功能帮你排查问题
完整功能清单
| 功能模块 | 功能说明 |
|---|---|
| 整合包商店 | 对接 Modrinth、CurseForge 两大平台，支持搜索、分类筛选、版本选择 |
| 一键下载安装 | 选择整合包后自动下载所有模组、配置文件和依赖，无需手动操作 |
| 版本管理 | 支持多个 Minecraft 版本和整合包并存，独立管理各自设置 |
| 智能 Java 检测 | 自动扫描系统 Java 环境，缺 Java 还会自动帮你装好 |
| 一键启动 | 自动构建启动参数，支持窗口化/全屏切换、分辨率设置、自动分配内存 |
| 红石联机 | 无需公网 IP 和路由器设置，一键开房和朋友联机 |
| 联机大厅 | 查看公开房间，复制地址直接加入 |
| V岛 AI 助手 | 内置 AI 小助手，游戏里也能用快捷键呼出，有问题直接问 |
| 崩溃诊断 | 游戏崩溃后自动分析日志，给出可能的解决方案 |
| 自动更新 | 内置自动更新机制，有新版本自动提示并更新 |
| 资源管理 | 支持查看和管理整合包详情、数据包、材质包、光影包 |
| 壁纸引擎 & 个性化 | 亮色/暗色主题、自定义背景壁纸、界面布局可调 |
相比初赛 Demo 的升级
- 初赛阶段：只是一个能下载和启动整合包的基础原型，功能简陋，界面粗糙
- 复赛阶段：
- 新增完整的整合包搜索和筛选功能（支持多平台源 + 国内镜像直连）
- 加入智能 Java 检测和自动选择机制
- 完善版本管理，支持多个版本独立设置
- 加入崩溃日志分析和诊断功能
- 新增红石联机、联机大厅、局域网联机等联机能力
- 新增 V岛 AI 助手、一键开服、壁纸引擎等实用工具
- 优化 UI 界面，更接近成熟产品的体验
- 修复大量兼容性问题（Forge/Fabric/NeoForge/高版本等）
- 实现自动更新机制
开发关键步骤截图
关键任务对话Session ID
797560428302000:da32a80a0291144ad315cf6fa1ff43da_6a69fa5736e8dbf856a21792.6a6de804c35277edca3c4d67.6a6de804c35277edca3c4d65:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/8/1 20:35:16)
797560428302000:ed6e431515445a52e60ed496ddf05385_6a6c148624cb45abce8996eb.6a6c80e824cb45abce89ab17.6a6c80e824cb45abce89ab15:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 19:03:04)
797560428302000:c1b0a471ab78a46b9c3d8dd566fe969c_6a69fa5736e8dbf856a21792.6a6c6b9424cb45abce89a865.6a6c6b9324cb45abce89a863:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 17:32:04)
797560428302000:3f6527369a5c8ed0f25092346926ed3f_6a69fa5736e8dbf856a21792.6a6a049d36e8dbf856a21e3b.6a6a049c36e8dbf856a21e39:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/29 21:48:13)
797560428302000:3aec960cd0443cc372792b2018541051_6a69fa5736e8dbf856a21792.6a69fe8f36e8dbf856a21894.6a69fe8f36e8dbf856a21892:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/29 21:22:23)
技术方案分享
系统架构
VersePC 采用 Electron 主进程 / 渲染进程分离 的四层架构，各层职责清晰、解耦良好：
Plain Text
┌─────────────────────────────────────────────────────────┐
│ ① 渲染进程（前端界面） │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │ HTML/CSS/JS │ 页面组件 │ 3D皮肤预览│ 主题/壁纸 │ │
│ │ 原生实现 │ 下载/版本 │ three.js │ 亮暗主题 │ │
│ │ 无框架 │ /模组/联机 │ skinview3d│ 壁纸引擎 │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
├─────────────────────────────────────────────────────────┤
│ ② 主进程（Node.js 核心逻辑） │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │ 游戏启动 │ 版本管理 │ Java检测 │ 崩溃诊断 │ │
│ │ 参数构建 │ JSON合并 │ 多路径扫描│ 日志分析 │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
├─────────────────────────────────────────────────────────┤
│ ③ 后端服务 │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │ 整合包下载 │ 红石联机 │ V岛AI助手 │ 自动更新 │ │
│ │ 多源+镜像 │ 内网穿透 │ 智能问答 │ 多源检测 │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
├─────────────────────────────────────────────────────────┤
│ ④ 外部服务 │
│ ┌──────────┬──────────┬────────────────────────┐ │
│ │ Modrinth │ CurseForge │ 中继/镜像服务器 │ │
│ └──────────┴──────────┴────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
各层职责说明：
- 渲染进程（前端 UI）：负责所有界面展示与用户交互。采用原生 HTML/CSS/JS（无框架），轻量快速；集成 three.js + skinview3d 实现 3D 皮肤预览，支持亮/暗主题与壁纸引擎个性化。
- 主进程（Node.js 核心）：承载全部核心业务逻辑，包括游戏启动参数构建、版本 JSON 继承链合并、智能 Java 检测、崩溃日志诊断等重计算任务，与 UI 层完全解耦。
- 后端服务：整合包多源并发下载与镜像回退、红石联机（内网穿透 + 中继）、V岛 AI 助手、自动更新等联网能力。
- 外部服务：对接 Modrinth、CurseForge 两大模组平台，以及自建的镜像/中继服务器，保证国内用户的下载与联机体验。
前端界面通过 IPC 通信 调用主进程能力，主进程再调度后端服务与外部 API，形成一条清晰、可维护的数据链路。
技术栈
- 前端： vue3
- 后端：Node.js（Electron 主进程）
- 桌面框架：Electron 28
- 打包工具：electron-builder + NSIS
- 数据存储：JSON 文件（本地持久化）
- API 对接：Modrinth API、CurseForge API
关键实现思路
- 整合包下载采用多源并发 + 镜像回退策略，确保国内用户也能正常下载
- Java 检测采用多路径扫描 + 版本匹配算法，自动选择最优 Java
- 版本管理采用 JSON 继承链合并，确保所有启动参数正确完整
- 自动更新采用多源检测机制，支持 latest.yml 和自定义 update.json 双重校验
- 红石联机采用内网穿透与中继技术，无需公网 IP 即可联机
产品迭代规划
下一步计划：
- 增加 Mod 独立管理功能（查看、启用/禁用模组）
- 优化启动速度，减少资源占用
- 完善 mac/Linux 平台支持
- 社区功能：用户评分、评论、整合包推荐