syncfusion-dotnet-powerpoint

PowerPoint（PPTX）演示文稿处理

概述

使用 Syncfusion Presentation Library 创建、编辑和转换 PowerPoint（.pptx）文件。 此技能支持两种操作模式——为用户的项目生成 C# 代码，或直接通过 CSX 脚本执行任务。

主要功能

• 创建与编辑： 演示文稿（.pptx）、幻灯片（克隆和合并）、段落、文本框、表格、形状、图像、列表、连接符、超链接、页眉/页脚、批注、文档属性、分节
• 高级功能： 自定义动画和幻灯片切换效果、母版版式、演讲者备注、SmartArt、OLE 对象、查找和替换、宏、图表创建和编辑、图表转图像
• 转换： PowerPoint 转 PDF；PowerPoint 转图像（PNG、JPEG）
• 安全性： 加密和解密演示文稿；设置和移除写保护

前提条件

• .NET SDK 8+ 和 dotnet-script：dotnet tool install -g dotnet-script
• 免费许可证：https://www.syncfusion.com/products/communitylicense

快速入门示例

示例 1：生成代码（模式 1）

用户：“演示如何创建带有简单柱状图的 PowerPoint 演示文稿”

结果： 显示 C# 代码片段（不会创建文件）

示例 2：执行任务（模式 2）

用户：“在 output/SalesChart.pptx 创建一个带有简单柱状图的 PowerPoint 演示文稿”

结果： 在 output/SalesChart.pptx 创建包含嵌入图表的实际文件

两种模式 — 根据用户意图选择

模式 1：为用户的项目生成 C# 代码 （默认）

当用户想要查看、编写、审查、重构或修改与 PowerPoint 处理相关的 C# 代码时，使用此模式。

触发关键词：“show me how”、“how to”、“how can I”、“how do I”、“provide code”、“provide an example”、“give an example”、“demonstrate”、“code snippet”、“sample code”、“example”、“sample”、“give me”、“show me”、“Program.cs”、“example code”、“generate code for”、“codesnippet”。

工作流：

步骤 1 — 检测应用类型并推荐所需的 NuGet 包

• 检查工作区项目文件（.csproj、web.config、App.config、Startup.cs、Program.cs 等），并使用 references/nuget-packages.md 中的检测信号表确定应用类型。
• 根据检测到的应用类型，从 references/nuget-packages.md 中确定正确的 NuGet 包，并指导用户在生成代码前安装这些包。

步骤 2 — 仅根据参考文件生成代码

切勿虚构、猜测或建议参考文件中未明确列出的任何 API、方法、属性、类或命名空间。

• 阅读与所请求功能相关的 references/*.md 文件
• 严格依据这些文件中的 API 和代码片段构建 C# 代码
• 根据步骤 1 中检测到的应用类型选择正确的代码片段变体：
  • 特定于 Windows 的应用（WinForms、WPF、.NET Framework Console、ASP.NET MVC4/5）→ 使用特定于 Windows 的代码片段
  • 跨平台应用（ASP.NET Core、.NET Core/.NET 5+ Console、Blazor、MAUI）→ 使用跨平台 / .Net.Core 代码片段
• 不要创建或运行任何 .csx 脚本

---

模式 2：通过 CSX 脚本执行 （不会触及项目文件）

仅当用户明确要求执行、生成文件或产出完整结果（例如，完成的 PPTX 文件）时，使用此模式。

触发关键词：“create a presentation”、“make a presentation”、“generate a presentation”、“open”、“edit”、“modify”、“change” .pptx 文件、“without modifying my project”、“run a csx script”，或用户提供文件路径时（例如，output/report.pptx）。

工作流：

步骤 1 — 创建临时 CSX 脚本

• 以 references/template.csx 为基础
• 创建于：{skill-root}/syncfusion-dotnet-powerpoint/scripts/temp-{uniqueId}.csx（例如，skill-root = .codestudio/skills）
• 使用随机 GUID 作为唯一文件名（例如，temp-a3f7b2c1.csx）；切勿在工作区根目录中创建

步骤 2 — 根据参考文件编写脚本

• 不要编造参考文件中没有的 API/方法
• 阅读相关的 references/*.md 文件并提取代码片段
• 替换所有占位符：文件路径、文档属性、数据值、字段名称等

步骤 3 — 执行脚本

• 运行：dotnet script {skill-root}/syncfusion-dotnet-powerpoint/scripts/temp-{uniqueId}.csx
• 验证是否成功执行，并记录任何错误

步骤 4 — 清理并报告

• 执行后删除临时 .csx 文件
• 报告 SUCCESS/ERROR，并提供输出文件路径及任何错误消息和修复方法

---

代码参考

所有模板和代码片段均位于 references/ 文件夹中：

文件	内容
template.csx	CSX 脚本基本结构（仅限模式 2）
presentation-structure.md	创建/保存/关闭演示文稿、幻灯片版式、页面大小、文档属性
slides.md	添加、删除、调整大小和自定义 PowerPoint 幻灯片、打印幻灯片
layout.md	访问、自定义和创建母版幻灯片及版式幻灯片
paragraph.md	在文本框和形状中添加、设置格式和管理段落
sections.md	在演示文稿中创建和修改节
tables.md	在演示文稿中创建和修改表格
shapes.md	在演示文稿中添加、遍历、设置格式和删除形状（自选图形、图片、文本框、组合形状）
connectors.md	添加、编辑、更新和删除形状之间的连接符
image.md	添加、替换、裁剪和删除图片，包括 SVG 支持
list.md	创建编号列表、项目符号列表、图片列表和多级列表
chart.md	在演示文稿中创建和编辑图表
animation-transition.md	在演示文稿中添加和修改幻灯片切换效果及动画效果
comments.md	在演示文稿中添加、回复、修改和删除批注
header-footer.md	添加、编辑和删除页眉与页脚，包括幻灯片编号和日期
notes.md	在演示文稿中添加、编辑、设置格式和删除演讲者备注
ole-objects.md	在幻灯片中插入、提取和管理 OLE 对象（Excel、Word、Visio）
conversions.md	将演示文稿转换为图像和 PDF
encrypt-decrypt.md	安全：在演示文稿读取或写入时进行保护、加密和解密
find-and-replace.md	在特定幻灯片或整个演示文稿中查找和替换、查找并突出显示
smartart.md	在 PowerPoint 演示文稿中创建 SmartArt、添加、编辑和删除 SmartArt 节点
hyperlinks.md	添加或修改网页、电子邮件、书签、文件和图片超链接
macros.md	加载、保存、删除和管理演示文稿中的宏
markdown-conversion.md	将 PowerPoint 演示文稿转换为 Markdown 或从 Markdown 转换，定制图像导出路径并配置 Markdown 编码选项

---

规则

• 输出文件放在 ./output/ 目录中
• 临时 .csx 脚本必须创建在 {skill-root}/syncfusion-dotnet-powerpoint/scripts/ 中，绝不能放在工作区根目录或客户的 scripts/ 文件夹中
• 绝不使用 Python 库（例如 python-pptx）
• 执行后绝不保留临时 .csx 文件