cli-anything-nsight-graphics

Nsight Graphics CLI Skill

Kommandozeilen-Orchestrierung offizieller NVIDIA Nsight Graphics Aktivitäten.

Fähigkeiten

• Erkennen installierter Nsight-Binärdateien und des Kompatibilitätsmodus
• Starten einer Anwendung im abgetrennten Nsight-Modus
• Anhängen von Nsight an eine laufende PID
• Auslösen von Graphics Capture oder OpenGL Frame Debugger Capture
• Auslösen von GPU Trace Capture, automatischem Export und Zusammenfassung
• Analysieren vorhandener .ngfx-capture-Dateien mit ngfx-replay
• Melden klarer Kompatibilitätsdiagnosen für .ngfx-gputrace-Eingaben
• Auslösen von Generate C++ Capture

Befehle

doctor

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

launch

cli-anything-nsight-graphics launch detached --activity "Graphics Capture" --exe "C:\Pfad\Zu\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:\Pfad\Zu\App.exe" ^
  --wait-frames 10

GPU Trace

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

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

Replay-Analyse

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

Generate C++ Capture

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

Agent-Hinweise

• Bevorzuge zuerst doctor info, um den verfügbaren Kompatibilitätsmodus zu finden.
• Verwende doctor versions, um erkannte Installationen aufzulisten, wenn mehrere Nsight Graphics Versionen existieren.
• Verwende --nsight-path, um ein bestimmtes Installationsverzeichnis oder ngfx.exe zu erzwingen.
• Verwende --json für programmatische Workflows.
• Bevorzuge gpu-trace capture --auto-export --summarize für ein einstufiges Performance-Triage. Die Zusammenfassung enthält exportierte Tabelleninventur, Metrikinventur, Framebudget-Klassifizierung, Auslastungsklassifizierung, Durchsatz-Ranking, Engpasshinweise und Warnungen für leere Ereignis-/Regimetabellen.
• Verwende replay analyze, wenn die Eingabe eine vorhandene .ngfx-capture-Datei ist. Ohne Analyses­chalter exportiert es Metadaten, Logs, erfasste Log-Fehler und einen Replay-Performance-Bericht und fügt dann strukturierte analysis.highlights / analysis.warnings hinzu.
• ngfx-replay dokumentiert seine Eingabe als Graphics Capture-Datei. .ngfx-gputrace-Eingaben werden für klare Diagnosen akzeptiert, können aber auf Nsight Graphics 2026.1.0 Invalid file header melden; verwende gpu-trace summarize für exportierte GPU Trace-Tabellenanalyse.
• replay analyze verwendet offizielle ngfx-replay-Metadaten-/Log-/Screenshot-/Perf-Bericht-Ausgaben; es ist kein RenderDoc-artiger Shader-, Pipeline-, Textur- oder Ressourceninspektor.
• Frame-/GPU-/C++-Capture-Befehle erfordern ein Startziel über --exe oder ein vorkonfiguriertes root-level --project.
• Wenn ein globales cli-anything-nsight-graphics-Kommando auf ein altes Worktree verweist, installiere es neu von nsight-graphics/agent-harness mit python -m pip install -e ..