验收面
真实 UI
截图必须来自本地跑起的系统或用户指定演示环境。
写入前
先备份
DB dump 优先；无 DB 权限时保存完整接口 JSON 备份。
出现问题
可回滚
apply 和 rollback 路径要成对保留，并记录证据路径。
核心反模式：不要把数据库或接口结果生成的图片，当作“系统前后截图”交付。Before 如果是空的，第一判断应是证据采集失败，而不是继续包装报告。
以后固定执行清单
| 步骤 | 正确做法 | 验收证据 |
|---|---|---|
| 1. 锁环境 | 确认是本地系统还是演示环境，锁定 URL、账号来源、API/DB、目标模块和截图页面。 | 环境说明、登录成功截图或可访问性记录。 |
| 2. 先截 Before | 先进入真实页面，确认数据可见、筛选正确，再截修改前截图。 | 同页面、同筛选、同视口的 Before 图片。 |
| 3. 先备份再改 | 能连 DB 就做库表备份；只能走接口就保存全量明细 JSON，不只保存摘要。 | 备份目录、备份清单、影响对象列表。 |
| 4. 安全写入 | 优先使用系统 API 或事务 SQL；确认更新接口是否需要完整对象 payload。 | apply 结果、影响行数或接口返回。 |
| 5. 双重验证 | API/DB 验值，真实 UI 验展示。设备数据类还要判断是否存在前端默认筛选问题。 | 接口/DB 验证 JSON + After 截图。 |
| 6. 图文交付 | 按“每个需求对应方案，右侧两列前后图片说明”输出，不混淆截图和说明。 | HTML 报告或表格，图片路径可打开。 |
| 7. 回滚机制 | 保留 rollback 脚本或 SQL，并说明是否已演练、何时可执行。 | rollback 文件、命令、备份路径。 |
截图证据样例
本次沉淀
项目 skill
新增 demo-system-data-screenshot-acceptance，以后遇到演示环境数据修改、前后截图、备份和回滚任务时先加载。
公开复盘页
本页用于给同事快速理解验收口径；敏感凭据、token、cookie 和完整原始 payload 不进入公开页面。