ComfyUI-DAELab-Custom-Nodes-Library

创作画布、共享控件与 DAELAB.MediaUpload 已迁至 独立 Creative Canvas 仓库。已有画布用户需同时安装新仓库并重启 ComfyUI。表格、分镜、LibTV、徽章与展厅业务仍由本库维护；画布通过公开 v1 适配器接入。

ComfyUI-DAELab-Custom-Nodes-Library

DAELab 维护的 ComfyUI 自定义节点库。

分镜与视频工作流

从文稿导入或空表开始，在同一表格中整理逐行任务、标记视频参考图片列、解析并编辑最终 Prompt，再连接现有 LibTV 批量生成节点。

• 交付范围、启动方式与复验入口
• 表格操作与参考列规则
• Prompt 方案 · 分阶段验收与 4 个真实视频结果
• 分镜视频模板 · 通用空表模板
• 提示词优化：自有 DeepSeek API 配置与费用说明（单格／整列建议，手动应用）

节点：DAELAB.Table（通用表格）、DAELAB.StoryboardImport（文稿分镜导入）、DAELAB.LibTV.StoryboardBatch（批量视频）及 DAELAB.ComfyTV.GPTImageStoryboardStage（既有独立图片生成）。安装新增依赖后重启 ComfyUI 并刷新前端；上游 ComfyTV 保持只读。

维护指南

• 多人协作请先阅读 Contributor Action List。
• 后续新增节点请先阅读 新增节点维护指南。
• 可从 新节点模板 复制基础结构。
• README 和文档统一使用 UTF-8 编码；节点截图、流程图放在对应节点目录的 assets/ 下。

节点列表

| 节点 ID | 显示名称 | 说明 | | --- | --- | --- | | DAELAB.BadgeApp87V1 | Badge 8.7 Stage Execution (DAELab) | #8.7 APP Mode 阶段执行：复用 #8.6 原型控制面板，执行真实生成与确定性局部合成。 | | DAELAB.BadgeApp87RegionAlignV1 | Badge 8.7 Material Mask Alignment (DAELab) | #8.7 内部材质遮罩配准，在生成图坐标系中吸附材质边界并保持源色参考。 | | BooleanList | Boolean List | 动态维护多组布尔输出。 | | BooleanListHierarchy | Boolean List Hierarchy | 维护最多 64 个带三层祖先级联、同层互斥组、跨分支 AND 依赖和稳定 ID 的布尔输出。 | | BooleanListHierarchyGet | Boolean List Hierarchy Get | 无连线选择 Hierarchy 的 Root 分支，并自动生成该分支的 Bool 输出。 | | BooleanGroupBypassController | Boolean Group Bypass Controller | 将 Hierarchy 或 Hierarchy Get 的指定 Bool 映射为可视节点组状态，并支持与 Boolean 祖先关系一致的嵌套 Bypass 合成。 | | SeedreamExhibitionPromptBuilder | Seedream Exhibition Prompt Builder | 面向 Seedream 5.0 Pro 展厅写实渲染工作流，按主题、参考图用途、语义色彩和布尔条件生成分段提示词。 | | GPTImage2Config | GPT Image2 Config | 集中输出 gpt-image-2 的预设尺寸、背景和质量参数；应用构建模式下以一个组合输入统一开关。 | | DAELAB.ComfyTV.GPTImageStoryboardStage | DAELAB - GPT Image 2 StoryBoard | 独立维护的 ComfyTV 兼容分镜表格；导入文档与参考图后，按分镜逐一调用 ComfyUI 账号积分版 GPT Image 2。 | | GPTImage2MaterialPrompt | GPT Image 2 材质提示词 | 选择徽章材质，只应用无色的材质物理特性并锁定 Image 1 参考图原色；节点不提供颜色开关、颜色输入或取色器，亚金、亚银预览保留金属固有色，其余为灰阶。 | | DAELabBadgeMaterialRegionV1 | Badge Material Region V1 (DAELab) | 将徽章平面图源颜色映射到区域材质；颜色只用于定位色块，未配置前景默认透明清漆，并输出可直接接入徽章基础渲染 Prompt Builder 的区域材质语义。 | | BadgeReliefPrompt | 徽章浮雕强度 / Badge Relief | 通过 0–5 档分段滑条生成只改变徽章表面 Z 轴浮雕、并锁定材质、文字、颜色和图形的编辑提示词。 | | DAELabMultiColorMask | Multi Color Mask (DAELab) | 默认一组、可动态增删颜色匹配组，并选择输出指定 mask_N 或全部启用组的 combined_mask。 | | DAELabMultiColorMaskV1 | Multi Color Mask V1 (DAELab) | 保留旧节点计算语义，以紧凑两行颜色组、稳定选中态和 ICON 增删操作编辑颜色蒙版。 | | DAELabBadgeHeightLayer | Badge Height Layer (DAELab) | 将动态颜色组映射到镂空及一至五层，输出固定 0.2 等差的离散灰度高度图和未匹配区域。 | | DAELabBadgeHeightLayerV1 | Badge Height Layer V1 (DAELab) | 保留旧节点的计算语义，以紧凑两行颜色层、稳定选中态和 ICON 增删操作编辑离散高度映射。 | | BadgeHeightEstablishPromptBuilder | Badge Height Establish Prompt Builder | 根据实际命中的离散层级生成高度 Prompt，并可接收材质语义，直接输出 #8.4 使用的结构、参考色、材质和不透明纯白背景完整基础成片 Prompt。 | | DAELAB.BadgeRenderSpaceMaskAlignV1 | Badge Render-Space Mask Align V1 (DAELab) | 从生成后的徽章效果图提取目标前景，支持按目标图全局颜色或源图颜色生成高对比 ID Map，并输出 Color To Mask 调色板、源图对照和 QA 报告。 | | RMBGConfig | RMBG Config | 集中输出 RMBG 遮罩提取节点的背景类型和背景颜色；应用构建模式下以一个组合输入统一开关。 | | AppModeLoadImage | Load Image (App Mode) | 继承原生图片上传、加载与 Mask 输出，并在 Bypass 时同步折叠应用面板输入。 | | BBoxPromptReroute | BBox Prompt Reroute | 转接正向/负向 SAM3 框 prompt，仅整理工作流连线。 | | PolygonMask | Polygon Mask | 接收外部 IMAGE socket，隔离复制工作流的多边形状态与执行预览，并输出叠加图、原图尺寸黑白 raw_mask 和面板多行文本。 | | SAM3ComplexCollector | SAM3 Complex Collector | 集 BBox 与交互式 collector 于一体，支持节点内独立 Run、会话缓存和增量分割。 |

