Presenton 故障排除指南：常见问题与解决方案
Presenton 是一款开源、本地运行的 AI 演示文稿生成器，作为 Gamma 的替代方案，它能够智能地根据用户输入创建专业的演示文稿。然而在使用过程中，用户可能会遇到各种技术问题，本指南将为您提供完整的故障排除解决方案。
🚀 Presenton 安装与启动问题
1. Docker 环境配置失败
问题描述：在使用 Docker Compose 启动时遇到端口冲突或容器启动失败。
解决方案：
- 检查端口占用：确保 5000 端口未被其他应用占用
- 修改 docker-compose.yml 文件中的端口映射，如将"5000:80"改为"5001:80"
- 确认 Docker 服务正常运行：
docker --version
2. 依赖项安装错误
问题描述：在安装过程中遇到包依赖冲突或缺失。
解决方案：
- 清理缓存：
docker system prune -a - 重新构建镜像：
docker-compose build --no-cache - 检查系统资源：确保有足够的磁盘空间和内存
🔧 API 配置与连接问题
3. LLM 提供商 API 密钥配置
问题描述：无法连接到 AI 模型服务，提示 API 密钥无效。
解决方案：
- 在环境变量中正确设置 API 密钥：
- OPENAI_API_KEY
- GOOGLE_API_KEY
- ANTHROPIC_API_KEY
- OLLAMA_URL
4. 模型服务连接超时
问题描述：生成演示文稿时长时间无响应或超时错误。
解决方案：
- 检查网络连接
- 验证 API 密钥权限
- 确认模型名称正确
🎨 演示文稿生成问题
5. 演示文稿生成失败
问题描述：点击生成后没有反应或提示生成错误。
解决方案：
- 检查文档上传状态
- 确认提示词输入完整
- 查看服务器日志定位具体错误
6. 图像生成问题
问题描述：AI 生成的图像不显示或质量不佳。
解决方案：
- 检查图像生成服务配置
- 确认图像提供商的 API 密钥
- 尝试不同的图像生成模型
📊 导出与格式问题
7. PDF 导出失败
问题描述：无法将演示文稿导出为 PDF 格式。
解决方案：
- 检查字体配置
- 确认导出权限