pptx

技能简介

本技能用于处理 .pptx / .potx 文件，涵盖创建、读取、编辑、合并拆分等操作。它帮助 Agent 安全地操作 PowerPoint 文件，避免因格式细节导致文件损坏。

使用场景

• 创建幻灯片、推介文稿或演示文稿
• 从 .pptx / .potx 中读取、解析或提取文本（即使后续用于邮件或摘要）
• 编辑、修改或更新现有演示文稿
• 合并或拆分幻灯片文件
• 使用模板（.potx）、版式、演讲者备注或批注

使用方法

将技能目录安装到 Agent 的 skills 路径（或使用平台的 skills add 命令）。pptxgenjs 已预装，无需先执行 npm install。

根据任务选择方式：

• 创建新文稿：编写 pptxgenjs 脚本。
• 编辑已有文稿或基于模板：unzip → 编辑 ppt/slides/slideN.xml → zip。
• 读取内容：markitdown deck.pptx；可视化网格：python scripts/thumbnail.py deck.pptx。

常用脚本：

• python scripts/thumbnail.py deck.pptx [prefix]：生成幻灯片缩略图网格。
• python scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml]：复制幻灯片。
• python scripts/clean.py unpacked/：清理未引用资源。
• python scripts/office/validate.py deck.pptx [--original src.pptx]：校验文件。
• python scripts/office/soffice.py --headless --convert-to pdf deck.pptx：转 PDF。

注意事项

• 创建时先设置 pres.layout；颜色格式为 "FF0000"，不能带 # 或 8 位透明度。
• 不要共享同一个 shadow/options 对象；阴影 offset 必须 ≥ 0；用 charSpacing 而非 letterSpacing。
• 列表用 bullet: true，不要用字面 •；每个输出文件单独用 new pptxgen()。
• 图表用 addChart() 保持原生，堆叠图 dataLabelPosition 不能用 outEnd；组合图需同时声明 valAxes 和 catAxes。
• 生成后运行 python scripts/office/validate.py deck.pptx 验证。