ComfyUI Manager 无法显示/安装失败？10 个排查思路一次解决

"ComfyUI Manager按钮不见了"、"Manager安装后没反应"、"节点列表显示空白"——这些问题是不是很眼熟？作为ComfyUI生态中最重要的插件管理工具，ComfyUI Manager的安装和使用问题困扰着无数用户。

从环境配置到网络连接，从依赖冲突到权限问题，ComfyUI Manager的故障原因多种多样。但好消息是，99%的问题都有标准化的解决方案。本文将系统性地分析所有常见故障，并提供"复制即用"的诊断脚本。

重点内容：10大类常见故障的诊断思路、自动化排查脚本、预防措施，以及备用的云端解决方案。

ComfyUI Manager 故障类型分析

在深入具体解决方案之前，我们先了解ComfyUI Manager故障的主要类型：

🔍 故障分类总览

📊 问题出现频率统计

基于社区反馈的问题频率分析：

故障排查思路1：界面显示问题

"Manager按钮不见了"是最常见的问题之一。

🔧 排查步骤详解

步骤1：验证安装完整性

# 检查Manager目录结构
ls -la custom_nodes/ComfyUI-Manager/

# 应该包含以下关键文件：
# - __init__.py
# - manager.py  
# - requirements.txt
# - web/
# - js/

步骤2：检查加载日志

# 启动ComfyUI并捕获Manager相关日志
import subprocess
import re

def check_manager_loading():
    """检查Manager加载日志"""
    
    # 启动ComfyUI并捕获日志
    process = subprocess.Popen(
        ['python', 'main.py', '--cpu'],
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        text=True
    )
    
    manager_logs = []
    timeout = 30  # 30秒超时
    
    try:
        stdout, stderr = process.communicate(timeout=timeout)
        all_logs = stdout + stderr
        
        # 查找Manager相关日志
        for line in all_logs.split('\n'):
            if 'manager' in line.lower() or 'custom_nodes' in line.lower():
                manager_logs.append(line)
        
        return manager_logs
        
    except subprocess.TimeoutExpired:
        process.kill()
        return ["启动超时，可能存在严重问题"]

# 运行检查
logs = check_manager_loading()
for log in logs:
    print(log)

步骤3：手动重新安装

# 完全清理后重新安装
rm -rf custom_nodes/ComfyUI-Manager

# 重新克隆
git clone https://github.com/ltdrdata/ComfyUI-Manager.git custom_nodes/ComfyUI-Manager

# 安装依赖
cd custom_nodes/ComfyUI-Manager
pip install -r requirements.txt

# 验证安装
python -c "import manager; print('Manager导入成功')"

故障排查思路2：安装失败问题

安装失败通常与网络连接或环境配置有关。

🌐 网络连接诊断

Git连接测试脚本

#!/usr/bin/env python3
"""
ComfyUI Manager网络连接诊断脚本
"""
import subprocess
import requests
import time

def test_git_connectivity():
    """测试Git连接性"""
    
    test_results = {}
    
    # 1. 测试GitHub基本连接
    try:
        response = requests.get("https://github.com", timeout=10)
        test_results["github_web"] = "✅ 可访问" if response.status_code == 200 else "❌ 不可访问"
    except Exception as e:
        test_results["github_web"] = f"❌ 连接失败: {str(e)}"
    
    # 2. 测试GitHub API
    try:
        response = requests.get("https://api.github.com", timeout=10)
        test_results["github_api"] = "✅ 可访问" if response.status_code == 200 else "❌ 不可访问"
    except Exception as e:
        test_results["github_api"] = f"❌ 连接失败: {str(e)}"
    
    # 3. 测试Git克隆
    try:
        cmd = ["git", "ls-remote", "https://github.com/ltdrdata/ComfyUI-Manager.git"]
        result = subprocess.run(cmd, capture_output=True, text=True, timeout=30)
        test_results["git_clone"] = "✅ 可克隆" if result.returncode == 0 else "❌ 克隆失败"
    except Exception as e:
        test_results["git_clone"] = f"❌ 测试失败: {str(e)}"
    
    return test_results

