> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 模型

> 直接在 IDE 中浏览、下载、分析和管理适用于 Qualcomm® 设备的 AI 模型。

## 概述

**AI 模型**部分让您可以浏览 Qualcomm AI Hub 模型目录，将模型下载到主机、烧录到活动设备并进行性能分析 — 全程无需离开 VS Code。

AI 模型部分有两个标签页：

* **MY MODELS** — 已下载到主机的模型
* **EXPLORE MODELS** — 完整的 Qualcomm AI Hub 模型目录

活动设备显示在 AI 模型页面的右上角。

***

## 我的模型

尚未下载任何模型时，**MY MODELS** 会显示带有 **Explore Models** 按钮的空状态：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_my_models_empty.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=44bc82ead5064a88e9baabe849fa724a" alt="AI 模型 — 我的模型空状态" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_my_models_empty.png" />

下载模型后，每行会显示模型名称、标签（任务、精度、运行时、支持的平台）、本地文件路径以及 **Profile** / **Flash** 操作按钮。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_downloaded.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=a88dcf55d9aec0e0911976b040657d65" alt="AI 模型 — 已下载的模型及其文件路径和操作按钮" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_downloaded.png" />

***

## 探索模型

**EXPLORE MODELS** 标签页以按类别分组的卡片网格形式展示 AI Hub 模型目录（例如 Computer Vision、Generative AI、Multimodal）。每个类别标题显示可用模型总数和 **View All** 链接。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_explore_models.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=61233ee3a331cc6f3a2f744f3d15f04d" alt="AI 模型 — 带类别网格的探索模型标签页" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_explore_models.png" />

每张卡片显示：

* 带任务徽章的预览图（例如 Image Classification、Text Generation）
* 模型名称和简短描述
* **Download** 和 **View Details** 操作按钮

### 过滤目录

使用网格上方的 **Device** 和 **Task** 过滤下拉菜单来缩小结果范围。

点击 **Device** 会打开一个包含搜索框和设备芯片选择器的模态框（例如 RB3 Gen2 Vision Kit、IQ-9075 Evaluation Kit、IQ-8275 Evaluation Kit Pro）。选择一个或多个设备，然后点击 **Apply Filter**。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_filter_device.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=3332b6509da2027f2d1d74c39ba10e7e" alt="AI 模型 — 设备过滤模态框" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_filter_device.png" />

点击 **Task** 会打开一个类似的模态框，其中包含任务芯片选择器（例如 Depth Estimation、Image Classification、Image Editing、Object Detection、Pose Estimation、Semantic Segmentation、Speech Recognition、Super Resolution）。选择一个或多个任务，然后点击 **Apply Filter**。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_filter_task.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=3337c6aba565ee3794ec36912c9a8e06" alt="AI 模型 — 任务过滤模态框" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_filter_task.png" />

***

## 模型详情页

在任意目录卡片上点击 **View Details** 打开模型详情页。您也可以在 **MY MODELS** 中点击模型名称进入此页面。

面包屑导航显示导航路径：

* 从 **Explore Models** 进入：`Explore Models > <Category> > <Model Name>`
* 从 **My Models** 进入：`My Models > <Model Name>`

从 **Explore Models** 进入的详情页会显示完整的基准测试表，其中列出各支持设备上每种精度/运行时组合：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_explore_detail.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=d669a8ae1d83b7349d532e8264721203" alt="AI 模型 — 带完整基准测试表的探索模型详情页" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_explore_detail.png" />

从 **MY MODELS** 进入的详情页会同时显示基准测试结果和性能分析结果列：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_model_detail.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=b1e37d2f186615ffbb8cd10e30319d49" alt="AI 模型 — 带基准测试和性能分析结果的我的模型详情页" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_model_detail.png" />

详情页包括：

* 模型名称、任务徽章和描述
* 版本、**Model Repository** 链接和 **Research Paper** 链接
* **Download** 按钮
* 带 **Device** 选择器的 **Results** 表格
* **Technical Details** — 模型检查点、输入分辨率、参数数量、模型大小
* **Supported Devices** — 兼容开发套件列表
* **Applicable Scenarios** — 建议的使用场景
* **Licenses** — 源模型许可证

***

## 下载模型

### 开始下载

在目录卡片或模型详情页上点击 **Download**。在 **Download Model** 对话框中，选择所需的 **Precision**、**Float** 和 **Runtime** 值，然后点击 **Start Download**。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_download_dialog.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=e86f5efb2893100672663b196c165236" alt="AI 模型 — 下载模型对话框" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_download_dialog.png" />

### 下载进度

下载期间，该模型会以 **Downloading…** 标签和进度条的形式出现在 **MY MODELS** 中：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_downloading.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=be2b34bac27815bc7a33cc2b74c0a2f8" alt="AI 模型 — 下载进行中" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_downloading.png" />

下载完成后，弹出通知确认：*"\<Model> downloaded successfully."* 模型行会更新以显示其本地文件路径以及 **Profile** 和 **Flash** 操作按钮。

***

## 分析模型

