Eagle 兼容性与独立性
Nephele 能深度读写 Eagle 的底层数据，但自身的运行和资源管理完全不依赖 Eagle。
第一次听说 Eagle 的话，先看下面一段；已经在用的可以直接跳到「我们怎么兼容」。
Eagle 是什么
Eagle 是画师和设计师常用的素材管理软件，可以理解成一个专门用来"收图""找图"的增强版文件夹：拖拽收图、给图打标签、按文件夹分类、PSD / CLIP / 视频缩略图预览、浏览器插件一键收藏。很多画师电脑里存着几万张参考图，Eagle 就是他们的"第二大脑"。
Nephele 理解 Eagle 存储数据的方式，能读取、搜索、帮你打标签和整理文件夹——但它不是 Eagle 的替代品，也不需要 Eagle 才能运行。
我们怎么兼容：文件系统直读
Nephele 与 Eagle 的交互走文件系统直读，不走插件、API 或进程通信。Eagle 素材库在磁盘上本质就是一个 XXX.library/ 文件夹：
| 文件 / 目录 | 内容 |
|---|---|
metadata.json | 库级元数据与文件夹树（层级、彩色标记） |
images/{id}.info/metadata.json | 单个素材的标签、评分、注释、调色板 |
images/{id}.info/ | 你导入的原图、PSD、视频及缩略图缓存 |
Nephele 把这些当作公开格式的数据文件来解析，而不是调用 Eagle 的私有接口。好处很直接：
- 快 —— 纯本地文件 I/O，没有网络往返和进程间通信
- 稳 —— Eagle 崩溃、未响应、版本升级，都不影响 Nephele 读取已保存的数据
- 松耦合 —— 两者生命周期完全独立，一个挂了不影响另一个
运行与资源管理都不依赖 Eagle
如果你从未安装过 Eagle，Nephele 的所有核心功能都完好无损。Eagle 只是在你配置了库路径之后，作为一个额外数据源出现。
| 场景 | 依赖 Eagle？ |
|---|---|
| 启动 / Agent 对话 / 水印与声明 / 数字存证 / 维权取证 / 参考板 / 3D 预览 | 否 |
| 资源库浏览 | 否，默认浏览本地磁盘 |
| 浏览或导入 Eagle 素材库 | 仅需库路径，不需要 Eagle 进程在运行 |
Nephele 的资源管理核心是它自己的本地文件系统视图和流水线引擎：默认数据源是本地磁盘，流水线处理的是文件路径而不关心来源，相似图的视觉嵌入与标签索引也是 Nephele 自建的数据库（由本地标签模型 PixAI Tagger 的 EVA02 嵌入空间产出），不是 Eagle 的索引。Eagle 库在这里只是"一个被 Nephele 理解的特殊文件夹"。
配置库路径后能做什么
| 功能 | 说明 |
|---|---|
| 浏览 | 在资源库中按文件夹树浏览 Eagle 素材 |
| 搜索 | 按关键词、标签、星级、扩展名、文件夹筛选 |
| 相似图 | 上传一张图，在 Eagle 库中找视觉相似的素材 |
| 导入 | 从浏览器、本地文件夹或参考板导入（带标签 / 评分 / 备注） |
| 批量打标 | 本地标签模型（PixAI Tagger，WD SwinV2 回落）自动打内容标签，写回 metadata.json |
| 整理 | 通过 Agent 对话移动文件夹、增删标签、更新评分、移入废纸篓 |
| 远程浏览 | 通过 Nephele Aura 在手机端浏览 Eagle 库 |
共同点：Nephele 在读写 Eagle 的数据文件，而不是操控 Eagle 软件本身。
常见误解
没买 Eagle 能用 Nephele 吗？ 能。绝大多数功能与 Eagle 无关；只有需要浏览 / 管理 Eagle 格式的素材库时，才需要先有 Eagle 库文件（而不仅仅是装了 Eagle 软件）。
Eagle 没打开能读到素材库吗？ 能。Nephele 读的是磁盘上的文件，不是 Eagle 进程的内存，Eagle 是否运行都不影响。
Eagle 升级会让 Nephele 失效吗？ 只要底层数据格式不变就不会——Eagle 的 metadata.json 结构一直保持稳定，若未来有破坏性变更我们会跟进适配。Nephele 也只写素材库目录下的数据文件，从不碰 Eagle 的安装目录。
Nephele 是 Eagle 的替代品吗？ 不是。我们兼容 Eagle，是因为很多画师已经在用它，想让现有工作流更顺畅，而不是逼你迁移。
一句话总结
就像 Photoshop 能打开 PNG，但运行完全不依赖任何 PNG 编辑器——PNG 只是一种被理解的格式。Eagle 的素材库格式对 Nephele 也是如此：我们理解它、能读写它、能帮你更高效地利用它，但 Nephele 的运转从不建立在 Eagle 之上。