PPTX 创建、编辑和分析

概述

用户可能会要求您创建、编辑或分析 .pptx 文件的内容。.pptx 文件本质上是一个包含 XML 文件和其他资源的 ZIP 压缩包，您可以读取或编辑。不同的任务有不同的工具和工作流程可用。

读取和分析内容

文本提取

如果您只需要读取演示文稿的文本内容，应将文档转换为 markdown：

# 将文档转换为 markdown
python -m markitdown path-to-file.pptx

原始 XML 访问

您需要原始 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 - 单个幻灯片内容（slide1.xml、slide2.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 在所有 XML 文件中查找颜色（<a:solidFill>、<a:srgbClr>）和字体引用

创建新 PowerPoint 演示文稿不使用模板

从头开始创建新 PowerPoint 演示文稿时，使用 html2pptx 工作流程将 HTML 幻灯片转换为具有精确定位的 PowerPoint。

设计原则

关键：在创建任何演示文稿之前，分析内容并选择适当的设计元素：

考虑主题：这个演示文稿是关于什么的？它暗示什么语气、行业或情绪？
检查品牌：如果用户提到公司/组织，考虑其品牌颜色和形象
将调色板与内容匹配：选择反映主题的颜色
说明您的方法：在编写代码之前解释您的设计选择

要求：

✅ 在编写代码之前说明您基于内容的设计方法
✅ 仅使用网页安全字体：Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact
✅ 通过大小、粗细和颜色创建清晰的视觉层次
✅ 确保可读性：强烈对比、适当大小的文本、整洁的对齐
✅ 保持一致性：在幻灯片之间重复模式、间距和视觉语言

调色板选择

创造性地选择颜色：

跳出默认思维：什么颜色真正匹配这个特定主题？避免自动选择。
考虑多个角度：主题、行业、情绪、能量水平、目标受众、品牌形象（如有提及）
大胆尝试：尝试意想不到的组合 - 医疗保健演示文稿不必是绿色的，金融不必是海军蓝
构建调色板：选择 3-5 种配合良好的颜色（主色 + 辅助色 + 强调色）
确保对比：文本必须在背景上清晰可读

示例调色板（用于激发创意 - 选择一个、调整它或创建自己的）：

经典蓝：深海军蓝（#1C2833）、石板灰（#2E4053）、银色（#AAB7B8）、米白（#F4F6F6）
青绿与珊瑚：青绿（#5EA8A7）、深青绿（#277884）、珊瑚（#FE4447）、白色（#FFFFFF）
大胆红色：红色（#C0392B）、亮红（#E74C3C）、橙色（#F39C12）、黄色（#F1C40F）、绿色（#2ECC71）
暖腮红：灰褐色（#A49393）、腮红（#EED6D3）、玫瑰（#E8B4B8）、奶油（#FAF7F2）
酒红奢华：酒红（#5D1D2E）、深红（#951233）、铁锈（#C15937）、金色（#997929）
深紫与翡翠：紫色（#B165FB）、深蓝（#181B24）、翡翠（#40695B）、白色（#FFFFFF）
奶油与森林绿：奶油（#FFE1C7）、森林绿（#40695B）、白色（#FCFCFC）
粉色与紫色：粉色（#F8275B）、珊瑚（#FF574A）、玫瑰（#FF737D）、紫色（#3D2F68）
青柠与梅色：青柠（#C5DE82）、梅色（#7C3A5F）、珊瑚（#FD8C6E）、蓝灰（#98ACB5）
黑与金：金色（#BF9A4A）、黑色（#000000）、奶油（#F4F6F6）
鼠尾草与赤陶：鼠尾草（#87A96B）、赤陶（#E07A5F）、奶油（#F4F1DE）、炭灰（#2C2C2C）
炭灰与红：炭灰（#292929）、红色（#E33737）、浅灰（#CCCBCB）
活力橙：橙色（#F96D00）、浅灰（#F2F2F2）、炭灰（#222831）
森林绿：黑色（#191A19）、绿色（#4E9F3D）、深绿（#1E5128）、白色（#FFFFFF）
复古彩虹：紫色（#722880）、粉色（#D72D51）、橙色（#EB5C18）、琥珀（#F08800）、金色（#DEB600）
复古大地：芥末（#E3B448）、鼠尾草（#CBD18F）、森林绿（#3A6B35）、奶油（#F4F1DE）
海岸玫瑰：老玫瑰（#AD7670）、海狸（#B49886）、蛋壳（#F3ECDC）、灰绿（#BFD5BE）
橙与青绿：浅橙（#FC993E）、灰青绿（#667C6F）、白色（#FCFCFC）

