cli-anything-nsight-graphics

Habilidade CLI do Nsight Graphics

Orquestração por linha de comando das atividades oficiais do NVIDIA Nsight Graphics.

Capacidades

• Detectar binários do Nsight instalados e modo de compatibilidade
• Iniciar um aplicativo destacado sob o Nsight
• Anexar o Nsight a um PID em execução
• Acionar captura gráfica ou captura do depurador de quadros OpenGL
• Acionar captura de rastreamento de GPU, exportação automática e resumo
• Analisar arquivos .ngfx-capture existentes através do ngfx-replay
• Relatar diagnósticos claros de compatibilidade para entradas .ngfx-gputrace
• Acionar geração de captura em 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

frame capture

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

GPU Trace

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álise de replay

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

Gerar captura em C++

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

Notas para Agentes

• Prefira doctor info primeiro para descobrir o modo de compatibilidade disponível.
• Use doctor versions para listar instalações detectadas quando houver múltiplas versões do Nsight Graphics.
• Use --nsight-path para forçar um diretório de instalação específico ou ngfx.exe.
• Use --json para fluxos de trabalho programáticos.
• Prefira gpu-trace capture --auto-export --summarize para triagem de desempenho em uma única etapa. O resumo inclui inventário de tabelas exportadas, inventário de métricas, classificação de orçamento de quadro, classificação de carga de trabalho, ranking de throughput, dicas de gargalo e avisos para tabelas vazias de eventos/regime.
• Use replay analyze quando a entrada for um arquivo .ngfx-capture existente. Sem opções de análise, ele exporta metadados, logs, erros de log capturados e um relatório de desempenho de replay, e então adiciona analysis.highlights / analysis.warnings estruturados.
• O ngfx-replay documenta sua entrada como um arquivo Graphics Capture. Entradas .ngfx-gputrace são aceitas para diagnósticos claros, mas no Nsight Graphics 2026.1.0 podem reportar Invalid file header; use gpu-trace summarize para análise de tabelas exportadas do GPU Trace.
• replay analyze usa saídas oficiais de metadados/log/screenshot/perf-report do ngfx-replay; não é um inspetor de shader, pipeline, textura ou recurso no estilo RenderDoc.
• Comandos de captura de quadro/GPU/C++ exigem um alvo de lançamento através de --exe ou um --project pré-configurado no nível raiz.
• Se um comando global cli-anything-nsight-graphics apontar para uma árvore de trabalho antiga, reinstale a partir de nsight-graphics/agent-harness com python -m pip install -e ..