English | 节点总览 | 安装指南 | API配置

让AI创作更简单，让工作流更智能。

ComfyUI-QING 是一个全面的 ComfyUI 扩展包，提供 79 个精心设计的专业节点，覆盖 AI 大模型接入、图像处理、遮罩工程、SVG 矢量图形、数据流控制、调试与配置管理六大领域。全面采用 ComfyUI Nodes 2.0 纯原生架构，启动极速、运行稳定。

🎯 为创作者而生 — 设计师、动画师、AI 艺术家、开发者，都能在这里找到提升效率的利器
🚀 Nodes 2.0 纯原生 — 100% 静态化适配，毫秒级扫描加载，完美兼容最新 ComfyUI 前端
🤖 AI 深度集成 — 内置 9 大主流 AI 平台，支持语言对话、视觉理解、图像编辑
🌍 国际化支持 — 内置中文/英文界面，随 ComfyUI 语言设置自动切换
🧩 径向菜单系统 — Pizza Slice 风格，25+ 插件，10 大对齐工具，大幅提升画布效率

全面采用 ComfyUI Nodes 2.0 纯原生规范，拥有极致的启动速度和完美的向后兼容性：

• 极速加载 — 基于文件签名缓存的智能节点发现，毫秒级扫描
• 精准呈现 — 原生 Schema 定义，完美适配最新 ComfyUI 前端特性
• 无缝兼容 — 自动兼容旧版节点，现有工作流无需修改

引入优雅的 Pizza Slice 径向菜单，完全融入 ComfyUI 原生主题：

• 插件化架构 — 内置 25+ 专业插件，涵盖工作流管理、快速创建节点和实用工具
• 10 大对齐工具 — 支持节点上/下/左/右对齐、水平/垂直居中、等距分布、拉伸匹配，极大提升画布整理效率
• 多面板与快捷键 — 支持最多 3 个独立配置的径向菜单面板，可自定义快捷键防冲突
• 历史管理 — 内置操作历史追踪，支持撤销/重做

支持多平台、多模态的统一 AI 调用框架：

特色能力：

• 内置多轮对话缓存与上下文管理
• 统一的流式输出与错误处理
• 自定义 URL 节点可对接任何 OpenAI-compatible 服务
• VLLM 全通节点支持高级参数微调

• 基础变换 — ImageRotation（旋转）、ImageFlipping（翻转）、ImageScaling（缩放）、MaskScale（遮罩缩放）
• 精确裁剪 — ImageCropByOrigin（坐标裁剪）、ImageCropByPixels（像素裁剪）、ImageCropByPercent（百分比裁剪）
• 多源加载 — CustomLoadImageWithFormat（本地多格式）、LoadImageFromURL（远程 URL）、LoadImageFromBase64（Base64 解码）
• 图像缓存 — ImageCache 智能缓存池，最大支持 99 张轮转
• 质量评估 — QING_ImageQualityScore 图像质量评分
• 格式互转 — ImageMaskConverter（图像↔遮罩）、ImageToSVG（位图→矢量）
• 命名工具 — QING_GetImageName（提取名称）、QING_SaveImage（保存）

• 语义匹配 — VectorMatcher（类别向量匹配）、ConvertDataToVectors（数据→向量）、ColorJudge（颜色判断）
• 类型转换 — DataConverter 系列：Int↔String、String↔Bool、Bool↔Int、Bool 翻转，6 向无缝转换
• 流程控制 — QING_ConditionRouter（条件路由分支）、HasValue（值存在判断）、DynamicIntegerIncrement（动态自增）
• 批量处理 — QING_BatchForEach（逐项处理）、QING_BatchCollect（结果收集）
• 提示词工具 — QING_PromptRandomizer（随机提示词）、QING_PromptTemplate（模板填充）、TextTemplateConcat（模板拼接）
• 文本处理 — TextCompare（多文本对比）、TextSplitter（分割）、LoadPathText（文件加载）、PathAssembler（路径组装）
• 数据工具 — ImageDataAnalyzer / MaskDataAnalyzer（数据统计分析）、ListItemGetter（列表索引取值）、RandomDirectoryItem（随机目录项）

• MaskSplitter — 智能拆分复杂多元素遮罩，支持文字/图形保护的智能合并
• MaskBlend — 高级混合，支持 8 种混合模式
• MaskExpansion — 方向性扩张，精细控制各方向扩展量
• MaskFill — 智能内部孔洞填充
• MaskJudgment — 遮罩数据统计与条件判断（面积、数量等）
• ImageMaskPreview — 图像与遮罩的混合实时预览

• ConfigExport / ConfigImport — 一键导出/导入完整 ComfyUI 工作流及 Python 依赖环境，支持跨端快速恢复
• LetMeSee / ShowMePure — 任意数据查看器，右键节点快速接入专属调试面板
• LogPrinter / QuickLogPrinter / TextLogPrinter — 多级日志输出
• MergeShardedModel — 模型分片合并
• OutputFilePack — 文件打包输出
• QING_MetadataWriter — 图片元数据写入

• LoadSVG — 本地 SVG 文件加载与格式校验
• SVGSaver — SVG 内容保存到文件
• SVGToImage — SVG → PNG/JPG 高质量栅格化（推荐配合 cairosvg）

进入 ComfyUI 的 custom_nodes 目录：

cd ComfyUI/custom_nodes
git clone https://github.com/GAOSHI-QING/ComfyUI-QING.git

推荐使用自动化安装脚本：