def print_connectivity_report():
    """打印连接性报告"""
    print("=== ComfyUI Manager 网络连接诊断 ===\n")
    
    results = test_git_connectivity()
    
    for test_name, result in results.items():
        print(f"{test_name}: {result}")
    
    # 提供解决建议
    failed_tests = [k for k, v in results.items() if "❌" in v]
    
    if failed_tests:
        print(f"\n❌ 发现 {len(failed_tests)} 个连接问题")
        print("\n建议解决方案：")
        print("1. 检查网络代理设置")
        print("2. 尝试使用镜像源")
        print("3. 考虑使用云端API服务")
        
        # 提供云端API建议
        print("\n🚀 云端替代方案：")
        print("如果网络问题无法解决，可以使用云端API：")
        print("- API易等平台提供ComfyUI云端服务")
        print("- 无需本地安装Manager，直接使用云端节点")
    else:
        print("\n✅ 网络连接正常，问题可能在其他方面")

if __name__ == "__main__":
    print_connectivity_report()

🔧 镜像源配置

如果GitHub访问有问题，可以配置镜像源：

# 配置Git镜像源
git config --global url."https://gitclone.com/github.com/".insteadOf "https://github.com/"

# 或使用其他镜像
git config --global url."https://hub.fastgit.xyz/".insteadOf "https://github.com/"

# 临时使用镜像下载Manager
git clone https://gitclone.com/github.com/ltdrdata/ComfyUI-Manager.git custom_nodes/ComfyUI-Manager

故障排查思路3：依赖环境问题

依赖问题是导致Manager无法正常工作的主要原因之一。

📦 依赖检查脚本

#!/usr/bin/env python3
"""
ComfyUI Manager依赖环境检查脚本
"""
import sys
import subprocess
import importlib
import os

def check_python_version():
    """检查Python版本"""
    version = sys.version_info
    print(f"Python版本: {version.major}.{version.minor}.{version.micro}")
    
    if version.major != 3:
        return False, "需要Python 3.x版本"
    
    if version.minor < 8:
        return False, "建议使用Python 3.8及以上版本"
    
    if version.minor > 11:
        return False, "Python 3.12可能存在兼容性问题，建议使用3.8-3.11"
    
    return True, "Python版本兼容"

def check_git_installation():
    """检查Git安装"""
    try:
        result = subprocess.run(['git', '--version'], 
                              capture_output=True, text=True)
        if result.returncode == 0:
            version = result.stdout.strip()
            return True, f"Git已安装: {version}"
        else:
            return False, "Git命令执行失败"
    except FileNotFoundError:
        return False, "Git未安装"

def check_required_packages():
    """检查必需的Python包"""
    required_packages = [
        'requests',
        'gitpython', 
        'aiohttp',
        'websockets'
    ]
    
    results = {}
    
    for package in required_packages:
        try:
            module = importlib.import_module(package)
            version = getattr(module, '__version__', 'unknown')
            results[package] = f"✅ 已安装 (v{version})"
        except ImportError:
            results[package] = "❌ 未安装"
    
    return results

def check_file_permissions():
    """检查文件权限"""
    custom_nodes_path = "custom_nodes"
    
    if not os.path.exists(custom_nodes_path):
        return False, "custom_nodes目录不存在"
    
    # 检查读写权限
    if not os.access(custom_nodes_path, os.R_OK | os.W_OK):
        return False, "custom_nodes目录权限不足"
    
    return True, "文件权限正常"

