frontend/doc/AIPPT.md

AIPPT的基本原理

1. 定义PPT结构（一套PPT中都有什么类型的页面，每种页面都有些什么内容）；
2. 基于以上结构，定义数据格式，该数据将用于AI生成结构化的PPT数据，具体结构见：
   • 示例数据：public/mocks/AIPPT.json
   • 结构定义：src/types/AIPPT.ts
3. 制作模板，模板中标记好结构类型；
4. AI生成符合第1步定义的PPT结构的数据；
5. 利用AI或其他方案，生成相关的配图（常见途径有：AI文生图、图库搜索匹配）；
6. 将AI生成的数据、配图与模板进行匹配结合，生成最终的PPT。

注：虽然当前线上版本不提供配图演示效果，但是AIPPT的方法是支持此功能的，你只需要自己提供图片源，按照要求的格式将待选图片集合传入AIPPT方法即可。

AIPPT模板制作流程

1. 打开PPTist；
2. 制作模板页面；
3. 打开左上角菜单[幻灯片类型标注]功能；
4. 为制作好的页面标注页面类型和节点类型；
5. 使用导出功能导出为JSON文件。

注意：实际上并不存在专门提供给AIPPT的模板。所谓的AIPPT模板只是把在PPTist中制作的普通页面标注上类型标记而已。这些数据不仅仅用于AI生成PPT，也可以作为普通的页面模板使用。

模板标记类型：页面标记和节点标记

封面页

• 标题
• 正文
• 图片（背景图、页面插图）

目录页

• 目录标题（标记类型为：列表项目）
• 图片（背景图、页面插图）

过渡页（章节过渡）

• 标题
• 正文
• 节编号
• 图片（背景图、页面插图）

内容页

• 标题
• 2～4个内容项，包括：
  • 内容项标题（标记类型为：列表项标题）
  • 内容项正文（标记类型为：列表项目）
  • 内容项编号（标记类型为：项目编号）
• 图片（背景图、页面插图、项目插图）

结束页（致谢页）

• 图片（背景图、页面插图）

节点标记分为两种 - 文本标记和图片标记：

• 文本标记可作用于文本节点和带文字的形状节点；
• 图片标记只作用于图片节点；
• 你可以自行添加更多类型的标记（如图表）。

AIPPT模板制作原则

一个用于AIPPT的模板至少包括以下页面（共12页）：

• 1个封面页
• 6个目录页（2～6个目录项各1个，10个目录项的1个）
• 1个过渡页
• 3个内容页（2～4个内容项各1个）
• 1个结束页

注意：

1. 以上页数仅满足当前替换逻辑的最基本要求，如果希望AI生成的PPT具有一定的随机性，需要适当增加每种页面的数量（举个例子，假设模板中存在3个封面页，生成时会从3个中随机选择1个使用）；
2. 当前替换逻辑下，目录页可支持1～20个目录项，内容页可支持1～12个内容项，但是却不需要每种数量的模板都做一遍，是因为程序会自动通过模板的拼接/裁减方式来实现特殊的项目数；
3. 你可以自行调整替换逻辑，以支持更多情况。