素材库搜索
工具名：eagle_search
在已经建立索引的素材库里按多维度筛选。这是日常翻自己收藏时最常用的工具。
适用场景
- 在自己收藏里翻特定类型的素材
- 按标签组合精确筛选，比如"武器 AND 4 星"
- 查看某张素材的完整元数据（通过 item_id）
使用方式
通过 Agent 对话
- "搜带 'weapon' 标签的图"
- "找所有 4 星以上的插画"
- "看看'角色参考'文件夹里有哪些 PNG"
- "给我这张图的完整信息"（传 item_id 直接返回单条元数据）
Agent 会自动组合多个参数进行精确筛选。比如你说"找 4 星以上、带 mecha 标签的 JPG"，它会同时传 star=4、tags=["mecha"], ext="jpg"。
通过工具箱手动执行
工具箱里有「素材库搜索」入口，可以手动设置关键词、标签、星级等条件后执行。
工作原理
Nephele 直接读取素材库的 metadata.json 和 .library/ 文件系统进行搜索，不依赖任何外部软件的 API。只要配置过库路径就能搜索，结果实时返回。
搜索参数
| 参数 | 类型 | 说明 |
|---|---|---|
| keyword | 字符串 | 搜索标题、标签、注释里的文字 |
| ext | 字符串 | 扩展名过滤，如 png、jpg、psd |
| tags | 字符串数组 | 标签过滤，素材必须包含所有指定标签 |
| star | 整数 (1-5) | 最低评分门槛 |
| folders | 字符串数组 | 文件夹 ID 过滤 |
| limit | 整数 | 返回数量上限，默认 20 |
| item_id | 字符串 | 传此参数时不做搜索，直接返回单条完整元数据 |
结果怎么看
每条返回的素材包含以下信息：
| 字段 | 说明 |
|---|---|
| id | 素材 item ID |
| name | 文件名 |
| ext | 扩展名 |
| tags | 标签列表 |
| star | 评分 (1-5) |
| width / height | 尺寸 |
| filePath | 文件路径 |
| thumbnail | 缩略图路径 |
| folders | 所在文件夹名称 |
提示
按标签和星级筛选需要素材库已完成 资源库索引。如果还没索引过，这些筛选条件会没有结果。
限制与注意事项
- 标签和星级搜索依赖索引。如果素材库新增了很多文件但还没重新索引，搜索结果会滞后。
item_id模式用于查询单张素材的完整信息，不做任何筛选，返回字段最全。