目录结构

ComfyUI-DAELab-Custom-Nodes-Library/
  __init__.py
  nodes/
    boolean_list/
      node.py
      README.md
      assets/
    boolean_list_hierarchy/
      node.py
      README.md
    boolean_list_hierarchy_get/
      node.py
      README.md
    boolean_group_bypass_controller/
      node.py
      README.md
    seedream_exhibition_prompt_builder/
      node.py
      README.md
    gpt_image2_config/
      node.py
      README.md
    daelab_comfytv_storyboard/
      node.py
      document_import.py
      runtime.py
      workflows/
      README.md
    gpt_image2_material_prompt/
      node.py
      README.md
    badge_relief_prompt/
      node.py
      README.md
    multi_color_mask/
      node.py
      README.md
    badge_height_layer/
      node.py
      README.md
    rmbg_config/
      node.py
      README.md
    app_mode_load_image/
      node.py
      README.md
    bbox_prompt_reroute/
      node.py
      README.md
      assets/
    polygon_mask/
      node.py
      README.md
    sam3_complex_collector/
      node.py
      README.md
    _shared_sam3.py
  templates/
    new_node/
  web/
    app_mode_bypass.js
    app_mode_bypass_model.mjs
    boolean_list.js
    boolean_list_hierarchy.js
    boolean_list_hierarchy_model.mjs
    boolean_list_hierarchy_get.js
    boolean_list_hierarchy_get_model.mjs
    boolean_group_bypass_controller.js
    boolean_group_bypass_controller_model.mjs
    gpt_image2_config.js
    gpt_image2_config_panel.mjs
    daelab_comfytv_storyboard.js
    daelab_storyboard_model.mjs
    material_prompt.js
    material_prompt_model.mjs
    materials.json
    material_thumbs/
    thumbnail_selector.mjs
    badge_relief_prompt.js
    badge_relief_prompt_panel.mjs
    multi_color_mask.js
    multi_color_mask_model.mjs
    multi_color_mask_v1.js
    multi_color_mask_v1_model.mjs
    badge_height_layer.js
    badge_height_layer_model.mjs
    badge_height_layer_v1.js
    badge_height_layer_v1_model.mjs
    compact_color_group_controls.mjs
    color_picker_widget.mjs
    prompt_preset.js
    bbox_loader.js
    polygon_mask.js
    polygon_mask_app_mode_load_image_compat.js
    polygon_mask_connection.mjs
    polygon_mask_image_state.mjs
    polygon_mask_panel.mjs
    polygon_mask_state.mjs
    rmbg_config.js
    rmbg_config_panel.mjs
    sam3_complex_collector.js
    prompt_preset_model.mjs
    styles.json
    thumbs/
  tests/

