# 智能生产报表AI分析功能

## 功能概述

智能报表功能利用AI分析生产数据，自动生成包含以下内容的生产报表：
- 生产总览和关键指标
- 平台产量分布
- 质量问题分析
- AI洞察和改进建议
- 产量预测

## 支持的AI提供商

1. **OpenAI** - GPT-3.5/GPT-4
2. **通义千问** - 阿里云
3. **文心一言** - 百度
4. **本地模型** - Ollama等

## 配置步骤

### 1. 后端配置

#### 1.1 安装依赖
```bash
cd backend
pip install aiohttp fastapi python-dotenv
```

#### 1.2 配置环境变量
```bash
# 复制配置文件
cp .env.example .env

# 编辑配置文件
nano .env
```

#### 1.3 配置示例

**使用OpenAI：**
```
AI_PROVIDER=openai
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
```

**使用通义千问：**
```
AI_PROVIDER=qwen
QWEN_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
```

**使用文心一言：**
```
AI_PROVIDER=wenxin
WENXIN_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxx
WENXIN_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxx
```

**使用本地模型（Ollama）：**
```
AI_PROVIDER=local
LOCAL_AI_URL=http://localhost:11434/api/generate
LOCAL_MODEL=llama2
```

### 2. 启动本地模型（可选）

如果使用本地模型，需要先启动Ollama：

```bash
# 安装Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 启动Ollama服务
ollama serve

# 下载模型
ollama pull llama2
# 或下载中文模型
ollama pull qwen:7b
```

### 3. 集成到后端

在主应用中注册AI API路由：

```python
# main.py 或 app.py
from api_ai import router as ai_router

app.include_router(ai_router)
```

### 4. 前端使用

前端已经集成AI报表组件，位于仪表盘页面。用户可以：
- 点击"生成智能报表"按钮
- 查看AI分析结果
- 导出报表为文本文件
- 刷新获取最新分析

## API接口

### 1. 分析生产数据
```
POST /api/ai/analyze
```

响应示例：
```json
{
  "summary": {
    "totalProduction": 15423,
    "goodRate": "98.5%",
    "trend": "up",
    "insights": [
      "本周产量较上周增长12%，主要得益于圆通订单的增加",
      "良品率保持在98%以上，质量管控效果显著",
      "建议：继续保持当前生产节奏，关注设备维护"
    ]
  },
  "platforms": {
    "pdd": {
      "count": 8934,
      "percentage": 57.9,
      "trend": "+5.2%"
    },
    "yt": {
      "count": 6489,
      "percentage": 42.1,
      "trend": "+18.7%"
    }
  },
  "quality": {
    "topIssues": [
      {"issue": "外观划痕", "count": 23, "percentage": "0.15%"},
      {"issue": "功能异常", "count": 12, "percentage": "0.08%"},
      {"issue": "包装破损", "count": 8, "percentage": "0.05%"}
    ]
  },
  "prediction": {
    "tomorrow": 2250,
    "weekRange": "15500-16500",
    "confidence": "92%"
  },
  "metadata": {
    "generated_at": "2024-01-20T10:30:00",
    "data_period": "最近30天",
    "total_records": 15423,
    "ai_provider": "openai"
  }
}
```

### 2. 获取AI配置信息
```
GET /api/ai/config
```

### 3. 测试AI连接
```
POST /api/ai/test
```

### 4. 获取支持的提供商
```
GET /api/ai/providers
```

## 注意事项

1. **API密钥安全**：请妥善保管API密钥，不要提交到版本控制
2. **成本控制**：使用云端AI服务会产生费用，建议设置使用限额
3. **响应时间**：AI分析可能需要几秒钟，请耐心等待
4. **数据隐私**：生产数据会发送给AI服务，请确保符合隐私政策

## 故障排除

### 1. AI分析失败
- 检查API密钥是否正确
- 确认网络连接正常
- 查看后端日志获取详细错误信息

### 2. 本地模型连接失败
- 确认Ollama服务正在运行
- 检查模型是否已下载
- 验证URL配置是否正确

### 3. 分析结果不准确
- 调整提示词（修改ai_service.py中的prompt）
- 尝试不同的AI模型
- 增加数据量或改进数据质量

## 扩展功能

1. **自定义分析维度**：可以修改提示词，添加更多分析维度
2. **定时生成报表**：可以设置定时任务，自动生成日报/周报
3. **报表模板**：支持多种报表格式（PDF、Excel等）
4. **历史记录**：保存历史分析结果，支持对比查看

## 技术支持

如有问题，请查看：
1. 后端日志：`/logs/ai_service.log`
2. 浏览器控制台错误信息
3. API响应状态和错误消息