幼儿园成长报告生成系统
项目概述
基于Python的自动化尚城幼儿园学期成长报告生成系统。该系统可以从Excel数据文件中读取幼儿信息，结合AI生成个性化评语，并将所有信息批量填充到PPT模板中，最终生成每个学生的个性化成长报告。系统还支持字体安装、图片替换、批量PDF转换等功能。
技术栈
- Python 3.x: 主要编程语言
- python-pptx: PPT文件处理
- pandas: Excel数据读取与处理
- langchain: AI模型集成
- comtypes: PowerPoint转PDF功能
- rich: 美化命令行界面
- loguru: 日志记录
- toml: 配置文件解析
核心功能
1. 生成模板 (📁 生成模板)
- 从Excel文件中读取学生姓名
- 为每个学生创建图片文件夹结构
2. 生成评语 (🤖 生成评语)
- 使用AI模型根据学生姓名、年龄组和表现特征生成个性化评语
- 评语会自动写入Excel文件的对应列
- 支持跳过已有评语的记录以节省API调用
3. 生成报告 (📊 生成报告)
- 读取Excel数据和图片资源
- 将信息批量填充到PPT模板中
- 保持原有的文字格式和样式
- 替换文本占位符和图片占位符
4. 格式转换 (📑 格式转换)
- 批量将生成的PPT文件转换为PDF格式
- 使用COM接口与PowerPoint进行交互
主要文件结构
growth_report/
├── main.py # 主程序入口，包含所有核心功能
├── config.toml # 项目配置文件
├── config/
│ └── config.py # 配置加载工具
├── utils/
│ ├── agent_utils.py # AI评语生成工具
│ ├── font_utils.py # 字体安装和检测工具
│ ├── pptx_utils.py # PPT文本和图片替换工具
│ ├── pef_utils.py # PPT转PDF工具
└── data/
├── names.xlsx # 学生数据Excel文件
└── images/ # 学生图片资源文件夹
配置说明
config.toml
paths: 定义文件路径（模板、输出、Excel、图片、字体）class_info: 班级信息（名称、教师名单）defaults: 默认设置（默认评语、年龄组）excel: Excel表配置（工作表名、列名顺序）ai: AI配置（API密钥、URL、模型、提示词）
Excel数据格式
Excel文件应包含以下列（顺序必须与配置文件中一致）：
- 姓名
- 英文名
- 性别
- 生日
- 属相
- 我的好朋友
- 我的爱好
- 喜欢的游戏
- 喜欢吃的食物
- 评价
图片文件结构
data/images/
├── 班级名称.jpg # 班级集体照片
└── 学生姓名/
├── me_image.jpg # 学生个人照片
├── 1.jpg # 活动照片1
├── 2.jpg # 活动照片2
AI评语生成
系统使用langchain框架与AI模型集成，根据以下信息生成评语：
- 幼儿姓名
- 所在班级（年龄段）
- 表现特征
评语风格为"治愈系"，采用三段式结构：亲切问候、具体描述优点、委婉期望与祝福。
使用方法
运行程序
python main.py
依赖安装
pip install -r requirements.txt
或使用uv：
uv sync
初始化设置
- 编辑
config.toml配置文件 - 准备Excel数据文件
- 准备图片资源文件夹
- 准备PPT模板文件
系统特点
- 自动化流程: 从数据到成品报告的全流程自动化
- AI集成: 智能生成个性化评语
- 格式保持: 替换文本时保持原有格式
- 用户友好: 丰富的命令行界面和进度提示
- 批量处理: 支持批量生成和转换
- 错误处理: 完善的异常处理和日志记录
开发约定
- 使用
loguru进行日志记录 - 使用
rich美化命令行输出 - 配置文件使用TOML格式
- 图片和文本替换使用占位符机制
- 遵循Python代码规范