ComfyUI_GJJ_Nodes 是个人开发的 ComfyUI 自定义节点合集，涵盖图像处理、视频生成、音频合成、提示词工程、模型管理、工作流辅助等多个方向。所有节点统一使用 GJJ · 前缀，内置中文工具提示，遵循零外部依赖原则（除 requirements.txt 中列出的通用包外，不依赖任何第三方自定义节点包）。

• 单文件部署，零额外依赖 — 不依赖任何第三方自定义节点包
• 内置中文工具提示 — 所有节点参数均提供中文说明，降低使用门槛
• 子目录感知的模型查找 — 自动递归搜索模型子目录，支持最长公共片段匹配和扩展名剥离
• 动态输入/输出插槽 — 采用 AnySwitch 稳定化模式，插槽变更后保持连线不丢失
• 1-based 用户编号 — 所有面向用户的插槽编号从 1 开始，符合直觉
• 自定义预览支持 — 多种输出格式（图片、音频、视频）的专用预览节点
• 丰富的格式预设 — 内置视频格式、提示词风格等预设，开箱即用
• 前端 JS 独立封装 — 每个节点的前端逻辑放在独立 JS 文件中，便于维护

cd ComfyUI/custom_nodes
git clone https://github.com/guojijun/ComfyUI_GJJ_Nodes.git
cd ComfyUI_GJJ_Nodes
pip install -r requirements.txt

1. 从 Releases 或 Code → Download ZIP 下载压缩包
2. 解压到 ComfyUI/custom_nodes/ComfyUI_GJJ_Nodes
3. 在该目录下运行 pip install -r requirements.txt

如果下载速度慢，可使用国内 pip 镜像源：

# 清华镜像（推荐）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 阿里云镜像
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple

# 腾讯云镜像
pip install -r requirements.txt -i https://mirrors.cloud.tencent.com/pypi/simple

# 可选依赖（同样使用镜像）
pip install -r requirements-optional.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install -r requirements-accelerate.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

部分节点还需要额外手动安装的包（部分已集成在 requirements 中）：

# 人脸分析 / 换脸
pip install onnx onnxruntime-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple

# Ollama 相关（统一助手、目录图片打标等）
pip install ollama -i https://pypi.tuna.tsinghua.edu.cn/simple

# 翻译
pip install transformers sentencepiece -i https://pypi.tuna.tsinghua.edu.cn/simple

# RIFE 视频插帧
pip install pillow -i https://pypi.tuna.tsinghua.edu.cn/simple

pip install -r requirements-optional.txt   # 可选功能
pip install -r requirements-accelerate.txt # 推理加速

部分节点需要配套模型才能运行。所有模型文件请从以下地址统一下载：

🔗 模型下载地址： https://pan.quark.cn/s/6ec846f1f58d

下载后将对应模型放入 ComfyUI/models/ 下的相应子目录：

提示： 大部分节点在运行时会自动在 ComfyUI/models/ 下递归搜索模型，面板中也会显示对应的中文 tooltip 提示所需路径。

1. 安装完成后重启 ComfyUI
2. 在节点菜单中搜索 GJJ 即可找到所有节点
3. 所有节点统一使用 GJJ · 前缀命名
4. 悬停参数标签可查看中文提示
5. 大部分节点支持右键菜单中的快捷操作
6. 详细用法参考 examples/ 目录中的工作流示例

ComfyUI_GJJ_Nodes/
├── __init__.py                    # 入口：注册节点、帮助 API
├── .editorconfig                  # 编辑器配置
├── .gitignore                     # Git 忽略规则
├── README.md                      # 项目说明
├── requirements.txt               # 核心依赖
├── requirements-optional.txt      # 可选依赖
├── requirements-accelerate.txt    # 推理加速依赖
├── js/                            # 前端 JS（每个节点独立文件）
├── nodes/                         # 后端 Python（每个节点独立文件）
│   └── common_utils/              # 共享工具模块
├── locales/                       # 国际化
│   └── zh/                        # 中文语言包
├── examples/                      # 工作流 JSON 示例
├── presets/                       # 预设文件
├── utils/                         # 通用工具脚本
└── web/                           # Web 资源

注意： 仓库中包含 SKILL/（开发文档）、docs/（使用指南）、memory/（开发记忆）等目录，这些目录已通过 .gitignore 排除，不会提交到远程仓库。如需查阅，请联系作者获取。

开发和架构文档存放于 SKILL/ 目录（本地知识库，已 gitignore）：

• SKILL_INDEX.md — 完整文档索引，包含所有节点的架构说明和开发指南
• GJJ_CODING_CONVENTIONS.md — 编码规范
• SKILL/10-node-architecture/ — 每个节点的前后端架构文档
• SKILL/11-dev-tools/ — 开发/测试工具

使用指南：

• docs/ — 功能使用说明（通过 .gitignore 排除，按需获取）
• examples/ — 工作流 JSON 示例文件

本项目仅限个人学习使用，禁止任何形式的商业用途。

感谢 ComfyUI 社区及其所有贡献者。

作者： guojijun