分析参考 PPTX 的结构、主题、版式与 OOXML…

当你需要在不修改源 PPTX 的前提下，提取其版式、主题、字体、诊断信息、模板目录和 OOXML 包证据，作为新演示文稿设计依据时使用。

适用场景

解决思路

1. 用一个小型、任务局部的 `python-pptx` 脚本按需实现所需提取；只捕获新 deck 所需的信息。
2. 提取紧凑提示上下文：幻灯片数量和尺寸、文本摘要、形状数量、样式、品牌信号、模板使用情况、版式节奏。
3. 执行完整提取：`summary`、slides，以及只读的 `layout_tree` 证据。
4. 执行文件夹诊断：每个 deck 输出一个结果，并生成 manifest。
5. 执行样式母版分析：颜色、字体、字号分布、母版/版式使用情况、流模式。
6. 生成派生模板目录：从零开始的源索引、版式角色、可用区域、占位符、视觉结构、约束。
7. 保持源 deck 只读，并独立编写每个目标幻灯片坐标。
8. 仅对高层提取无法暴露的原始主题、关系、备注、批注、动画、媒体、母版或版式，使用随附的 OOXML 工具。
9. 在分析 manifest 中记录检查过的部件和解析异常。
10. 未经明确许可和许可证据，不要将提取的内容、字体、图片或专有素材用于生成的 deck。
11. 使用随附工具前，从 `requirements.txt` 安装 `defusedxml`。
12. 运行 `scripts/inspect.py <deck.pptx>`，获取幻灯片顺序、文本、主题 token、关系、备注、批注、动画和媒体的紧凑 JSON 报告。
13. 运行 `scripts/validate_package.py <deck.pptx> --output <report.json>`，检查畸形 XML、内部关系断裂、内容类型缺口、重复版式链接和孤立部件。
14. 仅在需要原始包证据时运行 `scripts/unpack.py <deck.pptx> <output-dir>`。
15. 相对于 `.rels` 所有者解析关系目标；不要根据文件名推断幻灯片顺序。
16. 绝不修改提供的 deck，也不要把包部件盲目复制到新 deck。
17. 从可信工作区运行脚本；它们会拒绝路径穿越、符号链接、超大成员和归档炸弹。
18. 使用 `defusedxml` 解析不受信任的 XML；不要启用实体扩展、DTD 加载或网络访问。
19. 除非已根据配色方案完全解析，否则将主题颜色视为 token。
20. 查阅 `references/reference-deck-analysis.md` 了解输出形状，查阅 `references/reference-deck-analysis-patterns.md` 了解仅文档模式，查阅 `references/ooxml-parsing.md` 了解包部件映射。

适用边界 · 注意事项

• 需要直接修改、克隆或复制源 deck 时，不应使用本技能，因为它只做只读分析。
• 没有明确许可与许可证据却要复用提取的内容、字体、图片或专有素材时，不应继续生成 deck。
• 仅高层提取已足够、不需要原始 OOXML 包证据时，不要运行 `unpack.py` 或强行做原始包检查。