# 智能周报生成器

基于阿里云千问Max大模型的智能周报生成应用，使用 Laravel 框架开发。

## ✨ 功能特性

- 📝 **任务管理**：动态添加/删除任务列表
- 🖼️ **图片上传**：支持为每个任务上传截图（可选）
- 🤖 **AI生成**：调用千问Max模型智能生成专业周报
- 📄 **Markdown预览**：实时预览生成的周报内容
- ⬇️ **多格式下载**：支持 Markdown 和 PDF 格式下载
- 🎨 **精美界面**：现代化深色主题，响应式设计

## 🛠️ 技术栈

- **后端**：PHP 8.0+ / Laravel 8
- **前端**：原生 HTML/CSS/JavaScript
- **AI模型**：阿里云通义千问 Max (qwen-max)
- **PDF生成**：DomPDF

## 📋 环境要求

- PHP >= 8.0
- Composer
- 以下 PHP 扩展：
  - BCMath
  - Ctype
  - cURL
  - DOM
  - Fileinfo
  - JSON
  - Mbstring
  - OpenSSL
  - PDO
  - Tokenizer
  - XML

## 🚀 快速开始

### Windows 用户

1. **双击运行安装脚本**
   ```
   install.bat
   ```

2. **启动开发服务器**
   ```
   start.bat
   ```

3. **访问应用**
   
   打开浏览器访问：http://localhost:8000

### 手动安装

1. **克隆项目**
   ```bash
   cd E:\Workspace\weekreport
   ```

2. **安装依赖**
   ```bash
   composer install
   ```

3. **配置环境**
   ```bash
   # 复制环境配置文件
   copy env.txt .env
   
   # 或在 Linux/Mac 上
   cp env.txt .env
   ```

4. **生成应用密钥**
   ```bash
   php artisan key:generate
   ```

5. **创建存储链接**
   ```bash
   php artisan storage:link
   ```

6. **启动服务器**
   ```bash
   php artisan serve
   ```

## ⚙️ 配置说明

### API 配置

在 `.env` 文件中配置千问 API：

```env
# 千问Max API配置
QWEN_API_KEY=sk-7ea0fac260574e4ea22c9de728e7bff9
QWEN_API_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
QWEN_MODEL=qwen-max
```

### 数据库配置（可选）

默认使用 SQLite，如需使用 MySQL：

```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=weekreport
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

## 📖 使用指南

1. **设置周报信息**
   - 选择周报的开始和结束日期
   - 填写作者姓名（可选）

2. **添加任务**
   - 点击"添加新任务"按钮
   - 填写任务描述
   - 可选：上传任务相关截图

3. **生成周报**
   - 点击"生成周报"按钮
   - 等待 AI 生成专业周报

4. **预览与下载**
   - 在右侧预览区查看生成结果
   - 点击下载按钮获取 Markdown 或 PDF 格式

## 📁 项目结构

```
weekreport/
├── app/
│   ├── Http/
│   │   └── Controllers/
│   │       └── WeekReportController.php  # 主控制器
│   └── Providers/
├── config/
│   ├── app.php
│   ├── services.php        # API配置
│   └── ...
├── public/
│   └── index.php           # 入口文件
├── resources/
│   └── views/
│       └── weekreport/
│           └── index.blade.php  # 前端页面
├── routes/
│   └── web.php             # 路由定义
├── storage/
├── .env                    # 环境配置
├── composer.json
├── install.bat             # Windows安装脚本
├── start.bat               # Windows启动脚本
└── README.md
```

## 🔧 API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/` | 显示周报生成页面 |
| POST | `/upload` | 上传任务图片 |
| POST | `/generate` | 生成周报 |
| POST | `/download/markdown` | 下载 Markdown 格式 |
| POST | `/download/pdf` | 下载 PDF 格式 |

## 🐛 常见问题

### Q: 生成周报时报错 "API Key 未配置"

确保 `.env` 文件中正确配置了 `QWEN_API_KEY`。

### Q: 图片上传后不显示

运行以下命令创建存储链接：
```bash
php artisan storage:link
```

### Q: PDF 中文乱码

确保系统安装了中文字体，DomPDF 会自动使用系统字体。

## 📄 许可证

MIT License

## 🙏 致谢

- [阿里云百炼](https://bailian.console.aliyun.com/) - 提供千问大模型 API
- [Laravel](https://laravel.com/) - PHP Web 框架
- [DomPDF](https://github.com/dompdf/dompdf) - PDF 生成库
- [Remix Icon](https://remixicon.com/) - 图标库