From 5fa1d7ed833309ddd28b9ff980d70a48b755d8f7 Mon Sep 17 00:00:00 2001 From: sligter <1771322848@qq.com> Date: Sun, 5 Oct 2025 20:23:53 +0800 Subject: [PATCH] update --- docs/parallel_generation.md | 149 ------------------------------------ 1 file changed, 149 deletions(-) delete mode 100644 docs/parallel_generation.md diff --git a/docs/parallel_generation.md b/docs/parallel_generation.md deleted file mode 100644 index 1034b60..0000000 --- a/docs/parallel_generation.md +++ /dev/null @@ -1,149 +0,0 @@ -# 并行生成PPT功能使用指南 - -## 功能概述 - -并行生成PPT功能允许系统同时生成多个幻灯片，显著提高PPT生成速度。启用此功能后，系统会将幻灯片分批进行并行处理，而不是逐页顺序生成。 - -## 配置说明 - -### 1. 访问配置页面 - -1. 登录LandPPT系统 -2. 点击顶部导航栏的"系统配置" -3. 切换到"🎛️ 生成参数"标签页 - -### 2. 配置并行生成 - -在"生成参数"页面中，找到"🚀 并行生成PPT"配置区域： - -#### 启用并行生成 -- 点击"启用并行生成"开关 -- 启用后会显示详细配置选项 - -#### 设置并行页数 -- **并行生成页数**：设置每批同时生成的页面数量 -- **取值范围**：1-10页 -- **默认值**：3页 -- **推荐值**：3-5页（平衡速度与稳定性） - -### 3. 保存配置 - -点击页面底部的"💾 保存生成参数"按钮，配置将立即生效。 - -## 使用场景 - -### 适用场景 - -✅ **适合使用并行生成的情况：** -- 网络连接稳定 -- AI服务配额充足 -- 需要快速生成大量幻灯片 -- 使用的AI提供商支持高并发请求 - -### 不适用场景 - -❌ **不建议使用并行生成的情况：** -- 网络不稳定或延迟较高 -- AI API配额有限 -- 使用免费或受限的AI服务 -- AI提供商有严格的并发限制 - -## 性能对比 - -### 生成速度提升 - -假设单页平均生成时间为10秒： - -| 总页数 | 顺序生成 | 并行生成(3页) | 并行生成(5页) | 速度提升 | -|--------|----------|---------------|---------------|----------| -| 10页 | 100秒 | ~40秒 | ~25秒 | 2-4倍 | -| 20页 | 200秒 | ~70秒 | ~45秒 | 3-4倍 | -| 30页 | 300秒 | ~105秒 | ~65秒 | 3-5倍 | - -*实际速度提升取决于AI服务响应时间和网络状况* - -## 注意事项 - -### ⚠️ 重要提醒 - -1. **API费用**：并行生成会增加AI API的调用频率，可能产生更多费用 -2. **并发限制**：部分AI提供商有并发请求限制（如RPM - 每分钟请求数） -3. **错误处理**：如遇到频率限制错误，建议： - - 降低并行页数 - - 临时关闭并行生成功能 - - 等待一段时间后重试 - -### 错误提示处理 - -如果看到以下错误： -- `Rate limit exceeded`：超出API调用频率限制，降低并行页数或暂停使用 -- `Too many requests`：请求过多，降低并行页数 -- `Timeout`：网络超时，检查网络连接或降低并行页数 - -## 技术细节 - -### 后端实现 - -并行生成功能在 `EnhancedPPTService.generate_slides_parallel()` 方法中实现： - -```python -async def generate_slides_parallel(self, slide_requests: List[Dict[str, Any]], - scenario: str, topic: str, language: str = "zh") -> List[str]: - """并行生成多个幻灯片内容""" - # 检查是否启用并行生成 - if not ai_config.enable_parallel_generation: - # 顺序生成 - ... - else: - # 并行生成 - tasks = [self.generate_slide_content(...) for req in slide_requests] - results = await asyncio.gather(*tasks, return_exceptions=True) - ... -``` - -### 配置项 - -- **ENABLE_PARALLEL_GENERATION**：布尔值，启用/禁用并行生成 -- **PARALLEL_SLIDES_COUNT**：整数(1-10)，每批并行生成的页数 - -### 环境变量配置 - -也可以通过环境变量配置： - -```bash -# .env 文件 -ENABLE_PARALLEL_GENERATION=true -PARALLEL_SLIDES_COUNT=3 -``` - -## 最佳实践 - -1. **首次使用**：建议从较小的并行页数（3页）开始测试 -2. **监控性能**：观察生成速度和错误率，逐步调整 -3. **网络优化**：在网络状况良好时使用并行生成 -4. **AI配额管理**：注意AI服务的使用配额和费用 -5. **错误恢复**：如遇错误，系统会自动降级到顺序生成 - -## 常见问题 - -### Q: 并行生成会影响PPT质量吗？ -A: 不会。并行生成只是改变了生成顺序，每页的生成逻辑和质量保持不变。 - -### Q: 所有AI提供商都支持并行生成吗？ -A: 大多数AI提供商支持并发请求，但可能有不同的限制。建议查看您使用的AI服务的API文档。 - -### Q: 如何知道当前是否启用了并行生成？ -A: 在PPT生成日志中，如果启用了并行生成，会看到"🚀 并行生成已启用"的日志消息。 - -### Q: 并行页数设置多少最合适？ -A: 建议值： -- 免费API或受限服务：1-2页 -- 标准付费服务：3-5页 -- 高级企业服务：5-10页 - -## 更新日志 - -- **v1.0.0** (2025-01-10)：首次发布并行生成PPT功能 - - 支持配置启用/禁用 - - 支持设置并行页数（1-10页） - - 自动错误处理和降级 \ No newline at end of file