由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
BD2-L2D-Viewer 5分钟快速开始
快速启动并查看《棕色尘埃2》角色Live 2D动画的网页应用。
环境要求
支持的操作系统
运行环境
所需工具
安装项目依赖
操作步骤
克隆项目代码
使用Git将项目仓库克隆到本地。
git clone https://github.com/Jelosus2/BD2-L2D-Viewer.gitcd BD2-L2D-Viewer预期结果：：目录中出现项目文件，如 package.json, src/ 等。
如果未安装Git，可直接从GitHub下载ZIP包并解压。
安装项目依赖
使用npm安装所有必需的依赖包。
npm install预期结果：：命令执行完成，node_modules 目录被创建。
此过程可能需要1-3分钟，取决于网络速度。
启动本地开发服务器
运行项目内置的开发服务器，启动网页应用。
npm run dev预期结果：：终端显示类似 'Local: http://localhost:5173' 的本地访问地址，并提示服务器已启动。
终端窗口不要关闭，保持服务器运行。
在浏览器中查看效果
打开浏览器访问上一步输出的本地地址。
预期结果：：浏览器中打开网页，看到应用界面，可以浏览角色列表或预览动画。
如果端口被占用，Vite会自动尝试其他端口，请留意终端输出的实际地址。
验证应用启动成功
确认应用已在本地成功运行。
快速提示
如果npm install速度慢，可以尝试使用淘宝镜像：npm install --registry=https://registry.npmmirror.com
应用默认在开发模式下运行。如需生产构建，请使用 'npm run build' 命令。
遇到权限问题（如EACCES），请尝试在命令前加 'sudo'（仅限macOS/Linux）。
常见问题
'npm install' 命令失败或卡住。
检查网络连接。尝试删除 'node_modules' 文件夹和 'package-lock.json' 文件后重试。或使用 npm install --registry=https://registry.npmmirror.com 命令。
浏览器打开后页面空白或报错。
检查终端中运行 'npm run dev' 的窗口是否有错误信息。确保没有其他应用占用默认端口（如5173）。
Git克隆失败。
确保已安装Git，或直接从GitHub仓库页面点击 'Code' -> 'Download ZIP' 下载源码压缩包并解压。
下一步
探索项目代码
浏览 src/ 目录，了解Vue组件和Live 2D动画的实现方式。
贡献代码或报告问题
如果发现bug或有功能建议，欢迎在GitHub仓库提交Issue或Pull Request。
部署到线上
可以将项目构建（npm run build）后部署到任何静态网站托管服务（如Netlify, Vercel）。
相关项目推荐
PanJiaChen/vue-element-admin
🎉 神奇的Vue后台管理系统 https://panjiachen.github.io/vue-element-admin
ElemeFE/element
一个基于Vue.js 2.0的Web界面组件库 （注：根据技术文档翻译规范，"UI Toolkit"在中文技术社区常译为"界面组件库"或"UI工具包"，此处采用更符合中文开发习惯的"界面组件库"；"for Web"明确指向Web端开发，采用"Web"直译保持技术准确性）
CorentinTh/it-tools
专为开发者打造的便捷在线工具集合，拥有卓越的用户体验。
qier222/YesPlayMusic
高颜值第三方网易云播放器，支持Windows/macOS/Linux系统
vbenjs/vue-vben-admin
一个基于Vue3、Shadcn UI、Vite、TypeScript和Monorepo构建的现代化Vue管理面板。它速度极快！
requarks/wiki
Wiki.js | 基于 Node.js 构建的现代化强大 Wiki 应用