UI 业务流程图
预装版（UI 版本）由接入方服务端获取授权 code，前端通过 iframe SDK 打开 AiPPT 页面。接入方可以通过 options 和 routerOptions 控制功能板块、下载模式、场景鉴权、默认入口和自定义生成流程，并通过事件通知、事件推送与 iframe 页面交互。
版块阅读路径
建议按“先确认入口，再配置能力，最后处理事件”的顺序阅读：
| 顺序 | 页面 | 适合解决的问题 |
|---|---|---|
| 1 | 业务流程图 | 先确认 UI 版本整体链路、三类入口和关键事件边界 |
| 2 | 接入 | 完成 code 获取、SDK 引入和 AipptIframe.show 初始化 |
| 3 | 配置 | 配置功能板块、下载、场景鉴权、页面入口和自定义创建 |
| 4 | 事件通知 | 处理 iframe 通知宿主页面的路由、生成、保存、下载、错误和鉴权消息 |
| 5 | 事件推送 | 宿主页面主动向 iframe 发送操作，例如触发保存 |
| 6 | 更新日志 | 判断版本变化是否影响配置项、事件解析或接入逻辑 |
入口决策
| 入口 | 配置方式 | 进入后由谁继续推进 | 典型后续 |
|---|---|---|---|
| 默认进入 | routerOptions.list、routerOptions.generate、routerOptions.editor | 用户在 iframe 页面内继续操作 | 作品列表、AI 任务生成页或指定作品编辑器 |
| UI 自定义创建 | options.custom_generate.type + content / File / referList | UI 版本根据初始化内容创建任务 | 进入编辑大纲；粘贴 Markdown 可按 step=2 直接进模板选择 |
| API 自定义创建 | options.custom_generate.taskId + step | API 已创建任务，UI 版本继续展示该任务 | step=1 编辑大纲，step=2 选择模板，step=3 直接合成 PPT |
主流程
| 阶段 | 关键动作 | 相关配置或事件 |
|---|---|---|
| 接入鉴权 | 服务端使用 AK/SK 获取 code，前端引入 aippt-iframe-sdk.js | 鉴权、UI 接入 |
| 初始化 iframe | 调用 AipptIframe.show，传入 appkey、code、channel、container 和 onMessage | UI 接入 |
| 初始化配置 | 按业务需要配置功能板块、下载模式、场景鉴权、自定义创建和默认路由 | UI 配置 |
| 页面入口 | 分为默认进入、UI 自定义创建、API 自定义创建三类入口 | routerOptions、custom_generate |
| 生成流程 | 用户选择标题、文件、Markdown、参考文档、单页等方式生成大纲和内容；大纲弹框中可编辑大纲、下一步和下载大纲 | fc_plate、custom_generate.type、OUTLINE_CONFIRM、OUTLINE_DOWNLOAD |
| 场景鉴权 | 开启 scene_auth 后，iframe 在指定场景发出 SCENE_AUTH，接入方调用 sceneAuthContinue 决定是否继续 | SCENE_AUTH、AipptIframe.sceneAuthContinue |
| 作品处理 | 选择模板并合成新作品，合成成功后可进入编辑器继续编辑；进入编辑器后的保存才触发 PPT_SAVE | OUTLINE_CONFIRM、GENERATE_PPT_SUCCESS、PPT_SAVE、PPT_DOWNLOAD |
| 宿主交互 | 接入方通过 onMessage 接收通知，通过 setMessage 主动触发保存等动作 | 事件通知、事件推送 |