Agent生成的PPT支持用户修改的功能如何实现？

## 作用 让 Agent 生成的 PPT 不是静态图片或不可编辑的 HTML，而是一个“可继续编辑、可导出”的 PPT 产物，解决用户改一个字、换一种颜色就必须重新生成整份 PPT 的问题。 核心目标包括： - **网页端可视化修改**：生成后直接在浏览器中调整内容、布局、颜色、图表、图片和页面顺序。 - **保留 PPTX 可编辑性**：导出的不是图片型 PPTX，而是文字、标题、图表等节点仍可在 PowerPoint 中修改的真实 PPTX。 - **降低重复生成成本**：局部修改由用户在编辑器中完成，不需要重新调用 Agent 生成整份文稿。 - **支持模板和版式体系**：通过多套主题、大量版式和可调控件，满足不同页面类型和视觉风格的调整需求。 ## 原理 ### 1. “产物即编辑器” Agent 调用 PPT Skill 后，不只生成一份静态展示页，而是生成一个完整的网页版 PPT 编辑器。用户打开浏览器即可继续编辑，例如： - 点击文字就地修改； - 通过滑杆调整模块数量、目录项数、表格行数； - 通过下拉框切换页面布局或图表类型； - 拖拽替换图片、视频； - 拖拽缩略图重排页面； - 一键切换配色、复制页面、删除页面或跳过页面。 ### 2. 用结构化控件承载页面元素 PPT 页面由大量可调控件组成，而不是一次性渲染成图片。每个文字块、图表、布局、颜色、数量等都对应可操作的数据或配置项，因此编辑器能够针对具体节点进行修改。 其能力基础包括： - 多套视觉主题； - 覆盖封面、目录、指标、趋势、对比、流程、风险、结尾等页面角色的版式； - 大量可调控件； - 雷达图、瀑布图、矩形树图、漏斗图、热力图等图表类型。 ### 3. 修改的是结构化 PPT 数据 用户在网页端的操作会更新 PPT 的结构化描述，例如文本内容、页面顺序、布局类型、主题配色、图表参数、素材位置等。这样可以做到局部更新，而不是让 Agent 根据新需求重新生成一份全新 PPT。 ### 4. 导出时逐节点还原为 PPTX 导出 PPTX 时，系统按照页面中的节点进行还原： - 文本仍保留为 PowerPoint 文本对象； - 标题、正文等层级继续保留； - 图表按图表对象或可编辑结构还原； - 页面布局、主题和控件映射到 PPTX 中。 因此，用户导出后还能直接在 PowerPoint 中改数字、换产品名、增加页面，不必重新回到 AI 工具生成。 ### 5. 可通过命令行完成导出 生成项目后，可以使用导出命令将网页端 PPT 项目输出为 PPTX 或 PDF，例如： ```bash npm --prefix <project目录> run export:pptx -- <PPT输出目录>/ppt 输出.pptx npm --prefix <project目录> run export:pdf -- <PPT输出目录>/ppt ``` 整体实现关键是：**Agent 负责初始生成，编辑器负责局部修改，结构化数据负责状态保存，导出器负责把节点还原成真正可编辑的 PPTX。**