如何手动优化 ZED SDK AI 模型？

Last updated: October 22, 2026

ZED SDK 提供用于深度估计（NEURAL LIGHT、神经和 NEURAL PLUS 深度模式）、目标检测与跟踪，以及人体检测与跟踪（骨骼跟踪）的 AI 模型。

由于 AI 模型体积较大，因此未包含在 ZED SDK 的安装程序中，但可以在安装过程中从我们的服务器下载，并针对主机设备上可用的 GPU 进行优化。

如果您决定不在安装 ZED SDK 的过程中下载和优化 AI 模型，则在首次使用所需 AI 模型时，ZED SDK 会自动执行该过程。

在以下情况下，必须手动清理和优化 AI 模型：

主机设备的 GPU 已被更换；
ZED SDK 已更新到新版本；
由于意外原因导致下载过程失败（例如断电、互联网连接中断等）；
由于意外原因导致优化过程停止；
ZED SDK 处理出现异常行为（例如 NEURAL 深度模式下深度图错误、目标检测错误、骨骼检测错误等）。

注意：下面介绍的所有操作也可以通过 ZED Diagnostics 工具的图形界面执行，方法是在完成诊断测试后点击 AI 模型按钮。请参阅 ZED Diagnostics 文档。在无头设备上（例如没有显示器的 NVIDIA® Jetson™），添加 -c选项以命令行模式运行该工具。

如何运行命令

打开 shell 控制台，并使用下表中所述的选项运行该工具。

Linux / NVIDIA® Jetson™（当前文件夹无关紧要）：
```
ZED_Diagnostic <option>
```
Windows（命令提示符或 PowerShell）：
```
cd "C:\Program Files (x86)\ZED SDK\tools"
& ".\ZED Diagnostic.exe" <option>
```
在命令提示符（cmd.exe）中，省略开头的 &："ZED Diagnostic.exe" <option>

将 <option> 替换为以下选项之一：

选项	操作
`-aic`	清理（删除）所有已下载和优化的 AI 模型；可用于释放磁盘空间，或在出现问题时重置优化
`-nrlo_light`	下载并优化 NEURAL LIGHT 深度模型
`-nrlo`	下载并优化 NEURAL 深度模型
`-nrlo_plus`	下载并优化 NEURAL PLUS 深度模型
`-nrlo_all`	下载并优化所有基于 AI 的深度模型
`-ais X`	下载并优化单个 AI 模型（请参阅下面的列表）
`-aid`	下载所有 AI 模型但不进行优化（适用于准备离线部署；稍后在目标设备上执行优化）
`-aio`	一步下载并优化所有 AI 模型（这可能需要一段时间）

下载并优化单个 AI 模型

使用 -ais X 选项，根据 sl::AI_MODELS 枚举，将 "X" 替换为整数：

0 - MULTI_CLASS_DETECTION：相关于 sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_FAST
1 - MULTI_CLASS_MEDIUM_DETECTION：相关于 sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_MEDIUM
2 - MULTI_CLASS_ACCURATE_DETECTION：相关于 sl::OBJECT_DETECTION_MODEL::MULTI_CLASS_BOX_ACCURATE
3 - HUMAN_BODY_FAST_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST
4 - HUMAN_BODY_MEDIUM_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM
5 - HUMAN_BODY_ACCURATE_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE
6 - HUMAN_BODY_38_FAST_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_FAST，使用 sl::BODY_FORMAT::BODY_38
7 - HUMAN_BODY_38_MEDIUM_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_MEDIUM，使用 sl::BODY_FORMAT::BODY_38
8 - HUMAN_BODY_38_ACCURATE_DETECTION：相关于 sl::BODY_TRACKING_MODEL::HUMAN_BODY_ACCURATE，使用 sl::BODY_FORMAT::BODY_38
9 - PERSON_HEAD_DETECTION：相关于 sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_FAST
10 - PERSON_HEAD_ACCURATE_DETECTION：相关于 sl::OBJECT_DETECTION_MODEL::PERSON_HEAD_BOX_ACCURATE
11 - REID_ASSOCIATION：相关于 sl::BatchParameters::enable
12 - NEURAL_LIGHT_DEPTH：相关于 sl::DEPTH_MODE::NEURAL_LIGHT
13 - NEURAL_DEPTH：相关于 sl::DEPTH_MODE::NEURAL
14 - NEURAL_PLUS_DEPTH：相关于 sl::DEPTH_MODE::NEURAL_PLUS

注意：数字 ID 按照 sl::AI_MODELS 枚举的顺序排列，并且可能会在不同的主要 ZED SDK 版本之间发生变化。请始终通过使用 -h 标志运行该工具，验证与您安装的 ZED SDK 版本匹配的列表。

有关所有可用 ZED Diagnostics 命令的更多信息，请使用 -h 标志，或参阅 ZED Diagnostics 文档。