资源库索引
资源库索引是 Nephele 对素材库的 AI 分析功能。它会逐张扫描你的素材，自动打上内容标签、风格标签，提取姿势数据，并给出质量评分。所有模型都在本地运行，图片不会上传云端。
索引包含什么
资源库索引不是单一的"打标签"，而是三套独立的 AI 模块协同工作：
1. WD14 内容识别
使用 SmilingWolf WD SwinV2 v3 模型（ONNX 本地运行，约 467MB），每张图分析后输出三类信息：
| 输出类型 | 说明 | 示例 |
|---|---|---|
| 内容标签 | 画面里有什么元素 | 1girl, solo, long hair, weapon, landscape |
| 角色标签 | 识别的特定角色 | hatsune miku, kamado tanjiro |
内容标签的默认置信度阈值是 0.35，角色标签是 0.85。阈值越高，打上的标签越保守但越准确。
模型会自动处理透明背景图（合成到白底），并把图片填充为正方形后送入 448x448 的输入层。加速器优先级：DirectML（Windows）> CUDA > CPU。
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）。风格标签和内容标签是独立的两套体系。
3. YOLOv8 姿势提取
使用 YOLOv8-pose 模型（约 7MB）提取人物姿势的 17 个 COCO 关键点（nose, eyes, shoulders, elbows, wrists, hips, knees, ankles 等）。
姿势数据不会显示为标签，而是缓存为向量，用于姿势相似性搜索——你可以上传一张姿势草图，找素材库里姿势相近的参考。
质量评分机制
索引过程中，Nephele 会给没有星级的素材自动打 1-5 星。评分依据是内容标签中置信度最高的前 10 个标签的平均值：
| 平均置信度 | 星级 |
|---|---|
| >= 0.90 | 5 星 |
| >= 0.70 | 4 星 |
| >= 0.50 | 3 星 |
| >= 0.35 | 2 星 |
| < 0.35 | 1 星 |
提示
评分只给没有星级的素材。如果你之前手动打过星，Nephele 不会覆盖。
怎么启动索引
方式一：界面操作
进入「资源库索引」视图（左侧导航栏或星盘轮盘），你会看到瀑布流网格展示 Eagle 库里的素材。顶部有筛选和操作栏：
- 文件夹筛选 —— 只处理某个文件夹下的素材
- 扩展名筛选 —— png, jpg, psd, svg, gif, webp
- 状态筛选 —— 全部 / 已索引 / 未索引
- 处理数量上限 —— 默认无限制，可自行设定
点击「开始索引」后，Nephele 会先统计符合条件的未索引素材数量，然后逐张处理。
方式二：让 Agent 执行
直接跟 Nephele 说：
- "帮我的 Eagle 素材库批量打标签"
- "给'角色参考'文件夹里的图加上 AI 标签"
- "把没索引过的插画都处理一下"
Agent 会自动调用索引工具，处理完后汇报结果。
处理参数
| 参数 | 说明 | 默认值 |
|---|---|---|
| 标签置信度阈值 | 低于此值的标签会被过滤掉，调高可减少噪音 | 0.35 |
| 自动评分 | 是否给无星级的素材打 1-5 星 | 开启 |
| 文件夹 | 限定处理范围 | 全部 |
| 扩展名 | 只处理指定格式 | 全部图片 |
置信度阈值是最值得调节的参数。如果你发现打上的标签太杂，可以调到 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 本身在后台运行。
Nephele 直接读写 Eagle 的 .library/ 文件系统和 metadata.json，不依赖 Eagle 软件本身。处理过程中会自动过滤掉非图片文件（视频、音频、压缩包等），只处理 png, jpg, jpeg, gif, webp, bmp, tiff, tif。
单张预览
不想批量处理，只想看看某张图会被打上什么标签？在资源库索引视图中点击任意一张素材，右侧面板会显示「预览标签」按钮。点击后 Nephele 会分析这张图并展示预测结果，但不会写入 Eagle。
预览结果包括：内容标签、角色标签、风格标签、预测星级。
索引之后：搜索素材库
索引完成后，素材的标签、星级、风格、CLIP embedding、姿势向量都会写回 Eagle 的元数据（metadata.json）。你可以通过以下方式利用这些数据：
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。
提示
按标签和星级筛选需要素材库已完成索引。如果还没索引过，这些筛选条件会没有结果。
其他索引驱动的功能
- 相似图搜索 —— 上传一张图，找库里视觉风格最像的素材
- 姿势搜索 —— 上传姿势草稿，找库里姿势相近的参考
- Agent 自动整理 —— "把带 'mecha' 标签的图移到'机甲参考'文件夹"
如果你还没建立过索引，上述功能的效果会大幅受限。建议先对常用素材库跑一次完整索引。