Avatar Graph ComfyUI 插件完全教程

1. 插件简介

插件地址： https://github.com/avatechai/avatar-graph-comfyui

这个插件是专门用来制作实时互动虚拟角色的神器！简单来说，就是把一张静态的人物图片变成可以眨眼、张嘴、做表情的活动角色。

能给我们带来什么效果？

• 把静态图片变成会动的虚拟人物
• 制作会眨眼的角色（就像真人一样自然）
• 制作会说话时嘴巴动的角色（口型同步）
• 制作各种表情变化的角色
• 导出成可以在网页或其他软件中使用的3D模型

想象一下：你有一张喜欢的动漫角色图片，用这个插件就能让她活过来，会眨眼会说话！

2. 如何安装

方法一：通过 ComfyUI Manager 安装（推荐）

1. 打开 ComfyUI
2. 点击 Manager 按钮
3. 搜索 "avatar-graph-comfyui"
4. 点击安装
5. 重启 ComfyUI

方法二：手动安装

1. 进入 ComfyUI 的 custom_nodes 文件夹
2. 运行命令：git clone https://github.com/avatechai/avatar-graph-comfyui.git
3. 进入插件文件夹：cd avatar-graph-comfyui
4. 安装依赖：python -m pip install -r requirements.txt
5. 重启 ComfyUI（启动时加上参数：--enable-cors-header）

注意： 这个插件需要 Python 3.10 版本，因为要用到 Blender 的功能。

3. 节点详细解析

本插件总共包含约150+个节点，本教程将逐一详细解释每个节点的用途和参数。

3.1 Avatar Main Output 节点 - 最终输出节点

这是整个工作流程的"终点站"，就像一个打包机，把所有制作好的角色部件打包成最终的文件。

参数详解：

3.2 Create Shape Flow 节点 - 动画控制器

这个节点就像一个"遥控器"，用来控制角色的各种动作和表情。

参数详解：

3.3 Create Mesh Layer 节点 - 创建网格层

这个节点就像一个"裁剪工具"，把图片的某个部分（比如眼睛）变成3D的网格。

参数详解：

3.4 SAM MultiLayer 节点 - 智能分割工具

这是一个超级智能的"剪刀"，能自动识别并分割出图片中的眼睛、嘴巴、脸部等不同区域。

参数详解：

3.5 Join Meshes 节点 - 合并网格

这个节点就像"胶水"，把多个分开的部件（眼睛、嘴巴等）粘合成一个完整的角色。

参数详解：

3.6 Match Texture Aspect Ratio 节点 - 匹配纹理比例

这个节点就像"调整画框"，确保3D模型的比例和原图片一致，不会变形。

参数详解：

3.7 Plane Texture Unwrap 节点 - 平面纹理展开

这个节点就像"贴壁纸"，把图片正确地贴到3D平面上。

参数详解：

3.8 Modify Shape Key 节点 - 修改形状键

这是制作表情动画的核心节点，就像"表情调节器"，控制眼睛闭合、嘴巴张开等动作。

参数详解：

3.9 Set Shape Key Value 节点 - 设置形状键数值

这个节点就像"表情强度调节器"，控制表情动作的强弱程度。

参数详解：

3.10 Add Shape Keys 节点 - 添加形状键

这个节点就像"表情库管理器"，为角色添加各种表情的基础框架。

参数详解：

3.11 Assign Texture 节点 - 分配纹理

这个节点就像"化妆师"，把图片材质正确地涂抹到3D模型上。

参数详解：

3.12 Create Vertex Group 节点 - 创建顶点组

这个节点就像"区域划分器"，把3D模型的不同部分分组管理。

参数详解：

3.13 Assign Vertex Group 节点 - 分配顶点组

这个节点就像"贴标签"，把3D模型的某些部分标记为特定组。

参数详解：

3.14 Get First Obj 节点 - 获取第一个对象

这个节点就像"挑选器"，从一堆3D模型中挑出第一个来使用。

参数详解：

3.15 Group 节点 - 分组

这个节点就像"收纳盒"，把多个单独的3D模型装到一个盒子里方便管理。

参数详解：

3.16 To Group 节点 - 转为组

这个节点就像"单品装盒"，把一个3D模型包装成组的格式。

参数详解：

3.17 Mesh From Texture 节点 - 从纹理创建网格

这个节点就像"图片变立体"，把平面图片转换成有厚度的3D网格。

参数详解：

3.18 UV Modifier 节点 - UV修改器

这个节点就像"贴纸位置调整器"，微调图片在3D模型上的贴合位置。

参数详解：

3.19 Blender Render Image 节点 - Blender渲染图像

这个节点就像"拍照机"，把3D场景渲染成2D图片。

参数详解：

3.20 Get Image Width Height 节点 - 获取图像宽高

这个节点就像"尺子"，测量图片的长宽尺寸。

参数详解：

3.21 Load Image With Alpha 节点 - 加载带透明度图像

这个节点就像"透明图片加载器"，专门加载带透明背景的图片。

