%20(1).png)
ComfyUI-Eagle-Feeder 插件完全使用教程
1. 插件简介
ComfyUI-Eagle-Feeder 是一个 ComfyUI 的自定义节点插件，它能让你把生成的图片直接发送到 Eagle 图片管理软件中。这个插件最厉害的地方在于，它不仅支持 ComfyUI 和 Eagle 在同一台电脑上运行，还能处理通过 SSH 连接或者容器跨不同机器的复杂设置。
GitHub 原地址： https://github.com/tighug/comfyui-eagle-feeder
能给我们带来什么效果？
- 自动图片整理：生成的图片会自动保存到 Eagle 的指定文件夹中，不用手动拖拽
- 智能标签管理：可以自动从提示词或者其他标签节点获取标签，给图片分类
- 跨设备支持：即使 ComfyUI 和 Eagle 不在同一台电脑上也能用
- 无缝工作流：在 ComfyUI 里生成图片的同时就能完成图片管理
2. 如何安装
方法一：使用 ComfyUI Manager（推荐）
- 打开 ComfyUI，点击界面上的 "Manager" 按钮
- 在弹出的窗口中选择 "Install Custom Nodes"
- 搜索 "Eagle Feeder"
- 找到后点击 "Install" 按钮
- 安装完成后重启 ComfyUI
方法二：手动安装
- 找到你的 ComfyUI 安装目录下的
custom_nodes文件夹 - 在这个文件夹里打开命令行（或者终端）
- 输入以下命令：
git clone https://github.com/tighug/comfyui-eagle-feeder.git - 等待下载完成后重启 ComfyUI
3. 节点详解
3.1 Eagle Feeder 节点
这个节点就像是一个智能的图片快递员，它会把你生成的图片打包好，贴上标签，然后直接送到 Eagle 软件指定的文件夹里。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片输入 | images | IMAGE | 必填 | 这是你要发送到 Eagle 的图片，就像快递的包裹一样 | 接收 ComfyUI 生成的图像张量数据 | 连接任何输出图片的节点，比如 VAE 解码器 |
| 标签 | tags | STRING | 空字符串 | 给图片贴标签，就像给文件夹分类一样，方便以后找图片 | 为图片添加可搜索的标签信息，支持提示词标签或 WD14-Tagger 标签 | 可以写"风景,日落,唯美"，也可以连接 WD14-Tagger 节点 |
| 文件夹名称 | folder_name | STRING | 空字符串 | 指定图片要保存到 Eagle 的哪个文件夹里，就像选择要放进哪个抽屉 | 指定 Eagle 中的目标文件夹名称 | 写"我的作品"或"AI生成图片"等文件夹名 |
| Eagle 主机地址 | eagle_host | STRING | http://localhost:41595 | 告诉插件 Eagle 软件在哪里运行，就像写快递地址 | Eagle 软件的网络地址，Eagle 使用固定端口 41595 | 本地使用默认值，远程使用如 http://192.168.1.100:41595 |
| Eagle 访问令牌 | eagle_token | STRING | 空字符串 | 这是访问 Eagle 的通行证，就像门卡一样 | Eagle API 的身份验证令牌 | 在 Eagle 的"偏好设置→开发者"中找到并复制 |
4. 使用技巧和建议
4.1 设置 Eagle 访问令牌
- 打开 Eagle 软件
- 点击菜单栏的 "Eagle" → "偏好设置"
- 在左侧选择 "开发者" 选项
- 找到 "API 令牌" 并复制
- 粘贴到 ComfyUI 节点的相应位置
4.2 文件夹管理技巧
- 先在 Eagle 中手动创建好文件夹，插件暂时不能自动创建新文件夹
- 如果有多个同名文件夹，图片会随机保存到其中一个
- 建议用英文命名文件夹，避免特殊字符
4.3 标签使用建议
- 可以直接在标签栏输入文字，用逗号分隔多个标签
- 建议连接 WD14-Tagger 节点自动识别图片内容并生成标签
- 标签越详细，以后找图片越方便
4.4 网络设置
- 本地使用：Eagle 和 ComfyUI 在同一台电脑上，用默认地址
http://localhost:41595 - 远程使用：如果 Eagle 在其他电脑上，需要输入该电脑的 IP 地址
5. 常见问题解答
5.1 连接失败怎么办？
问题：节点报错说连接不上 Eagle
解决方案：
- 确保 Eagle 软件正在运行
- 检查 Eagle 主机地址是否正确
- 确认 Eagle 的 API 功能是否开启
- 检查防火墙是否阻止了连接
5.2 图片没有保存到指定文件夹
问题：图片发送成功但没在想要的文件夹里
解决方案：
- 确认文件夹名称拼写正确
- 检查 Eagle 中是否存在该文件夹
- 避免使用特殊字符或中文名称
5.3 标签没有正确添加
问题：发送的图片没有标签或标签不对
解决方案：
- 检查标签输入格式，多个标签用逗号分隔
- 确认连接的标签节点输出格式正确
- 查看 Eagle 中的标签是否正确显示
5.4 跨设备使用时连接不上
问题：Eagle 在另一台电脑上，无法连接
解决方案：
- 确认两台电脑在同一网络中
- 检查目标电脑的 IP 地址是否正确
- 确认 Eagle 允许外部连接
- 检查网络防火墙设置
6. 工作流程示例
6.1 基本使用流程
- 准备阶段：确保 Eagle 软件正在运行，获取 API 令牌
- 连接节点：在 ComfyUI 中添加 Eagle Feeder 节点
- 配置参数：填写 Eagle 主机地址、令牌等信息
- 连接图片：把生成图片的节点连接到 Eagle Feeder 的图片输入
- 设置标签：可以直接输入标签文字，或连接标签生成节点
- 指定文件夹：输入 Eagle 中已存在的文件夹名称
- 运行工作流：执行后图片会自动保存到 Eagle 中
6.2 高级使用技巧
- 批量处理：可以处理多张图片，会逐个发送到 Eagle
- 自动标签：配合 WD14-Tagger 等节点实现自动标签识别
- 工作流管理：建议为不同类型的图片设置不同的文件夹
7. 总结
ComfyUI-Eagle-Feeder 插件是一个非常实用的图片管理工具，它能够：
- 自动化图片保存流程
- 智能标签管理
- 支持远程和本地使用
- 与 Eagle 软件无缝集成
这个插件特别适合需要大量生成和管理 AI 图片的用户，能够显著提高工作效率。只要按照教程正确配置，就能享受到自动化图片管理的便利。
记住，这个插件的核心优势是解决了传统同类插件只能在同一台机器上使用的限制，通过临时启动本地文件服务器和使用 Eagle 的 API，实现了跨设备的图片传输功能。