Nsight Graphics CLI 技能
官方 NVIDIA Nsight Graphics 活動的命令列協調。
功能
- 探測已安裝的 Nsight 二進位檔與相容模式
- 以分離模式啟動應用程式並置於 Nsight 管理下
- 附加 Nsight 至執行中的 PID
- 觸發 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
重播分析
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
Agent 備註
- 優先使用
doctor info來探索可用的相容模式。 - 當存在多個 Nsight Graphics 版本時，使用
doctor versions列出已偵測到的安裝。 - 使用
--nsight-path強制指定特定的安裝目錄或ngfx.exe。 - 使用
--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 summarize進行匯出的 GPU Trace 表格分析。replay analyze使用官方的ngfx-replay中繼資料/日誌/螢幕截圖/效能報告輸出；它不是 RenderDoc 風格的著色器、管線、紋理或資源檢查器。- Frame/GPU/C++ 捕捉指令需要透過
--exe指定啟動目標，或使用預先配置的根層級--project。 - 如果全域的
cli-anything-nsight-graphics指令指向舊的工作目錄，請從nsight-graphics/agent-harness重新安裝，使用python -m pip install -e .。