参数详解：

3.22 Image Alpha Mask Merge 节点 - 图像透明蒙版合并

这个节点就像"抠图合成器"，把图片和蒙版合并成带透明效果的图片。

参数详解：

3.23 Save Image With Workflow 节点 - 保存图像和工作流

这个节点就像"备份器"，保存图片的同时记录制作过程。

参数详解：

3.24 Export GLTF 节点 - 导出GLTF

这个节点就像"格式转换器"，把制作好的3D角色导出成通用的3D格式。

参数详解：

3.25 Export Blendshapes 节点 - 导出混合形状

这个节点就像"表情数据导出器"，专门导出角色的表情动画数据。

参数详解：

3.26 Combine Points 节点 - 合并点

这个节点就像"坐标收集器"，把多个点击位置合并成一个提示数据。

参数详解：

3.27 Extract Boundary Points 节点 - 提取边界点

这个节点就像"轮廓描边器"，自动找出图片中物体的边缘轮廓点。

参数详解：

3.28 Image Bridge 节点 - 图像桥接

这个节点就像"中转站"，用来传递图片数据，有时用于调试或数据流控制。

参数详解：

3.29 Load Image From Request 节点 - 从请求加载图像

这个节点就像"网络图片加载器"，可以从外部请求或指定位置加载图片。

参数详解：

3.30 Load Value From Request 节点 - 从请求加载数值

这个节点就像"数值获取器"，从外部获取数值参数。

参数详解：

3.31 B_ENUM 节点 - Blender枚举

这个节点就像"选项选择器"，用于在Blender中选择预设的选项值。

参数详解：

3.32 Vector 3D 节点 - 3D向量

这个节点就像"3D坐标器"，用来设置3D空间中的位置或方向。

参数详解：

3.33 Vector 4D 节点 - 4D向量

这个节点就像"4D坐标器"，用来设置包含额外参数的4D数据。

参数详解：

3.34 Apply Mesh Transform As Shape Key 节点 - 应用网格变换为形状键

这个节点就像"表情复制器"，把当前的网格变形状态保存成一个新的表情动画。

参数详解：

3.35 自动生成的Blender操作节点

除了上述手工制作的节点外，插件还自动生成了大量Blender操作节点，这些节点直接对应Blender软件中的各种操作。主要包括：

3.35.1 网格操作节点 (Mesh_*)

包含约80个网格编辑操作，如：

• Mesh_Extrude - 挤出操作，就像"拉伸橡皮泥"
• Mesh_Subdivide - 细分操作，就像"把大格子分成小格子"
• Mesh_Select_All - 全选操作，就像"框选所有内容"
• Mesh_Delete - 删除操作，就像"橡皮擦"

3.35.2 对象操作节点 (Object_*)

包含约60个对象操作，如：

• Object_Duplicate - 复制操作，就像"复印机"
• Object_Join - 合并操作，就像"胶水粘合"
• Object_Transform_Apply - 应用变换，就像"确认修改"

3.35.3 变换操作节点 (Transform_*)

包含约25个变换操作，如：

• Transform_Translate - 移动操作，就像"搬家"
• Transform_Rotate - 旋转操作，就像"转动魔方"
• Transform_Resize - 缩放操作，就像"放大镜"

3.35.4 UV操作节点 (UV_*)

包含约30个UV贴图操作，如：

• UV_Unwrap - UV展开，就像"剥橘子皮摊平"
• UV_Smart_Project - 智能投影，就像"自动贴壁纸"

3.35.5 基础形状节点 (Mesh_Primitive_*)

包含约10个基础形状创建，如：

• Mesh_Primitive_Cube_Add - 添加立方体，就像"搭积木"
• Mesh_Primitive_Plane_Add - 添加平面，就像"铺地板"

3.35.6 对象属性设置节点 (ObjectSet_*)

包含约40个属性设置操作，用于调整对象的各种属性。

3.35.7 对象方法调用节点 (ObjectCall_*)

包含约30个对象方法调用，用于执行对象的各种功能。

4. 自动生成节点详细解析

4.1 网格操作节点 (Mesh_*) - 共约80个

这些节点就像"3D雕刻工具箱"，用来编辑和修改3D网格的形状。

4.1.1 基础选择操作

4.1.2 基础编辑操作

4.1.3 高级变形操作

4.2 对象操作节点 (Object_*) - 共约60个

这些节点就像"物体管理器"，用来管理和操作整个3D对象。

4.2.1 基础对象操作

4.2.2 变换应用操作

4.2.3 材质和修改器操作

4.3 变换操作节点 (Transform_*) - 共约25个

这些节点就像"移动工具箱"，用来移动、旋转、缩放对象。

4.3.1 基础变换操作

4.3.2 高级变换操作

4.4 UV操作节点 (UV_*) - 共约30个

这些节点就像"贴纸工具箱"，用来控制纹理在3D模型上的贴合方式。

4.4.1 UV展开操作

4.4.2 UV编辑操作

4.5 基础形状节点 (Mesh_Primitive_*) - 共约10个

