cli-anything-nsight-graphics

Skill CLI de Nsight Graphics

Orquestación desde línea de comandos de las actividades oficiales de NVIDIA Nsight Graphics.

Capacidades

• Detectar binarios de Nsight instalados y el modo de compatibilidad
• Iniciar una aplicación de forma desatendida bajo Nsight
• Adjuntar Nsight a un PID en ejecución
• Disparar captura de gráficos o captura del depurador de frames OpenGL
• Disparar captura de traza de GPU, autoexportación y resumen
• Analizar archivos .ngfx-capture existentes mediante ngfx-replay
• Reportar diagnósticos de compatibilidad claros para entradas .ngfx-gputrace
• Disparar generación de captura C++

Comandos

doctor

cli-anything-nsight-graphics --json doctor info
cli-anything-nsight-graphics --json doctor versions
cli-anything-nsight-graphics --nsight-path "C:\Path\To\Nsight Graphics 2024.2\host\windows-desktop-nomad-x64" --json doctor info

launch

cli-anything-nsight-graphics launch detached --activity "Graphics Capture" --exe "C:\Path\To\App.exe"
cli-anything-nsight-graphics launch attach --activity "Graphics Capture" --pid 12345

captura de frames

cli-anything-nsight-graphics --output-dir D:\captures frame capture ^
  --exe "C:\Path\To\App.exe" ^
  --wait-frames 10

Traza de GPU

cli-anything-nsight-graphics --output-dir D:\traces gpu-trace capture ^
  --exe "C:\Path\To\App.exe" ^
  --start-after-ms 1000 ^
  --limit-to-frames 1 ^
  --auto-export ^
  --summarize

cli-anything-nsight-graphics gpu-trace summarize ^
  --input-dir D:\traces

Análisis de repetición

cli-anything-nsight-graphics --json replay analyze ^
  --capture-file D:\captures\frame.ngfx-capture ^
  --output-dir D:\analysis

Generar captura C++

cli-anything-nsight-graphics --output-dir D:\cpp cpp capture ^
  --exe "C:\Path\To\App.exe" ^
  --wait-seconds 5

Notas para el agente

• Preferir doctor info primero para descubrir el modo de compatibilidad disponible.
• Usar doctor versions para listar las instalaciones detectadas cuando existan múltiples versiones de Nsight Graphics.
• Usar --nsight-path para forzar un directorio de instalación específico o ngfx.exe.
• Usar --json para flujos de trabajo programáticos.
• Preferir gpu-trace capture --auto-export --summarize para un triaje de rendimiento en un solo paso. El resumen incluye el inventario de tablas exportadas, inventario de métricas, clasificación de presupuesto de frames, clasificación de carga de trabajo, ranking de rendimiento, sugerencias de cuellos de botella y advertencias para tablas de eventos/regímenes vacías.
• Usar replay analyze cuando la entrada sea un archivo .ngfx-capture existente. Sin modificadores de análisis, exporta metadatos, registros, errores de registro capturados y un informe de rendimiento de repetición, y luego añade analysis.highlights / analysis.warnings estructurados.
• ngfx-replay documenta su entrada como un archivo de captura de gráficos. Las entradas .ngfx-gputrace se aceptan para diagnósticos claros, pero en Nsight Graphics 2026.1.0 pueden reportar Invalid file header; usar gpu-trace summarize para el análisis de tablas de traza de GPU exportadas.
• replay analyze utiliza las salidas oficiales de ngfx-replay (metadatos, registro, captura de pantalla, informe de rendimiento); no es un inspector de shaders, pipeline, texturas o recursos al estilo de RenderDoc.
• Los comandos de captura de frames, GPU o C++ requieren un destino de lanzamiento mediante --exe o un --project preconfigurado a nivel raíz.
• Si un comando global cli-anything-nsight-graphics apunta a un árbol de trabajo antiguo, reinstalar desde nsight-graphics/agent-harness con python -m pip install -e ..