powerpoint-presentations

PowerPoint 演示文稿

使用分阶段工作流：分类 → 检查 → 规划 → 执行 → 验证 → 渲染 → 迭代。 不得跳过源文件验证或质量检查。

1. 对请求分类

准确选择一种路径：

路径	适用情况	主要工具
编辑源文件	修改已上传或现有的演示文稿	inspect_presentation、begin_presentation_edit、编辑工具
基于模板构建	在已上传的品牌演示文稿中创建内容	begin_presentation_edit、duplicate_slide、update_slide_content
创建新演示文稿	无需保留源文件或模板	create_presentation
分析	在不编辑的情况下检查内容、设计或结构	inspect_presentation、预览工具

编辑或基于模板的请求，绝不可使用 create_presentation。它会创建新的 程序包，无法保留源文件的母版、版式、关系、备注或嵌入资源。

2. 验证并检查源文件

对于编辑和模板路径：

1. 调用 list_my_powerpoint_presentations。
2. 确认存在完全匹配的源文件名。
3. 调用 inspect_presentation，并设置 persist_spec=true。
4. 调用 preview_presentation_montage，对整套演示文稿进行视觉检查。
5. 仅对需要详细元素 ID 的幻灯片调用 analyze_presentation。

如果无法加载源文件，请停止并报告缺少该文件。不要根据描述重建演示文稿，不要 悄悄切换到新建演示文稿工作流，也不要将任务委派到尚未验证源文件的环境中。

将持久化的演示文稿规格视为跨轮次使用的设计系统记录。检查后，调用一次 begin_presentation_edit 并保留其 edit_id。结构更改后，使用该 edit_id 重新运行 inspect_presentation；不要依赖对话记忆来获取字体、颜色、版式或幻灯片 结构。

3. 编辑前规划

明确以下内容：

• 受众及决策或预期结果
• 叙事脉络，以及每张幻灯片要传达的一条信息
• 每张幻灯片的功能类型
• 内容密度预算
• 要保留或复制的源幻灯片／版式
• 需要新增视觉内容或数据的幻灯片

对于实质性内容创建，在生成代码或修改程序包前，先编写简洁的幻灯片规划。阅读 workflow-guide.md，了解规划方案和各路径的具体流程。

4. 建立设计系统

对于源文件／模板相关工作，从 deck_spec 中提取设计令牌：幻灯片尺寸、主题颜色、 主题字体、显式字体、版式名称和重复出现的视觉元素。除非用户明确要求重新设计， 否则保留这些令牌。

对于新建演示文稿，在创建幻灯片前先定义一套简洁的设计系统。阅读 design-guide.md。仅在了解新建演示文稿的实现细节时，阅读 pptxgenjs.md。

5. 谨慎执行

编辑现有演示文稿

1. 调用一次 begin_presentation_edit 并保留其 edit_id。
2. 分析目标幻灯片。
3. 构建一批完整的操作。
4. 使用相同的 edit_id 调用 update_slide_content。
5. 对 replace_text 使用 find 和 replace。

未知操作、空的查找字符串、重复的幻灯片批次以及未匹配的文本均属于错误。 请修正操作，而不是改用其他工作流。编辑前请阅读 editing-guide.md。

基于模板构建

每种功能类型的幻灯片，优先复制一张有代表性的源幻灯片。这样最能保留占位符几何尺寸、 视觉装饰和关系。

1. 检查模板并确定有代表性的幻灯片。
2. 复制最接近的代表性幻灯片。
3. 在一批操作中替换其文本／图像。
4. 重新排列幻灯片。
5. 仅在工作版演示文稿完成后，才删除未使用的示例幻灯片。

仅当存在合适版式且确实需要基于版式创建空白幻灯片时，才使用 add_slide。确定必须 保留的幻灯片类型和版式之前，绝不可删除所有示例。

创建新演示文稿

使用 create_presentation 和 PptxGenJS。根据需要，在每个幻灯片代码片段中定义共享常量和辅助函数；不要在多次调用之间重复使用选项对象，因为 PptxGenJS 会修改这些对象。

6. 验证与渲染

每次修改后：

1. 调用 validate_presentation，并设置 presentation_name=edit_id。
2. 在继续任何工作之前修复结构错误。
3. 检查有关边界、重叠、溢出风险、占位符和字体的警告。
4. 调用 preview_presentation_montage，检查完整演示文稿。
5. 仅对受影响的幻灯片调用 preview_presentation_slides，以更高细节进行检查。
6. 修复问题并重复验证及针对性渲染。
7. 使用所需的输出名称调用一次 finalize_presentation_edit。对于应用生成的演示文稿，除非用户要求单独交付文件，否则保留原文件名：最终确认会更新现有结果并保留先前的字节内容。上传的源文件保持不可变，因此需要使用不同的输出名称。

LibreOffice 渲染结果只是对 Microsoft PowerPoint 的近似还原。如果缺少字体或包含复杂的 Office 功能，请尽可能在 PowerPoint 中进行最终检查。 阅读 qa-guide.md，了解验收标准。

满足以下条件后才能宣布成功：

• 演示文稿包没有结构错误。
• 不存在尚未解决的占位符或越界警告。
• 每张修改过的幻灯片都已在最终编辑后渲染。
• 最终拼图展示的内容、设计和叙事流程协调一致。

不可妥协的规则

• 保留上传的源文件；只编辑 begin_presentation_edit 返回的隐藏草稿。
• 整个任务使用同一个 edit_id。绝不创建 v2、v3 或类似的中间演示文稿文件。
• 仅通过 finalize_presentation_edit 发布一次。
• 批量进行相关编辑；条件草稿写入会拒绝过时的并发更新。
• 编辑工具使用从 0 开始的幻灯片索引，预览工具使用从 1 开始的编号。
• 演示文稿名称仅使用字母、数字和连字符。
• 如果请求要求忠实还原源文件，请勿使用生成的近似版本。
• 不要将工具成功执行视为视觉正确的证明。