def main():
    """主检查函数"""
    print("=== ComfyUI Manager 依赖环境检查 ===\n")
    
    # 1. Python版本检查
    py_ok, py_msg = check_python_version()
    print(f"Python版本: {'✅' if py_ok else '❌'} {py_msg}")
    
    # 2. Git检查
    git_ok, git_msg = check_git_installation()
    print(f"Git安装: {'✅' if git_ok else '❌'} {git_msg}")
    
    # 3. Python包检查
    print("\nPython依赖包:")
    package_results = check_required_packages()
    for package, status in package_results.items():
        print(f"  {package}: {status}")
    
    # 4. 权限检查
    perm_ok, perm_msg = check_file_permissions()
    print(f"\n文件权限: {'✅' if perm_ok else '❌'} {perm_msg}")
    
    # 5. 生成修复建议
    issues = []
    if not py_ok:
        issues.append("Python版本问题")
    if not git_ok:
        issues.append("Git未安装")
    if "❌" in str(package_results.values()):
        issues.append("Python包缺失")
    if not perm_ok:
        issues.append("权限问题")
    
    if issues:
        print(f"\n❌ 发现 {len(issues)} 个问题需要修复")
        print("\n修复建议:")
        
        if not git_ok:
            print("- 安装Git: https://git-scm.com/downloads")
        
        missing_packages = [k for k, v in package_results.items() if "❌" in v]
        if missing_packages:
            print(f"- 安装缺失包: pip install {' '.join(missing_packages)}")
        
        if not perm_ok:
            print("- 检查目录权限，可能需要管理员权限")
        
        print("\n🚀 替代方案:")
        print("考虑使用云端API服务，避免本地环境配置问题")
        
    else:
        print("\n✅ 依赖环境检查通过")

if __name__ == "__main__":
    main()

故障排查思路4：权限与文件系统问题

特别是Windows用户，经常遇到权限相关的问题。

🔒 Windows权限修复

# Windows PowerShell权限修复脚本
# 需要以管理员身份运行

# 1. 检查当前用户权限
whoami /priv

# 2. 为ComfyUI目录设置完全控制权限
$comfyui_path = "C:\path\to\ComfyUI"
icacls $comfyui_path /grant Users:F /T

# 3. 添加到Windows Defender排除列表
Add-MpPreference -ExclusionPath $comfyui_path

# 4. 临时禁用实时保护（谨慎使用）
# Set-MpPreference -DisableRealtimeMonitoring $true

Write-Host "权限修复完成，请重新尝试安装Manager"

🐧 Linux权限修复

#!/bin/bash
# Linux权限修复脚本

COMFYUI_DIR="$(pwd)"

echo "修复ComfyUI Manager权限问题..."