这些节点就像"积木盒"，用来创建各种基础的3D形状。

参数详解表格：

4.6 对象属性设置节点 (ObjectSet_*) - 共约40个

这些节点就像"属性调节器"，用来设置3D对象的各种属性值。

4.6.1 显示属性设置

4.6.2 变换属性设置

4.6.3 材质属性设置

4.7 对象方法调用节点 (ObjectCall_*) - 共约30个

这些节点就像"功能按钮"，用来执行3D对象的各种方法和功能。

4.7.1 形状键操作方法

4.7.2 网格转换方法

4.7.3 数据更新方法

4.8 顶点组操作节点 (Object_Vertex_Group_*) - 共约25个

这些节点就像"区域管理器"，用来管理3D模型的顶点分组。

4.8.1 顶点组基础操作

4.8.2 顶点组高级操作

4.9 Context Transform 节点 - 上下文变换

这个节点用来设置变换操作的上下文环境。

参数详解：

4.10 Apply Mesh Transform As Shape Key 节点增强版

这个节点的完整参数说明：

高级参数详解：

4. 使用技巧和建议

4.1 图片准备技巧

• 最佳图片要求：使用768x768以上分辨率的图片，角色要正面朝向
• 嘴巴状态：最好使用嘴巴微张的图片，这样制作口型动画效果更好
• 背景处理：建议使用纯色背景或透明背景的图片
• 光线均匀：避免阴影过重的图片，会影响分割效果

4.2 工作流程建议

1. 先分割后制作：使用SAM MultiLayer节点先把图片分割成不同区域
2. 分层制作：眼睛、嘴巴、脸部分别制作成独立的网格层
3. 逐步调试：每完成一个部分就测试一下效果
4. 保存节点：重要的节点设置要及时保存

4.3 表情制作技巧

• 眨眼效果：scale_y设为0.1-0.3，scale_x保持1.0
• 张嘴效果：scale_y设为1.2-1.5，可以配合轻微的offset_y
• 微笑效果：使用小幅度的rotate和offset组合
• 自然过渡：falloff参数设为0.5-1.0让变形更自然

4.4 性能优化建议

• 合理使用seed：相同的seed可以复现相同效果，便于调试
• 适当简化：不需要过于复杂的网格，简单的形状动画效果更好
• 批量处理：多个相似角色可以复用相同的工作流程

5. 常见问题解答

5.1 安装相关问题

Q: 安装时提示Python版本不对怎么办？
A: 这个插件需要Python 3.10版本，因为要用到bpy库。建议使用conda创建专门的环境：

conda create --name comfyui python=3.10
conda activate comfyui

Q: 提示找不到Blender怎么办？
A: 需要安装Blender软件，或者在Avatar Main Output节点中指定Blender的安装路径。

Q: SAM模型下载失败怎么办？
A: 插件会自动下载SAM模型，如果网络不好可以手动下载sam_vit_h_4b8939.pth文件放到models/sams文件夹中。

5.2 使用相关问题

Q: 分割效果不好怎么办？
A:

• 确保图片分辨率足够高（建议768x768以上）
• 角色要正面朝向，五官清晰
• 背景尽量简单，避免复杂背景干扰

Q: 表情动画不自然怎么办？
A:

• 调整falloff参数增加渐变效果
• 适当减小transform_radius避免影响范围过大
• 微调scale和offset参数，避免变形过度

Q: 导出的文件无法使用怎么办？
A:

• 检查是否选择了正确的导出格式（GLB最通用）
• 确保所有必要的节点都正确连接
• 查看ComfyUI的错误日志获取具体错误信息

Q: 角色比例不对怎么办？
A: 使用Match Texture Aspect Ratio节点调整，确保scale参数设置合理（通常是0.001左右的小数）。

5.3 高级使用问题

Q: 如何制作更复杂的表情？
A: 可以组合多个Modify Shape Key节点，每个控制不同的面部区域，然后通过Shape Flow控制它们的协调动作。

Q: 如何优化渲染速度？
A:

• 减少不必要的网格复杂度
• 合理设置convex_hull和shape_threshold参数
• 避免过多的形状键

Q: 能否批量处理多个角色？
A: 可以通过修改文件名和embedding_id参数来处理不同角色，但需要为每个角色单独运行工作流程。

6. 进阶应用

6.1 自定义表情动画

通过组合多个形状键，可以创建复杂的表情：

• 组合眨眼+微笑 = 开心表情
• 组合皱眉+嘴角下垂 = 难过表情
• 组合眼睛放大+嘴巴张开 = 惊讶表情

6.2 与其他插件配合

• 可以与ControlNet配合生成更好的角色图片
• 可以与动画插件配合制作更复杂的动作
• 可以与语音合成配合实现真正的口型同步

6.3 商业应用建议

• 虚拟主播：制作会动的虚拟角色
• 游戏开发：快速制作NPC表情动画
• 教育内容：制作生动的教学角色
• 社交媒体：制作个性化的动态头像