**MY MODELS** 中的每个模型行都有一个 **Profile** 分体式按钮。点击下拉箭头（▾）可从四个选项中选择：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_dropdown.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=7014206eef29cc736d1b2b40ff8398aa" alt="AI 模型 — Profile 分体式按钮下拉菜单" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_dropdown.png" />

| 选项 | 说明 |
| - | - |
| **Profile in AI Hub** | 在云端运行模型以分析性能 |
| **Profile on active device** | 在已连接的设备上运行模型以分析性能 |
| **View profiling results** | 打开性能分析结果页面 |

### 在活动设备上分析

选择 **Profile on active device** 会启动本地性能分析。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_local_progress.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=512c5462fd83b4b49a9f49bd7d91acc0" alt="AI 模型 — 正在将基准测试模型推送到设备" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_local_progress.png" />

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_running.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=b6986381a87c908a6dbded4a65320590" alt="AI 模型 — 正在设备上运行测量" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_running.png" />

完成后，弹出通知确认：*"AOT-GAN profiled locally on IQ-8075 Evaluation Kit."*

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_done.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=84920d389f36d390ff4d1670b9a1657f" alt="AI 模型 — 本地性能分析完成" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_done.png" />

<Note>
  使用 **Profile on active device** 前必须设置活动设备。有关设置说明，请参阅
  [设备](../development/devices)。
</Note>

### 在 AI Hub 中分析

#### AI Hub 令牌

首次在 AI Hub 中分析模型时，扩展会提示您输入 AI Hub 令牌：

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_hub_token.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=028eda4cddf8a41aca677a911a4d38f6" alt="AI 模型 — 输入 AI Hub 令牌提示" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_hub_token.png" />

从 [aihub.qualcomm.com/account](https://aihub.qualcomm.com/account) 粘贴您的令牌，然后按 **Enter** 确认或按 **Escape** 取消。

选择 **Profile in AI Hub** 会打开一个侧边面板来配置云端分析作业。从下拉菜单中选择 **Device Type**，然后点击 **Start Profile**。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_hub_dialog.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=3d23298efcb7a2f0c57427e0d2fbd05c" alt="AI 模型 — 在 AI Hub 中分析侧边面板" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_hub_dialog.png" />

通知面板确认作业已创建：*"Profile job created on AI Hub. Results may take a while"* 和 *"Starting profiling on AI Hub."*

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_hub_started.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=9e7d700509cdf8567361e738482320a7" alt="AI 模型 — AI Hub 分析作业已启动通知" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_hub_started.png" />

### 查看性能分析结果

选择 **View profiling results** 可从模型详情视图打开结果页面。面包屑导航显示 `My Models > <Model Name>`。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_profile_results.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=bbc295b33b8f5794899bba1d28aa9382" alt="AI 模型 — 包含全部三列结果的性能分析结果页面" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_profile_results.png" />

结果表头显示用于分析的 Component、Precision、Runtime 和 Device。各列显示来自所有可用来源的结果：

| 列 | 说明 |
| - | - |
| **Benchmark Results** | 该模型已发布的 AI Hub 参考值 |
| **Profile Results – AI Hub** | 来自云端 AI Hub 分析作业的值 |
| **Profile Results – Active Device** | 在本地连接的设备上测量的值 |

**Profile Results** 列中的每个值都有一个彩色箭头，表示相对于基准的性能：

* **红色** — 比基准差
* **绿色** — 比基准好

每列中的 **More Details** 链接会打开完整的 AI Hub 性能分析报告。

***

## 将模型烧录到设备

在 **MY MODELS** 的模型行上点击 **Flash**，将模型推送到活动设备。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_flash_transfer.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=27db8306a74b06456d9656538cb7c0bc" alt="AI 模型 — 正在将模型文件传输到设备" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_flash_transfer.png" />

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_flash_model.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=e03a4ba2cf72be7266069e5b1d1626c1" alt="AI 模型 — 正在推送模型到设备并显示进度条" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_flash_model.png" />

完成后，弹出通知确认：*"AOT-GAN model pushed to IQ-8075 Evaluation Kit successfully."*

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_flash_pushed.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=e8f30280f81e4b1b1a4afd74cfef40f1" alt="AI 模型 — 模型推送成功并显示 Pushed 徽章" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_flash_pushed.png" />

<Note>
  烧录前必须设置活动设备。活动设备显示在 AI 模型页面的右上角。有关设置说明，请参阅
  [设备](../development/devices)。
</Note>

***

## 移除模型

点击 **MY MODELS** 中模型行右侧的 **⋮** 溢出菜单，选择 **Remove**，即可从主机上删除该模型及其所有性能分析结果。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/aimodels_remove.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=bac7071d7ed9f343e104855ab98fd49c" alt="AI 模型 — 溢出菜单中的移除选项" width="2560" height="1440" data-path="Tools/QVSCE/images/aimodels_remove.png" />

<Warning>
  **Remove** 会删除本地模型文件和所有关联的性能分析结果。
  该模型可以从 **Explore Models** 标签页重新下载。
</Warning>
