ethanfly/weekreport

Fork 0

Ethanfly 98e2950b2e Sure! Pl

2026-01-09 11:00:31 +08:00

4.2 KiB

Raw Permalink Blame History

智能周报生成器

基于阿里云千问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 用户

双击运行安装脚本
```
install.bat
```
启动开发服务器
```
start.bat
```
访问应用

打开浏览器访问：http://localhost:8000

手动安装

克隆项目
```
cd E:\Workspace\weekreport
```
安装依赖
```
composer install
```

配置环境

# 复制环境配置文件
copy env.txt .env

# 或在 Linux/Mac 上
cp env.txt .env

生成应用密钥
```
php artisan key:generate
```
创建存储链接
```
php artisan storage:link
```
启动服务器
```
php artisan serve
```

⚙️ 配置说明

API 配置

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

# 千问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：

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

📖 使用指南

设置周报信息
- 选择周报的开始和结束日期
- 填写作者姓名（可选）
添加任务
- 点击"添加新任务"按钮
- 填写任务描述
- 可选：上传任务相关截图
生成周报
- 点击"生成周报"按钮
- 等待 AI 生成专业周报
预览与下载
- 在右侧预览区查看生成结果
- 点击下载按钮获取 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: 图片上传后不显示

运行以下命令创建存储链接：

php artisan storage:link

Q: PDF 中文乱码

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

📄 许可证

MIT License

🙏 致谢

阿里云百炼 - 提供千问大模型 API
Laravel - PHP Web 框架
DomPDF - PDF 生成库
Remix Icon - 图标库

4.2 KiB Raw Permalink Blame History Unescape Escape