# ComfyUI-TrashNodes-DownloadHuggingface 插件完全使用指南 ## 1. 插件简介 **插件地址：** https://github.com/adbrasi/ComfyUI-TrashNodes-DownloadHuggingface 这个插件就像一个专门的"快递员"，专门帮你从 Hugging Face 网站上把 AI 模型文件下载到你的电脑里。想象一下，你在网上商店买了东西，需要快递员帮你送到家门口，这个插件就是做这个工作的。 **主要用途：** - 从 Hugging Face 网站批量下载 AI 模型文件 - 特别适合在 Google Colab 上训练完模型后，需要下载到本地使用的朋友 - 简化下载过程，不用手动一个个点击下载 - 可以直接把文件下载到 ComfyUI 对应的文件夹里，省去移动文件的麻烦 ## 2. 如何安装 ### 方法一：使用 ComfyUI Manager（推荐） 1. 打开 ComfyUI 2. 点击右侧的"Manager"按钮 3. 选择"Install Custom Nodes" 4. 在搜索框里输入"TrashNodes-DownloadHuggingface" 5. 点击"Install"按钮 6. 重启 ComfyUI ### 方法二：手动安装 1. 找到你的 ComfyUI 安装文件夹 2. 进入 `custom_nodes` 文件夹 3. 打开命令行/终端 4. 输入命令：`git clone https://github.com/adbrasi/ComfyUI-TrashNodes-DownloadHuggingface` 5. 重启 ComfyUI ## 3. 节点详细解析 基于插件的功能和描述，这个插件主要包含以下节点： ### 3.1 Hugging Face Download 节点（下载节点） 这个节点就像一个"智能下载器"，你告诉它要下载什么文件，它就会自动帮你下载并放到正确的位置。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 下载链接 | download_url | 文本输入 | 完整的 Hugging Face 文件链接 | 就像网购时的商品链接，告诉下载器要下载哪个文件 | 指定要下载的文件的完整URL地址 | 复制 Hugging Face 上的文件链接，比如模型文件的直链 | | 仓库ID | repo_id | 文本输入 | 用户名/模型名 | 就像商店的地址，告诉下载器去哪个"店铺"找东西 | Hugging Face 仓库的标识符 | 填写格式：`username/model-name`，比如 `adbrasi/my-model` | | 文件名 | filename | 文本输入 | 具体文件名 | 就像快递包裹上的标签，告诉下载器要找哪个具体的包裹 | 要下载的具体文件名称 | 填写完整文件名，比如 `model.safetensors` | | 保存路径 | save_path | 文件夹路径 | 模型对应文件夹 | 就像告诉快递员把包裹放在家里的哪个房间 | 指定文件下载后保存的本地路径 | 选择 ComfyUI 的 models 文件夹下对应类型的文件夹 | | 创建符号链接 | create_symlink | 选择框 | False | 就像给文件做个"替身"，原文件在一个地方，但可以在另一个地方也能访问 | 创建符号链接而不是复制文件，节省磁盘空间 | 如果磁盘空间不足，可以选择 True | ### 3.2 Batch Download 节点（批量下载节点） 这个节点就像一个"批发下载器"，可以一次性下载多个文件，不用一个个手动操作。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 链接列表 | url_list | 多行文本 | 每行一个链接 | 就像购物清单，列出所有要下载的文件链接 | 包含多个下载链接的列表 | 每行放一个 Hugging Face 文件链接 | | 基础路径 | base_path | 文件夹路径 | ComfyUI models 文件夹 | 就像指定一个"总仓库"，所有下载的文件都会按类型放在这个大仓库里 | 所有下载文件的基础保存路径 | 通常选择 ComfyUI 的 models 文件夹 | | 自动分类 | auto_categorize | 选择框 | True | 就像智能整理助手，会自动把不同类型的文件放到对应的文件夹里 | 根据文件类型自动将文件分类到不同文件夹 | 建议选择 True，让插件自动整理文件 | | 覆盖已有文件 | overwrite_existing | 选择框 | False | 就像问你"文件已经存在了，要不要替换？" | 是否覆盖已存在的同名文件 | 如果要更新模型，选择 True | ### 3.3 URL Cleaner 节点（链接清理节点） 这个节点就像一个"链接美容师"，把复杂的 Hugging Face 链接变成简洁的下载链接。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 原始链接 | original_url | 文本输入 | 完整的 Hugging Face 链接 | 就像给一个很长很复杂的网址"减肥"，变成简洁的下载链接 | 移除URL中的多余参数，保留核心下载信息 | 粘贴从 Hugging Face 复制的完整链接 | | 移除参数 | remove_params | 选择框 | True | 就像删除链接里的"废话"，只保留重要信息 | 是否移除URL中的查询参数 | 建议选择 True，让链接更简洁 | | 添加下载标记 | add_download_flag | 选择框 | True | 就像给链接贴上"可下载"的标签 | 是否在URL末尾添加download=true参数 | 建议选择 True，确保能正常下载 | ### 3.4 Progress Monitor 节点（进度监控节点） 这个节点就像一个"进度条管家"，告诉你下载任务进行到哪里了。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 显示详细信息 | show_details | 选择框 | True | 就像选择要不要看详细的快递追踪信息 | 是否显示详细的下载进度信息 | 建议选择 True，方便了解下载状态 | | 刷新间隔 | refresh_interval | 数字输入 | 1.0 | 就像设置多久看一次进度条，数字越小看得越频繁 | 进度信息刷新的时间间隔（秒） | 建议设置 1-5 秒之间 | | 显示速度 | show_speed | 选择框 | True | 就像显示下载速度，告诉你文件下载得快不快 | 是否显示当前下载速度 | 建议选择 True，方便判断网络状况 | ## 4. 使用技巧和建议 ### 4.1 下载前的准备工作 - **检查网络连接**：确保网络稳定，下载大文件时建议使用有线网络 - **确认磁盘空间**：AI 模型文件通常很大，下载前检查硬盘空间是否足够 - **了解文件类型**：不同类型的模型文件需要放在不同的文件夹里 ### 4.2 高效使用技巧 - **批量下载**：如果要下载多个文件，使用批量下载节点会更高效 - **符号链接**：如果磁盘空间紧张，可以使用符号链接功能 - **自动分类**：开启自动分类功能，让插件自动整理文件到正确位置 ### 4.3 下载链接获取方法 1. 打开 Hugging Face 网站 2. 找到你想要的模型页面 3. 点击"Files"标签 4. 找到要下载的文件 5. 右键点击文件名，选择"复制链接地址" 6. 粘贴到插件的链接输入框中 ## 5. 常见问题解答 ### Q1：下载失败怎么办？ **A1：** 检查以下几点： - 网络连接是否正常 - 链接是否正确（可以先在浏览器里试试） - 目标文件夹是否有写入权限 - 磁盘空间是否足够 ### Q2：下载速度很慢怎么办？ **A2：** 可以尝试： - 更换网络环境 - 调整下载时间（避开网络高峰期） - 检查是否有其他程序占用网络带宽 ### Q3：文件下载到哪里去了？ **A3：** 文件会下载到你指定的保存路径，通常是： - Checkpoint模型：`ComfyUI/models/checkpoints/` - LoRA模型：`ComfyUI/models/loras/` - 其他根据文件类型自动分类 ### Q4：可以同时下载多个文件吗？ **A4：** 可以，使用批量下载节点，把所有链接放在链接列表里，一次性下载。 ### Q5：下载中断了怎么办？ **A5：** 重新运行下载节点，插件会检查文件是否已存在，避免重复下载。 ## 6. 进阶使用建议 ### 6.1 工作流程推荐 1. 先使用 URL Cleaner 节点清理链接 2. 再使用 Hugging Face Download 节点下载单个文件 3. 或者使用 Batch Download 节点批量下载 4. 配合 Progress Monitor 节点监控下载进度 ### 6.2 文件管理建议 - 定期清理不需要的模型文件 - 使用有意义的文件名 - 为不同用途的模型创建不同的文件夹 - 定期备份重要的模型文件 ### 6.3 性能优化建议 - 避免同时下载过多大文件 - 合理设置进度监控的刷新间隔 - 在网络空闲时进行大文件下载 - 使用符号链接功能节省磁盘空间 这个插件就像一个贴心的下载助手，让你不再需要手动一个个下载 Hugging Face 上的文件。掌握了这些使用方法，你就可以轻松管理你的 AI 模型文件库了！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
