# 快速开始指南

## 前置要求

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

## 三步启动

### 第一步：配置API密钥

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

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

或者通过环境变量设置：
```bash
export BAILIAN_API_KEY=sk-your-api-key-here
```

### 第二步：构建项目

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

或者手动构建：
```bash
# 先构建前端
cd frontend
npm install
npm run build
cd ..

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

### 第三步：运行项目

```bash
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密钥是否正确，确认账户余额充足

## 开发模式

### 前端开发（支持热更新）
```bash
cd frontend
npm run dev
# 访问 http://localhost:3000
```

### 后端开发
```bash
mvn spring-boot:run
# 访问 http://localhost:8080
```

## 技术支持

查看详细文档：[README.md](README.md)