Grabación de Video del Navegador
Modelo de Dependencias
Divide el flujo de trabajo en tres capas:
- Control del navegador y fotogramas fuente: Utiliza el navegador integrado de Codex a través de la skill/MCP de Browser. No uses Chrome cuando el usuario solicite el navegador de Codex o el proyecto indique lo contrario. La capa del navegador proporciona capturas de pantalla reales y estados reales de clic/desplazamiento/navegación.
- Renderizador de video local: Utiliza el script Python incluido para convertir las capturas en un MP4 con cursor macOS natural, escala sutil de clic y seguimiento de zoom calmado. Esto no requiere un MCP de grabación de pantalla.
- Integración opcional con grabador nativo: Utiliza un MCP de grabación nativo solo cuando sea invocable y explícitamente útil para iniciar/detener una grabación real de la aplicación o abrir un proyecto generado. Si no está disponible, está bloqueado o no puede capturar la superficie del navegador de Codex, recurre al renderizador de capturas a video y explica la alternativa.
Ejecución Autónoma
Esta skill es suficiente para que otra instancia de Codex realice el renderizado Python siempre que la carpeta completa de la skill esté instalada, incluyendo scripts/render_browser_demo.py. Codex debe ejecutar el script incluido en lugar de recrear el renderizador.
Herramientas locales necesarias:
python3- Paquete Python
Pillow ffmpegyffprobe
La extracción opcional del cursor macOS utiliza swift y /usr/sbin/screencapture. Si no están disponibles, proporciona un PNG transparente a través de cursor_asset y establece cursor_hotspot en la configuración.
La skill/MCP de Browser sigue siendo necesaria para obtener capturas frescas del navegador integrado de Codex. Si no está disponible, utiliza la mejor fuente de capturas de automatización de navegador disponible e indica la alternativa.
Soporte Opcional de Grabador Nativo
Para grabación nativa de aplicaciones, verifica que el MCP soporte:
- Usar
frameRate: 60. - Usar
resolutionRawValue: "4K". - Usar
ratioPresetRawValue: "4:3"para grabaciones de región. - Usar un
selectedRegionOnScreenexplícito al recortar a una ventana de navegador incrustada.
Para el renderizador local, 4K 4:3 significa 3840x2880. Si un grabador nativo expone un enumerado 4K, trátalo como un preset de resolución del lado de la aplicación y combínalo con la selección de región 4:3 al grabar a través de ese MCP.
Flujo de Captura
Primero usa browser:control-in-app-browser. Después de cargar su documentación, maneja el navegador integrado con la API de Node/navegador:
- Establece el viewport a
1920x1440para salida 4:3 4K, luego restablécelo antes de finalizar. - Navega a la página solicitada y realiza clics, retrocesos, búsquedas y desplazamientos reales.
- Guarda capturas de pantalla solo del navegador después de cada cambio de estado importante. Usa nombres como
01-results-top.png,02-after-card-click.png,03-back-results.png. - Registra las coordenadas del viewport de cada objetivo de clic/desplazamiento. El trazado final del cursor debe aterrizar en esos puntos, pausarse, hacer clic y luego moverse al siguiente punto significativo.
Evita la automatización de coordenadas del escritorio a menos que el usuario necesite explícitamente la UI del sistema. La visibilidad del navegador de Codex puede no exponer una superficie macOS capturable; las capturas de pantalla de la API del navegador son la fuente confiable.
Reglas de Movimiento
Haz que el cursor se sienta intencionado:
- Usa trayectorias del cursor mayormente rectas y espaciadas.
- Pausa brevemente en un objetivo antes de hacer clic.
- No deambules sobre UI no relacionada.
- Deja que la transición de página ocurra después del clic, no antes.
- Usa solo retroalimentación sutil de clic: una pequeña bajada/rebote de escala, no anillos decorativos a menos que se solicite.
- Mantén el seguimiento de zoom más calmado que el cursor. La cámara debe encuadrar el contenido clicado, no perseguir cada pequeño movimiento del ratón.
Objetivo visual predeterminado:
- Puntero macOS real extraído del compositor, o un activo de cursor transparente existente.
- Escala del cursor
3.0, coincidiendo con el estilo de cursor grande comúnmente usado en grabaciones de demostración editadas. - Fuerza de animación de clic
15para una sutil bajada de escala. - Fuerza de rotación hasta
8deg, solo por velocidad horizontal.
Script de Renderizado
Usa scripts/render_browser_demo.py para salida determinista a 60 fps 4:3 4K:
python3 /ruta/a/browser-video-recording/scripts/render_browser_demo.py \
--config /tmp/browser-demo-config.json \
--output /tmp/browser-demo-4x3-4k-60fps.mp4
Genera una configuración inicial:
python3 /ruta/a/browser-video-recording/scripts/render_browser_demo.py --write-template
La configuración proporciona:
shots: mapa de nombres de estado a rutas de PNG de captura.scene_starts: entradas[tiempo, nombreCaptura, transición].cursor_keys: entradas[tiempo, x, y]de coordenadas del viewport.camera_keys: entradas[tiempo, x, y, zoom].click_times: marcas de tiempo de clics.duration,fps,output_size,source_size,cursor_scale.
Valores predeterminados preferidos:
{
"fps": 60,
"output_size": [3840, 2880],
"source_size": [1920, 1440]
}
Si se omite cursor_asset, el script muestra brevemente una superposición de color sólido y usa screencapture para extraer el cursor macOS real actual en un PNG transparente. Esto es soporte de renderizado local, no una dependencia de MCP.
Verificación
Verifica siempre el video entregado:
ffprobe -v error \
-show_entries stream=codec_name,width,height,r_frame_rate \
-show_entries format=duration,size \
-of json /ruta/a/salida.mp4
Extrae al menos una miniatura a mitad del video e inspecciónala:
ffmpeg -y -ss 8 -i /ruta/a/salida.mp4 -frames:v 1 -update 1 /tmp/browser-demo-thumb.png
Confirma:
- La resolución es la salida solicitada, generalmente
3840x2880para 4:3 4K. - La tasa de fotogramas es
60/1o equivalente. - La duración coincide con la solicitud.
- El cursor es visible, natural y está en el objetivo.
- El video está recortado al contenido del navegador, no al escritorio.
- La anulación del viewport del navegador se ha restablecido.