update

docs/parallel_generation.md

@@ -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页）
-  - 自动错误处理和降级