闪光安全审核 是做什么的?
在无头浏览器中记录页面(或读取视频),运行EA的IRIS闪光检测器,使用WCAG面积阈值(屏幕的0.111),并生成Markdown + JSON报告。这是一种筛查,而非认证。
从本技能文件夹使用其自身的Python运行命令:.\\.venv\Scripts\python.exe(以下简称为python)。使用--out参数将报告输出到用户的项目中。
1. 设置(仅当.venv缺失或导入失败时)
python -m venv .venv
.\\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\\.venv\Scripts\python.exe -m playwright install chromium
2. 选择输入
| 输入 | 使用场景 |
|---|---|
--url https://... | 实时网页 |
--html path\page.html | 本地HTML文件 |
--video path\clip.mp4 | 游戏录制、预告片或任何现有视频 |
python scripts/audit.py --url https://example.com
python scripts/audit.py --html page.html --duration 10
python scripts/audit.py --video clip.mp4
有用的选项:--duration(秒,默认10)、--settle(秒,默认1)、--viewport(默认1024x768)、--out(默认reports/)。
退出代码:0 = 通过,1 = 失败,2 = 错误。不支持点击、悬停和滚动;如果危险需要交互,请要求用户提供屏幕录制并使用--video。
3. 阅读报告(report.md)
- WCAG 2.3.1结果是唯一的判定。如果发现任何亮度或红色“闪光失败”帧,则判定为失败。请引用时间范围。
- **额外警告(非WCAG)**是IRIS广播规则(例如,每秒2-3次闪光持续数秒)。请单独提及;切勿将其称为WCAG失败。
- 比半帧率更快的闪烁(页面录制约为12 Hz)不会被测量。切勿将此类内容描述为“通过”。
- 始终重复免责声明:通过并不证明页面是安全的。
4. 失败时的修复建议
- 将闪烁频率降低到每秒低于3次。
- 使闪光区域变小(在1024 x 768分辨率下,远小于341 x 256像素)。
- 减少闪光状态之间的亮度对比。
- 避免饱和的红色闪光。
- 尊重
@media (prefers-reduced-motion: reduce)并添加暂停/停止控制。
5. 安全规则
切勿在可视浏览器中打开测试页面、审核页面或录制内容,也切勿向用户显示或嵌入它们。仅通过scripts/audit.py在无头模式下运行。共享报告,而非素材。