生成的文字有乱码或模糊
- 检查是否处于 1K 低分辨率模式。在「项目设置 → 全局设置」中切换到 2K 或 4K 分辨率，文字清晰度差异明显。注意：部分 OpenAI 格式中转服务不支持调高分辨率，建议改用 Gemini 格式。
- 在页面描述中包含具体要渲染的文字内容，AI 更容易正确渲染。
可编辑 PPTX 导出效果不好，文字错位或缺失
通常是 API 配置问题。确保BAIDU_API_KEY 设置正确，详见配置说明。
也可以在「项目设置 → 导出设置」中调整文本提取方法（OCR / 视觉模型 / 混合），不同模型对不同排版效果差异较大。
普通 PPTX 导出后文字无法在 PowerPoint 中编辑
普通 PPTX 是将幻灯片图片嵌入 PPT，图片内的文字不可编辑。需要可编辑文字请使用「导出可编辑 PPTX（Beta）」。免费版 Gemini API 能用吗？
文本生成（大纲、描述）可以用，但图片生成需要付费层级。出现 503 错误或持续重试
通常是模型配置错误。建议先在设置页底部点击「服务测试」验证配置，再排查具体问题。 也可以查看后端日志：修改 .env 后没有生效
- Docker 部署需重启容器才生效。
- 如果在网页设置页配置过参数，数据库中的值优先级高于
.env，点击「还原默认设置」可以清除。
PPT 翻新上传后解析结果不对
- 推荐先在本地将 PPTX 转为 PDF 再上传，效果更稳定。
- 直接上传 PPTX 需要服务端 LibreOffice 转换，可能因缺少字体（微软雅黑、Calibri 等）导致排版偏差。
- Docker 用户需要在容器内安装 LibreOffice 才支持 PPTX 上传：
如何更改画面比例？
在首页创建项目前选择比例，或在幻灯片预览页的「项目设置」中修改。修改后需要重新生成图片才会生效。 注意：部分图像生成模型不支持某些比例，若生成报错可尝试切换到 16:9。生成速度很慢
- 在「设置」中调大「描述生成最大并发数」和「图像生成最大并发数」，提高并行度。
- 如果使用免费 API 额度，可能有速率限制，考虑使用付费额度或 AIHubMix 等中转服务。
如何只重新生成某一页？
在幻灯片预览页，点击该页的编辑图标（铅笔），在右侧修改描述或填写修改指令，点击「生成图片」，只重新生成这一页。幻灯片里能放柱状图、折线图、树状图这些图表吗？
有两种方案： 方案一：描述 + 生成要求（推荐） 在页面描述中直接用 Markdown 或文字描述图表内容，并在「描述生成要求」或「额外要求」中注明图表风格，AI 大概率能直接生成出来。示例描述：如何保证每页图表风格统一？
推荐使用文字描述风格而非上传参考图片——根据测试，文字方式对生成一致性的控制效果更好。 在「额外要求」或「风格描述」中明确写下统一规范，例如：所有图表使用蓝色系配色（#2563EB 为主色），白色背景，无边框图表字体统一为无衬线字体，数据标签始终显示在柱子顶部折线图使用圆形数据点标记，线条粗细 2px
AI 修改大纲/描述的输入框在哪里？
在大纲编辑器和描述编辑器的顶部导航栏中，有一个输入框，填写指令后按 Ctrl+Enter 提交。例如：在第三页后加一页案例分析。