Initial commit: Add maimaiDX API web application with AimeDB scanning and logging features

README.md

@@ -0,0 +1,82 @@
+# 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 依赖并启动服务：
+
+```bash
+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 依赖并启动应用：
+
+```bash
+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](https://www.diving-fish.com/maimaidx/prober) 进行详细分析。
+  * **通用接口调用**: 通过输入API名称，调用任意 `GetUser...Api` 接口，并显示原始响应。
+  * **危险操作**: 清空所有票券、强制用户登出。
+
+* **分数详情**: 获取并显示用户的所有乐曲分数记录。
+
+### 更新链接
+
+* 获取 AuthLiteDelivery 更新链接列表。
+* 解析每个更新链接指向的 INI 文件，并美观地展示其中的更新信息（如游戏描述、发布时间、主更新包和可选更新包链接）。
+
+## 贡献
+
+欢迎提交 Pull Request 或报告 Bug。在提交代码之前，请确保您的代码符合项目规范。
+
+## 许可证
+
+本项目采用 MIT 许可证。详情请参阅 `LICENSE` 文件。
+