# 1. 修复目录权限
chmod -R 755 "$COMFYUI_DIR"
chmod -R 644 "$COMFYUI_DIR"/*.py
chmod -R 644 "$COMFYUI_DIR"/*.txt

# 2. 修复custom_nodes权限
if [ -d "custom_nodes" ]; then
    chmod -R 755 custom_nodes/
    chown -R $USER:$USER custom_nodes/
fi

# 3. 检查Python执行权限
which python3
python3 --version

# 4. 检查Git权限
git config --global --list

echo "权限修复完成"

故障排查思路5：缓存与配置文件问题

缓存损坏或配置错误也会导致Manager异常。

🧹 缓存清理脚本

#!/usr/bin/env python3
"""
ComfyUI Manager缓存清理脚本
"""
import os
import shutil
import json

def clean_manager_cache():
    """清理Manager相关缓存"""
    
    cache_paths = [
        "custom_nodes/ComfyUI-Manager/__pycache__",
        "custom_nodes/ComfyUI-Manager/.git/index.lock",
        "custom_nodes/ComfyUI-Manager/temp",
        "custom_nodes/ComfyUI-Manager/downloads",
        ".comfyui_manager_cache"
    ]
    
    cleaned = []
    errors = []
    
    for path in cache_paths:
        try:
            if os.path.exists(path):
                if os.path.isfile(path):
                    os.remove(path)
                    cleaned.append(f"删除文件: {path}")
                elif os.path.isdir(path):
                    shutil.rmtree(path)
                    cleaned.append(f"删除目录: {path}")
        except Exception as e:
            errors.append(f"清理失败 {path}: {str(e)}")
    
    return cleaned, errors

def reset_manager_config():
    """重置Manager配置"""
    
    config_files = [
        "custom_nodes/ComfyUI-Manager/config.ini",
        "custom_nodes/ComfyUI-Manager/settings.json"
    ]
    
    reset_files = []
    
    for config_file in config_files:
        if os.path.exists(config_file):
            # 备份原配置
            backup_file = config_file + ".backup"
            shutil.copy2(config_file, backup_file)
            
            # 删除原配置让其重新生成
            os.remove(config_file)
            reset_files.append(config_file)
    
    return reset_files

def main():
    """主清理函数"""
    print("=== ComfyUI Manager 缓存清理 ===\n")
    
    # 1. 清理缓存
    print("正在清理缓存文件...")
    cleaned, errors = clean_manager_cache()
    
    for item in cleaned:
        print(f"✅ {item}")
    
    for error in errors:
        print(f"❌ {error}")
    
    # 2. 重置配置
    print("\n正在重置配置文件...")
    reset_files = reset_manager_config()
    
    for file in reset_files:
        print(f"✅ 重置配置: {file}")
    
    # 3. 清理Python缓存
    print("\n正在清理Python缓存...")
    os.system("find . -name '*.pyc' -delete")
    os.system("find . -name '__pycache__' -type d -exec rm -rf {} +")
    
    print("\n🎉 缓存清理完成！")
    print("建议重启ComfyUI以应用更改")

if __name__ == "__main__":
    main()

故障排查思路6-10：综合诊断脚本

为了简化排查过程，我们提供一个综合诊断脚本：

🔍 一键诊断工具

#!/usr/bin/env python3
"""
ComfyUI Manager 综合故障诊断工具
自动检测并提供修复建议
"""
import os
import sys
import subprocess
import json
import requests
import shutil
from datetime import datetime

class ComfyUIManagerDiagnostic:
    def __init__(self):
        self.issues = []
        self.suggestions = []
        self.comfyui_path = os.getcwd()
        self.manager_path = os.path.join(self.comfyui_path, "custom_nodes", "ComfyUI-Manager")
    
    def log_issue(self, category, description, severity="medium"):
        """记录问题"""
        self.issues.append({
            "category": category,
            "description": description,
            "severity": severity,
            "timestamp": datetime.now().isoformat()
        })
    
    def add_suggestion(self, suggestion):
        """添加修复建议"""
        self.suggestions.append(suggestion)
    
    def check_installation(self):
        """检查1: Manager安装完整性"""
        print("🔍 检查1: Manager安装完整性")
        
        if not os.path.exists(self.manager_path):
            self.log_issue("安装", "ComfyUI Manager目录不存在", "high")
            self.add_suggestion("重新安装Manager: git clone https://github.com/ltdrdata/ComfyUI-Manager.git custom_nodes/ComfyUI-Manager")
            return False
        
        required_files = [
            "__init__.py",
            "manager.py", 
            "requirements.txt"
        ]
        
        missing_files = []
        for file in required_files:
            if not os.path.exists(os.path.join(self.manager_path, file)):
                missing_files.append(file)
        
        if missing_files:
            self.log_issue("安装", f"关键文件缺失: {', '.join(missing_files)}", "high")
            self.add_suggestion("重新下载完整的Manager文件")
            return False
        
        print("✅ Manager文件完整")
        return True
    
    def check_dependencies(self):
        """检查2: 依赖环境"""
        print("🔍 检查2: 依赖环境")
        
        # Python版本
        version = sys.version_info
        if version.major != 3 or version.minor < 8 or version.minor > 11:
            self.log_issue("环境", f"Python版本不兼容: {version.major}.{version.minor}.{version.micro}", "high")
            self.add_suggestion("使用Python 3.8-3.11版本")
        else:
            print(f"✅ Python版本: {version.major}.{version.minor}.{version.micro}")
        
        # Git检查
        try:
            result = subprocess.run(['git', '--version'], capture_output=True, text=True)
            if result.returncode == 0:
                print(f"✅ Git: {result.stdout.strip()}")
            else:
                self.log_issue("环境", "Git执行失败", "high")
        except FileNotFoundError:
            self.log_issue("环境", "Git未安装", "high")
            self.add_suggestion("安装Git: https://git-scm.com/downloads")
    
    def check_network(self):
        """检查3: 网络连接"""
        print("🔍 检查3: 网络连接")
        
        try:
            response = requests.get("https://github.com", timeout=10)
            if response.status_code == 200:
                print("✅ GitHub连接正常")
            else:
                self.log_issue("网络", f"GitHub访问异常: {response.status_code}", "medium")
        except Exception as e:
            self.log_issue("网络", f"GitHub无法访问: {str(e)}", "medium")
            self.add_suggestion("配置代理或使用镜像源")
            self.add_suggestion("考虑使用云端API服务（如API易平台）")
    
    def check_permissions(self):
        """检查4: 文件权限"""
        print("🔍 检查4: 文件权限")
        
        custom_nodes_path = os.path.join(self.comfyui_path, "custom_nodes")
        
        if not os.path.exists(custom_nodes_path):
            self.log_issue("权限", "custom_nodes目录不存在", "high")
            return
        
        if not os.access(custom_nodes_path, os.R_OK | os.W_OK):
            self.log_issue("权限", "custom_nodes目录权限不足", "high")
            self.add_suggestion("修复目录权限: chmod -R 755 custom_nodes/")
        else:
            print("✅ 文件权限正常")
    
    def check_conflicts(self):
        """检查5: 节点冲突"""
        print("🔍 检查5: 节点冲突检测")
        
        custom_nodes_dir = os.path.join(self.comfyui_path, "custom_nodes")
        if not os.path.exists(custom_nodes_dir):
            return
        
        node_dirs = [d for d in os.listdir(custom_nodes_dir) 
                    if os.path.isdir(os.path.join(custom_nodes_dir, d))]
        
        print(f"✅ 检测到 {len(node_dirs)} 个自定义节点")
        
        # 检查重复节点
        duplicate_check = {}
        for node_dir in node_dirs:
            key = node_dir.lower().replace('-', '').replace('_', '')
            if key in duplicate_check:
                self.log_issue("冲突", f"可能的重复节点: {node_dir} 和 {duplicate_check[key]}", "medium")
            else:
                duplicate_check[key] = node_dir
    
    def upload_logs(self):
        """检查6: 上传日志到云端分析（示例）"""
        print("🔍 检查6: 日志分析")
        
        if not self.issues:
            print("✅ 未发现问题")
            return
        
        # 生成诊断报告
        report = {
            "timestamp": datetime.now().isoformat(),
            "system": {
                "platform": sys.platform,
                "python_version": f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
            },
            "issues": self.issues,
            "suggestions": self.suggestions
        }
        
        # 保存本地报告
        report_file = "comfyui_manager_diagnostic.json"
        with open(report_file, 'w', encoding='utf-8') as f:
            json.dump(report, f, indent=2, ensure_ascii=False)
        
        print(f"📊 诊断报告已保存: {report_file}")
        
    
    def run_full_diagnostic(self):
        """运行完整诊断"""
        print("=== ComfyUI Manager 综合故障诊断 ===\n")
        
        self.check_installation()
        self.check_dependencies()
        self.check_network()
        self.check_permissions()
        self.check_conflicts()
        self.upload_logs()
        
        # 生成诊断总结
        print(f"\n=== 诊断总结 ===")
        
        if not self.issues:
            print("🎉 未发现任何问题！Manager应该可以正常工作")
            return
        
        # 按严重程度分类
        high_issues = [i for i in self.issues if i["severity"] == "high"]
        medium_issues = [i for i in self.issues if i["severity"] == "medium"]
        
        if high_issues:
            print(f"❌ 发现 {len(high_issues)} 个严重问题:")
            for issue in high_issues:
                print(f"  • {issue['category']}: {issue['description']}")
        
        if medium_issues:
            print(f"⚠️  发现 {len(medium_issues)} 个一般问题:")
            for issue in medium_issues:
                print(f"  • {issue['category']}: {issue['description']}")
        
        # 显示修复建议
        if self.suggestions:
            print(f"\n💡 修复建议:")
            for i, suggestion in enumerate(self.suggestions, 1):
                print(f"  {i}. {suggestion}")
        
        # 提供备用方案
        if high_issues:
            print(f"\n🚀 备用方案:")
            print("  如果本地问题难以解决，可以考虑:")
            print("  • 使用云端API服务（如API易等平台）")
            print("  • 通过Docker环境运行ComfyUI")
            print("  • 使用预配置的虚拟机镜像")

def main():
    """主函数"""
    diagnostic = ComfyUIManagerDiagnostic()
    diagnostic.run_full_diagnostic()

if __name__ == "__main__":
    main()

特殊场景解决方案

🐳 Docker环境问题

# Docker环境下的Manager安装
FROM python:3.10-slim

# 安装系统依赖
RUN apt-get update && apt-get install -y \
    git \
    wget \
    curl \
    && rm -rf /var/lib/apt/lists/*

# 创建工作目录
WORKDIR /comfyui

# 克隆ComfyUI
RUN git clone https://github.com/comfyanonymous/ComfyUI.git .

# 安装Manager
RUN cd custom_nodes && \
    git clone https://github.com/ltdrdata/ComfyUI-Manager.git && \
    cd ComfyUI-Manager && \
    pip install -r requirements.txt

# 设置权限
RUN chmod -R 755 /comfyui

EXPOSE 8188
CMD ["python", "main.py", "--listen", "0.0.0.0"]

🍎 macOS特殊问题

#!/bin/bash
# macOS ComfyUI Manager修复脚本

echo "修复macOS ComfyUI Manager问题..."

# 1. 修复Xcode Command Line Tools
xcode-select --install

# 2. 修复权限问题（macOS Big Sur及以上）
sudo xattr -r -d com.apple.quarantine /path/to/ComfyUI

# 3. 修复Python环境
if command -v brew &> /dev/null; then
    brew install [email protected]
    brew install git
fi

# 4. 修复SSL证书问题
pip install --upgrade certifi
/Applications/Python\ 3.10/Install\ Certificates.command

echo "macOS修复完成"

预防措施与最佳实践

🛡️ 预防性维护脚本

#!/usr/bin/env python3
"""
ComfyUI Manager预防性维护脚本
定期运行以避免常见问题
"""
import os
import subprocess
import shutil
from datetime import datetime, timedelta

def backup_manager():
    """备份Manager配置"""
    manager_path = "custom_nodes/ComfyUI-Manager"
    
    if os.path.exists(manager_path):
        backup_path = f"backups/manager_backup_{datetime.now().strftime('%Y%m%d_%H%M%S')}"
        os.makedirs(os.path.dirname(backup_path), exist_ok=True)
        shutil.copytree(manager_path, backup_path)
        print(f"✅ Manager已备份到: {backup_path}")

def update_manager():
    """更新Manager到最新版本"""
    manager_path = "custom_nodes/ComfyUI-Manager"
    
    if os.path.exists(manager_path):
        os.chdir(manager_path)
        try:
            # 拉取最新更新
            subprocess.run(['git', 'pull'], check=True)
            
            # 更新依赖
            subprocess.run(['pip', 'install', '-r', 'requirements.txt', '--upgrade'], check=True)
            
            print("✅ Manager更新完成")
        except subprocess.CalledProcessError as e:
            print(f"❌ Manager更新失败: {e}")
        finally:
            os.chdir("../..")

def clean_temp_files():
    """清理临时文件"""
    temp_patterns = [
        "**/__pycache__",
        "**/*.pyc",
        "**/temp/*",
        "**/.DS_Store"
    ]
    
    import glob
    for pattern in temp_patterns:
        files = glob.glob(pattern, recursive=True)
        for file in files:
            try:
                if os.path.isfile(file):
                    os.remove(file)
                elif os.path.isdir(file):
                    shutil.rmtree(file)
            except:
                pass
    
    print("✅ 临时文件清理完成")

