# Playbook3D ComfyUI 插件完全教程 ## 1. 插件简介 Playbook3D ComfyUI 插件（GitHub地址：https://github.com/playbook3d/playbook3d-comfyui-nodes）是一个让你在ComfyUI里面直接使用3D渲染的神器。想象一下，你有一个3D场景，这个插件就像一个万能照相机，可以从不同角度、用不同模式给你的3D场景拍照。 这个插件能给你四种不同的"拍照模式"：最终成品照片（Beauty）、轮廓线照片（Canny）、距离远近照片（Depth）、还有特定物体的遮罩照片（Mask）。就像你用手机拍照时可以选择普通模式、人像模式、夜景模式一样简单。 ## 2. 如何安装 ### 方法一：手动安装（推荐新手） 1. 打开你的ComfyUI文件夹 2. 找到里面的"custom_nodes"文件夹（就像一个专门放插件的盒子） 3. 下载这个插件的所有文件 4. 把下载的文件全部放进"custom_nodes"文件夹里 5. 重启ComfyUI ### 方法二：用ComfyUI管理器（如果你装了的话） 1. 打开ComfyUI管理器 2. 搜索"playbook3d" 3. 点击安装 4. 重启ComfyUI ### 额外准备工作 - 你需要去 beta.playbook3d.com 注册一个账号 - 获取你的专属钥匙（API key），这就像你家的钥匙一样，用来证明你的身份 ## 3. 节点详细解析 ### 3.1 Playbook Beauty节点 - 最终成品照片机 这个节点就像一个专业摄影师，给你的3D场景拍出最漂亮的成品照片。想象你做了一个3D房间，这个节点就能给你拍出装修杂志那样的精美照片。 #### 参数详解表格 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | API密钥 | api_key | 文本 | 你的专属密钥 | 这就像你家的钥匙，用来证明你的身份 | 用于验证用户身份的认证令牌 | 从playbook3d网站获取后填入 | | 场景ID | scene_id | 文本 | 你的3D场景编号 | 告诉插件你要拍哪个3D场景的照片 | 指定要渲染的3D场景标识符 | 在playbook3d创建场景后获得 | | 渲染质量 | quality | 选择 | high/medium/low | 就像手机拍照的高清/标清选项 | 控制输出图像的分辨率和质量 | 高质量更清晰但耗时更久 | | 输出格式 | format | 选择 | png/jpg | 选择保存照片的格式 | 指定输出图像的文件格式 | PNG支持透明，JPG文件更小 | ### 3.2 Playbook Canny节点 - 轮廓线提取机 这个节点就像一个会画线稿的艺术家，能把你的3D场景的所有轮廓线都描出来。就像你小时候描红本一样，把所有边缘都用线条勾勒出来。 #### 参数详解表格 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | API密钥 | api_key | 文本 | 你的专属密钥 | 这就像你家的钥匙，用来证明你的身份 | 用于验证用户身份的认证令牌 | 从playbook3d网站获取后填入 | | 场景ID | scene_id | 文本 | 你的3D场景编号 | 告诉插件你要提取哪个3D场景的轮廓线 | 指定要处理的3D场景标识符 | 在playbook3d创建场景后获得 | | 线条粗细 | line_thickness | 数字 | 1-5 | 控制描出来的线条有多粗 | 设置边缘检测的线条宽度 | 数字越大线条越粗 | | 敏感度 | sensitivity | 数字 | 0.1-1.0 | 控制多细微的边缘都要描出来 | 调整边缘检测的敏感程度 | 越高连很细的边缘都会描出来 | | 输出格式 | format | 选择 | png/jpg | 选择保存线稿的格式 | 指定输出图像的文件格式 | PNG支持透明背景 | ### 3.3 Playbook Depth节点 - 距离远近信息机 这个节点就像一个测距仪，能告诉你场景里每个地方离镜头有多远。近的地方是白色，远的地方是黑色，就像黑白照片一样显示距离信息。 #### 参数详解表格 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | API密钥 | api_key | 文本 | 你的专属密钥 | 这就像你家的钥匙，用来证明你的身份 | 用于验证用户身份的认证令牌 | 从playbook3d网站获取后填入 | | 场景ID | scene_id | 文本 | 你的3D场景编号 | 告诉插件你要获取哪个3D场景的距离信息 | 指定要处理的3D场景标识符 | 在playbook3d创建场景后获得 | | 最近距离 | near_distance | 数字 | 0.1 | 设置最近能看到多近的物体 | 定义深度图的最近裁剪平面 | 太小可能看不到很近的物体 | | 最远距离 | far_distance | 数字 | 100 | 设置最远能看到多远的物体 | 定义深度图的最远裁剪平面 | 太大可能所有东西都显示成黑色 | | 反转颜色 | invert | 开关 | false | 把远近的黑白颜色对调 | 反转深度图的颜色映射 | 开启后近的变黑，远的变白 | | 输出格式 | format | 选择 | png/jpg | 选择保存距离图的格式 | 指定输出图像的文件格式 | PNG质量更好 | ### 3.4 Playbook Mask节点 - 物体遮罩生成机 这个节点就像一个智能剪刀，能把你指定的物体从3D场景中"剪"出来。比如你想要单独处理一把椅子，这个节点就能给你生成一个椅子形状的白色遮罩。 #### 参数详解表格 | 参数名 (界面显示) | 参数名 (代码里) | 参数值类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | API密钥 | api_key | 文本 | 你的专属密钥 | 这就像你家的钥匙，用来证明你的身份 | 用于验证用户身份的认证令牌 | 从playbook3d网站获取后填入 | | 场景ID | scene_id | 文本 | 你的3D场景编号 | 告诉插件你要从哪个3D场景生成遮罩 | 指定要处理的3D场景标识符 | 在playbook3d创建场景后获得 | | 目标物体 | target_object | 文本 | 物体名称 | 指定你要"剪"出来的物体名字 | 指定要生成遮罩的特定对象 | 比如"chair"、"table"等 | | 材质过滤 | material_filter | 文本 | 材质名称 | 根据材质来选择物体 | 基于材质属性过滤对象 | 比如"wood"、"metal"等 | | 遮罩类型 | mask_type | 选择 | binary/soft | 选择硬边遮罩还是软边遮罩 | 控制遮罩边缘的类型 | binary是纯黑白，soft有灰度过渡 | | 边缘模糊 | edge_blur | 数字 | 0-10 | 让遮罩边缘变得模糊 | 对遮罩边缘应用模糊效果 | 数字越大边缘越模糊 | | 输出格式 | format | 选择 | png/jpg | 选择保存遮罩的格式 | 指定输出图像的文件格式 | PNG支持透明，适合遮罩 | ## 4. 使用技巧和建议 ### 4.1 工作流程建议 1. **先用Beauty节点**：就像拍照前先看看整体效果，确保你的3D场景看起来不错 2. **再用其他节点**：根据你的需要添加Canny、Depth或Mask节点 3. **组合使用**：比如用Beauty节点得到基础图，用Canny节点得到线稿，最后合成创意效果 ### 4.2 参数调节技巧 - **质量设置**：做实验时用低质量快速预览，最终输出时用高质量 - **距离设置**：Depth节点的远近距离要根据你的场景大小调整 - **敏感度控制**：Canny节点的敏感度从低开始调，逐渐增加到合适的效果 ### 4.3 常见组合用法 - **线稿风格**：Beauty + Canny，可以做出手绘风格的效果 - **景深效果**：Beauty + Depth，可以制作模糊背景的效果 - **物体替换**：Beauty + Mask，可以单独处理某个物体 ## 5. 常见问题解答 ### Q1: 为什么我的节点显示"连接失败"？ **A1**: 检查以下几点： - 你的API密钥是否正确填写 - 网络连接是否正常 - 场景ID是否存在 ### Q2: 为什么生成的图片是黑色的？ **A2**: 可能的原因： - 场景没有正确设置灯光 - Depth节点的远近距离设置不合理 - 场景ID错误 ### Q3: 如何获取场景ID？ **A3**: 在playbook3d.com网站上创建或打开你的3D场景，场景ID会显示在网址中或场景信息里。 ### Q4: 不同节点可以同时使用吗？ **A4**: 当然可以！这些节点就像不同的照相机，你可以同时用它们从不同角度"拍照"同一个场景。 ### Q5: 渲染需要多长时间？ **A5**: 这取决于你的场景复杂度和质量设置： - 简单场景 + 低质量：几秒钟 - 复杂场景 + 高质量：几分钟 ## 6. 创意应用案例 ### 案例1：制作产品展示图 1. 用Beauty节点获得产品的漂亮渲染图 2. 用Mask节点生成产品遮罩 3. 在ComfyUI中添加不同背景，制作多种展示效果 ### 案例2：创作艺术风格图片 1. 用Beauty节点作为基础图层 2. 用Canny节点提取线稿 3. 混合两者创造独特的艺术风格 ### 案例3：制作深度效果 1. 用Beauty节点获得彩色图像 2. 用Depth节点获得深度信息 3. 利用深度信息制作景深模糊效果 ## 总结 Playbook3D ComfyUI插件就像给你的ComfyUI装上了一个3D摄影棚。通过四个不同的"照相机"（节点），你可以从不同角度、用不同方式来"拍摄"你的3D场景。每个节点都有自己的特殊功能，组合使用可以创造出无限的可能性。 记住，刚开始使用时不要害怕实验，多试试不同的参数组合，你会发现很多意想不到的效果。就像学开车一样，熟练了之后，这些节点就会成为你创作的得力助手！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
