cli-anything-nsight-graphics

Compétence Nsight Graphics CLI

Orchestration en ligne de commande des activités officielles de NVIDIA Nsight Graphics.

Capacités

• Sonder les binaires Nsight installés et le mode de compatibilité
• Lancer une application détachée sous Nsight
• Attacher Nsight à un PID en cours d'exécution
• Déclencher une capture Graphics Capture ou OpenGL Frame Debugger
• Déclencher une capture GPU Trace, exportation automatique et résumé
• Analyser des fichiers .ngfx-capture existants via ngfx-replay
• Rapporter des diagnostics de compatibilité clairs pour les entrées .ngfx-gputrace
• Déclencher la génération de capture C++

Commandes

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

Analyse de replay

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

Génération de capture C++

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

Notes pour l'agent

• Privilégiez d'abord doctor info pour découvrir le mode de compatibilité disponible.
• Utilisez doctor versions pour lister les installations détectées lorsqu'il existe plusieurs versions de Nsight Graphics.
• Utilisez --nsight-path pour forcer un répertoire d'installation spécifique ou ngfx.exe.
• Utilisez --json pour les workflows programmatiques.
• Privilégiez gpu-trace capture --auto-export --summarize pour un triage de performance en une étape. Le résumé inclut l'inventaire des tables exportées, l'inventaire des métriques, la classification du budget d'image, la classification de la charge de travail, le classement du débit, des indices de goulot d'étranglement, et des avertissements pour les tables d'événements/régimes vides.
• Utilisez replay analyze lorsque l'entrée est un fichier .ngfx-capture existant. Sans options d'analyse, il exporte les métadonnées, les journaux, les erreurs de journal capturées et un rapport de performance de replay, puis ajoute des analysis.highlights / analysis.warnings structurés.
• ngfx-replay documente son entrée comme un fichier Graphics Capture. Les entrées .ngfx-gputrace sont acceptées pour des diagnostics clairs, mais sur Nsight Graphics 2026.1.0, elles peuvent signaler Invalid file header ; utilisez gpu-trace summarize pour l'analyse des tables GPU Trace exportées.
• replay analyze utilise les sorties officielles de métadonnées/journal/capture d'écran/rapport de performance de ngfx-replay ; ce n'est pas un inspecteur de shaders, pipelines, textures ou ressources de style RenderDoc.
• Les commandes de capture d'image/GPU/C++ nécessitent une cible de lancement via --exe ou un --project préconfiguré au niveau racine.
• Si une commande globale cli-anything-nsight-graphics pointe vers un ancien espace de travail, réinstallez depuis nsight-graphics/agent-harness avec python -m pip install -e ..