def health_check():
    """健康状态检查"""
    issues = []
    
    # 检查磁盘空间
    statvfs = os.statvfs('.')
    free_space_gb = statvfs.f_frsize * statvfs.f_bavail / (1024**3)
    if free_space_gb < 5:
        issues.append(f"磁盘空间不足: {free_space_gb:.1f}GB")
    
    # 检查Manager状态
    manager_path = "custom_nodes/ComfyUI-Manager"
    if not os.path.exists(manager_path):
        issues.append("Manager目录不存在")
    
    if issues:
        print("⚠️  发现问题:")
        for issue in issues:
            print(f"  • {issue}")
    else:
        print("✅ 健康检查通过")

def main():
    """主维护流程"""
    print("=== ComfyUI Manager 预防性维护 ===\n")
    
    print("1. 备份Manager...")
    backup_manager()
    
    print("\n2. 更新Manager...")
    update_manager()
    
    print("\n3. 清理临时文件...")
    clean_temp_files()
    
    print("\n4. 健康检查...")
    health_check()
    
    print("\n🎉 预防性维护完成！")

if __name__ == "__main__":
    main()

❓ ComfyUI Manager 故障排查FAQ

# 系统性排查脚本
def troubleshoot_no_ui_changes():
    """排查界面无变化问题"""
    
    checks = [
        ("检查Manager目录", "ls -la custom_nodes/ComfyUI-Manager"),
        ("检查Python导入", "python -c 'import sys; sys.path.append(\"custom_nodes/ComfyUI-Manager\"); import manager'"),
        ("检查启动日志", "python main.py 2>&1 | grep -i manager"),
        ("检查浏览器缓存", "Ctrl+F5强制刷新页面")
    ]
    
    for check_name, command in checks:
        print(f"执行: {check_name}")
        print(f"命令: {command}")
        print("---")

