# ComfyUI-SAMURAI-SAM2 插件完整教程 ## 1. 插件简介 **GitHub原地址：** https://github.com/takemetosiberia/ComfyUI-SAMURAI--SAM2- 这个插件就像是一个超级聪明的"视频剪刀手"，它能够帮你在视频中精确地"抠出"某个物体，就像用魔法棒一样！比如你有一段视频，里面有一只小猫在走动，这个插件就能帮你把小猫从整个视频中完整地"抠出来"，即使小猫在移动、变换姿势，插件也能紧紧跟踪它。 **能给我们带来什么效果：** - 自动追踪视频中的任何物体（人物、动物、车辆等） - 制作视频蒙版（就像给物体戴上隐形面具） - 实现视频背景替换（让你的猫咪出现在太空中） - 创建专业的视频特效 ## 2. 如何安装 ### 第一步：准备工作 1. 确保你有一台带NVIDIA显卡的电脑（这个插件需要显卡来加速运算） 2. 确保已经安装了ComfyUI 3. 建议使用Conda环境（这是一个管理软件包的工具，就像一个专门的工具箱） ### 第二步：安装SAMURAI基础模型 1. 先按照 [SAMURAI安装指南](https://github.com/yangchris11/samurai) 安装基础模型 2. 下载必要的模型权重文件 ### 第三步：安装插件 1. 打开命令行，进入ComfyUI的插件目录： ```bash cd ComfyUI/custom_nodes ``` 2. 克隆插件代码： ```bash git clone https://github.com/takemetosiberia/ComfyUI-SAMURAI--SAM2-.git samurai_nodes ``` 3. 把SAMURAI安装文件夹复制到插件目录中 ### 第四步：安装依赖包 ```bash pip install hydra-core omegaconf loguru ``` 安装完成后，你的文件夹结构应该是这样的： ``` ComfyUI/ └── custom_nodes/ └── samurai_nodes/ ├── samurai/ # SAMURAI模型安装 ├── __init__.py # 模块初始化文件 ├── samurai_node.py # 主要节点代码 └── utils.py # 工具函数 ``` ## 3. 节点逐一解析 ### 3.1 SAMURAI Box Input 节点 - 框选追踪器 这个节点就像是一个"智能框选工具"，你可以在视频的第一帧画个框，告诉它"我要追踪这个区域的东西"。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 视频输入 | video_frames | 视频帧序列 | - | 就像喂给机器的连续照片 | 输入的视频帧数据 | 连接Load Video节点的输出 | | 框选区域 | box_coordinates | 坐标值 | 根据物体大小 | 你用鼠标画的那个框的位置 | 边界框的坐标信息 | 在第一帧上画框圈出要追踪的物体 | | 起始帧 | start_frame | 整数 | 0 | 从视频的第几张图片开始工作 | 开始处理的帧编号 | 通常设为0（从头开始） | ### 3.2 SAMURAI Points Input 节点 - 点选追踪器 这个节点就像是一个"精准指针"，你可以在物体上点几个点，告诉它"这些点是我要的东西，那些点是我不要的"。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 视频输入 | video_frames | 视频帧序列 | - | 就像喂给机器的连续照片 | 输入的视频帧数据 | 连接Load Video节点的输出 | | 正选点 | positive_points | 坐标点列表 | 根据需要 | 你点击的"这个我要"的地方 | 标记目标对象的正样本点 | 在小猫身上点几个点 | | 负选点 | negative_points | 坐标点列表 | 根据需要 | 你点击的"这个我不要"的地方 | 标记背景的负样本点 | 在背景上点几个点 | | 点标签 | point_labels | 标签列表 | 自动生成 | 告诉机器哪些点是好的哪些是坏的 | 点的分类标签（1为正，0为负） | 系统自动标记，不用管 | | 起始帧 | start_frame | 整数 | 0 | 从视频的第几张图片开始工作 | 开始处理的帧编号 | 通常设为0（从头开始） | ### 3.3 SAMURAI Refine 节点 - 追踪处理器 这个节点就像是一个"魔法师"，它接收你的选择（框或点），然后在整个视频中追踪这个物体，最后给你一个完美的蒙版。 #### 参数详解： | 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 视频输入 | video_frames | 视频帧序列 | - | 要处理的原始视频 | 输入的视频帧数据 | 连接Load Video节点的输出 | | 输入数据 | input_data | 框或点数据 | - | 从前面节点来的选择信息 | 来自Box或Points节点的数据 | 连接Box Input或Points Input的输出 | | 模型路径 | model_path | 文件路径 | 默认路径 | 告诉机器去哪里找"大脑"文件 | SAMURAI模型文件的位置 | 使用默认设置即可 | | 设备类型 | device | cuda/cpu | cuda | 用显卡还是用CPU来计算 | 运行设备选择 | 有显卡选cuda，没有选cpu | | 输出格式 | output_format | mask/image | mask | 你想要什么样的结果 | 输出数据的格式类型 | mask用于进一步处理，image用于预览 | | 追踪质量 | tracking_quality | 0.0-1.0 | 0.8 | 追踪的精确度，越高越准确但越慢 | 模型推理的质量阈值 | 0.8是不错的平衡点 | | 内存优化 | memory_optimization | True/False | True | 是否省内存，开启后占用更少显存 | 是否启用内存优化模式 | 显存不够时开启 | ## 4. 使用技巧和建议 ### 基础使用流程： 1. **加载视频**：使用Load Video节点载入你的视频 2. **选择方式**：用Box Input（适合方形物体）或Points Input（适合复杂形状） 3. **精确选择**：在第一帧仔细选择要追踪的物体 4. **连接处理**：把选择结果连接到SAMURAI Refine节点 5. **输出结果**：得到完美的追踪蒙版 ### 提高效果的小窍门： **选择技巧：** - 用Box Input时，框要稍微大一点，但不要包含太多背景 - 用Points Input时，正选点要均匀分布在物体上，负选点要放在明显的背景区域 **性能优化：** - 如果电脑配置不高，可以先用较低的追踪质量测试 - 开启内存优化可以处理更长的视频 - 视频分辨率太高时，可以先缩小再处理 **常见应用场景：** - 人物追踪：选择人的躯干部分，避免手臂摆动区域 - 动物追踪：选择动物的身体中心部分 - 车辆追踪：选择车身，避免车轮部分 - 物体更换：先追踪原物体，再用蒙版合成新物体 ## 5. 常见问题解答 **Q: 安装时提示找不到SAMURAI模型怎么办？** A: 确保你已经按照SAMURAI官方指南安装了基础模型，并且模型文件放在了正确的目录中。检查 `samurai/sam2/checkpoints` 目录是否存在。 **Q: 追踪效果不好，物体总是丢失怎么办？** A: - 检查第一帧的选择是否准确 - 尝试调高追踪质量参数 - 如果物体变化太快，可以尝试用Points Input方式 **Q: 处理速度太慢怎么办？** A: - 确保使用了CUDA（显卡加速） - 开启内存优化 - 降低追踪质量参数 - 可以考虑先缩小视频分辨率 **Q: 显存不够用怎么办？** A: - 开启memory_optimization参数 - 处理较短的视频片段 - 降低视频分辨率 - 关闭其他占用显存的程序 **Q: 输出的蒙版不够精确怎么办？** A: - 在第一帧更仔细地选择区域 - 使用Points Input方式，添加更多正选点和负选点 - 调高追踪质量参数 ## 6. 进阶应用和创意用法 ### 创意组合使用： - **多物体追踪**：可以同时使用多个SAMURAI节点追踪不同物体 - **蒙版合成**：将追踪结果与其他ComfyUI节点结合，创造复杂效果 - **动态背景**：用追踪蒙版实现动态背景替换 - **特效制作**：结合图像生成节点，为追踪物体添加特效 ### 工作流程建议： 1. 先用低质量快速测试追踪效果 2. 确认效果满意后，再用高质量设置最终渲染 3. 保存成功的参数设置，方便后续使用 4. 建立自己的常用工作流程模板 这个插件就像是给ComfyUI装上了一双"火眼金睛"，让它能够在视频中精准地跟踪任何物体。虽然安装过程稍微复杂，但一旦设置好，就能为你的视频创作带来无限可能！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
