> ## Documentation Index
> Fetch the complete documentation index at: https://anionex-feat-editable-text-only-export.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> 常见问题解答

## 生成的文字有乱码或模糊

* 检查是否处于 1K 低分辨率模式。在「**项目设置 → 全局设置**」中切换到 2K 或 4K 分辨率，文字清晰度差异明显。注意：部分 OpenAI 格式中转服务不支持调高分辨率，建议改用 Gemini 格式。
* 在页面描述中包含具体要渲染的文字内容，AI 更容易正确渲染。

## 可编辑 PPTX 导出效果不好，文字错位或缺失

通常是 API 配置问题。确保 `BAIDU_API_KEY` 设置正确，详见[配置说明](/zh/configuration#百度-api-key)。

也可以在「**项目设置 → 导出设置**」中调整文本提取方法（OCR / 视觉模型 / 混合），不同模型对不同排版效果差异较大。

## 普通 PPTX 导出后文字无法在 PowerPoint 中编辑

普通 PPTX 是将幻灯片图片嵌入 PPT，图片内的文字不可编辑。需要可编辑文字请使用「**导出可编辑 PPTX（Beta）**」。

## 免费版 Gemini API 能用吗？

文本生成（大纲、描述）可以用，但图片生成需要付费层级。

## 出现 503 错误或持续重试

通常是模型配置错误。建议先在设置页底部点击「**服务测试**」验证配置，再排查具体问题。

也可以查看后端日志：

```bash theme={null}
docker logs --tail 200 banana-slides-backend
```

## 修改 .env 后没有生效

* Docker 部署需重启容器才生效。
* 如果在网页设置页配置过参数，数据库中的值优先级高于 `.env`，点击「**还原默认设置**」可以清除。

## PPT 翻新上传后解析结果不对

* 推荐先在本地将 PPTX 转为 PDF 再上传，效果更稳定。
* 直接上传 PPTX 需要服务端 LibreOffice 转换，可能因缺少字体（微软雅黑、Calibri 等）导致排版偏差。
* Docker 用户需要在容器内安装 LibreOffice 才支持 PPTX 上传：
  ```bash theme={null}
  docker exec -it banana-slides-backend bash -c "apt-get update && apt-get install -y libreoffice-impress"
  ```

## 如何更改画面比例？

在首页创建项目前选择比例，或在幻灯片预览页的「**项目设置**」中修改。修改后需要重新生成图片才会生效。

注意：部分图像生成模型不支持某些比例，若生成报错可尝试切换到 16:9。

## 生成速度很慢

* 在「**设置**」中调大「**描述生成最大并发数**」和「**图像生成最大并发数**」，提高并行度。
* 如果使用免费 API 额度，可能有速率限制，考虑使用付费额度或 [AIHubMix](https://aihubmix.com/?aff=17EC) 等中转服务。

## 如何只重新生成某一页？

在幻灯片预览页，点击该页的编辑图标（铅笔），在右侧修改描述或填写修改指令，点击「**生成图片**」，只重新生成这一页。

## 幻灯片里能放柱状图、折线图、树状图这些图表吗？

有两种方案：

**方案一：描述 + 生成要求（推荐）**
在页面描述中直接用 Markdown 或文字描述图表内容，并在「描述生成要求」或「额外要求」中注明图表风格，AI 大概率能直接生成出来。示例描述：

```
页面右侧展示过去5年营收柱状图，数据为：2020: 120万、2021: 180万、2022: 240万、2023: 310万、2024: 420万，柱子为蓝色渐变，背景白色。
```

**方案二：先做成图片再粘贴**
用 Excel、Python（matplotlib）等工具提前生成图表图片，然后直接粘贴（Ctrl+V）到描述卡片中作为参考图，AI 会参考图片风格进行绘制。

## 如何保证每页图表风格统一？

推荐使用**文字描述风格**而非上传参考图片——根据测试，文字方式对生成一致性的控制效果更好。

在「额外要求」或「风格描述」中明确写下统一规范，例如：

* `所有图表使用蓝色系配色（#2563EB 为主色），白色背景，无边框`
* `图表字体统一为无衬线字体，数据标签始终显示在柱子顶部`
* `折线图使用圆形数据点标记，线条粗细 2px`

风格约束写得越具体，各页一致性越高。如果对字间距、字号这类细节有要求，也可以直接写进去。

## AI 修改大纲/描述的输入框在哪里？

在**大纲编辑器**和**描述编辑器**的顶部导航栏中，有一个输入框，填写指令后按 **Ctrl+Enter** 提交。例如：`在第三页后加一页案例分析`。