项目使用说明

这页是给“第一次接触项目”的你准备的，重点是：怎么把项目真正跑起来并开始使用。

1. 先理解这个项目怎么工作

浏览器并不是直接调用 Python 模型，而是走这条链路：

浏览器 -> Java 后端(8080) -> Python ML 服务(5000)

这样做的好处是：权限、日志、业务数据统一在后端管理，前端更稳定。

2. 首次使用（推荐顺序）

1. 准备 MySQL、Redis、Java、Python、Node.js 环境
2. 执行数据库初始化脚本：sql/init.sql
3. 启动后端、ML 服务、前端
4. 打开前端地址 http://localhost:8888
5. 使用默认管理员账号登录（见 sql/init.sql）：
   • 用户名：admin
   • 密码：123456

3. 两种启动方式

方式 A：一键启动（最省事）

cd yolo11-craft
start_all.bat

注意：start_all.bat 里有你本机的绝对路径（MySQL / Redis / JDK / Conda），换机器后要先改路径再运行。

方式 B：分模块启动（排错更方便）

:: 后端
cd backend
mvnw.cmd spring-boot:run

:: ML 服务
cd ..\ml-service
python app.py

:: 前端
cd ..\frontend
npm install
npm run dev

4. 日常使用流程（建议）

1. 进入数据集模块，上传并检查数据
2. 在训练模块配置训练参数并启动任务
3. 在图片/视频推理模块查看检测结果
4. 如需实时识别，使用摄像头实时检测模块
5. 结果文件与日志可通过后端文件接口回看

5. 常用访问地址

• 前端应用：http://localhost:8888
• Java 后端：http://localhost:8080
• Python ML：http://localhost:5000

6. 小白最容易踩的坑

• 先开前端再开后端：会看到接口报错（正常，后端未就绪）
• 数据库没初始化：登录、任务记录等功能会异常
• 端口被占用：服务启动失败，需释放端口或改端口
• GPU 不可用：先确认 CUDA、驱动、PyTorch 版本一致