提示词节点

SeedreamExhibitionPromptBuilder 是面向 Seedream 5.0 Pro 的展厅提示词节点，复用 web/styles.json 和 web/prompt_preset.js 的缩略图选择器，节点输入在前端统一显示中文标签。base_prompt 始终作为基础输入并显示在面板顶部；模板模式在其后按目标、参考约束、人物要求、设计材质、配色、灯光摄影组织段落。Color Picker 输入会同时输出自然语言色彩语义和标准化 #RRGGBB。应用构建模式可把缩略图至“附加细节描述”合并为一个“提示词模板”面板，并由 use_theme_template 控制最终应用中的整组显隐。

GPTImage2MaterialPrompt 复用共享的缩略图按钮与网格交互，通过 web/materials.json 建立可扩充材质目录。面板顶部以独立的 1:1 Viewport 放大显示当前选中材质，下方八个 1:1 缩略图按钮固定为四列两行；所有预览统一使用正视圆角方形样片，亚金、亚银保留金属固有色，其余材质为灰阶。“编辑目标（可选）”默认留空，只有用户填写后才会写入输出；旧工作流保存的旧自动默认文案会迁移为空，旧颜色值和颜色开关会被丢弃。节点不包含颜色选择功能，提示词和 material_semantics 只使用无色的材质物理语义，并明确锁定 Image 1 参考图中已有的局部颜色和颜色分区。材质图不会自动传入图像输入。

Badge Material Region V1 (DAELab) 面向徽章第二阶段渲染前的区域材质配置。每个紧凑列表项包含“平面图源区域颜色与匹配阈值 / 材质目录选项”两行；取色器只识别 images 中的源色块，不提供输出目标色。节点默认把未命中的徽章前景设为透明清漆，但工作流可以显式选择其他默认材质；普通材质继承原始平面图固有色，亚金和亚银允许使用自身固有金银色。在 #8.4 - Badge Workflow 中，第一个 GPT Image 2 节点输出带参考色烤漆的结构基础成片；第二个 GPT Image 2 节点以该彩色成片作为 Image 1、以原始平面色块图作为 Image 2，并只在选定区域覆盖材质。#8.4 将未匹配区域设为烤漆，以保持第一阶段表面连续性。诊断预览和验证报告用于检查空规则、重叠颜色与默认材质覆盖区域。

交互式节点

• Boolean List Hierarchy 使用稳定条目 ID 保存连线，支持 Root、子项、孙项、同父项互斥组、跨分支多前置依赖、整棵子树排序、缩进、提升和递归级联删除。
• Boolean List Hierarchy Get 无需连接来源节点，可选择一个 Root 分支并自动同步该分支的输出及其跨分支依赖上下文。
• Boolean Group Bypass Controller 是前端虚拟控制器，不参与正常 API Prompt；它支持 Hierarchy 与 Hierarchy Get 双来源，并允许父 Bool 的外层组与子 Bool 的内层组按 Bypass 优先规则安全合成。
• Multi Color Mask (DAELab) 默认显示一组颜色匹配设置，可增加到 16 组；单一输出口由 output_mask 在指定 mask_N 和 combined_mask 之间切换。
• Multi Color Mask V1 (DAELab) 是独立的新版本节点，不替换旧节点。每个颜色组使用“颜色与阈值 / 反转匹配”两行布局；先选中颜色组，再用 ICON 在其后新增或删除。输出选择与增删共用紧凑工具栏，删除或插入后会保持原输出目标，不会因索引移动而错选其他颜色。
• Badge Height Layer (DAELab) 复用 Multi Color Mask 的颜色控件，可把最多 16 种颜色分别映射为镂空及一至五层，并同时输出高度 MASK、灰度 IMAGE、未匹配区域和实际命中层级档案；Badge Height Establish Prompt Builder 读取该档案，并可选接收材质语义，动态生成高度 Prompt、完整基础成片 Prompt 与诊断报告。
• Badge Height Layer V1 (DAELab) 是独立的新版本节点，不替换旧节点。每个颜色层使用“颜色与阈值 / 语义高度”两行布局；先选中颜色层，再用 ICON 在其后新增或删除该层。层级文案明确显示最低、次低、中间、次高、最高层，以及对应的 H=0.2–1.0 和灰度值。配置通过隐藏 height_layer_config 显式进入 Prompt 和缓存键，并追加实际配置、摘要与报告输出供前后端核对。
• Polygon Mask 可直接读取当前工作流中相连 Load Image 的选择；其他图像来源先接收不会覆盖持久状态的执行预览，再由 Apply Preview 明确应用。换图会保留有效 Polygon，并在分辨率变化时按宽高比例缩放顶点。
• SAM3 Complex Collector 的首次 Run 会只执行必要的上游依赖和 collector 以建立缓存，后续可在不执行下游节点的情况下更新当前交互式 prompt 或全部 BBox prompt 的预览。