troubleshoot_no_ui_changes()

# 网络连接修复方案
# 1. 测试GitHub API连接
curl -I https://api.github.com/repos/ltdrdata/ComfyUI-Manager-nodes/contents

# 2. 配置代理（如果需要）
export https_proxy=http://your-proxy:port
export http_proxy=http://your-proxy:port

# 3. 使用镜像源
git config --global url."https://gitclone.com/github.com/".insteadOf "https://github.com/"

# 4. 手动下载节点列表
cd custom_nodes/ComfyUI-Manager
wget https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager-nodes/main/node_list.json

# 快速恢复脚本
def emergency_recovery():
    """紧急恢复脚本"""
    import os
    import shutil
    from datetime import datetime
    
    # 1. 备份当前状态
    backup_dir = f"emergency_backup_{datetime.now().strftime('%Y%m%d_%H%M%S')}"
    if os.path.exists("custom_nodes"):
        shutil.copytree("custom_nodes", backup_dir)
        print(f"✅ 当前状态已备份至: {backup_dir}")
    
    # 2. 逐个禁用节点进行测试
    custom_nodes_dir = "custom_nodes"
    node_dirs = []
    
    if os.path.exists(custom_nodes_dir):
        for item in os.listdir(custom_nodes_dir):
            item_path = os.path.join(custom_nodes_dir, item)
            if os.path.isdir(item_path) and item != "ComfyUI-Manager":
                node_dirs.append(item)
    
    # 3. 批量禁用所有节点
    for node_dir in node_dirs:
        old_path = os.path.join(custom_nodes_dir, node_dir)
        new_path = os.path.join(custom_nodes_dir, f"{node_dir}.disabled")
        if os.path.exists(old_path):
            os.rename(old_path, new_path)
            print(f"禁用节点: {node_dir}")
    
    print("🎉 所有节点已禁用，请重启ComfyUI测试")
    print("如果启动成功，再逐个启用节点找出问题节点")

