资源库索引
资源库索引是 Nephele 对素材库的 AI 分析功能。它会逐张扫描你的素材，自动打上内容标签、风格标签，并建立跨语言语义搜索索引。所有模型都在本地运行，图片不会上传云端。
索引包含什么
资源库索引不是单一的"打标签"，而是三套独立的本地 AI 模块协同工作：
1. 内容识别
默认使用 PixAI Tagger v0.9 模型（EVA02 架构，ONNX 本地运行，约 1.2GB），每张图分析后输出两类标签：
| 输出类型 | 说明 | 示例 |
|---|---|---|
| 内容标签 | 画面里有什么元素 | 1girl, solo, long hair, weapon, landscape |
| 角色标签 | 识别的特定角色 | hatsune miku, kamado tanjiro |
内容标签的默认置信度阈值是 0.35，角色标签是 0.85。阈值越高，打上的标签越保守但越准确（PixAI 自带的 thresholds.csv 会覆盖这两个默认值）。
模型会自动处理透明背景图（合成到白底），并把图片填充为正方形后送入 448x448 的输入层。加速器优先级：DirectML（Windows）> CUDA > CPU。
PixAI 在打标的同一趟里还会顺手产出一个 1024 维图像嵌入向量（EVA02 空间），免费随打标存下来，供以图搜图做图像相似检索用。
提示
旧版 WD SwinV2 v3（SmilingWolf，约 467MB，词表收录至 2024-02）保留为兜底模型——没装 PixAI 升级模型时自动启用。PixAI 词表更新到 2025-01，识别更新的角色更全。
2. CLIP 风格分类
使用 CLIP ViT-B/32 模型进行零样本风格识别，从 18 种预定义风格中匹配：
watercolor, oil painting, cel shading, flat color, pixel art, sketch, lineart, ink wash, 3D render, photograph, comic panel, realistic digital, pastel, impasto, vector art, concept art, chibi, monochrome
每张图会取置信度最高的前 2 个风格标签（最低门槛 0.20）。CLIP 同时还驱动以文搜图（512 维文本-图像联合空间）。风格标签和内容标签是独立的两套体系。
3. 多语言语义搜索
使用 gte-multilingual-base 把标签和你的查询编码进同一语义空间（768 维）。这样你用中文搜「蓝色调 少女」也能命中库里那些只有英文 Danbooru 标签的图——它搜的是标签语义，再过滤到你库里真实存在的标签。该模型为可选下载，首次语义检索时按需获取。
标签会变成中文
打标时，模型产出的英文标签会被替换成对应的中文展示名，直接写回 Eagle 元素（没有中文译名的才保留英文）。也就是说存量库要转成中文，重新跑一次索引（强制重打标）即可。Nephele 在底层记录了每个标签的来源，重打标时只会替换上次自己写入的标签，不碰你手动加的标签。
怎么启动索引
方式一：界面操作
进入「资源库索引」视图（左侧导航栏或星盘轮盘），你会看到瀑布流网格展示 Eagle 库里的素材。顶部有筛选和操作栏：
- 文件夹筛选 —— 只处理某个文件夹下的素材
- 扩展名筛选 —— png, jpg, psd, svg, gif, webp
- 状态筛选 —— 全部 / 已索引 / 未索引
- 处理数量上限 —— 默认无限制，可自行设定
点击「开始索引」后，Nephele 会先统计符合条件的未索引素材数量，然后逐张处理。
方式二：让 Agent 执行
直接跟 Nephele 说：
- "帮我的 Eagle 素材库批量打标签"
- "给'角色参考'文件夹里的图加上 AI 标签"
- "把没索引过的插画都处理一下"
Agent 会自动调用索引工具，处理完后汇报结果。
处理参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| 标签置信度阈值 | 低于此值的标签会被过滤掉，调高可减少噪音 | 0.35 |
| 文件夹 | 限定处理范围 | 全部 |
| 扩展名 | 只处理指定格式 | 全部图片 |
置信度阈值是最值得调节的参数。如果你发现打上的标签太杂，可以调到 0.45 或 0.50；如果觉得漏掉了一些明显的元素，可以降到 0.25。
断点续传
Nephele 在批处理开始时会在本地写一个 checkpoint 文件（~/.nephele_workshop/tagger_state.json），记录当前的任务范围。如果处理过程中软件崩溃或被强制退出，下次启动时 Nephele 会检测到这个未清除的 checkpoint，并提示你是否继续上次的任务。
正常完成或手动取消后，checkpoint 会自动清除。
技巧
批处理过程中随时可以取消。取消前已计算的结果（标签、embedding）会被保存，不会浪费。
去重与跳过
Nephele 不会重复处理已经索引过的素材。判断依据是素材是否带有 Nephele-tagged 这个标记标签：
- 批处理前会自动预过滤掉已标记的素材
- 直接模式默认只处理「无标签」的素材（除非指定了其他标签筛选条件）
- 如果你故意想重新处理某张图，可以手动删掉它的
Nephele-tagged标签
读写方式
Nephele 直接读写 Eagle 的 .library/ 文件系统和 metadata.json，不经过 Eagle 软件的 HTTP API。只要配置过 Eagle 库路径就能处理，无需 Eagle 本身在后台运行。处理过程中会自动过滤掉非图片文件（视频、音频、压缩包等），只处理 png, jpg, jpeg, gif, webp, bmp, tiff, tif。
提示
Nephele 与 Eagle 的关系是底层兼容，而非运行依赖。详见 Eagle 兼容性与独立性。
单张预览
不想批量处理，只想看看某张图会被打上什么标签？在资源库索引视图中点击任意一张素材，右侧面板会显示「预览标签」按钮。点击后 Nephele 会分析这张图并展示预测结果，但不会写入 Eagle。
预览结果包括：内容标签、角色标签、风格标签。
索引之后：搜索素材库
索引完成后，素材的标签和风格会写回 Eagle 的元数据（metadata.json），图像嵌入向量则存在本地缓存里（图像相似用 EVA02 tagger 空间，以文搜图用 CLIP 空间，两套向量分开存放、互不混用）。你可以通过以下方式利用这些数据：
Agent 对话
直接跟 Nephele 说：
- "搜带 'weapon' 标签的图"
- "找所有 4 星以上的插画"
- "看看'角色参考'文件夹里有哪些 PNG"
- "给我这张图的完整信息"
Agent 会自动组合多个参数进行精确筛选。比如你说"找 4 星以上、带 mecha 标签的 JPG"，它会同时传 star=4、tags=["mecha"]、ext="jpg"。
工具箱手动搜索
工具箱里有「素材库搜索」入口，可以手动设置关键词、标签、星级等条件后执行。
搜索参数
| 参数 | 类型 | 说明 |
|---|---|---|
| keyword | 字符串 | 搜索标题、标签、注释里的文字 |
| ext | 字符串 | 扩展名过滤，如 png、jpg、psd |
| tags | 字符串数组 | 标签过滤，素材必须包含所有指定标签 |
| star | 整数 (1-5) | 最低评分门槛 |
| folders | 字符串数组 | 文件夹 ID 过滤 |
| limit | 整数 | 返回数量上限，默认 20 |
| item_id | 字符串 | 传此参数时不做搜索，直接返回单条完整元数据 |
搜索结果
每条返回的素材包含：id、name、ext、tags、star、width/height、filePath、thumbnail、folders。
提示
按标签和星级筛选需要素材库已完成索引。如果还没索引过，这些筛选条件会没有结果。
其他索引驱动的功能
- 相似图搜索 —— 给一张参考图，在你自己的素材库里找视觉最像的素材（基于 EVA02 tagger 嵌入向量，标签 Jaccard 兜底）
- 以文搜图 —— 用一句话描述你想要的画面，在已索引的素材库里检索语义最匹配的图（基于 CLIP 嵌入，无需精确标签）。CLIP 是英文训练的，中文描述会由 Agent 先翻成英文再检索
- Agent 自动整理 —— "把带 'mecha' 标签的图移到'机甲参考'文件夹"
如果你还没建立过索引，上述功能的效果会大幅受限。建议先对常用素材库跑一次完整索引。