问题修复
交付可编辑 PPTX 前,用质量门禁验证并修复几何…
在交付生成的 PPTX 演示文稿前,需要系统验证或修复其布局几何、可访问性、原生可编辑性、来源记录和 OOXML 包完整性时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
交付可编辑 PPTX 前,用质量门禁验证通用
解决思路
- 交付生成的 PPTX 前使用此技能;将确定性失败视为修复工作,而不是例外。
- 确认规格(spec)、构建器(builder)、PPTX、来源清单(source manifest)和审计路径。
- 在构建前,将 `references/audit-checklist.md` 应用于坐标契约。
- 重新打开 PPTX,比较幻灯片数量、实际边界、隐藏幻灯片和请求的几何尺寸与布局树。
- 对于生产演示文稿,运行 `pptx-reference-deck-analysis/scripts/validate_package.py` 并保存 JSON 报告。
- 检查文档语言、幻灯片标题、有意义的图片替代文本(alt text)、阅读顺序、表格表头和来源引用。
- 当兼容的渲染器已经可用时,检查预览中的裁剪、字体回退、对比度、裁切和层级;不要添加渲染器依赖。
- 修复规格(spec)或任务本地构建器(builder),重新构建,并重新运行相同的检查。
- 将规格(spec)、PPTX、构建记录、几何审计、可访问性审计、包报告和来源清单(source manifest)保存在一起。
- 报告任何已记录例外时,包含幻灯片 ID、对象 ID、负责人、原因和复查日期。
- 通过标准:零内容碰撞、文本溢出、不安全内容边界、无效正几何和包完整性错误。
- 有意义的幻灯片内容必须保持为原生可编辑对象;图片用于支持而非替代它。
- 完整清单见 `references/audit-checklist.md`。
适用边界 · 注意事项
- 没有兼容渲染器时,不要添加渲染器依赖来做预览检查;可跳过该预览检查。
- 不需要原生可编辑对象的纯图片或 PDF 交付物,不适用这些原生可编辑性门禁。
- 不要用图片替代有意义的幻灯片内容;若目标是生成不可编辑的视觉稿,则不应套用“内容必须原生可编辑”的要求。