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

# 模型

> 分发到你团队代理上的自定义 checkpoint、LoRA 和其它模型文件。

Cyberun Cloud 中的**模型**是一个文件（一个 checkpoint、一个 LoRA、一个嵌入、一个 ControlNet，或者某种自定义类型），由你的团队上传到平台。模型会被分发到符合条件的代理上，让工作流可以按名称引用它们。

如果本部署没有启用自定义模型，侧边栏不会出现 **Models** 条目。

## 模型记录包含什么

* **显示名称** ——展示在列表和参数选择器中的人类可读标签。最多 255 个字符。
* **类型** ——文件所属的 ComfyUI models 子目录（`checkpoints`、`loras`、`vae`、`controlnet`……）。最多 50 个字符的自由字符串——使用你的工作流期望的目录名。
* **路径** ——代理 ComfyUI models 目录下的相对路径（例如 `models/checkpoints/sdxl_base_1.0.safetensors`）。必填。不能是绝对路径，也不能包含 `..`。
* **大小和内容哈希** ——文件字节大小，加上一个内容哈希，上传时作为完整性元数据记录。
* **状态** —— `active`（默认；代理把它纳入同步集合）或 `disabled`（保留在目录中，但不参与同步）。

## 模型如何到达代理

当一个代理连接进来，且其所在团队拥有标记为 `active` 的模型时，代理会把每个文件拉到本地缓存。代理在下载过程中声明状态为 `syncing`（含每个文件的进度百分比）。派发到这个代理的任务会等待同步完成。

一旦缓存好，后续任务就复用本地副本。新代理上的第一个任务慢；后面的就不慢了。

你不需要手动推送。把模型上传到 **Models** 页面，下一个需要这个文件的代理会自行去拉取。

## 更新模型

模型记录中可编辑的元数据有**显示名称**、**类型**、**路径**和**状态**。修改它们不会改变文件字节——创建时上传的文件就是会分发到代理的文件。

要在同一个概念名称下发布不同字节，请上传一条新记录。要让某个模型不再同步又不删除它，把它的状态设为 `disabled`。

## 删除模型

从 Cloud 中删除该记录。代理可能在本地保留缓存文件直到它自行清理；新代理不会再看到这个模型。

## 相关

* [上传模型](/zh/cloud/guides/upload-model) ——演练。
* [自定义节点](/zh/cloud/concepts/nodes) ——分发自定义节点包，而不是模型文件。
* [工作流](/zh/cloud/concepts/workflows) ——模型被引用的地方。