SuperAPI AI 工具集

pptx

办公与效率

查看项目

更新于 10-24 16:20

技能介绍

用途

PPTTX 面向需要由 AI 助手处理 PowerPoint 演示文稿(.pptx 文件)的场景,覆盖三类任务:创建新演示文稿、修改已有演示文稿、分析演示文稿内容。资料指出 .pptx 本质是一个 ZIP 归档,内部包含 XML 文件和其他资源,因此可以读取和编辑。

主要能力

读取与分析内容

  • 文本提取:可将文档转换为 markdown,命令为 python -m markitdown path-to-file.pptx。
  • 原始 XML 访问:用于处理批注、演讲者备注、幻灯片版式、动画、设计元素和复杂格式,需要解包演示文稿后读取原始 XML。
  • 解包命令:python ooxml/scripts/unpack.py <office_file> <output_dir>。资料说明 unpack.py 位于项目根目录相对路径 skills/pptx/ooxml/scripts/unpack.py,若不存在可用 find . -name "unpack.py" 查找。
  • 关键文件结构:ppt/presentation.xml(主元数据与幻灯片引用)、ppt/slides/slide{N}.xml(单页内容)、ppt/notesSlides/notesSlide{N}.xml(演讲者备注)、ppt/comments/modernComment_*.xml(批注)、ppt/slideLayouts/(版式模板)、ppt/slideMasters/(母版)、ppt/theme/(主题样式)、ppt/media/(图片与媒体)。
  • 字体与颜色提取:读取 ppt/theme/theme1.xml 中的颜色方案(<a:clrScheme>)与字体方案(<a:fontScheme>);检查 ppt/slides/slide1.xml 中实际字体使用(<a:rPr>)与颜色;用 grep 搜索 <a:solidFill>、<a:srgbClr> 等模式。

从零创建演示文稿

采用 html2pptx 工作流:为每页创建 HTML 文件(16:9 建议 720pt × 405pt),文本内容使用 <p>、<h1>-<h6>、<ul>、<ol>;图表/表格区域使用 class="placeholder" 并以灰色背景呈现;渐变与图标需先用 Sharp 栅格化为 PNG 再在 HTML 中引用;随后用 html2pptx.js 库转换并保存。资料强调创建前须完整阅读 html2pptx.md,且不得设置读取范围限制。

设计准则包括:先分析内容与品牌再确定配色(3-5 种颜色、保证对比度)、仅使用网络安全字体(Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact)、建立清晰的视觉层级并保持跨页一致。资料还给出多组示例配色(如 Classic Blue、Teal & Coral、Bold Red 等)以及几何图形、边框、字体排版、图表与布局、背景处理等视觉细节选项。布局上优先采用两栏布局(如 40%/60%)或整页布局放置图表/表格,禁止将图表/表格纵向堆叠在文本下方。

视觉校验:使用 python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 生成缩略图网格,检查文本截断、文本重叠、位置越界、对比度不足等问题,调整后重新生成直到正确。

基于模板创建

流程为:先用 markitdown 提取模板文本并生成缩略图网格;分析模板并保存 template-inventory.md(幻灯片从 0 开始索引,每页单独列出);根据模板清单编写大纲 outline.md 并给出 template_mapping;用 python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52 复制、重排、删除页面;再用 python scripts/inventory.py working.pptx text-inventory.json 提取全部文本形状与属性(位置、段落、字体、颜色、项目符号等)。资料要求选择版式时匹配实际内容数量,不得用多于内容数量的占位符。

编辑已有演示文稿

基于 Office Open XML 格式:解包、编辑 XML(主要是 ppt/slides/slide{N}.xml 及相关文件)、每次编辑后立即校验(python ooxml/scripts/validate.py <dir> --original <file>)、最后打包(python ooxml/scripts/pack.py <input_directory> <office_file>)。资料要求编辑前完整阅读 ooxml.md(约 500 行)。

使用方式

工具以技能包形式提供,包含 Python 脚本(unpack.py、pack.py、validate.py、thumbnail.py、rearrange.py、inventory.py)、JavaScript 库 html2pptx.js 以及说明文档(html2pptx.md、ooxml.md)。通过命令行运行脚本,配合 AI 助手的代码执行能力完成演示文稿的创建、编辑与分析。

适用场景

适合需要批量或自动化生成演示文稿、按照既有模板产出风格统一的幻灯片、对已有 .pptx 进行文本提取与结构分析、以及通过 XML 精细修改备注/批注/版式等内容的场景。

限制

资料未提供该工具的价格、收费模式、平台兼容性、性能指标或效果保证;也未说明对非 .pptx 格式(如 .ppt)的支持。脚本路径与命令需按资料原样使用,缺失事实暂未提供。