cli-anything-nsight-graphics

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Nsight Graphics CLI Skill

Nsight Graphics CLI 技能

Command-line orchestration of official NVIDIA Nsight Graphics activities.

官方NVIDIA Nsight Graphics各项操作的命令行编排工具。

Capabilities

功能特性

Probe installed Nsight binaries and compatibility mode
Launch an application detached under Nsight
Attach Nsight to a running PID
Trigger Frame Debugger capture
Trigger GPU Trace capture, auto-export, and summarize
Trigger Generate C++ Capture

探测已安装的Nsight二进制文件及兼容模式
通过Nsight以分离模式启动应用程序
将Nsight附加到运行中的PID
触发Frame Debugger捕获
触发GPU Trace捕获、自动导出并生成摘要
触发生成C++ Capture

Commands

命令

doctor

bash

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

bash

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

bash

cli-anything-nsight-graphics launch detached --activity "Frame Debugger" --exe "C:\Path\To\App.exe"
cli-anything-nsight-graphics launch attach --activity "Frame Debugger" --pid 12345

bash

cli-anything-nsight-graphics launch detached --activity "Frame Debugger" --exe "C:\Path\To\App.exe"
cli-anything-nsight-graphics launch attach --activity "Frame Debugger" --pid 12345

frame capture

bash

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

bash

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

GPU Trace

bash

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

bash

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

Generate C++ Capture

bash

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

bash

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

Agent Notes

Agent 使用说明

Prefer
```
doctor info
```
first to discover the available compatibility mode.
Use
```
doctor versions
```
to list detected installs when multiple Nsight Graphics versions exist.
Use
```
--nsight-path
```
to force a specific install directory or
```
ngfx.exe
```
.
Use
```
--json
```
for programmatic workflows.

Prefer

gpu-trace capture --auto-export --summarize

for one-step performance triage.

Frame/GPU/C++ capture commands require a launch target through
```
--exe
```
or a preconfigured root-level
```
--project
```
.
V1 is orchestration-focused; it does not expose shader, pipeline, or resource inspection commands.

优先使用
```
doctor info
```
来查看可用的兼容模式。
当存在多个Nsight Graphics版本时，使用
```
doctor versions
```
列出检测到的安装版本。
使用
```
--nsight-path
```
指定特定的安装目录或
```
ngfx.exe
```
。
对于程序化工作流，使用
```
--json
```
参数。

优先使用

gpu-trace capture --auto-export --summarize

进行一站式性能诊断。

帧/GPU/C++捕获命令需要通过
```
--exe
```
指定启动目标，或者预先配置根级别的
```
--project
```
。
V1版本以编排为核心；暂不提供着色器、管线或资源检查命令。