视觉细节选项

几何图案：

对角线分隔代替水平分隔
不对称列宽（30/70、40/60、25/75）
90° 或 270° 旋转的文本标题
图片的圆形/六边形框架
角落的三角形装饰形状
重叠形状增加深度

边框和框架处理：

仅一侧的粗单色边框（10-20pt）
对比色的双线边框
角括号代替完整框架
L 形边框（上+左或下+右）
标题下方的下划线强调（3-5pt 粗）

排版处理：

极端大小对比（72pt 标题 vs 11pt 正文）
大写标题配宽字母间距
超大显示字体的编号章节
等宽字体（Courier New）用于数据/统计/技术内容
窄体字体（Arial Narrow）用于密集信息
轮廓文本强调

图表和数据样式：

单色图表配单一强调色用于关键数据
水平条形图代替垂直条形图
点图代替条形图
最少或无网格线
数据标签直接在元素上（无图例）
关键指标的超大数字

布局创新：

带文本叠加的满版图片
侧边栏列（20-30% 宽度）用于导航/上下文
模块化网格系统（3×3、4×4 块）
Z 形或 F 形内容流
浮动文本框覆盖在彩色形状上
杂志风格多栏布局

背景处理：

占幻灯片 40-60% 的纯色块
渐变填充（仅垂直或对角线）
分割背景（两种颜色，对角线或垂直）
边到边的色带
负空间作为设计元素

布局提示

创建带图表或表格的幻灯片时：

两栏布局（推荐）：使用跨越全宽的标题，然后下方两栏 - 一栏放文本/要点，另一栏放主要内容。这提供更好的平衡，使图表/表格更易读。使用不等列宽的 flexbox（例如 40%/60% 分割）来优化每种内容类型的空间。
全幻灯片布局：让主要内容（图表/表格）占据整个幻灯片以获得最大影响力和可读性
切勿垂直堆叠：不要将图表/表格放在单列中的文本下方 - 这会导致可读性差和布局问题

工作流程

必须 - 完整阅读整个文件：完整阅读 html2pptx.md，从头到尾。阅读此文件时切勿设置任何范围限制。 在开始创建演示文稿之前，阅读完整文件内容以了解详细语法、关键格式规则和最佳实践。
为每个幻灯片创建具有正确尺寸的 HTML 文件（例如 16:9 为 720pt × 405pt）
- 使用 <p>、<h1>-<h6>、<ul>、<ol> 处理所有文本内容
- 对将添加图表/表格的区域使用 class="placeholder"（渲染灰色背景以便可见）
- 关键：首先使用 Sharp 将渐变和图标光栅化为 PNG 图片，然后在 HTML 中引用
- 布局：对于带图表/表格/图片的幻灯片，使用全幻灯片布局或两栏布局以获得更好的可读性
创建并运行使用 html2pptx.js 库的 JavaScript 文件，将 HTML 幻灯片转换为 PowerPoint 并保存演示文稿
- 使用 html2pptx() 函数处理每个 HTML 文件
- 使用 PptxGenJS API 将图表和表格添加到占位符区域
- 使用 pptx.writeFile() 保存演示文稿
视觉验证：生成缩略图并检查布局问题
- 创建缩略图网格：python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4
- 阅读并仔细检查缩略图图片：
  - 文本截断：文本被标题栏、形状或幻灯片边缘截断
  - 文本重叠：文本与其他文本或形状重叠
  - 定位问题：内容太靠近幻灯片边界或其他元素
  - 对比问题：文本和背景之间对比不足
