116 lines
3.6 KiB
Markdown
116 lines
3.6 KiB
Markdown
|
# 📊 PPT智能管理系统
|
|||
|
|
|
|||
|
|
PPT管理系统，实现**静态模板内容**与**动态数据内容**的智能合并。
|
|||
|
|
|
|||
|
|
## ✨ 核心特性
|
|||
|
|
|
|||
|
|
- 📁 **静态PPT管理**: 固定不变的原理内容放在本地PPT模板中
|
|||
|
|
- 🔄 **动态内容生成**: Python脚本负责数据采集、图表生成
|
|||
|
|
- 🎯 **页面映射配置**: YAML配置文件定义每页是静态还是动态
|
|||
|
|
- 🖱️ **一键生成**: Web界面点击按钮自动合成最终PPT
|
|||
|
|
- 📝 **日志记录**: 使用loguru完整记录生成过程
|
|||
|
|
|
|||
|
|
## 📁 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
ppt_manager/
|
|||
|
|
├── static_ppt/ # 静态PPT模板目录
|
|||
|
|
│ └── macro_analysis_template.pptx # 23页模板示例
|
|||
|
|
├── config/
|
|||
|
|
│ └── project_config.yaml # 项目配置：页面映射关系
|
|||
|
|
├── scripts/ # 动态内容生成脚本
|
|||
|
|
│ ├── gdp_chart.py # GDP图表生成
|
|||
|
|
│ ├── inflation_chart.py # CPI/PPI图表
|
|||
|
|
│ ├── employment_table.py # 就业数据表
|
|||
|
|
│ ├── trade_chart.py # 进出口图表
|
|||
|
|
│ └── market_analysis.py # 市场分析图表
|
|||
|
|
├── dynamic_content/ # 动态生成的图片存放
|
|||
|
|
├── output/ # 最终生成的PPT输出目录
|
|||
|
|
├── logs/ # 日志目录
|
|||
|
|
├── src/
|
|||
|
|
│ ├── config_loader.py # 配置加载器
|
|||
|
|
│ ├── ppt_core.py # PPT核心操作
|
|||
|
|
│ ├── dynamic_generator.py # 动态内容生成器
|
|||
|
|
│ └── ppt_generator.py # 主合成引擎
|
|||
|
|
├── templates/
|
|||
|
|
│ └── index.html # Web界面
|
|||
|
|
├── app.py # Flask Web应用
|
|||
|
|
├── main.py # 命令行入口
|
|||
|
|
├── create_sample_template.py # 创建示例模板脚本
|
|||
|
|
└── requirements.txt # Python依赖
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 快速开始
|
|||
|
|
|
|||
|
|
### 1. 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd ppt_manager
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 初始化示例静态PPT模板
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python create_sample_template.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 运行系统
|
|||
|
|
|
|||
|
|
**方式一：Web界面（推荐）**
|
|||
|
|
```bash
|
|||
|
|
python app.py
|
|||
|
|
```
|
|||
|
|
然后在浏览器打开: http://localhost:5000
|
|||
|
|
|
|||
|
|
**方式二：命令行**
|
|||
|
|
```bash
|
|||
|
|
python main.py macro_analysis
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## ⚙️ 配置说明
|
|||
|
|
|
|||
|
|
在 [config/project_config.yaml](file:///f:/ppt/ppt_manager/config/project_config.yaml) 中配置：
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
projects:
|
|||
|
|
macro_analysis:
|
|||
|
|
name: "宏观数据分析报告"
|
|||
|
|
static_ppt: "static_ppt/macro_analysis_template.pptx"
|
|||
|
|
total_slides: 23
|
|||
|
|
slide_mapping:
|
|||
|
|
1: static # 静态页，来自模板
|
|||
|
|
2: static
|
|||
|
|
3: static
|
|||
|
|
4: dynamic_chart_gdp # 动态页，执行对应脚本
|
|||
|
|
5: dynamic_chart_inflation
|
|||
|
|
...
|
|||
|
|
dynamic_generators:
|
|||
|
|
dynamic_chart_gdp: "scripts/gdp_chart.py" # 脚本对应关系
|
|||
|
|
...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📝 动态脚本编写规范
|
|||
|
|
|
|||
|
|
每个动态脚本必须包含一个 `generate(output_dir)` 函数，返回生成的图片路径：
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
def generate(output_dir):
|
|||
|
|
# 1. 采集数据（API/爬虫/数据库等）
|
|||
|
|
# 2. 生成图表（matplotlib/plotly等）
|
|||
|
|
# 3. 返回图片完整路径
|
|||
|
|
return str(image_path)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🎯 使用场景示例
|
|||
|
|
|
|||
|
|
| 页面 | 类型 | 内容 | 更新频率 |
|
|||
|
|
|------|------|------|----------|
|
|||
|
|
| 1-3页 | static | 封面、目录、分析框架 | 固定不变 |
|
|||
|
|
| 4页 | dynamic | GDP趋势图 | 每月更新 |
|
|||
|
|
| 5页 | dynamic | CPI/PPI通胀图 | 每月更新 |
|
|||
|
|
| 7页 | dynamic | 就业数据表 | 每月更新 |
|
|||
|
|
| 10页 | dynamic | 进出口贸易 | 每月更新 |
|
|||
|
|
| 13页 | dynamic | A股市场分析 | 每周更新 |
|
|||
|
|
| 其他页 | static | 原理、方法论 | 固定不变 |
|