应用构建模式

• web/app_mode_bypass.js 统一监听本库节点的 Active、Bypass、Mute 等模式，并折叠最终应用中属于非正常执行节点的输入项；恢复 Active 后会恢复原面板状态。
• GPTImage2Config、GPTImage2MaterialPrompt、BadgeReliefPrompt、RMBGConfig、PolygonMask 和 SeedreamExhibitionPromptBuilder 会参与统一的 App Mode Bypass 显隐；已有组合面板节点继续把原生 widget 折叠为稳定输入。
• DAELabMultiColorMask 的动态颜色组和输出选择可加入应用输入；节点进入 Bypass、Mute 等状态后，这些输入会随节点一起折叠。
• DAELabMultiColorMaskV1 将颜色组与输出选择折叠为一个紧凑组合面板，并复用共享 App Mode Bypass 逻辑。
• DAELabBadgeHeightLayer 的动态颜色组会参与相同的 App Mode Bypass 折叠与恢复逻辑。
• DAELabBadgeHeightLayerV1 的紧凑组合面板同样复用共享 App Mode Bypass 折叠与恢复逻辑。
• AppModeLoadImage 保留原生 LoadImage 的上传、Mask 和缓存语义，同时参与应用输入的 Bypass 显隐；polygon_mask_app_mode_load_image_compat.js 负责让 Polygon Mask 正确识别该节点。
• 普通工作流画布仍保留原生 socket、widget 和序列化键；组合面板只改变应用构建器中的呈现方式，不改变后端输入名称。

依赖与交付

• 请复制或克隆整个仓库目录，不要只复制单个 nodes/<name>/ 子目录；根 __init__.py 负责节点注册，WEB_DIRECTORY = "./web" 负责加载组合面板、缩略图和交互脚本。
• Python 依赖主要来自 ComfyUI Core，包括 comfy_api.latest、PyTorch、NumPy、Pillow 和 aiohttp。根目录 requirements.txt 只额外声明分镜文档解析所需的 python-docx、openpyxl 与 pdfplumber；不使用分镜文档导入时，其他节点不依赖这些解析库。
• V3 节点要求接收方的 ComfyUI 提供 comfy_api.latest。若启动日志出现 No module named 'comfy_api'，应更新 ComfyUI Core，而不是单独安装同名 pip 包。
• comfyui-sam3 是 SAM3 Collector 的可选软依赖；不使用 SAM3 节点时，不影响提示词、Config、Polygon Mask 或 App Mode Load Image。
• 完整展厅工作流中的 OpenAI、RMBG、SAM3 等生成或分割节点仍需各自的 Custom Nodes、模型、API 凭证及网络条件，这些不属于本库配置节点本身的运行依赖。

测试

仓库同时包含 Python 后端测试和 Node.js 前端纯逻辑测试：

python -m unittest discover -s tests -p "test_*.py"
node --test tests/*.test.mjs

完整编译检查请在 ComfyUI 根目录执行：

.\.venv\Scripts\python.exe -m compileall .\custom_nodes\ComfyUI-DAELab-Custom-Nodes-Library

安装

将仓库克隆到 ComfyUI 的 custom_nodes 目录：

cd <ComfyUI>\custom_nodes
git clone https://github.com/TeutonicMepheles/ComfyUI-DAELab-Custom-Nodes-Library.git

安装后重启 ComfyUI。

更新

在仓库目录中执行：

cd <ComfyUI>\custom_nodes\ComfyUI-DAELab-Custom-Nodes-Library
git pull

更新后建议重启 ComfyUI，确保前端脚本和节点定义重新加载。

注意事项

• 节点 ID 保持稳定，用于兼容已有工作流。
• 仓库按“每个节点一个目录”的方式组织后端代码和节点说明文档。
• 不要同时启用旧的分散节点目录，否则可能出现重复节点 ID。
• 前端资源集中放在 web/ 下，以保持 ComfyUI 的 WEB_DIRECTORY 加载方式稳定。