pptx-reference-deck-analysis

PPTX 参考演示文稿分析

将参考演示文稿作为设计依据进行检查。此技能绝不会复制、克隆或修改源演示文稿。

约定

按需使用一个小型任务级 python-pptx 脚本实现所需的提取。仅捕获新演示文稿所需的信息：

• 紧凑提示词上下文：幻灯片数量和尺寸、文本摘要、形状数量、样式、品牌信号、模板使用情况以及版式节奏；
• 完整提取：summary、幻灯片以及只读的 layout_tree 证据；
• 文件夹诊断：每份演示文稿一个结果，外加一个清单；
• 样式母版分析：颜色、字体、尺寸分布、母版/版式使用情况以及流模式；
• 派生模板目录：从零开始的源索引、版式角色、可用区域、占位符、视觉结构以及约束。

规则

• 保持源演示文稿只读，并独立编写每个目标幻灯片坐标。
• 仅将随附的 OOXML 实用工具用于高层提取无法暴露的原始主题、关系、备注、批注、动画、媒体、母版或版式。
• 在分析清单中记录已检查的部分和解析异常。
• 未经明确许可和许可证证据，不得在生成的演示文稿中使用提取的内容、字体、图像或专有资产。

OOXML 包检查

在使用随附的实用工具之前，请先从 requirements.txt 安装 defusedxml。

1. 运行 scripts/inspect.py <deck.pptx>，获取幻灯片顺序、文本、主题令牌、关系、备注、批注、动画和媒体的紧凑 JSON 报告。
2. 运行 scripts/validate_package.py <deck.pptx> --output <report.json>，检查格式错误的 XML、损坏的内部关系、内容类型缺口、重复的版式链接和孤立部分。
3. 仅在需要原始包证据时运行 scripts/unpack.py <deck.pptx> <output-dir>。
4. 相对于 .rels 所有者解析关系目标；切勿从文件名推断幻灯片顺序。

安全

• 切勿修改提供的演示文稿，也不要将包部分盲目复制到新演示文稿中。
• 从可信工作区运行脚本；它们会拒绝路径遍历、符号链接、超大成员和归档炸弹。
• 使用 defusedxml 解析不受信任的 XML；不要启用实体扩展、DTD 加载或网络访问。
• 除非已完全根据配色方案解析，否则将主题颜色视为令牌。

有关输出形态，请参阅 references/reference-deck-analysis.md；有关仅文档模式，请参阅 references/reference-deck-analysis-patterns.md；有关包部分映射，请参阅 references/ooxml-parsing.md。