- 如果发现问题，调整 HTML 边距/间距/颜色并重新生成演示文稿
- 重复直到所有幻灯片视觉正确

编辑现有 PowerPoint 演示文稿

编辑现有 PowerPoint 演示文稿中的幻灯片时，您需要使用原始 Office Open XML（OOXML）格式。这涉及解压 .pptx 文件、编辑 XML 内容，然后重新打包。

工作流程

必须 - 完整阅读整个文件：完整阅读 ooxml.md（约 500 行），从头到尾。阅读此文件时切勿设置任何范围限制。 在编辑任何演示文稿之前，阅读完整文件内容以获取有关 OOXML 结构和编辑工作流程的详细指导。
解压演示文稿：python ooxml/scripts/unpack.py <office_file> <output_dir>
编辑 XML 文件（主要是 ppt/slides/slide{N}.xml 和相关文件）
关键：每次编辑后立即验证，并在继续之前修复任何验证错误：python ooxml/scripts/validate.py <dir> --original <file>
打包最终演示文稿：python ooxml/scripts/pack.py <input_directory> <office_file>

使用模板创建新 PowerPoint 演示文稿

当您需要创建遵循现有模板设计的演示文稿时，您需要复制和重新排列模板幻灯片，然后替换占位符内容。

工作流程

提取模板文本并创建可视化缩略图网格：
- 提取文本：python -m markitdown template.pptx > template-content.md
- 阅读 template-content.md：阅读整个文件以了解模板演示文稿的内容。阅读此文件时切勿设置任何范围限制。
- 创建缩略图网格：python scripts/thumbnail.py template.pptx
- 有关更多详细信息，请参阅创建缩略图网格部分
分析模板并将清单保存到文件：
- 视觉分析：查看缩略图网格以了解幻灯片版式、设计模式和视觉结构
- 创建并保存模板清单文件到 template-inventory.md，包含：
```
# 模板清单分析
**总幻灯片数：[count]**
**重要：幻灯片从 0 开始索引（第一张幻灯片 = 0，最后一张幻灯片 = count-1）**

## [类别名称]
- 幻灯片 0：[版式代码（如有）] - 描述/用途
- 幻灯片 1：[版式代码] - 描述/用途
- 幻灯片 2：[版式代码] - 描述/用途
[... 每个幻灯片都必须单独列出其索引 ...]
```
- 使用缩略图网格：参考可视化缩略图来识别：
  - 版式模式（标题幻灯片、内容版式、章节分隔）
  - 图片占位符位置和数量
  - 幻灯片组之间的设计一致性
  - 视觉层次和结构
- 此清单文件是下一步选择适当模板所必需的
根据模板清单创建演示文稿大纲：
- 查看步骤 2 中的可用模板。
- 为第一张幻灯片选择介绍或标题模板。这应该是最前面的模板之一。
- 为其他幻灯片选择安全的、基于文本的版式。
- 关键：将版式结构与实际内容匹配：
  - 单列版式：用于统一叙述或单一主题
  - 两列版式：仅当您有正好 2 个不同的项目/概念时使用
  - 三列版式：仅当您有正好 3 个不同的项目/概念时使用
  - 图片+文本版式：仅当您有实际图片要插入时使用
  - 引用版式：仅用于实际的人物引用（带归属），切勿用于强调
  - 切勿使用占位符比内容多的版式
  - 如果您有 2 个项目，不要强行放入 3 列版式
  - 如果您有 4+ 个项目，考虑分成多张幻灯片或使用列表格式
