CommunityProgramación y desarrollogithub.com

Detcader101/benchmark

Evalúa el sandbox NGC-1980 / Thrust Zarch con muestras reproducibles de fotogramas renderizados, comprobaciones de jugabilidad, capturas de pantalla y clips cortos. Útil para comparativas de rendimiento o evidencia visual de un cambio en el juego.

¿Qué es benchmark?

Esta habilidad permite obtener evidencia medible del juego en ejecución para el sandbox NGC-1980 / Thrust Zarch. Utiliza las herramientas del repositorio (`tools/benchmark.mjs` y `tools/snap.mjs`) para generar comparativas antes/después con configuraciones coincidentes (escena, semilla, navegador, renderizador, resolución y política de muestreo). Es compatible con flujos de trabajo de desarrollo que requieren evidencia visual o de rendimiento, y puede integrarse con informes HTML a través de `$devlog`. La habilidad establece reglas claras para evitar falsas mejoras: exige una línea base del código anterior, rechaza comparaciones con configuraciones dispares y distingue entre repetibilidad y mejora real. Además, detalla la inspección manual de PNGs y contact sheets de clips, así como la interpretación correcta de métricas como SwiftShader (renderizador por software), fases de CPU suavizadas, contadores de draw del último pase y tasa de codificación de video (que no debe confundirse con FPS del juego).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Detcader101/NGC-1980/tree/main/skills/benchmark

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace benchmark?

Produce evidencia medible del juego en ejecución. Utiliza las herramientas tools/benchmark.mjs y tools/snap.mjs del repositorio, preservando el worktree elegido y su huella de contenido del juego. El checkout experimental es /home/jayjay/thrust-zarch-experimental; el clásico main es una versión diferente del juego. Localiza el checkout adecuado antes de ejecutar. Lee el flujo de trabajo para comandos y la API de escena.

Elige un fixture corto que alcance el comportamiento modificado. Reutiliza las escenas existentes cuando sea posible; usa el fixture predeterminado coastal-flight/research para una captura general. Ejecuta un navegador a la vez. Realiza el benchmark sin capturas de pantalla, grabaciones, otros navegadores de prueba ni lotes de regresión de CPU ejecutándose simultáneamente. Captura los medios después.

Para una afirmación de antes/después, conserva una línea base del código anterior y repite la misma escena, semilla, navegador, renderizador, resolución y política de muestreo. La herramienta rechaza comparaciones con configuraciones dispares. Una repetición del código sin cambios mide repetibilidad, no una mejora. No disfraces una línea base faltante o una ejecución fallida.

Inspecciona los PNGs y las hojas de contacto de clips decodificados. Cuando la afirmación involucra movimiento, inspecciona más fotogramas o reproduce/busca en el clip; tres miniaturas no establecen cada fotograma intermedio. Reporta lo que la evidencia renderizada respalda junto con las afirmaciones reales. Los recuentos de población por sí solos no establecen peces visibles, y un fotograma no vacío no establece un escenario correcto. Mantén las observaciones visuales separadas de las comprobaciones automáticas.

Devuelve el directorio de ejecución, la identidad de la fuente, los números relevantes, los fallos y los límites. SwiftShader es un renderizador por software; la emulación de XR no es una calificación de visor. Las fases de CPU son costos de CPU suavizados; los contadores de draw provienen del último pase de renderizado. La tasa de codificación de video nunca es FPS del juego, y la duración codificada puede diferir del tiempo de captura. Entrega la evidencia a $devlog cuando se solicite un informe de desarrollo en HTML; el benchmark sigue siendo utilizable de forma independiente.

Skills relacionados