lab_report_interpret/QUICKSTART.md

快速开始指南

前置要求

• JDK 17+
• Node.js 18+
• Maven 3.6+
• 阿里云百炼平台API密钥

三步启动

第一步：配置API密钥

编辑 src/main/resources/application.yaml 文件：

bailian:
  api-key: sk-your-api-key-here  # 替换为您的百炼平台API密钥

或者通过环境变量设置：

export BAILIAN_API_KEY=sk-your-api-key-here

第二步：构建项目

# 一键构建（推荐）
./build.sh

或者手动构建：

# 先构建前端
cd frontend
npm install
npm run build
cd ..

# 再构建后端（会自动复制前端资源）
mvn clean package -DskipTests

第三步：运行项目

java -jar target/lab-report-interpret-1.0.0.jar

看到以下提示表示启动成功：

========================================
 检验报告解读系统启动成功！
 访问地址: http://localhost:8080
========================================

使用说明

1. 打开浏览器访问 http://localhost:8080
2. 点击"检验报告解读"按钮
3. 允许浏览器访问摄像头
4. 拍摄纸质检验报告
5. 等待AI解读（10-30秒）
6. 查看详细解读报告
7. 点击"返回首页"继续下一个报告

常见问题

Q: 如何获取百炼平台API密钥？

A: 访问 https://bailian.console.aliyun.com/ 获取API密钥

Q: 构建失败怎么办？

A: 确保已安装JDK 17和Node.js 18，检查网络连接

Q: 摄像头无法访问？

A: 使用localhost或HTTPS访问，检查浏览器权限设置

Q: API调用失败？

A: 检查API密钥是否正确，确认账户余额充足

开发模式

前端开发（支持热更新）

cd frontend
npm run dev
# 访问 http://localhost:3000

后端开发

mvn spring-boot:run
# 访问 http://localhost:8080

技术支持

查看详细文档：README.md