WD14 Tagger模型手动下载与配置指南

1. WD14 Tagger模型手动下载方案解析

在图像处理工作流中，WD14 Tagger作为ComfyUI的重要插件，其自动下载功能常因网络问题失效。本文将详细介绍手动获取模型文件的完整方案，包含国内镜像站使用技巧、文件结构规范以及常见配置误区。

1.1 模型文件获取途径

国内开发者可通过镜像站点获取所需资源，推荐使用稳定更新的镜像源。具体操作步骤如下：

1. 访问镜像站点资源目录（示例链接已做脱敏处理）
2. 定位到模型版本目录（如wd-v1-4-moat-tagger-v2）
3. 下载两个核心文件：
   • 模型本体（.onnx格式）
   • 标签定义文件（原始名为selected_tags.csv）

注意：部分镜像站可能存在同步延迟，若发现文件版本不一致，可尝试切换其他镜像节点。建议优先下载文件校验值（SHA256）明确的资源包。

1.2 文件处理规范

下载后的文件需进行标准化处理才能被插件正确识别：

1. 重命名规则：

   • 模型文件保持原始名称（如wd-v1-4-moat-tagger-v2.onnx）
   • 标签文件必须同步更改为同名csv文件（如wd-v1-4-moat-tagger-v2.csv）

2. 目录结构要求：

bash复制ComfyUI/
└── custom_nodes/
    └── ComfyUI-WD14-Tagger/
        └── models/
            └── wd14_tagger/
                ├── wd-v1-4-moat-tagger-v2.onnx
                └── wd-v1-4-moat-tagger-v2.csv

2. 完整配置流程详解

2.1 文件下载实操

以Moat模型为例的分步指南：

1. 在镜像站找到目标模型的发布页面
2. 下载以下两个文件：
   • 模型文件（原始可能命名为model.onnx）
   • 标签文件（通常为selected_tags.csv）
3. 本地重命名：

   bash复制mv model.onnx wd-v1-4-moat-tagger-v2.onnx
   mv selected_tags.cs