- 在选择版式之前计算您的实际内容数量
- 验证所选版式中的每个占位符都将填充有意义的内容
- 为每个内容部分选择一个代表最佳版式的选项。
- 保存 outline.md，包含内容和利用可用设计的模板映射
- 示例模板映射：
```
# 要使用的模板幻灯片（0 基索引）
# 警告：验证索引在范围内！有 73 张幻灯片的模板索引为 0-72
# 映射：大纲中的幻灯片编号 -> 模板幻灯片索引
template_mapping = [
    0,   # 使用幻灯片 0（标题/封面）
    34,  # 使用幻灯片 34（B1：标题和正文）
    34,  # 再次使用幻灯片 34（复制用于第二个 B1）
    50,  # 使用幻灯片 50（E1：引用）
    54,  # 使用幻灯片 54（F2：结束语+文本）
]
```
使用 rearrange.py 复制、重新排序和删除幻灯片：
- 使用 scripts/rearrange.py 脚本创建具有所需顺序幻灯片的新演示文稿：
```
python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52
```
- 该脚本自动处理重复幻灯片的复制、删除未使用的幻灯片和重新排序
- 幻灯片索引从 0 开始（第一张幻灯片是 0，第二张是 1，等等）
- 同一幻灯片索引可以出现多次以复制该幻灯片

使用 inventory.py 脚本提取所有文本：

运行清单提取：

python scripts/inventory.py working.pptx text-inventory.json

阅读 text-inventory.json：阅读整个 text-inventory.json 文件以了解所有形状及其属性。阅读此文件时切勿设置任何范围限制。

清单 JSON 结构：

  {
    "slide-0": {
      "shape-0": {
        "placeholder_type": "TITLE",  // 或非占位符为 null
        "left": 1.5,                  // 位置（英寸）
        "top": 2.0,
        "width": 7.5,
        "height": 1.2,
        "paragraphs": [
          {
            "text": "段落文本",
            // 可选属性（仅在非默认时包含）：
            "bullet": true,           // 检测到显式项目符号
            "level": 0,               // 仅在 bullet 为 true 时包含
            "alignment": "CENTER",    // CENTER、RIGHT（非 LEFT）
            "space_before": 10.0,     // 段前间距（磅）
            "space_after": 6.0,       // 段后间距（磅）
            "line_spacing": 22.4,     // 行间距（磅）
            "font_name": "Arial",     // 来自第一个运行
            "font_size": 14.0,        // 磅
            "bold": true,
            "italic": false,
            "underline": false,
            "color": "FF0000"         // RGB 颜色
          }
        ]
      }
    }
  }

关键特性：
- 幻灯片：命名为"slide-0"、"slide-1"等。
- 形状：按视觉位置（从上到下、从左到右）排序为"shape-0"、"shape-1"等。
- 占位符类型：TITLE、CENTER_TITLE、SUBTITLE、BODY、OBJECT 或 null
- 默认字体大小：从版式占位符提取的 default_font_size（磅，如可用）
- 幻灯片编号被过滤：具有 SLIDE_NUMBER 占位符类型的形状自动从清单中排除
- 项目符号：当 bullet: true 时，level 始终包含（即使是 0）
- 间距：space_before、space_after 和 line_spacing（磅，仅在设置时包含）
- 颜色：RGB 的 color（例如"FF0000"），主题颜色的 theme_color（例如"DARK_1"）
- 属性：输出中仅包含非默认值

生成替换文本并将数据保存到 JSON 文件 根据上一步的文本清单：
- 关键：首先验证清单中存在哪些形状 - 只引用实际存在的形状
- 验证：replace.py 脚本将验证替换 JSON 中的所有形状都存在于清单中
  - 如果引用不存在的形状，您将收到显示可用形状的错误
  - 如果引用不存在的幻灯片，您将收到指示该幻灯片不存在的错误
  - 所有验证错误在脚本退出前一次性显示
