适用场景

当主要交付物为 Microsoft PowerPoint 演示文稿或 .pptx 幻灯片文件时使用，尤其适用于对版式、模板、占位符、备注、批注、图表、内容提取、编辑操作或最终视觉质量有较高要求的场景。

核心规范

1. 动手编辑前，先确定工作流

• 纯文本读取、现有幻灯片编辑、基于模板重建、从零创建，属于不同任务，失败模式各异。
• 如需进行文本提取或内容检查，请先读取幻灯片，再进行编辑。
• 文本提取 + 缩略图级视觉检查，比仅依赖形状假设进行编辑更安全。
• 若采用模板驱动方式，请先完成幻灯片资产清点，再替换内容。
• 深度编辑时须知：.pptx 文件本质为 OOXML 格式，其幻灯片、版式、母版、媒体、备注和批注均以独立部件存储。
• 若存在模板，应优先保障模板保真度，而非依赖通用幻灯片设计直觉。
• 复用或复制一张已验证良好的幻灯片，通常比重新构建并寄希望于主题仍能匹配更稳妥。

2. 替换内容前，先完成幻灯片资产清点

• 首先统计可复用的版式、真实占位符、备注、批注、媒体资源，以及重复出现的字体或配色规律。
• 占位符索引与版式索引不具备跨模板可移植性，不可作为默认假设。
• 在定位标题、正文、图表或图片形状前，务必实际检查目标幻灯片或模板本身。
• 演讲者备注、批注及关联资源可能存在于可见幻灯片区域之外。
• 缺失或错误的占位符目标可能导致内容被静默地置入错误容器或图层。
• 母版与版式设置可能覆盖幻灯片本地编辑，因此所见问题未必出现在当前正在编辑的幻灯片上。

3. 内容必须严格匹配实际占位符

• 选择版式前，先统计实际内容单元数量。
• 版式选择应基于幻灯片真实所需的观念数、列数、图片数或图表数。
• 勿强行将两个观点塞入三栏版式，亦勿将密集文本硬压在图表下方。
• 分类项数量与数据序列长度必须一致，否则图表将以明显异常方式崩溃。
• 显式尺寸设定优于主观预期：“文本框、图片、图表需要真实可用空间”，而非“应该能放下”。
• 勿选用占位符数量超过内容可有意义填充量的版式。
• 引用型版式仅用于真实引用内容；图片主导型版式仅用于确实含图片的幻灯片。
• 对于以图表、表格或图片为主的幻灯片，全幅或双栏版式通常比在视觉元素上方堆叠密集文本更稳妥。

4. 保持幻灯片固有视觉语言

• 主题、母版与版式文件通常比单张幻灯片更能决定字体、配色与信息层级。
• 应始于幻灯片自身的主题、字体、间距与宽高比，而非即兴设计新风格。
• 应复用幻灯片既有的对齐与间距体系，避免另行构建第二套视觉语言。
• 为保障兼容性与可读性，宜选用通用字体，并确保足够强的对比度。
• 首要目标是保留模板的视觉逻辑；原创性远不如避免破坏既有视觉语言重要。
• 合并多个来源的幻灯片后，须统一归一化主题、母版与对齐方式。

5. 分离执行内容质量检查（Content QA）与视觉质量检查（Visual QA）

• 文本溢出、对齐偏差、图形裁切、对比度不足、残留占位符等，均为首轮常见失败现象。
• 必须同时运行内容 QA 与视觉 QA；文字缺失与布局损坏属于不同类别的故障。
• 当版式至关重要时，应在交付前渲染或实际检查最终幻灯片输出效果。
• 宣布幻灯片完成前，须搜索并清除残留模板垃圾内容、样例标签及占位符文本。
• 备注、批注、标签、图例及图表/表格语义需在视觉检查之外单独核查。
• 一份幻灯片可能通过文本提取测试，却因重叠、裁切、主题继承错误或备注损坏而视觉失败。
• 缩略图网格与渲染后的幻灯片通常比代码或文本检查更快暴露布局缺陷。
• 应默认首次渲染结果为错误状态，并至少执行一轮“修复–验证”循环后再标记为完成。
• 每次修复后均需复查受影响幻灯片，因一处间距调整常引发另一处问题。

6. 确保幻灯片具备可移植性与审阅安全性

• 母版可意外覆盖直接编辑操作。
• 复杂效果在 PowerPoint、LibreOffice 及各类转换流程中可能降级，关键内容应不依赖此类效果以保障鲁棒性。
• 图片尺寸、字体替换、占位符错配，是导致幻灯片在代码中表现良好、但在屏幕上显示异常的常见原因。
• 备注、批注、关联媒体及合并后的幻灯片，即使可见幻灯片表面正常，也可能持续处于损坏状态。

常见陷阱

• 占位符文本与样例图表若未被显式替换，在模板复用时往往被意外保留。
• 直接编辑单张幻灯片可能失败，因根本问题实则位于母版或版式定义中。
• 图表、图标与文本框需预留充足空间；临近碰撞问题通常仅在渲染后才可见。
• 版式索引因模板而异，一套幻灯片中的内置假设在另一套中极易失效。
• 缺失占位符或错误的形状目标会静默地将内容置入错误位置。
• 先选版式再统计观点数，常导致空占位符、层级薄弱或残留模板垃圾。
• 字体替换可能改变换行位置，从而破坏精心设计的间距。
• 演讲者备注、批注与关联媒体可能持续损坏，即使可见幻灯片表面无异常。
• 幻灯片可通过文本检查，却因重叠、对比度不足或边缘裁切而在视觉层面失败。
• 仅凭单张幻灯片编辑，易忽略主题、母版或版式定义中真正的事实源头。
• 在无匹配内容支撑的情况下选用引用型、对比型或多栏版式，通常使幻灯片显得模板化而非有意设计。
• 合并或复制幻灯片时若未校验母版与主题，可能导致逐页累积细微不一致性。
• 16:9 与 4:3 等宽高比不匹配，即使每张幻灯片局部看起来合理，也会系统性偏移全部布局决策。

相关技能

若用户确认，可通过 clawhub install 安装：

• documents — 常向演示文稿提供内容的文档工作流。
• design — 视觉方向与版式决策。
• brief — 面向幻灯片叙事的精炼商业信息表达。

反馈

• 若本指南有用：clawhub star powerpoint-pptx
• 保持更新：clawhub sync