pptx-slide-specification

PPTX 幻灯片规范

直接在 layout_tree 中编写最终坐标。任何渲染器都不得在审计后自行决定摆放位置、缩小文本或推断布局。

必需契约

• 根 JSON 包含 summary 和 slides。
• 每张幻灯片都有一个稳定的 id、一个以信息为导向的 title、一个无障碍阅读顺序，以及一个完整的 layout_tree。
• 布局树声明幻灯片尺寸、根分组、以 id 为键的分组和对象、最终英寸 bbox、样式、z-index 和分类。
• 每个有意义的对象都有 id、kind、role、classification、content、style、bbox 和 z_index。
• 生产环境的 summary 包含显式的 layout_policy（安全边距、内容底部、页脚顶部、最小间距）和无障碍元数据。

编写规则

1. 使用稳定、可读的 ID、绝对分组和正数英寸尺寸。
2. 将常规内容保持在安全边距内、页脚栏上方。仅背景 layout_design 对象可以全出血。
3. 使用原生 text、shape、line、table 和 image 对象。将任何辅助视觉中的标签和数值重建为原生对象。
4. 为有意义的图像提供替代文本。为有来源的陈述记录 source_ref。
5. 将内容文本保持在 9 pt 或更大；在减小字号之前，先缩短、调整尺寸或拆分密集内容。
6. 使用共享网格、一致的间距、显式颜色、显式字号，以及有意的 z 顺序。

构建契约

任务本地构建器从空白幻灯片布局开始，并使用 Inches(...) 映射所有 bbox。显式设置换行、禁用自动调整大小、文本内边距、锚点、对齐、字体、颜色、线条设置、图像宽高比和隐藏幻灯片状态。在添加对象之前，拒绝零或负几何值。

参见 references/layout-contract.md 以了解紧凑模式与修复指导。