- 重要：replace.py 脚本内部使用 inventory.py 来识别所有文本形状
- 自动清除：清单中的所有文本形状都将被清除，除非您为它们提供"paragraphs"
- 为需要内容的形状添加"paragraphs"字段（不是"replacement_paragraphs"）
- 替换 JSON 中没有"paragraphs"的形状将自动清除其文本
- 带项目符号的段落将自动左对齐。当 "bullet": true 时不要设置 alignment 属性
- 为占位符文本生成适当的替换内容
- 使用形状大小来确定适当的内容长度
- 关键：包含原始清单中的段落属性 - 不要只提供文本
- 重要：当 bullet: true 时，不要在文本中包含项目符号符号（•、-、*）- 它们会自动添加
- 基本格式规则：
  - 标题通常应有 "bold": true
  - 列表项应有 "bullet": true, "level": 0（bullet 为 true 时需要 level）
  - 保留任何对齐属性（例如居中文本的 "alignment": "CENTER"）
  - 与默认不同时包含字体属性（例如 "font_size": 14.0、"font_name": "Lora"）
  - 颜色：RGB 使用 "color": "FF0000"，主题颜色使用 "theme_color": "DARK_1"
  - 替换脚本期望正确格式的段落，而不仅仅是文本字符串
  - 重叠形状：优先选择 default_font_size 更大或 placeholder_type 更合适的形状
- 将带有替换的更新清单保存到 replacement-text.json
- 警告：不同的模板版式有不同的形状数量 - 在创建替换之前始终检查实际清单
显示正确格式的示例 paragraphs 字段：
```
"paragraphs": [
  {
    "text": "新演示文稿标题文本",
    "alignment": "CENTER",
    "bold": true
  },
  {
    "text": "章节标题",
    "bold": true
  },
  {
    "text": "第一个要点，不带项目符号符号",
    "bullet": true,
    "level": 0
  },
  {
    "text": "红色文本",
    "color": "FF0000"
  },
  {
    "text": "主题颜色文本",
    "theme_color": "DARK_1"
  },
  {
    "text": "没有特殊格式的普通段落文本"
  }
]
```
替换 JSON 中未列出的形状将自动清除：
```
{
  "slide-0": {
    "shape-0": {
      "paragraphs": [...] // 此形状获得新文本
    }
    // 清单中的 shape-1 和 shape-2 将自动清除
  }
}
```
演示文稿的常见格式模式：
- 标题幻灯片：粗体文本，有时居中
- 幻灯片内的章节标题：粗体文本
- 项目符号列表：每个项目需要 "bullet": true, "level": 0
- 正文文本：通常不需要特殊属性
- 引用：可能有特殊的对齐或字体属性
使用 replace.py 脚本应用替换
```
python scripts/replace.py working.pptx replacement-text.json output.pptx
```
该脚本将：
- 首先使用 inventory.py 的函数提取所有文本形状的清单
- 验证替换 JSON 中的所有形状都存在于清单中
- 清除清单中识别的所有形状的文本
- 仅对替换 JSON 中定义了"paragraphs"的形状应用新文本
- 通过应用 JSON 中的段落属性来保留格式
- 自动处理项目符号、对齐、字体属性和颜色
- 保存更新后的演示文稿
示例验证错误：
```
错误：替换 JSON 中的无效形状：
  - 'slide-0' 上未找到形状 'shape-99'。可用形状：shape-0、shape-1、shape-4
  - 清单中未找到幻灯片 'slide-999'
```
```
错误：替换文本使以下形状的溢出更严重：
  - slide-0/shape-2：溢出加剧 1.25"（原为 0.00"，现为 1.25"）
```

创建缩略图网格

要创建 PowerPoint 幻灯片的可视化缩略图网格以便快速分析和参考：

python scripts/thumbnail.py template.pptx [output_prefix]

功能：

