youxirenshengandClaude
99e219c55e
- Add ModelMetadataReader node for reading model metadata - Add ModelListReader node for listing models - Support multiple model types (loras, checkpoints, vae, etc.) - Extract metadata from safetensors files including download URLs - Add comprehensive README documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# ComfyUI Model Metadata Reader
|
||
|
||
ComfyUI 模型元数据读取插件，用于读取模型文件中的元数据信息，包括下载地址等。
|
||
|
||
## 功能
|
||
|
||
### 1. Model Metadata Reader（模型元数据读取器）
|
||
读取单个模型文件的详细元数据信息。
|
||
|
||
**输入:**
|
||
- `model_type`: 模型类型（checkpoints, loras, vae, controlnet等）
|
||
- `model_name`: 模型文件名
|
||
|
||
**输出:**
|
||
- `metadata_json`: 完整的元数据JSON字符串
|
||
- `download_url`: 模型下载地址
|
||
- `model_info`: 模型信息摘要
|
||
|
||
### 2. Model List Reader（模型列表读取器）
|
||
列出指定类型的所有可用模型。
|
||
|
||
**输入:**
|
||
- `model_type`: 模型类型
|
||
|
||
**输出:**
|
||
- `model_list`: 模型列表字符串
|
||
- `model_count`: 模型数量
|
||
|
||
## 支持的模型类型
|
||
|
||
- checkpoints（检查点）
|
||
- loras（LoRA模型）
|
||
- vae（VAE模型）
|
||
- controlnet（ControlNet模型）
|
||
- embeddings（嵌入模型）
|
||
- upscale_models（放大模型）
|
||
- clip_vision（CLIP视觉模型）
|
||
- diffusion_models（扩散模型）
|
||
- text_encoders（文本编码器）
|
||
|
||
## 支持的元数据字段
|
||
|
||
从 safetensors 文件中可以提取的元数据包括：
|
||
|
||
- 下载地址: `download_url`, `ss_download_url`, `modelspec.download_url`
|
||
- 模型信息: `modelspec.title`, `modelspec.description`, `modelspec.architecture`
|
||
- 训练参数: `ss_base_model_version`, `ss_resolution`, `ss_network_dim`, `ss_network_alpha`
|
||
- 以及其他所有存储在文件中的元数据
|
||
|
||
## 使用方法
|
||
|
||
1. 将插件放置在 `ComfyUI/custom_nodes/` 目录下
|
||
2. 重启 ComfyUI
|
||
3. 在节点菜单的 `utils/model` 分类下找到这两个节点
|
||
4. 添加到工作流中使用
|
||
|
||
## 示例
|
||
|
||
### 读取 LoRA 模型元数据
|
||
1. 添加 `Model Metadata Reader` 节点
|
||
2. 设置 `model_type` 为 `loras`
|
||
3. 输入模型文件名到 `model_name`
|
||
4. 查看输出的元数据信息
|
||
|
||
### 列出所有 checkpoint 模型
|
||
1. 添加 `Model List Reader` 节点
|
||
2. 设置 `model_type` 为 `checkpoints`
|
||
3. 查看输出的模型列表
|
||
|
||
## 注意事项
|
||
|
||
- 仅支持读取 safetensors 格式的模型文件元数据
|
||
- 其他格式（如 .ckpt, .pt）不包含可读取的元数据信息
|
||
- 元数据内容取决于模型训练时保存的信息
|