comfyui-node-installer

Files (4)

• SKILL.md
• node-package-mapping.md · references/
• node_installer_impl.py · references/
• usage_examples.py · references/

SKILL.md (first lines)

# ComfyUI 节点安装器

> 自动检测 workflow 所需的自定义节点，并从 ComfyUI-Manager 或 GitHub 安装。

---

## 预注入变量

`run_python` 已注入以下变量，**直接使用，无需 import**：

| 变量 | 类型 | 说明 |
|------|------|------|
| `S` | `[]` | 无选中概念 |
| `W` | `None` | 无当前文件概念 |
| `L` | ComfyUI Lib | `L.nodes`, `L.folder_paths` |
| `nodes` | module | 节点注册表 |
| `client` | ComfyUIClient | HTTP API 客户端（含 Manager API） |

---

## 核心功能

### 1. 检测缺失节点

```python
from comfyui_node_installer import diagnose_workflow

# 诊断当前 workflow
wf = {...}  # workflow JSON
report = diagnose_workflow(wf)

print(report)
# {
#   "status": "missing_found",
#   "missing_count": 3,
#   "missing": [
#     {
#       "node_id": "15",
#       "node_type": "ComfyrollStudio",
#       "package": "ComfyUI_Comfyroll_CustomNodes",
#       "install_url": "https://github.com/Suzie1/ComfyUI_Comfyroll_CustomNodes"
#     },
#     ...
#   ],
#   "available": [...],
#   "suggestions": [...]
# }
```

### 2. 安装缺失节点

```python
from comfyui_node_installer import install_missing_nodes

# 自动安装所有缺失节点
result = install_missing_nodes(wf)
print(result)
# {
#   "success": True,
#   "installed": ["ComfyUI_Comfyroll_CustomNodes"],
#   "failed": [],
#   "reboot_required": True  # 需要重启 ComfyUI
# }
```

### 3. 搜索节点包

```python
from comfyui_node_installer import search_packages

# 搜索节点包
results = search_packages("controlnet")
print(results)
# [
#   {
#     "title": "ComfyUI ControlNet Aux",
#     "reference": "https://github.com/Fannovel16/comfyui_controlnet_aux",
#     "author": "Fannovel16",
#     "install_type": "git-clone",
#     "description": "Preprocessors for ControlNet"
#   },
#   ...
# ]
```

---

## 完整使用流程

### 场景1: 加载 workflow 时自动修复

```python
# 1. 加载 workflow
wf = load_template("marketplace/awesome-portrait-v2")

# 2. 诊断缺失节点
diagnosis = diagnose_workflow(wf)

if diagnosis["missing_count"] > 0:
    print(f"发现 {diagnosis['missing_count']} 个缺失节点:")
    for m in diagnosis["missing"]:
        print(f"  - {m['node_type']} (来自: {m['package']})")
    
    # 3. 询问用户是否安装（或自动安装）
    result = install_missing_nodes(wf, auto_install=True)
    
    if result["reboot_required"]:
        print("⚠️ 需要重启 ComfyUI 才能使用新节点")
        print("请重启后重新加载此 workflow")
```

### 场景2: 手动安装特定节点包

```python
from comfyui_node_installer import install_package

# 通过 Git URL 安装
result = install_package(
    url="https://github.com/Fannovel16/comfyui_controlnet_aux",

From IvanYangYangXi/artclaw_bridge, MIT.

More from IvanYangYangXi/artclaw_bridge