comfyui-node-installer

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. 检测缺失节点

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. 安装缺失节点

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. 搜索节点包

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 时自动修复

# 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")