fix:更新项目说明文档

This commit is contained in:
2025-12-13 22:57:41 +08:00
parent 3a4a9df751
commit 6809c6f2c6
5 changed files with 107 additions and 52 deletions

View File

@@ -5,7 +5,7 @@
## 项目概述
基于Python的自动化幼儿园学期成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息结合AI生成个性化评语并将所有信息批量填充到PPT模板中最终生成每个学生的个性化成长报告。系统支持界面操作(命令行界面图形界面具备字体安装、图片替换、批量PDF转换、生肖计算、模板导出等完整功能。
基于Python的自动化幼儿园学期成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息结合AI生成个性化评语并将所有信息批量填充到PPT模板中最终生成每个学生的个性化成长报告。系统支持界面操作(命令行界面图形界面和NiceGUI界面具备字体安装、图片替换、批量PDF转换、生肖计算、模板导出等完整功能。
## ✨ 主要特性
@@ -13,7 +13,7 @@
- 🤖 **AI评语**: 智能生成个性化、治愈系风格的幼儿评语
- 🖼️ **图文并茂**: 支持个人照片、活动照片、班级合影的自动替换
- 📄 **格式转换**: 批量PPT转PDF便于分发和存档
- 🎨 **界面**: 提供命令行界面和图形界面,满足不同用户需求
- 🎨 **界面**: 提供命令行界面、tkinter图形界面和NiceGUI现代Web界面,满足不同用户需求
- 🐲 **生肖计算**: 根据生日自动计算生肖信息
- 📦 **模板导出**: 生成标准化数据模板,快速上手
- 🔤 **字体安装**: 自动检测和安装所需字体文件
@@ -28,6 +28,7 @@
- **rich**: 美化命令行界面
- **loguru**: 日志记录
- **tkinter**: 图形用户界面
- **nicegui**: 现代Web界面
- **tomli**: 配置文件解析
## 📋 系统要求
@@ -67,7 +68,12 @@ pip install -r requirements.txt
### 4. 运行程序
#### 图形界面(推荐
#### NiceGUI界面推荐现代Web界面
```bash
python main_nicegui.py
```
#### 图形界面tkinter界面
```bash
python UI.py
```
@@ -131,7 +137,9 @@ data/images/
```
growth_report/
├── main.py # 主程序入口(命令行界面)
├── UI.py # 图形用户界面入口
├── UI.py # 图形用户界面入口tkinter
├── main_nicegui.py # NiceGUI界面入口
├── main.pyw # Windows图形界面启动文件
├── config.env.toml # 项目配置文件
├── pyproject.toml # 项目依赖配置
├── start_app.bat # 启动脚本
@@ -140,6 +148,19 @@ growth_report/
├── config/
│ ├── config.py # 配置加载工具
│ └── output/ # 配置输出目录
├── ui/
│ ├── app_window.py # tkinter图形界面
│ ├── main_nicegui.py # NiceGUI界面主文件
│ ├── assets/
│ │ ├── icon.ico # 应用图标
│ │ └── style.css # 样式文件
│ ├── core/
│ │ ├── logger.py # 日志处理
│ │ ├── state.py # 应用状态管理
│ │ ├── task_runner.py # 任务运行器
│ │ └── __pycache__/
│ └── views/
│ └── home_page.py # NiceGUI主页面
├── utils/
│ ├── agent_utils.py # AI评语生成工具
│ ├── file_utils.py # 文件操作工具
@@ -147,6 +168,7 @@ growth_report/
│ ├── generate_utils.py # 核心生成功能
│ ├── growt_utils.py # PPT模板替换工具
│ ├── image_utils.py # 图片处理工具
│ ├── log_handler.py # 日志处理器
│ ├── pdf_utils.py # PDF转换工具
│ ├── pptx_utils.py # PPT文本和图片替换工具
│ └── zodiac_utils.py # 生肖计算工具