forked from GuChen/maimaiDX-API-Web-Server
Maimai DX Web 工具
这是一个基于 Python (FastAPI) 和 Vue.js (Element Plus) 构建的 Web 工具,旨在提供一个用户友好的界面来管理和查看 maimai DX 模拟器的数据。
项目结构
maimai-web-app/
├── backend/ # Python 后端服务 (FastAPI)
└── frontend/ # Vue.js 前端应用 (Element Plus)
运行项目
请确保您的系统已安装 Python 3.8+ 和 Node.js (包含 npm)。
1. 启动后端服务
打开您的命令行工具,进入 maimai-web-app/backend 目录,然后安装 Python 依赖并启动服务:
cd maimai-web-app/backend
pip install -r requirements.txt
python main.py
注意:
- 后端服务默认运行在
http://0.0.0.0:8000。如果您需要从其他设备访问(例如手机),请确保您的防火墙允许 8000 端口的传入连接,并且您的设备在同一局域网内,或者您已正确配置了端口映射。 main.py中的testUid8是一个默认的用户ID,您可以在MyConfig.py中修改它。
2. 启动前端应用
打开一个新的命令行工具(不要关闭后端服务的窗口),进入 maimai-web-app/frontend 目录,然后安装 Node.js 依赖并启动应用:
cd maimai-web-app/frontend
npm install
npm run dev -- --port 5174
前端应用默认运行在 http://localhost:5174。如果该端口被占用,它会自动尝试其他端口。您也可以通过 --port 参数指定端口,例如 npm run dev -- --port 3000。
3. 访问应用
在浏览器中打开前端应用提供的地址(通常是 http://localhost:5174)。
已实现功能
乐曲列表
- 浏览所有 maimai DX 乐曲。
- 支持按歌曲名和艺术家搜索。
用户中心
-
用户选择: 通过输入用户ID获取玩家的完整信息或预览信息。
-
玩家操作:
- 领取登录奖励: 领取所有可用的每日登录奖励。
- 道具管理: 解锁指定种类和ID的道具。
- 票券管理: 购买指定类型的票券。
- 分数管理: 上传或删除指定乐曲的分数记录。
- 上传至水鱼: 将用户的分数上传至 diving-fish.com 进行详细分析。
- 通用接口调用: 通过输入API名称,调用任意
GetUser...Api接口,并显示原始响应。 - 危险操作: 清空所有票券、强制用户登出。
-
分数详情: 获取并显示用户的所有乐曲分数记录。
更新链接
- 获取 AuthLiteDelivery 更新链接列表。
- 解析每个更新链接指向的 INI 文件,并美观地展示其中的更新信息(如游戏描述、发布时间、主更新包和可选更新包链接)。
贡献
欢迎提交 Pull Request 或报告 Bug。在提交代码之前,请确保您的代码符合项目规范。
许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。
Languages
Python
70.8%
Vue
25.8%
TypeScript
3.1%
HTML
0.2%
CSS
0.1%