cd ComfyUI-QING
python install_dependencies.py

国内用户使用镜像加速安装：

python install_dependencies.py --mirror --auto

更多选项：

或手动安装：pip install -r requirements.txt

• Python ≥ 3.9
• ComfyUI 最新版本
• 推荐安装 cairosvg 以获得最佳 SVG 渲染效果
• 网络支持 — AI API 节点需要网络连接

重启 ComfyUI 后，在顶部菜单栏选择 设置 (Settings) → QING → API配置，可视化填入各平台的 API Key：

• 所有配置本地热保存，重启不丢失
• 节点调用时自动拉取，无需在工作流中暴露密钥
• 支持 9 大平台独立配置

内置中英文界面翻译，随 ComfyUI 语言设置自动切换。翻译文件位于 locales/ 目录，欢迎贡献其他语言。

ComfyUI-QING/
├── nodes/
│   ├── api/          # AI 大模型接入（19节点）
│   ├── image/        # 图像处理（16节点）
│   ├── data/         # 数据工具（25节点）
│   ├── mask/         # 遮罩工程（6节点）
│   ├── utils/        # 配置与调试（10节点）
│   ├── svg/          # SVG 处理（3节点）
│   └── video/        # 视频处理（开发中）
├── js/               # 前端 JS（径向菜单、调试面板、设置同步等）
├── locales/          # 国际化翻译（zh / en）
├── example_workflows/ # 示例工作流
├── data/             # 数据配置模板
├── scripts/          # 构建与工具脚本
├── install_dependencies.py  # 依赖安装脚本
├── requirements.txt  # Python 依赖
└── pyproject.toml    # 项目元数据与构建配置

欢迎提交 Issues 反馈问题，或通过 PR 贡献新功能！无论是节点优化、新平台适配、格式扩展还是文档完善，你的参与都能让这个工具更强大。

• 🐛 报告问题
• 📖 Wiki 文档
• 💡 欢迎 Star ⭐ 支持项目持续发展

中文 | Nodes | Install | API Config

Making AI creation simpler, workflows smarter.

ComfyUI-QING is a comprehensive ComfyUI extension delivering 79 meticulously crafted nodes across 6 domains: AI model integration, image processing, mask engineering, SVG pipelines, data flow control, and debugging & configuration. Fully built on the ComfyUI Nodes 2.0 pure native architecture for lightning-fast startup and rock-solid stability.

🎯 Built for creators — designers, animators, AI artists, and developers alike
🚀 100% Nodes 2.0 native — no legacy adapters, millisecond-level scanning, perfect UI compatibility
🤖 9 AI platforms — language, vision, and image editing via a unified framework
🌍 i18n ready — built-in Chinese & English UI, auto-switching with ComfyUI locale settings
🧩 Radial menu — Pizza Slice style, 25+ plugins, 10 alignment tools for massive canvas productivity

• DeepSeek, GLM (Zhipu), Kimi (Moonshot), Qwen (Alibaba), Doubao (ByteDance), Gemini (Google) — language, vision, and image editing
• VLLM Omni — text→text, text→image, image→image via any OpenAI-compatible endpoint with advanced parameter tuning
• Custom URL nodes — connect any OpenAI-compatible API for language, vision, or image editing
• Model fallback — automatic failover on API errors
• Multi-turn conversation memory with context management

• Rotation, flipping, scaling (multiple interpolation methods), mask scaling
• Crop by origin coordinates, pixel dimensions, or percentage
• Load from local path, remote URL, or Base64 string
• Smart image cache pool (up to 99 images in rotation)
• Image quality scoring
• Raster→SVG vectorization, image↔mask conversion

• VectorMatcher — semantic category matching via embedding vectors
• DataConverter series — 6-way conversion between Int, String, and Bool
• ConditionRouter — flow branching based on text comparison
• BatchForEach / BatchCollect — batch processing pipeline
• PromptRandomizer / PromptTemplate — dynamic prompt generation
• Type-agnostic tools: text splitting, path assembly, list access, random directory item, dynamic increment

• MaskSplitter — split complex multi-element masks with text/shape protection
• MaskBlend — 8 blend modes for advanced compositing
• MaskExpansion — directional expansion with per-side fine-tuning
• MaskFill — intelligent internal hole filling
• MaskJudgment — statistical analysis and conditional checks on mask data
• ImageMaskPreview — real-time blended preview

• ConfigExport / ConfigImport — full workflow & dependency snapshot for cross-machine recovery
• LetMeSee / ShowMePure — attach debug viewers to any node via right-click context menu
• MergeShardedModel — merge model shards into a single file
• OutputFilePack — file packaging for output management
• QING_MetadataWriter — write metadata into generated images

cd ComfyUI/custom_nodes
git clone https://github.com/GAOSHI-QING/ComfyUI-QING.git
cd ComfyUI-QING
python install_dependencies.py

Users in China — use the mirror flag for faster downloads:

python install_dependencies.py --mirror --auto

Requirements: Python ≥ 3.9, ComfyUI latest. cairosvg recommended for best SVG quality.

After restarting ComfyUI, go to Settings → QING → API Configuration to enter your API keys. All keys are saved locally and auto-injected at runtime — never exposed in your workflow graphs.

Issues and PRs are welcome! Whether it's node optimization, new platform support, format extensions, or documentation improvements — your contribution makes this toolkit better.

• 🐛 Report an Issue
• 📖 Documentation
• ⭐ Star the project to support ongoing development

ComfyUI-QING · Unleash your creativity. 🚀