# comfyui-lcc-nodes **Repository Path**: lcc5050/comfui-lcc ## Basic Information - **Project Name**: comfyui-lcc-nodes - **Description**: comfyui节点合集 - **Primary Language**: Unknown - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-22 - **Last Updated**: 2026-07-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ComfyUi-LCC `ComfyUi-LCC` 是一个面向 ComfyUI 的自定义节点集合，当前包含： - `Qwen` 图像相关节点 - `PainterFlux` 图像编辑节点 - 文本转图片数组工具 - 动态表单节点 - 分辨率工具 - LoRA 文本加载工具 - 标签提示词编辑器：标签管理、头部/尾部通用提示词、收藏与翻译 - 类型检测工具 - 一些前端增强脚本与通用模块 ## 近期更新 - 标签提示词编辑器新增**角色快速添加功能**，支持通过侧边栏弹窗搜索和添加角色到提示词列表（包含5149个角色，支持中英文搜索和缩略图显示）。 - 标签提示词编辑器新增 `MyMemory` 翻译提供商，无需配置 API Key，可直接用于中英互译。 - 标签提示词收藏支持保存和恢复头部/尾部通用提示词，收藏内容会保留 `common` 与 `tags` 两部分。 - 收藏面板支持追加或替换收藏：替换会同步头部、尾部与标签；追加会合并头尾提示词并追加标签。 ## 安装 1. 将目录放入： ```text ComfyUI/custom_nodes/ComfyUi-LCC ``` 1. 安装依赖： ```bash pip install -r requirements.txt ``` 1. 重启 ComfyUI。 ## 项目目录树 ```text ComfyUi-LCC/ # 插件根目录 ├─ __init__.py # ComfyUI 插件入口，导出节点映射和 WEB_DIRECTORY ├─ README.md # 项目说明文档 ├─ requirements.txt # Python 依赖列表 ├─ pyproject.toml # 项目构建与元数据配置 ├─ LICENSE # 许可证 ├─ test.md # 测试或补充说明文档 ├─ .gitignore # Git 忽略规则 ├─ .trae/ # 项目过程文档或临时记录 │ └─ documents/ # 过程文档目录 ├─ data/ # 角色数据目录 │ └─ characters/ # 角色数据 │ ├─ characters.json # 角色数据JSON（5149个角色） │ ├─ wai_characters.csv # 原始CSV数据 │ ├─ wai_character_md5_v160.json # MD5映射数据 │ ├─ wai_character_thumbs_v160.json # 缩略图Base64数据 │ └─ image/ # 角色缩略图目录 │ └─ *.png # 缩略图文件（5149张） ├─ common/ # 公共 Python 模块 │ ├─ __init__.py # common 模块导出 │ ├─ cache.py # 通用缓存工具 │ ├─ file_picker.py # 本地文件选择相关逻辑 │ ├─ logger.py # LCC 通用日志模块 │ ├─ utils.py # 通用工具函数 │ └─ onetoall_alignment/ # 内置姿态对齐实现 │ ├─ __init__.py # 对齐模块入口 │ ├─ retarget_pose.py # 姿态重定向核心逻辑 │ ├─ onetoall/ # OneToAll 对齐相关实现 │ │ ├─ __init__.py # onetoall 子模块入口 │ │ └─ infer_function.py # 对齐推理与桥接函数 │ └─ pose_utils/ # 姿态数据结构与转换工具 │ ├─ __init__.py # pose_utils 子模块入口 │ └─ pose2d_utils.py # 2D pose 元数据工具 ├─ logs/ # LCC 通用日志目录 ├─ plugins/ # 实际节点与路由实现 │ ├─ __init__.py # 汇总所有插件节点映射 │ ├─ routes.py # 插件级统一路由挂载入口 │ ├─ dynamic_form/ # 动态表单相关节点 │ │ ├─ __init__.py # dynamic_form 插件入口 │ │ ├─ nodes.py # DynamicFormNode │ │ └─ form_property_node.py # FormPropertyNode │ ├─ intelligent_vram/ # WanVideo 显存与 blockswap 工具 │ │ ├─ __init__.py # intelligent_vram 插件入口 │ │ ├─ intelligent_vram_manager.py # 显存管理辅助逻辑 │ │ └─ nodes.py # WanVideoEnhancedBlockSwap_LCC │ ├─ lora_loader/ # LoRA 文本加载工具 │ │ ├─ __init__.py # lora_loader 插件入口 │ │ └─ nodes.py # LoraLoaderByText_LCC │ ├─ painter_flux/ # PainterFlux 图像编辑 │ │ ├─ __init__.py # painter_flux 插件入口 │ │ └─ nodes.py # PainterFluxImageEdit_LCC │ ├─ qwen_integrated/ # Qwen 图像工作流整合节点 │ │ ├─ __init__.py # qwen_integrated 插件入口 │ │ └─ nodes.py # Qwen 系列节点 │ ├─ resolution_adjuster/ # 分辨率工具 │ │ ├─ __init__.py # resolution_adjuster 插件入口 │ │ ├─ nodes.py # ResolutionAdjuster_LCC │ │ └─ preset_nodes.py # ResolutionPreset_LCC │ ├─ text_to_image/ # 文本转图片数组工具 │ │ ├─ __init__.py # text_to_image 插件入口 │ │ ├─ nodes.py # TextToImageArray_LCC │ │ └─ routes.py # 图片浏览与预览路由 │ └─ type_detector/ # 类型检测工具 │ ├─ __init__.py # type_detector 插件入口 │ └─ nodes.py # TypeDetectorNode └─ web/ # 前端扩展目录 └─ js/ # 前端脚本 ├─ dynamic_form.js # 动态表单节点前端增强 ├─ form_property.js # 表单属性节点前端增强 ├─ lcc_notifier.js # 前端通用通知组件 └─ text_to_image_array.js # 文本转图片数组前端 UI ``` ## 当前节点总览 下面列出当前在 LCC 中注册的节点。 | 节点类名 | 显示名 | 分类 | 说明 | | ----------------------------------------- | -------------------------------------------- | ----------------- | ------------------------------ | | `QwenImageIntegratedKSampler_LCC` | `千问图像集成采样器 / Qwen Image Integrated KSampler` | `LCC/Qwen` | `Qwen` 图像综合采样节点 | | `ExtraOptions` | `额外设定 / Extra Options` | `LCC/Qwen` | `Qwen` 高级参数输出节点 | | `QwenImageControlNetIntegratedLoader_LCC` | `千问 ControlNet 集成加载器` | `LCC/Qwen` | `Qwen` ControlNet 数据加载 | | `PainterFluxImageEdit_LCC` | `PainterFlux 图像编辑` | `LCC/PainterFlux` | `Flux` 图像编辑 | | `TextToImageArray_LCC` | `文本转图片数组_LCC` | `LCC/工具` | 从多行文本路径读取图片 | | `ResolutionAdjuster_LCC` | `分辨率调整器LCC` | `LCC/分辨率` | 根据输入尺寸返回推荐分辨率 | | `ResolutionPreset_LCC` | `分辨率预设集LCC` | `LCC/分辨率` | 输出预设宽高 | | `LoraLoaderByText_LCC` | `文本加载多个LoRA_LCC` | `LCC/LoRA` | 从文本读取 LoRA 路径与权重 | | `DynamicFormNode` | `动态表单节点` | `LCC/动态表单` | 动态生成表单字段并输出 | | `FormPropertyNode` | `获取动态表单属性` | `LCC/动态表单` | 从动态表单中读取指定字段 | | `TagPromptNode_LCC` | `标签提示词编辑器_LCC` | `LCC/提示词` | 可视化编辑标签、头尾提示词、收藏与翻译 | | `Wan22MultiImageRef_LCC` | `wan2.2图生视频多图参考_LCC` | `LCC/Wan22` | Wan2.2 多帧图像参考图生视频 | | `TypeDetectorNode` | `类型检测节点_LCC` | `LCC/工具` | 检测输入参数类型 | ## 节点分组说明 ### 1. Qwen 集成 目录： - [plugins/qwen\_integrated/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/qwen_integrated/nodes.py) 包含节点： - `QwenImageIntegratedKSampler_LCC` - `ExtraOptions` - `QwenImageControlNetIntegratedLoader_LCC` 用途： - 集中处理 `Qwen` 图像模型的采样、额外参数和 ControlNet 数据。 ### 2. PainterFlux 目录： - [plugins/painter\_flux/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/painter_flux/nodes.py) 包含节点： - `PainterFluxImageEdit_LCC` 用途： - 对输入图片进行 `Flux` 风格编辑。 ### 3. 文本与图片工具 目录： - [plugins/text\_to\_image/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/text_to_image/nodes.py) - [plugins/text\_to\_image/routes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/text_to_image/routes.py) 包含节点： - `TextToImageArray_LCC` 用途： - 将多行文本中的图片路径读取为 `IMAGE` 数组。 ### 4. 动态表单 目录： - [plugins/dynamic\_form/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/dynamic_form/nodes.py) - [plugins/dynamic\_form/form\_property\_node.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/dynamic_form/form_property_node.py) 包含节点： - `DynamicFormNode` - `FormPropertyNode` 用途： - 在 ComfyUI 内动态生成表单字段，并在其他节点中读取指定字段值。 ### 5. 分辨率工具 目录： - [plugins/resolution\_adjuster/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/resolution_adjuster/nodes.py) - [plugins/resolution\_adjuster/preset\_nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/resolution_adjuster/preset_nodes.py) 包含节点： - `ResolutionAdjuster_LCC` - `ResolutionPreset_LCC` 用途： - 根据尺寸关系输出适合的宽高 - 提供固定分辨率预设 ### 6. LoRA 工具 目录： - [plugins/lora\_loader/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/lora_loader/nodes.py) 包含节点： - `LoraLoaderByText_LCC` 用途： - 从文本批量解析 LoRA 路径和权重。 ### 7. 类型检测 目录： - [plugins/type\_detector/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/type_detector/nodes.py) 包含节点： - `TypeDetectorNode` 用途： - 检测输入对象的类型，便于调试工作流。 ### 8. 标签提示词编辑器 目录： - [plugins/tag\_prompt/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/tag_prompt/nodes.py) - [plugins/tag\_prompt/routes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/tag_prompt/routes.py) - [plugins/tag\_prompt/translation\_api.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/tag_prompt/translation_api.py) - [plugins/tag\_prompt/models/character\_repository.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/tag_prompt/models/character_repository.py) 包含节点： - `TagPromptNode_LCC` 用途： - 可视化编辑中英文标签、权重、忽略状态，并实时输出中文提示词、英文提示词和 JSON 数据。 - 支持头部/尾部通用提示词，最终输出会按"头部 + 标签列表 + 尾部"拼接。 - 支持收藏当前提示词组合，收藏会保存标签、头部提示词、尾部提示词和可选封面。 - 支持从收藏追加或替换到当前编辑器；旧版只包含标签数组的收藏仍可继续使用。 - 翻译提供商支持百度翻译、OpenAI 兼容 LLM 接口和 `MyMemory`。其中 `MyMemory` 不需要 API Key。 - 支持 WD14 图片反推，将图片识别结果导入为标签提示词。 - **新增：角色快速添加功能**，通过侧边栏弹窗快速搜索和添加角色到提示词列表，包含5149个角色，支持中英文搜索和缩略图显示。 收藏 JSON 数据格式： ```json { "common": { "chinese_prefix": "高质量", "english_prefix": "best quality", "chinese_suffix": "电影光影", "english_suffix": "cinematic lighting" }, "tags": [ { "chinese": "女孩", "english": "girl", "weight": 1.0, "ignored": false } ] } ``` ### 9. Wan2.2 多帧图像参考 目录： - [plugins/wan22\_multi\_image\_ref/nodes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/wan22_multi_image_ref/nodes.py) 包含节点： - `Wan22MultiImageRef_LCC` 用途： - 支持多帧图像数组输入，自动处理首尾帧。 - 内部自动进行 CLIP Vision 编码。 - 自动调整尺寸到符合 Wan2.2 模型要求（宽度/高度16倍数，帧数4倍数+1）。 - 支持"首尾帧一致"功能，简化循环视频制作。 ## 路由说明 当前插件包含以下后端路由： - [plugins/routes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/routes.py) 统一插件路由挂载入口 - [plugins/text\_to\_image/routes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/text_to_image/routes.py) 负责图片浏览与预览相关接口 - [plugins/tag\_prompt/routes.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/plugins/tag_prompt/routes.py) 负责标签搜索、翻译配置、翻译请求、收藏管理、收藏封面、图片反推和角色管理相关接口 ## 日志 LCC 已提供通用日志模块： - [common/logger.py](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/common/logger.py) 日志目录： - [logs](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/logs) 使用方式： ```python from ...common.logger import get_lcc_logger LOGGER = get_lcc_logger("your_plugin_name") ``` 日志文件命名规则： - 由 `get_lcc_logger("name")` 里的名字决定 - 例如 `get_lcc_logger("sdpose_keypoint_extractor")` 会写入： `ComfyUi-LCC/logs/sdpose_keypoint_extractor.log`（注：`sdpose_keypoint_extractor` 插件已移除，此日志文件不再产生） 当前规则： - 按天切割 - 保留最近 14 天 - UTF-8 编码 ## 前端增强 前端脚本位于： - [web/js/dynamic\_form.js](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/web/js/dynamic_form.js) - [web/js/form\_property.js](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/web/js/form_property.js) - [web/js/lcc\_notifier.js](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/web/js/lcc_notifier.js) - [web/js/tag\_prompt/tag\_prompt.js](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/web/js/tag_prompt/tag_prompt.js) - [web/js/text\_to\_image\_array.js](/D:/ai/tools/ComfyUI-aki-v3/ComfyUI/custom_nodes/ComfyUi-LCC/web/js/text_to_image_array.js) ## 使用建议 - 修改 Python 后端代码后，需要重启 ComfyUI。 - 仅修改前端 JS 时，通常刷新页面即可。 ## 备注 本 README 以当前代码实现为准。后续如果新增、删除或调整节点，建议同步更新文档，避免说明与代码脱节。 *** Made for the ComfyUI community.