visual_review_workflow

# 演示文稿视觉审查工作流 ## 概述 视觉审查是演示文稿质量保证的关键步骤，允许你在演示前识别并修复布局问题、文本溢出、元素重叠和设计问题。本指南涵盖了将演示文稿转换为图像、系统性视觉检查、常见问题以及迭代改进策略。 ## ⚠️ 关键规则：切勿直接读取PDF演示文稿 **强制要求：始终先将演示文稿PDF转换为图像，然后审查这些图像。** ### 为什么存在此规则 - **防止缓冲区溢出**：直接读取演示文稿PDF（尤其是多幻灯片文档）会导致“JSON消息超过最大缓冲区大小”错误 - **视觉准确性**：图像显示了观众将看到的实际内容，包括渲染问题 - **性能**：基于图像的审查比PDF文本提取更快、更可靠 - **一致性**：确保所有演示文稿的审查过程统一 ### 演示文稿的唯一正确工作流 1. ✅ 从PowerPoint/Beamer源文件生成PDF 2. ✅ 使用 `pdf_to_images.py` 脚本**将PDF转换为图像** 3. ✅ 系统地**审查图像文件** 4. ✅ 按幻灯片编号记录问题 5. ✅ 在源文件中修复问题 6. ✅ 重新生成PDF并重复 ### 严禁事项 - ❌ 严禁在演示文稿PDF上使用 `read_file` 工具 - ❌ 严禁尝试将PDF幻灯片作为文本读取 - ❌ 严禁跳过图像转换步骤 - ❌ 严禁假设PDF“足够小”可以直接读取 **如果你正在审查演示文稿且尚未转换为图像，请停止并先进行转换。** ## 为什么视觉审查很重要 ### 源文件中不可见的常见问题 **LaTeX Beamer问题**： - 文本框中的文本溢出 - 元素重叠（方程覆盖在图像上） - 糟糕的换行 - 图表超出幻灯片边界 - 实际分辨率下的字体大小问题 **PowerPoint问题**： - 形状或幻灯片边缘截断文本 - 图像与文本重叠 - 幻灯片间距不一致 - 颜色渲染差异 - 字体替换问题 **投影问题**： - 内容在笔记本上可见，但投影时被截断 - 投影仪上的颜色看起来不同 - 低对比度元素变得不可见 - 小细节消失 ### 视觉审查的好处 - **尽早发现布局错误**：在打印或演示前修复 - **验证可读性**：确保文字足够大且对比度高 - **检查一致性**：发现幻灯片间的不一致之处