cli-anything-nsight-graphics

Nsight Graphics CLI スキル

公式 NVIDIA Nsight Graphics アクティビティをコマンドラインでオーケストレーションします。

機能

• インストールされている Nsight バイナリと互換モードを調査
• Nsight の下でアプリケーションをデタッチ状態で起動
• 実行中の PID に Nsight をアタッチ
• Graphics Capture または OpenGL Frame Debugger キャプチャをトリガー
• GPU Trace キャプチャ、自動エクスポート、サマリー生成をトリガー
• ngfx-replay を通じて既存の .ngfx-capture ファイルを解析
• .ngfx-gputrace 入力に対する明確な互換性診断を報告
• Generate C++ Capture をトリガー

コマンド

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

Replay analysis

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:\Path\To\App.exe" ^
  --wait-seconds 5

エージェント向けの注意事項

• 利用可能な互換モードを確認するには、まず doctor info を優先してください。
• 複数の Nsight Graphics バージョンが存在する場合に、検出されたインストールを一覧表示するには doctor versions を使用してください。
• 特定のインストールディレクトリまたは ngfx.exe を強制するには --nsight-path を使用してください。
• プログラムによるワークフローには --json を使用してください。
• ワンステップのパフォーマンストリアージには gpu-trace capture --auto-export --summarize を優先してください。サマリーには、エクスポートされたテーブル一覧、メトリクス一覧、 フレームバジェット分類、ワークロード分類、スループットランキング、 ボトルネックのヒント、および空のイベント/レジームテーブルに対する警告が含まれます。
• 入力が既存の .ngfx-capture ファイルである場合は replay analyze を使用してください。解析スイッチを 指定しない場合、メタデータ、ログ、キャプチャされたログエラー、および リプレイパフォーマンスレポートをエクスポートし、その後、構造化された analysis.highlights / analysis.warnings を追加します。
• ngfx-replay は、その入力を Graphics Capture ファイルとして文書化しています。.ngfx-gputrace 入力は明確な診断のために受け入れられますが、Nsight Graphics 2026.1.0 では Invalid file header が報告されることがあります。エクスポートされた GPU Trace テーブル解析には gpu-trace summarize を使用してください。
• replay analyze は公式の ngfx-replay メタデータ/ログ/スクリーンショット/パフォーマンスレポート 出力を使用します。これは RenderDoc スタイルのシェーダー、パイプライン、テクスチャ、またはリソースインスペクターではありません。
• フレーム/GPU/C++ キャプチャコマンドには、--exe または 事前設定されたルートレベルの --project を通じた起動ターゲットが必要です。
• グローバルな cli-anything-nsight-graphics コマンドが古いワークツリーを指している場合は、 nsight-graphics/agent-harness から python -m pip install -e . で再インストールしてください。