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

@@ -2,7 +2,7 @@
## 项目概述
这是一个基于Python的自动化幼儿园成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息结合AI生成个性化评语并将所有信息批量填充到PPT模板中最终生成每个学生的个性化成长报告。系统支持双界面运行命令行界面图形界面具备字体安装、图片替换、批量PDF转换、生肖计算等功能。
这是一个基于Python的自动化幼儿园成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息结合AI生成个性化评语并将所有信息批量填充到PPT模板中最终生成每个学生的个性化成长报告。系统支持双界面运行命令行界面图形界面和NiceGUI界面具备字体安装、图片替换、批量PDF转换、生肖计算等功能。
## 技术栈
@@ -15,6 +15,7 @@
- **loguru**: 日志记录
- **tomli**: 配置文件解析
- **tkinter**: 图形用户界面
- **nicegui**: 现代Web界面
## 核心功能
@@ -66,7 +67,9 @@
```
growth_report/
├── main.py # 主程序入口(命令行界面)
├── UI.py # 图形用户界面入口
├── UI.py # 图形用户界面入口tkinter
├── main_nicegui.py # NiceGUI界面入口
├── main.pyw # Windows图形界面启动文件
├── config.env.toml # 项目配置文件
├── pyproject.toml # 项目依赖配置
├── start_app.bat # Windows启动批处理文件
@@ -75,6 +78,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 # 文件操作工具
@@ -82,6 +98,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 # 生肖计算工具
@@ -153,11 +170,16 @@ data/images/
python main.py
```
#### 图形界面
#### 图形界面 (tkinter)
```bash
python UI.py
```
#### NiceGUI界面 (现代Web界面)
```bash
python main_nicegui.py
```
或直接运行批处理文件:
```bash
start_app.bat
@@ -184,11 +206,11 @@ pip install -r requirements.txt
## 系统特点
- **界面支持**: 提供命令行界面和图形界面两种操作方式
- **界面支持**: 提供命令行界面、tkinter图形界面和NiceGUI现代Web界面三种操作方式
- **自动化流程**: 从数据到成品报告的全流程自动化
- **AI集成**: 智能生成个性化评语
- **格式保持**: 替换文本时保持原有格式
- **用户友好**: 丰富的命令行界面和图形界面,实时日志显示
- **用户友好**: 丰富的命令行界面和多种图形界面,实时日志显示
- **批量处理**: 支持批量生成和转换
- **错误处理**: 完善的异常处理和日志记录
- **生肖计算**: 自动根据生日计算生肖
@@ -200,7 +222,7 @@ pip install -r requirements.txt
- 使用`loguru`进行日志记录
- 使用`rich`美化命令行输出
- 使用`tkinter`构建图形界面
- 使用`tkinter``nicegui`构建图形界面
- 配置文件使用TOML格式
- 图片和文本替换使用占位符机制
- 遵循Python代码规范