创建：thumbnails.jpg（或大型演示文稿为 thumbnails-1.jpg、thumbnails-2.jpg 等）
默认：5 列，每个网格最多 30 张幻灯片（5×6）
自定义前缀：python scripts/thumbnail.py template.pptx my-grid
- 注意：如果您想要输出到特定目录，输出前缀应包含路径（例如 workspace/my-grid）
调整列数：--cols 4（范围：3-6，影响每个网格的幻灯片数）
网格限制：3 列 = 12 张幻灯片/网格，4 列 = 20，5 列 = 30，6 列 = 42
幻灯片从零开始索引（幻灯片 0、幻灯片 1 等）

用例：

模板分析：快速了解幻灯片版式和设计模式
内容审查：整个演示文稿的视觉概览
导航参考：通过外观找到特定幻灯片
质量检查：验证所有幻灯片格式正确

示例：

# 基本用法
python scripts/thumbnail.py presentation.pptx

# 组合选项：自定义名称、列数
python scripts/thumbnail.py template.pptx analysis --cols 4

将幻灯片转换为图片

要可视化分析 PowerPoint 幻灯片，使用两步过程将其转换为图片：

将 PPTX 转换为 PDF：

soffice --headless --convert-to pdf template.pptx

将 PDF 页面转换为 JPEG 图片：
```
pdftoppm -jpeg -r 150 template.pdf slide
```
这会创建 slide-1.jpg、slide-2.jpg 等文件。

选项：

-r 150：设置分辨率为 150 DPI（调整以平衡质量/大小）
-jpeg：输出 JPEG 格式（如需要可使用 -png 输出 PNG）
-f N：要转换的第一页（例如 -f 2 从第 2 页开始）
-l N：要转换的最后一页（例如 -l 5 在第 5 页停止）
slide：输出文件的前缀

特定范围示例：

pdftoppm -jpeg -r 150 -f 2 -l 5 template.pdf slide  # 仅转换第 2-5 页

代码风格指南

重要：生成 PPTX 操作代码时：

编写简洁的代码
避免冗长的变量名和冗余操作
避免不必要的 print 语句

依赖项

必需的依赖项（应该已经安装）：

markitdown：pip install "markitdown[pptx]"（用于从演示文稿提取文本）
pptxgenjs：npm install -g pptxgenjs（用于通过 html2pptx 创建演示文稿）
playwright：npm install -g playwright（用于 html2pptx 中的 HTML 渲染）
react-icons：npm install -g react-icons react react-dom（用于图标）
sharp：npm install -g sharp（用于 SVG 光栅化和图片处理）
LibreOffice：sudo apt-get install libreoffice（用于 PDF 转换）
Poppler：sudo apt-get install poppler-utils（用于 pdftoppm 将 PDF 转换为图片）
defusedxml：pip install defusedxml（用于安全的 XML 解析）

pptx

Safety Notice

Copy this and send it to your AI assistant to learn

PPTX 创建、编辑和分析

概述

读取和分析内容

文本提取

原始 XML 访问

解压文件

关键文件结构

排版和颜色提取

创建新 PowerPoint 演示文稿不使用模板

设计原则

调色板选择

视觉细节选项

布局提示

工作流程

编辑现有 PowerPoint 演示文稿

工作流程

使用模板创建新 PowerPoint 演示文稿

工作流程

创建缩略图网格

将幻灯片转换为图片

代码风格指南

依赖项

Source Transparency

Related Skills

frontend-design

xlsx

canvas-design

docx

pptx

Safety Notice

Copy this and send it to your AI assistant to learn

PPTX 创建、编辑和分析

概述

读取和分析内容

文本提取

原始 XML 访问

解压文件

关键文件结构

排版和颜色提取

创建新 PowerPoint 演示文稿 不使用模板

设计原则

调色板选择

视觉细节选项

布局提示

工作流程

编辑现有 PowerPoint 演示文稿

工作流程

使用模板创建新 PowerPoint 演示文稿

工作流程

创建缩略图网格

将幻灯片转换为图片

代码风格指南

依赖项

Source Transparency

Related Skills

frontend-design

xlsx

canvas-design

docx

创建新 PowerPoint 演示文稿不使用模板