Eagle 兼容性与独立性
Nephele 能深度读写 Eagle 的底层数据，但 Nephele 自身的运行和资源管理完全不依赖 Eagle。
如果你已经知道 Eagle 是什么，可以直接跳到下面的章节。如果你第一次听说这个名字，建议先花一分钟看完第一段。
Eagle 是什么
Eagle 是一款画师和设计师常用的素材管理软件。你可以把它理解为一个专门用来"收图"和"找图"的增强版文件夹。
画师日常工作里会有大量参考图、灵感图、成品图需要管理。Eagle 就是解决这个问题的工具：
- 拖拽收图 —— 从浏览器、QQ、微信直接拖图片进去，自动保存
- 标签系统 —— 给每张图打标签，比如"机甲""角色设计""赛博朋克"，方便以后搜索
- 文件夹分类 —— 按项目、风格、用途建文件夹，彩色标记一目了然
- 快速预览 —— 支持 PSD、CLIP、PDF、视频等格式的缩略图，不用打开源软件
- 浏览器插件 —— 在 Pinterest、Pixiv、ArtStation 上看到喜欢的图，一键收藏到 Eagle
很多画师电脑里都有几万甚至几十万张参考图，Eagle 就是他们的"第二大脑"。
Nephele 和 Eagle 的关系：Nephele 理解 Eagle 存储数据的方式，可以读取、搜索、甚至帮你在 Eagle 里打标签和整理文件夹——但 Nephele 不是 Eagle 的替代品，也不依赖 Eagle 才能运行。
兼容底层：我们读的是什么
Nephele 与 Eagle 的交互，走的是文件系统直读，而非插件、API 或进程间通信。
Eagle 素材库在磁盘上本质上是一个普通文件夹，里面包含：
| 文件/目录 | 内容 |
|---|---|
metadata.json | 素材的元数据（标签、评分、注释、文件夹关系等） |
.library/ | 缩略图缓存、文件夹结构索引 |
| 原始素材文件 | 你导入的图片、PSD、视频等 |
Nephele 直接解析这些文件，实现以下功能：
- 浏览文件夹树 —— 读取
.library/中的层级索引，按 Eagle 的文件夹结构渲染侧边栏 - 搜索与筛选 —— 读取
metadata.json，按标签、星级、扩展名、文件夹 ID 做本地查询 - 导入素材 —— 向 Eagle 库目录写入文件，并同步更新
metadata.json - 修改元数据 —— 更新标签、评分、注释、文件夹归属，写回
metadata.json - 批量打标 —— 用 WD14 / CLIP 模型生成标签后，直接写入 Eagle 的元数据
提示
Nephele 操作的是 Eagle 生成的公开数据格式，不是 Eagle 软件的内部私有接口。这意味着无论 Eagle 是否打开、甚至是否安装，Nephele 对这些文件的读写都能正常进行。
运行不依赖 Eagle
Nephele 的启动、运行、关闭，全程不需要 Eagle 参与。
| 场景 | 是否依赖 Eagle |
|---|---|
| 启动 Nephele | 否。软件初始化的是自己的 QML 引擎、浏览器内核和 AI 模型 |
| 打开资源库 | 否。默认浏览本地文件系统 |
| 使用 Agent 对话 | 否。云端走 Axioma，本地走 Ollama |
| 使用发布打包 / 数字存证 / 维权取证 | 否。这些功能与 Eagle 完全无关 |
| 使用参考板 / 3D 预览 | 否。独立功能模块 |
| 浏览 Eagle 素材库 | 仅在已配置路径时可用，但不需要 Eagle 进程运行 |
| 向 Eagle 导入素材 | 仅在已配置路径时可用，写入的是文件系统 |
如果你从未安装过 Eagle，Nephele 的所有核心功能都完好无损。Eagle 相关功能只是在你配置了库路径之后，作为额外数据源出现。
资源管理不依赖 Eagle
Nephele 的资源管理核心是自己的本地文件系统视图和流水线引擎。
- 资源库的默认数据源是本地磁盘（桌面、文档、下载、自定义文件夹）
- 右键菜单里的"固定为参考""发送到流水线""复制路径"对所有本地文件都有效
- 流水线（Pipeline）处理的是文件路径，不关心这个文件来自本地文件夹还是 Eagle 库
- 相似图搜索的 CLIP 视觉索引和 WD14 标签索引，是 Nephele 自己维护的数据库，不是 Eagle 的索引
Eagle 素材库在 Nephele 里被视为一种特殊的文件夹——它的组织结构、标签系统和缩略图缓存可以被 Nephele 读取和利用，但 Nephele 不会因为缺少这个"特殊文件夹"就丧失资源管理能力。
技巧
你可以把 Eagle 库理解为"一个格式被 Nephele 理解的文件夹"。就像资源库能浏览 ZIP 压缩包（如果支持的话），它也能浏览 Eagle 库——但浏览 ZIP 不需要你安装压缩软件，浏览 Eagle 库同理不需要 Eagle 运行。
和传统"集成"的区别
市面上常见的"软件 A 集成软件 B"通常有以下几种模式：
| 模式 | 原理 | 缺点 |
|---|---|---|
| 插件/扩展 | 在 B 里安装 A 的插件 | 依赖 B 的版本兼容性，升级容易断裂 |
| API 调用 | B 提供 HTTP/RPC 接口，A 通过网络请求通信 | 需要 B 进程运行，有性能开销和延迟 |
| 脚本注入 | 通过自动化脚本操控 B 的 UI | 脆弱、易出 bug、难以维护 |
| 数据库直连 | A 直接读写 B 的数据库文件 | 需要理解 B 的表结构，B 升级可能改变 schema |
Nephele 采用的是文件系统直读 + 元数据解析。Eagle 的 metadata.json 是一个结构化的 JSON 文件，.library/ 目录是按规则组织的缩略图缓存。Nephele 把这些当作公开格式的数据文件来解析，而不是作为 Eagle 软件的私有接口来调用。
这种方式的优势：
- 快：没有网络往返，没有进程间通信，纯本地文件 I/O
- 稳：Eagle 崩溃、未响应、版本升级，都不影响 Nephele 读取已保存的数据
- 松耦合：Nephele 和 Eagle 的生命周期完全独立，一个挂了不影响另一个
功能全景：Nephele 能对 Eagle 做什么
如果你配置了 Eagle 库路径，Nephele 提供以下增强能力：
| 功能 | 说明 |
|---|---|
| 浏览 | 在资源库中按文件夹树浏览 Eagle 素材 |
| 搜索 | 按关键词、标签、星级、扩展名、文件夹筛选素材 |
| 相似图 | 上传一张图，在 Eagle 库中找视觉相似的素材 |
| 导入 | 从浏览器下载、本地文件夹或参考板直接导入 Eagle（带标签/评分/备注） |
| 批量打标 | 用 WD14 模型为 Eagle 素材自动打内容标签，写入 metadata.json |
| 整理 | 通过 Agent 对话移动文件夹、修改标签、更新评分、清空废纸篓 |
| 远程浏览 | 通过 Nephele Aura 在手机端浏览 Eagle 素材库（开发中） |
所有这些操作的共同点是：Nephele 在读写 Eagle 的数据文件，而不是操控 Eagle 软件本身。
常见误解澄清
Q: 我没有买 Eagle，能用 Nephele 吗？
能。Nephele 的绝大多数功能与 Eagle 无关。只有当你需要浏览/管理 Eagle 格式的素材库时，才需要先有 Eagle 库文件（而不仅仅是安装 Eagle 软件）。
Q: Eagle 没打开，Nephele 能读取我的素材库吗？
能。Nephele 读取的是磁盘上的文件，不是 Eagle 进程的内存。Eagle 是否运行完全不影响 Nephele。
Q: Nephele 会修改 Eagle 的程序文件吗？
不会。Nephele 只修改素材库目录下的 metadata.json 和 .library/ 中的数据文件，不会碰 Eagle 软件的安装目录。
Q: Eagle 升级了，Nephele 会失效吗？
只要 Eagle 的底层数据格式不变，Nephele 就能继续读取。历史上 Eagle 的 metadata.json 结构保持稳定。如果未来 Eagle 做了破坏性格式变更，Nephele 会跟进适配。
Q: Nephele 是 Eagle 的替代品吗？
不是。Nephele 不做素材管理软件的竞品。我们兼容 Eagle 是因为很多画师已经在用它，我们希望让现有工作流更顺畅，而不是迫使你迁移。
一句话总结
Nephele 和 Eagle 的关系，就像 Photoshop 能打开 PNG 文件，但 Photoshop 的运行完全不依赖任何 PNG 编辑器——PNG 只是一种被理解的格式。Eagle 的素材库格式对 Nephele 来说也是如此：我们理解它、能读写它、能帮你更高效地利用它，但Nephele 的自我运转从不建立在 Eagle 之上。