上传模型

本页讲解自定义模型的上传流程。关于概念概览见 模型。侧边栏必须出现 模型 入口 —— 如果没有，说明此部署在你的部署上未提供自定义模型。

​

开始之前

• 你要上传的本地文件。
• 一个你所属的团队。任何成员都可以上传。

​

上传

1. 打开侧边栏中的 模型。
2. 点击 上传模型。
3. 选择文件。
4. 填写元数据：

   字段	说明
   显示名	在参数选择器中显示的人类可读标签。最多 255 个字符。
   类型	ComfyUI 模型子目录的名称 —— checkpoints、loras、vae、controlnet，… 自由字符串，最多 50 个字符；选择你的工作流所期望的目录。
   路径	必填。代理的 ComfyUI 模型目录内的相对路径（例如 models/checkpoints/sdxl_base_1.0.safetensors）。不能是绝对路径，也不能包含 ..。

5. 点击 上传。控制台会上传文件并注册该记录；随后它会出现在列表中。

​

接下来会发生什么

文件会保存在平台存储中。每个标签集匹配且所在团队拥有该模型的代理 都会把它拉到本地缓存。代理在下载期间会上报 syncing。一旦缓存完成，该代理上的后续任务会重用本地副本。 你不需要把文件推到任何特定的机器上。

​

编辑或删除

从某个模型所在行：

• 编辑 —— 修改显示名、类型、路径或状态 （active / disabled）。文件字节本身不会通过 编辑替换；如需推送不同的字节请上传新的记录。
• 删除 —— 移除该记录。代理会保留本地的缓存文件 直到自行驱逐；新加入的代理则不会再看到它。

​

批量删除

在列表中多选行，并使用批量操作栏。

​

故障排查

上传成功但工作流找不到模型 —— 确认 路径 与 工作流参数所期望的相符。该路径正是代理相对其 ComfyUI 模型目录所看到的路径。 代理一直停在 syncing —— 代理在首次使用时正在下载该模型。 后续运行很快。

​

相关

• 模型 —— 概念。
• 自定义节点 —— 节点包采用相同模式。
• 工作流 —— 模型在哪里被引用。