Auditoría de seguridad de destellos
Graba la página en un navegador sin cabeza (o lee un video), ejecuta el detector de destellos IRIS de EA con el umbral de área WCAG (0.111 de la pantalla) y escribe un informe en Markdown + JSON. Es un cribado, no un certificado.
Ejecuta los comandos desde la carpeta de esta habilidad con su propio Python,
.\venv\Scripts\python.exe (mostrado como python abajo). Usa --out para poner
el informe en el proyecto del usuario.
1. Configuración (solo si falta .venv o fallan las importaciones)
python -m venv .venv
.\venv\Scripts\python.exe -m pip install -r requirements.txt
.\venv\Scripts\python.exe -m playwright install chromium
2. Elige la entrada
| Entrada | Úsalo cuando |
|---|---|
--url https://... | una página web en vivo |
--html ruta\página.html | un archivo HTML local |
--video ruta\clip.mp4 | una captura de juego, tráiler o cualquier video existente |
python scripts/audit.py --url https://ejemplo.com
python scripts/audit.py --html página.html --duration 10
python scripts/audit.py --video clip.mp4
Opciones útiles: --duration (s, valor predeterminado 10), --settle (s, valor predeterminado 1),
--viewport (valor predeterminado 1024x768), --out (valor predeterminado reports/).
Código de salida 0 = PASS, 1 = FAIL, 2 = error. No se admiten clics, hover ni desplazamiento;
si el peligro requiere interacción, pídele al usuario una grabación de pantalla
y usa --video.
3. Lee el informe (report.md)
- El resultado WCAG 2.3.1 es el único veredicto. FAIL si se encontraron fotogramas de "fallo de destello" de luminancia o rojo. Cita los rangos de tiempo.
- Advertencias adicionales (no WCAG) son reglas de transmisión IRIS (por ejemplo, 2–3 destellos/s durante varios segundos). Menciónalas por separado; nunca las llames un fallo WCAG.
- El parpadeo más rápido que la mitad de la frecuencia de fotogramas (~12 Hz para grabaciones de página) no se mide. Nunca describas dicho contenido como "aprobado".
- Repite siempre el descargo de responsabilidad: una aprobación no prueba que la página sea segura.
4. Correcciones para sugerir cuando falla
- Ralentizar el destello a menos de 3 por segundo.
- Hacer que el área de destello sea más pequeña (muy por debajo de 341 x 256 px a 1024 x 768).
- Reducir el contraste de brillo entre los estados de destello.
- Evitar destellos de rojo saturado.
- Respetar
@media (prefers-reduced-motion: reduce)y agregar un control de pausa/parada.
5. Regla de seguridad
Nunca abras páginas de prueba, páginas auditadas o grabaciones en un navegador visible, y
nunca las muestres ni las incrustes para el usuario. Ejecútalas solo sin cabeza a través de
scripts/audit.py. Comparte el informe, no la grabación.