%20(1).png)
BilboX's ComfyUI Custom Nodes 插件完全教程
1. 插件简介
BilboX's ComfyUI Custom Nodes 是一个功能丰富的 ComfyUI 插件集合，插件原地址：https://github.com/syllebra/bilbox-comfyui
这个插件就像是给你的 ComfyUI 装了一个专业的摄影工作室，它能帮你：
- 摄影提示词大师（PromptGeek Photo Prompt）：就像有一个专业摄影师在旁边指导，帮你组合出专业级的摄影提示词，包含各种摄影风格、灯光、相机设置等
- 颜色调色师（LUT Color Correction）：就像电影调色师一样，用专业的颜色查找表让你的图片呈现电影级的色彩效果
- 暗角艺术家（Vignette Effect）：给图片加上优雅的暗角效果，让主体更突出，就像老式相机的自然效果
- 远程控制管家（Server Control）：可以远程控制服务器的关机、重启等操作，就像有个贴心管家
这个插件特别适合想要制作专业摄影风格图片的用户，提供了大量真实摄影师和摄影技术的数据库。
2. 如何安装
前置条件
- 确保你已经安装了 ComfyUI
- 确保有 git 工具
安装步骤
- 打开终端或命令行
- 进入你的 ComfyUI 安装目录下的
custom_nodes文件夹 - 运行以下命令：
git clone https://github.com/syllebra/bilbox-comfyui.git
- 重启 ComfyUI
LUT 文件设置（可选）
如果要使用 LUT 颜色校正功能：
- 将 .cube 格式的 LUT 文件放到
custom_nodes/bilbox-comfyui/luts文件夹 - 或者在
custom_nodes/bilbox-comfyui/luts_directory.txt文件中指定你的 LUT 文件目录
3. 节点详细解析
3.1 BilboX PromptGeek Photo Prompt 节点（摄影提示词大师）
这个节点就像一个专业的摄影指导老师，它包含了大量真实摄影师的作品风格和摄影技术数据，能帮你组合出专业级的摄影提示词。就像有个摄影专家在旁边告诉你"用这个灯光、这个角度、这个相机设置"。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模态选择框 | modal_combos | 布尔值 | True | 选择用弹窗模式还是提示模式来选择选项，就像选择看大图还是小图预览 | 控制下拉菜单的显示模式，弹窗模式显示大图预览 | True显示大图弹窗，False显示小提示框 |
| 摄影风格 | style | 下拉选择 | 根据需求选择 | 选择照片的整体风格，就像选择"复古风"、"时尚风"、"纪实风"等 | 选择摄影作品的艺术风格和表现手法 | 选择"beauty"会让照片偏向美妆摄影风格 |
| 拍摄主体 | subject | 多行文本 | 根据需求填写 | 描述你要拍摄的主要对象，就像告诉摄影师"我要拍什么" | 描述照片的主要拍摄对象和细节特征 | 输入"一个穿红裙子的女孩，微笑着，手里拿着花" |
| 构图方式 | framing | 下拉选择 | 根据需求选择 | 选择拍摄的构图方式，就像选择"全身照"、"半身照"、"特写"等 | 确定照片的取景范围和构图方式 | 选择"close up on face"会拍摄面部特写 |
| 场景背景 | setting_background | 多行文本 | 根据需求填写 | 描述拍摄的场景和背景，就像选择"在公园里"、"在咖啡厅"等 | 描述拍摄环境和背景设置 | 输入"在一个温馨的咖啡厅里，窗外有阳光" |
| 灯光效果 | lighting | 下拉选择 | 根据需求选择 | 选择灯光类型，就像选择"柔和光线"、"戏剧性光线"、"自然光"等 | 选择照片的光照条件和光线效果 | 选择"golden hour"会产生温暖的黄昏光线效果 |
| 拍摄角度 | camera_angle | 下拉选择 | 根据需求选择 | 选择相机的拍摄角度，就像选择"平视"、"俯拍"、"仰拍"等 | 确定相机相对于被摄对象的位置角度 | 选择"from above/high angle"会从上往下拍摄 |
| 相机属性 | camera_properties | 下拉选择 | 根据需求选择 | 选择相机型号，不同相机有不同的成像特点，就像选择"胶片相机"、"数码相机"等 | 指定特定相机设备的成像特征 | 选择"Canon EOS 5D"会模拟佳能5D的成像效果 |
| 胶片类型 | film_types | 下拉选择 | 根据需求选择 | 选择胶片类型，影响照片的色彩和质感，就像选择"彩色胶片"、"黑白胶片"等 | 指定胶片的品牌和特性，影响色彩表现 | 选择"Kodak Portra 160"会产生柔和的肖像色彩 |
| 镜头类型 | lenses | 下拉选择 | 根据需求选择 | 选择镜头类型，影响视角和景深，就像选择"广角镜头"、"长焦镜头"等 | 指定镜头的焦距和光学特性 | 选择"50mm"会产生接近人眼视角的自然透视 |
| 滤镜效果 | filters_effects | 下拉选择 | 根据需求选择 | 选择特殊效果，就像给照片加"美颜滤镜"、"复古滤镜"等 | 应用各种光学滤镜和后期效果 | 选择"black and white"会产生黑白照片效果 |
| 摄影师风格 | photographers | 下拉选择 | 根据需求选择 | 选择著名摄影师的风格，就像模仿"安塞尔·亚当斯"、"安妮·莱博维茨"等大师 | 模拟知名摄影师的拍摄风格和技法 | 选择"Richard Avedon"会模拟这位时尚摄影大师的风格 |
| 预览 | preview | 多行文本 | 自动生成 | 显示最终组合的提示词预览，就像看"菜谱"的最终效果 | 实时显示组合后的完整提示词 | 自动显示组合后的完整摄影提示词 |
| 记录日志 | log_prompt | 下拉选择 | "No" | 选择是否在控制台打印提示词，方便调试 | 控制是否在控制台输出生成的提示词 | 选择"Yes"会在控制台显示生成的提示词 |
3.2 BilboX post-processing LUT 节点（颜色调色师）
这个节点就像一个专业的电影调色师，使用 LUT（颜色查找表）来调整图片的色彩，就像给照片套上不同的"滤镜"，但比普通滤镜更专业、更精确。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE类型 | 必填 | 这是你要调色的原始图片，就像给调色师一张照片 | 需要进行颜色校正的输入图像 | 连接前面节点输出的图片 |
| LUT文件名 | lut_name | 下拉选择 | 从列表选择 | 选择要使用的调色方案，就像选择"电影风格"、"复古风格"等预设 | 选择要应用的LUT颜色查找表文件 | 选择"cinematic.cube"会应用电影级调色效果 |
| 对数色彩空间 | log | 下拉选择 | "No" | 选择是否使用对数色彩空间，就像选择"专业模式"还是"普通模式" | 是否在对数色彩空间中应用LUT | 一般选择"No"，除非你的LUT是专门为对数空间设计的 |
| 打印信息 | 下拉选择 | "No" | 选择是否显示详细的处理信息，方便调试 | 是否在控制台输出LUT处理的详细信息 | 选择"Yes"可以看到LUT文件的详细信息 |
3.3 BilboX post-processing vignette effect 节点（暗角艺术家）
这个节点就像一个专业的暗角效果师，能给图片添加优雅的暗角效果，让图片边缘逐渐变暗，突出中心的主体，就像老式相机镜头的自然暗角效果。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE类型 | 必填 | 这是你要添加暗角效果的原始图片 | 需要应用暗角效果的输入图像 | 连接前面节点输出的图片 |
| 暗角大小 | size | 浮点数 | 0.0-10.0 | 控制暗角的大小范围，就像调节"暗角覆盖面积" | 控制暗角效果的扩散范围 | 设置为5.0会产生中等程度的暗角效果 |
| 暗角透明度 | opacity | 浮点数 | 0.0-1.0 | 控制暗角的深浅程度，就像调节"暗角的浓度" | 控制暗角效果的不透明度强度 | 设置为0.8会产生较明显但不过分的暗角 |
3.4 Context Menu Enhancement 功能（右键菜单增强）
这是一个前端增强功能，为 PromptGeek Photo Prompt 节点提供更好的用户体验。
功能特点
| 功能名称 | 功能描述 | 通俗解释 | 专业解释 | 使用方法 |
|---|---|---|---|---|
| 提示模式 | 鼠标悬停显示预览图和说明 | 就像商品目录，鼠标放上去就能看到商品图片和介绍 | 在下拉菜单项上悬停时显示缩略图和描述信息 | 鼠标悬停在选项上即可看到预览 |
| 弹窗模式 | 全屏显示所有选项的大图预览 | 就像打开一个图片画廊，可以看到所有选项的大图 | 显示模态窗口，展示所有选项的大图预览 | 点击下拉菜单会弹出全屏选择窗口 |
| 实时预览 | 自动组合并显示最终提示词 | 就像菜谱预览，实时显示你选择的"配料"组合效果 | 实时更新并显示组合后的完整提示词 | 每次选择选项后自动更新预览框 |
| 样式美化 | 为界面添加专业的视觉样式 | 让界面看起来更专业、更美观 | 通过CSS样式表美化用户界面 | 自动应用，无需手动设置 |
3.5 Server Control 功能（远程控制管家）
这是一个前端功能，可以远程控制运行 ComfyUI 的服务器。
功能特点
| 功能名称 | 功能描述 | 通俗解释 | 专业解释 | 使用方法 |
|---|---|---|---|---|
| 锁定会话 | 锁定服务器屏幕 | 就像给电脑上锁，别人不能随便使用 | 调用系统锁屏功能保护服务器安全 | 点击"Lock Session"按钮 |
| 注销登录 | 注销当前用户 | 就像从电脑上"退出登录" | 注销当前用户会话但不关闭系统 | 点击"Logout"按钮 |
| 重启系统 | 重启服务器 | 就像重启电脑一样 | 安全重启服务器系统 | 点击"Reboot"按钮 |
| 关闭系统 | 关闭服务器 | 就像关闭电脑一样 | 安全关闭服务器系统 | 点击"Shutdown"按钮 |
| 安全开关 | 可以在设置中开启/关闭此功能 | 防止误操作，可以隐藏这些危险按钮 | 通过设置控制功能的显示状态 | 在设置中找到"Show distant server shutdown menu"开关 |
4. 使用技巧和建议
4.1 PromptGeek Photo Prompt 使用技巧
- 风格搭配：不同的摄影风格要搭配合适的灯光和相机设置，比如"beauty"风格配"soft lighting"
- 提示模式选择：新手建议用弹窗模式（modal_combos=True），可以看到大图预览
- 主体描述：在subject字段要详细描述，包括外观、动作、表情等
- 预览功能：随时查看preview字段，确保提示词符合预期
4.2 LUT 调色使用技巧
- LUT文件准备：收集一些高质量的.cube格式LUT文件
- 效果测试：同一张图片可以尝试不同的LUT，找到最合适的效果
- 对数空间：一般情况下保持log为"No"，除非你的LUT专门为对数空间设计
- 组合使用：可以先用LUT调色，再用暗角效果增强氛围
4.3 暗角效果使用技巧
- 适度原则：暗角效果不要过强，一般opacity设置在0.6-0.8之间
- 尺寸调节：size参数根据图片内容调整，人像可以小一些，风景可以大一些
- 风格搭配：暗角效果特别适合复古风格和肖像摄影
- 后期顺序：建议在其他后期处理之后再添加暗角
4.4 服务器控制使用技巧
- 安全第一：使用前确保重要工作已保存
- 权限确认：确保有足够的系统权限执行这些操作
- 网络考虑：远程操作时注意网络连接稳定性
- 谨慎使用：建议在设置中关闭此功能，避免误操作
5. 常见问题解答
Q1：PromptGeek 节点的选项太多，怎么选择？
A1：
- 新手建议开启弹窗模式，可以看到每个选项的效果图
- 从基础开始：先选风格，再选灯光，最后选细节
- 多看预览框，实时了解组合效果
- 可以参考插件提供的示例图片
Q2：LUT 文件在哪里下载？
A2：
- 可以从专业调色网站下载，如 LUT.com
- 一些摄影师会分享自己的LUT文件
- 确保下载的是.cube格式的文件
- 注意版权问题，使用免费或已购买的LUT
Q3：暗角效果看起来不自然怎么办？
A3：
- 降低opacity值，让效果更subtle
- 调整size值，找到合适的覆盖范围
- 确保原图质量足够好
- 可以尝试不同的参数组合
Q4：服务器控制功能不工作怎么办？
A4：
- 检查是否在设置中开启了此功能
- 确认服务器系统支持这些命令
- 检查用户权限是否足够
- 注意这个功能主要适用于Windows系统
Q5：如何获得最佳的摄影效果？
A5：
- 学习真实摄影知识，理解各种参数的含义
- 多尝试不同的组合，建立自己的风格库
- 参考真实摄影师的作品
- 结合其他ComfyUI节点使用
6. 高级应用场景
6.1 专业摄影工作流
结合PromptGeek节点和后期处理节点：
- 使用PromptGeek生成专业摄影提示词
- 用LUT节点进行电影级调色
- 用暗角节点增强氛围感
- 创建完整的摄影后期流程
6.2 风格化图片制作
利用丰富的摄影数据库：
- 模拟不同年代的摄影风格
- 重现经典摄影师的作品风格
- 创建独特的视觉风格
- 批量制作风格统一的图片
6.3 教学和学习
作为摄影教学工具：
- 学习不同摄影风格的特点
- 理解灯光对照片的影响
- 掌握构图和角度的运用
- 培养摄影审美能力
6.4 商业应用
用于商业图片制作：
- 制作产品宣传图片
- 创建品牌风格图片
- 生成社交媒体内容
- 制作广告素材
7. 技术原理简介（可选阅读）
7.1 PromptGeek 数据库
- 数据来源：基于PromptGeek的专业摄影教程书籍
- 数据结构：JSON格式存储各种摄影参数和描述
- 图片预览：每个选项都配有真实的效果图片
- 动态组合：前端JavaScript实时组合提示词
7.2 LUT 颜色处理
- LUT原理：使用3D颜色查找表进行颜色映射
- 文件格式：支持.cube格式的LUT文件
- 颜色空间：支持线性和对数色彩空间
- 处理算法：基于colour库的专业颜色处理
7.3 暗角算法
- 数学模型：基于径向距离的渐变计算
- 优化改进：修复了原版插件的一些问题
- 性能优化：使用PyTorch进行GPU加速计算
- 参数映射：将用户友好的参数映射到数学模型
8. 更新日志和致谢
致谢
感谢以下项目和个人的贡献：
- PromptGeek：提供了丰富的摄影数据和教程
- EllangoK：ComfyUI-post-processing-nodes项目的启发
- Yoonsikp：pycubelut项目的LUT处理算法
- BilboX：插件的主要开发者
数据来源
- 摄影风格数据来自PromptGeek的专业摄影教程
- 包含18种摄影风格、4种构图方式、20种灯光效果
- 涵盖4种拍摄角度、20种相机设备、12种胶片类型
- 包含3种镜头类型、20种滤镜效果、37位知名摄影师风格
相关链接
- 插件地址：https://github.com/syllebra/bilbox-comfyui
- PromptGeek教程：https://promptgeek.gumroad.com/photoreal
- PromptGeek YouTube：https://www.youtube.com/@PromptGeek
总结：BilboX's ComfyUI Custom Nodes 是一个专业的摄影风格插件，为ComfyUI用户提供了丰富的摄影知识数据库和专业的后期处理工具。无论是摄影爱好者还是专业用户，都能从中获得灵感和实用的工具。
记住：好的摄影不仅仅是技术，更是艺术。多学习、多实践、多观察真实的摄影作品，你会发现更多的可能性！