# 运行恢复
emergency_recovery()

📚 延伸阅读与社区资源

🛠️ 故障排查工具

🔗 社区支持资源

🎯 总结与建议

ComfyUI Manager的故障虽然类型多样，但大多数问题都有标准化的解决方案。关键在于系统性地排查和准确定位问题根源。

核心排查思路回顾：

1. 安装完整性：确保文件完整，目录结构正确
2. 环境依赖：Python版本、Git工具、必需包
3. 网络连接：GitHub访问、API连接、镜像源配置
4. 权限问题：文件读写权限、系统安全策略
5. 冲突检测：节点冲突、版本冲突、配置冲突

最佳实践建议：

• 预防优于治疗：定期维护，及时备份
• 工具化排查：使用自动诊断脚本提高效率
• 社区求助：遇到疑难问题及时向社区求助
• 备用方案：考虑云端API服务作为备选

当本地环境问题难以解决时，云端API服务（如API易等平台）提供了可靠的替代方案，既能避免本地环境配置的复杂性，又能享受到ComfyUI的强大功能。

📝 作者简介：ComfyUI技术支持专家，专注解决各类安装和配置问题。分享实用的故障排查经验，搜索"API易"可获取更多ComfyUI技术支持和云端解决方案。
🔔 技术交流：欢迎在评论区分享你的故障排查经验，帮助更多用户解决ComfyUI Manager相关问题。