• 人工智能
• 媒体生成
• AI 应用
• MCP 服务
• AI 技能
• 音视频
• AI Agent
• 前端

ComfyTV 的 Eagle 集成把 ComfyUI 渲染结果自动归档进 Eagle 图库，并为每条产出附带完整生成溯源（工作流、prompt、参数），同时支持把 Eagle 库中的素材一键拖拽上画布。对于需要长期积累 AIGC 资产、又苦于"找不到当时那张图是怎么生成的"的用户，这是一套开箱即用的资产管理实战方案。

一、为什么 AIGC 素材需要 Eagle 这样的资产管家

用 ComfyUI 批量生成一段时间后，你大概率会遇到这些问题：

• 📦素材散落：output 目录里的图片视频越堆越多，没有分类、没有标签；
• 🔍无法回溯：看到一张满意的结果，却记不清当时用的 prompt 和参数；
• ✂️复用率低：从网上剪藏的参考图、之前满意的产出，想再用时找不到地方。

ComfyTV 的 Eagle 集成正是为了解决这三件事：把本机 Eagle 接成 ComfyTV 的长期档案馆——生成结果自动流进 Eagle，Eagle 里的素材随时拖回画布，双向打通。

二、先搞懂分工：资产库是工作台，Eagle 是档案馆

两者的数据是双向流通的：

• 出：生成结果流进 Eagle（手动或自动），按项目归档，永远能靠当时的 prompt 搜回来；
• 进：Eagle 里的任何东西——包括你从网上剪藏的参考图——都能在侧边栏浏览，拖上画布变成普通资产。

💡 一个需要提前接受的事实：Eagle 导入任何文件都会拷贝进它的.library目录。ComfyUI 的 output 原文件原地不动（ComfyTV 永不删文件），Eagle 里那份就是归档正本。

三、5 分钟上手：配置 Eagle 集成

前置条件

• 已安装Eagle 桌面应用（Eagle 4；4.0 Build 21+ 解锁更强的 V2 API，老版本自动回落 V1）；
• 一个你愿意接收 ComfyTV 产出的库，推荐专门建一个库（Eagle 同时只能打开一个库）。

设置项一览

在 ComfyTV 侧边栏打开设置 → Eagle 集成，核心开关有 5 个：

三种连接状态

Eagle 的 API 永远只作用于当前打开的库，ComfyTV 探测后会在 Eagle 页签标题的圆点上显示三态：

这里的队列就是安全机制：你开着个人库的时候，绝不会有东西误灌进去。下次探测到钉死的库打开时，排队条目自动补发（Eagle 页签有横幅显示数量，也可手动补发）。

四、渲染结果自动归档：开启"自动沉淀"

打开产出自动沉淀到 Eagle后，每次 stage 渲染（图片 / 视频 / 音频，批图逐张）在落盘的瞬间就会自动归档：

• 📁 归入以项目命名的 Eagle 文件夹（自动创建）；
• 🏷️ 标签为comfytv+ 项目名；
• 📝 批注带完整溯源：工作流、prompt、参数。

两个细节让这套机制很安心：

1. 不阻塞生成：归档走队列，在工作线程入队，Eagle 没开或开着别的库时条目攒在队列里，之后自动补发（队列逻辑见 eagle_pending.py）；
2. 档案天然全：支撑的正是社区主流用法——放开手生成，回头在 Eagle 里靠评星筛片。

生成溯源：以后搜 prompt 就能找回那张图

以前"这张图当时 prompt 是什么"只能靠回忆，现在每条归档条目的批注里都写着：

• 来源 stage 与项目
• 使用的工作流
• 完整 prompt 与参数

日后在 Eagle 里搜那段 prompt，就能定位到当时那张图——这是很多 AIGC 工作流最稀缺的能力。

五、手动发送：右键资产一键入库

不想全量自动归档？也可以在资产库右键任意资产选发送到 Eagle：

• 文件导入 Eagle，归入你设置的发送目标文件夹；
• 自动打上comfytv标签；
• 批注自动填入从输出历史恢复的生成溯源。

手动 + 自动可以共存：自动沉淀兜底保证"不漏"，手动发送处理你特别想单独归类的精品。

六、拖拽入画布：从 Eagle 取素材的最快路径

侧边栏的Eagle页签列出整个库，带搜索、文件夹下拉和媒体类型过滤（V2 API 下搜索是全文的，标签也能命中）。视频卡悬停即播，音频卡有内联试听按钮。

要用一个 Eagle 条目，路径短到只有一步：

1. 直接拖上画布——条目自动导入资产库，并在落点生成 loader 节点，之后它和原生资产完全一样（接 stage、@引用、proxy）；
2. 或者悬停卡片点导入箭头，只入资产库、不落节点。

几个实用保障：

• 导入的条目是source: eagle的普通资产，重复导入同一条目会复用已有资产，不会重复；
• 拖拽与导入逻辑分别由 assetCanvasDrop.ts 和 useEagleImports.ts 实现。

七、进阶：AI 搜索与找相似

如果装了 Eagle 官方的AI Search插件且后端在运行，两个能力自动点亮：

• 🔮 搜索框旁的AI 开关——按含义搜（"海浪上的红船"）而非按关键词；
• 🖼️ 每张卡上的找相似——全库以图搜图。

插件未就绪时这些入口保持隐藏，不影响其他功能。

八、实战工作流建议

结合以上能力，推荐的日常节奏是：

小结

ComfyTV × Eagle 的组合把"生成"和"资产管理"拆成了各自最擅长的两半：ComfyTV 负责画布上的生产流水线，Eagle 负责跨项目的长期档案馆。自动沉淀 + 完整溯源 + 拖拽入画布，构成了 AIGC 素材从产出 → 归档 → 检索 → 复用的完整闭环。完整功能说明可参考官方文档 eagle.zh.md 与 sidebar.zh.md。

• 人工智能
• 媒体生成
• AI 应用
• MCP 服务
• AI 技能
• 音视频
• AI Agent
• 前端