claw-presentation-creator

核心用法

claw-presentation-creator 是一个基于 python-pptx 库的 PowerPoint 自动化生成技能，通过 Python 代码即可完整控制 PPT 的创建、编辑和保存流程。用户可从零新建演示文稿，或基于现有模板进行修改，支持标题页、内容页、双栏布局等 7 种标准版式。

内容编辑方面，该技能覆盖了文本格式化（字体、颜色、大小、对齐、层级缩进）、图片插入（支持尺寸控制与保持宽高比）、表格创建（含单元格合并、背景色、边框样式）以及 10+ 种图表类型（柱状图、折线图、饼图、散点图等）。高级功能包括形状绘制、演讲者备注添加、幻灯片母版访问等。

显著优点

1. 完整生态兼容：原生支持 Office Open XML 标准，生成的 .pptx 文件与 Microsoft PowerPoint、WPS、Google Slides 完全兼容
2. 高度可编程：所有视觉元素均可通过代码精确控制位置和尺寸，适合数据驱动的批量报告生成
3. 模板继承能力：可直接加载企业模板并沿用其母版样式，确保品牌一致性
4. 零依赖运行：纯 Python 实现，无需 Office 软件安装，适合服务器端自动化部署

潜在缺点与局限性

1. 动画支持薄弱：python-pptx 本身仅支持读取动画，创建复杂动画需借助其他工具
2. 排版调试成本高：坐标定位基于英寸（Inches）或磅（Pt），缺乏可视化拖拽界面，精细排版需反复试错
3. 字体兼容性风险：若指定字体在目标设备不存在，可能触发字体回退导致版式错乱
4. 图表交互受限：生成的图表为静态图片，不支持数据透视或实时更新

适合人群

• 数据分析师：需将 Python 分析结果自动输出为商业级演示文稿
• 运营与财务团队：周期性报告（周报/月报/季报）的自动化生成
• 开发者与 DevOps：构建文档生成流水线，集成至 CI/CD 或自动化办公系统
• 教育培训机构：批量生成标准化课件或证书

常规风险

• 文件覆盖风险：代码中 prs.save() 默认覆盖同名文件，需确保输出路径唯一性
• 图片路径依赖：若图片资源使用相对路径，迁移至其他环境时可能失效
• 内存占用：处理大量高分辨率图片时，需注意内存管理，建议先压缩再插入
• 版本兼容性：不同 PowerPoint 版本的默认版式索引可能略有差异，跨模板使用时需验证

核心用法

本 Skill 提供完整的 python-pptx 技术文档，帮助用户通过 Python 代码程序化创建和编辑 PowerPoint 演示文稿。核心能力包括：幻灯片管理（9 种标准布局）、文本格式化（字体、颜色、对齐、层级）、图片插入（支持 JPG/PNG，可指定尺寸和位置）、表格创建（单元格样式、合并、边框）、图表生成（柱状图、饼图、折线图等 12 种类型）、形状绘制（矩形、箭头、椭圆等），以及模板复用和演讲者备注添加。

典型使用流程为：导入 Presentation 类 → 选择或加载模板 → 添加幻灯片并指定布局 → 填充内容（文本/图片/图表/表格）→ 应用格式 → 保存文件。所有操作均通过代码精确控制，支持批量生成和自动化工作流集成。

显著优点

专业级功能覆盖：完整封装 python-pptx 核心 API，从基础文本到复杂图表、从单张幻灯片到整套模板，满足商务汇报、数据分析、教育培训等多场景需求。

零学习曲线：提供 148 个可直接运行的代码示例，涵盖商务演示、照片画廊、发票生成等完整案例，复制即可产出可用 PPT。

格式精确可控：支持英寸（Inches）、磅（Pt）等精确单位，RGB 颜色定义，以及对齐方式、缩进层级、字体样式的细粒度控制。

开源零成本：基于 MIT 许可证的 python-pptx 库，无商业授权费用，适合个人开发者和企业团队。

潜在缺点与局限性

动画支持有限：python-pptx 仅支持基础动画，复杂动画效果（如路径动画、触发器）需手动在 PowerPoint 中添加。

Office 兼容性：生成文件需 Microsoft Office 2010+ 或兼容软件（如 LibreOffice）打开，部分高级功能在旧版本或移动端查看时可能显示异常。

图表定制深度不足：复杂图表样式（自定义数据标签位置、组合图表类型）需借助其他工具后期调整。

模板依赖性：美观程度高度依赖输入模板质量，从零设计专业视觉风格需要较强的设计能力。

适合的目标群体

• 数据分析师/商业分析师：需将 Python 分析结果（pandas 数据）自动转换为可视化 PPT 报告
• 自动化工程师：构建文档生成流水线，批量产出标准化演示材料
• 教育工作者/培训师：程序化生成课件、习题集、成绩单等结构化内容
• 开发者技术写作者：制作 API 文档演示、架构图说明等技术分享材料
• 行政办公人员：通过简单修改示例代码，快速生成会议议程、项目汇报等常规文档

使用风险

文件系统操作风险：示例代码涉及本地文件读写（图片加载、PPT 保存），需确保：1) 读取的图片/模板来源可信，防止路径遍历攻击；2) 输出目录有适当写入权限，避免覆盖重要文件。建议在隔离环境或专用工作目录运行。

依赖项管理：需安装 python-pptx（~1MB）和 Pillow（图像处理），numpy 为图表可选依赖。建议使用虚拟环境，避免与系统 Python 包冲突。

性能考量：处理高分辨率图片（>10MB）或大量幻灯片（>100 页）时，内存占用显著增加，可能出现生成延迟。建议预先压缩图片、分页生成后合并。

无网络风险：该 Skill 纯离线运行，无外部 API 调用，无数据外泄风险。