截图证据链纪律

截图是视觉问题的第一证据，但截图用得不规范，证据链就是断的。这篇讲截图证据链的纪律——Air 系列视觉排障的血泪总结。

▍第一条铁律
截图为准，日志不能自证渲染。日志说渲染成功、界面白屏的矛盾现场发生过太多：渲染管线认为自己画了，画面就是黑的。一切界面外观的结论必须建立在真实读取过的截图之上——没有截图，就没有视觉结论。

▍第二条：双通道
重要视觉结论双通道印证：看图描述加定量测量。看图回答是什么样（黑屏、花屏、错位），测量回答差多少（元素区域坐标、偏移像素数）。单通道的误判案例：肉眼觉得整体偏移，测量发现只有部分元素偏移——结论完全不同（布局 bug 还是坐标换算 bug）。测量的做法：截图导入分析工具，取元素边界坐标算差值。

▍第三条：留痕
每个视觉结论引用具体截图文件（路径加时间），复盘可回溯。测试脚本自动截图的命名规范：场景加步骤加时间戳。一图胜千言的对称面：没有留痕的截图等于没截。

▍截图的坑
一，截图不可信场景：部分合成路径下截图与实际显示不一致（截图来自另一个合成阶段）——高怀疑时用帧直存（应用侧把帧缓冲直接存文件）对照，两条路都黑才是真黑，一条黑一条正常就是截图通道问题。二，瞬态问题抓不到：小于零点几秒的黑帧、闪烁，截图时机对不上——改用路径命中计数（在嫌疑路径埋递增探针，操作后统计命中次数，用计数定案；Air 工程用这招给两个瞬态问题一锤定音）。三，设备截图与实机观感差异：色彩配置与亮度，视觉走查要在实机做，截图做证据。

▍流程化
问题上报模板含：截图（多时刻）、定量描述、复现步骤、版本与机型。收到这种报告，排查效率翻倍——所以论坛反馈引导用户按这个模板来（反馈姿势篇有展开）。

▍自测
你最近一次视觉 bug 的结论，能拿出截图与测量数据吗？不能，从下一个 bug 开始。

有疑问欢迎在本板块直接发帖，我们会逐条回复。