> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型库 - 浏览本地模型

> 打开模型库侧栏，查找 ComfyUI models 目录下的 checkpoint 等模型，并拖放到画布。

左侧边栏的 **Models（模型）** 入口会打开模型库。ComfyUI 启动后，会列出 `ComfyUI/models`（以及你配置的额外模型路径）中检测到的模型文件夹与文件。可按名称搜索、按文件夹类型浏览、预览元数据，并把模型拖到画布以插入对应的加载节点。

不同版本的可用性有所不同：

* **自托管 / Desktop**：侧栏显示本地模型文件的文件夹树。在 Desktop 上，进行中的下载会出现在面板顶部，侧栏图标还可显示下载数量徽章。
* **Comfy Cloud**：当资产系统可用且 **Use the asset browser for the model library** 开启时（Cloud 默认），点击 **Models** 会打开模型的资产浏览器，而不是侧栏树。上传或导入自有权重见 [导入模型](/zh/cloud/import-models)。

媒体文件（图片、视频、音频、3D）不在此列出，它们位于 [资产](/zh/interface/assets)。

<img src="https://mintcdn.com/dripart/svxMC8DHZXobTT5E/images/interface/model-library/model_library.png?fit=max&auto=format&n=svxMC8DHZXobTT5E&q=85&s=45a85041be034c947ab6e8b6fe8092f9" alt="模型库侧栏，checkpoints 文件夹已展开，搜索框位于列表上方" width="624" height="1800" data-path="images/interface/model-library/model_library.png" />

## 打开模型库

点击左侧边栏的 **Models** 图标。面板标题为 **Model Library**。

## 按文件夹浏览

未输入搜索时，面板会列出根级模型文件夹（例如服务端返回的 `checkpoints`、`loras`、`vae`、`controlnet`、`diffusion_models`、`upscale_models`、`text_encoders` 等）。展开文件夹以加载其中的文件。

默认情况下，根文件夹在展开时才加载内容。可在设置中更改：

* **Automatically load all model folders**（`Comfy.ModelLibrary.AutoLoadAll`）：开启后，一打开模型库就会加载所有文件夹（大型库可能较慢）；关闭时（自托管默认），仅在展开文件夹时加载。此设置在 Comfy Cloud 上隐藏。
* **What name to display in the model library tree view**（`Comfy.ModelLibrary.NameFormat`）：`title`（默认）在有元数据时显示标题；`filename` 显示去掉目录与 `.safetensors` 扩展名后的简化文件名。

当资产功能开关关闭时，面板标题栏刷新按钮旁会出现 **Load all folders**。

## 搜索

顶部搜索框会按名称及相关可搜索字段过滤模型。搜索会加载全部文件夹以保证结果完整，结果树会自动展开。若匹配超过 500 个模型，面板会提示结果已截断；请缩小查询范围以查看其余项。

## 预览与刷新

悬停模型叶子节点可在有元数据时打开预览卡片，可能显示标题、文件名、架构、作者、预览图、用法提示、触发词与描述。

在 ComfyUI 运行期间增删模型文件后，请使用面板标题栏的刷新按钮，或按 `r`（`Comfy.RefreshNodeDefinitions`）。该刷新也会重载节点下拉列表，使加载器控件能识别新文件。

## 拖到画布

模型叶子节点可拖拽。拖到画布会创建该文件夹映射的加载节点（例如 `checkpoints` → `CheckpointLoaderSimple`，`loras` → `LoraLoader`，`vae` → `VAELoader`，`diffusion_models` → `UNETLoader`，`text_encoders` → `CLIPLoader`，以及前端注册的其他映射），并填入对应模型文件名。

若某文件夹类型没有已注册的加载映射，拖放可能不会创建节点。工作流缺少的模型仍会出现在 [右侧面板](/zh/interface/right-side-panel) 的 **Errors** 标签中，并在可用时提供下载或导入操作。

## 相关设置

| 设置 | 位置 | 作用 |
| - | - | - |
| Automatically load all model folders | `Comfy` → Model Library | 打开时加载全部文件夹，或展开时再加载 |
| Name format | `Comfy` → Model Library | 树中显示 `title` 或 `filename` |
| Use the asset browser for the model library | 实验性 / 面向 Cloud | 在资产启用时打开资产浏览器而非侧栏树 |

## 相关页面

* [界面概览](/zh/interface/overview)
* [资产](/zh/interface/assets)（媒体文件，不是模型权重）
* [导入模型](/zh/cloud/import-models)（Cloud）
* [右侧面板](/zh/interface/right-side-panel)（缺失模型错误）
* [Comfy 设置](/zh/interface/settings/comfy)（Model Library 部分）


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.