# comfyui节点分析工具

**Repository Path**: elihe999/comfyui-node-analysis-tool

## Basic Information

- **Project Name**: comfyui节点分析工具
- **Description**: 解析workflow json里面用了哪些节点
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ComfyUI 工作流插件分析工具

独立 Python 工具（与主项目无关），用于分析 ComfyUI 工作流 JSON 使用了哪些自定义节点/插件。

## 功能

- 选择 ComfyUI 工作流文件夹（支持递归扫描 `.json`）
- 解析 **API 格式** 与 **UI 保存格式** 工作流（含 ComfyUI 0.4+ 新版 JSON）
- 优先读取节点 `properties.cnr_id` 识别插件来源（比外部映射表更准确）
- 读取 `extra.node_versions` 显示各插件版本
- **工作流详情视图**
  - 左侧：工作流列表
  - 右上：每个节点类型及其所属插件
  - 右下：按插件聚合的节点树
- **全局统计视图**：按插件/组件汇总，展开查看各节点及使用它的工作流
- 节点→插件映射基于 [ComfyUI-Manager extension-node-map.json](https://github.com/ltdrdata/ComfyUI-Manager/blob/main/extension-node-map.json)
- 仓库内 `data/extension-node-map.json` 为离线内置副本；启动时会尝试在线更新到 `.cache/`

## 环境要求

- Python 3.9+
- 仅使用标准库（Tkinter 随 Python 安装，Windows/macOS 通常已包含）

## 运行

```bash
cd python
python main.py
```

## 使用说明

1. 点击 **选择工作流文件夹**，指向存放 ComfyUI workflow JSON 的目录
2. 在左侧点击工作流，右侧查看节点与插件详情
3. 点击 **切换到全局统计** 查看整个文件夹的汇总
4. 若网络无法访问 GitHub，可手动下载 `extension-node-map.json` 后点击 **导入映射文件**

> **注意**：`data/extension-node-map.json` 是节点→插件的**映射表**，不是工作流文件。真实工作流请放在任意文件夹（如 `sample_workflows/`）后通过 GUI 选择该文件夹。

## 目录结构

```
python/
├── main.py              # GUI 入口
├── workflow_parser.py   # 工作流 JSON 解析
├── node_mapper.py       # 节点→插件映射
├── analyzer.py          # 聚合分析逻辑
├── data/                # 内置节点映射（离线可用）
├── sample_workflows/    # 示例工作流（测试用）
└── .cache/              # 节点映射缓存（运行时生成）
```

## 说明

- 映射表中没有的节点会标记为 **ComfyUI 核心/内置**
- 解析失败的工作流会在列表中显示 `[错误]`