SuperAPI AI 工具集

library-curator

设计与创作

查看项目

更新于 10-15 16:22

技能介绍

用途

library-curator 用于在任务执行过程中搜索 OD Library(全局素材注册表),并把匹配到的素材应用到当前项目。它解决的是素材复用问题:让用户已有的素材能够被直接调用,而无需重新上传。

适用时机包括:用户引用自己已经拥有的素材(例如“我截的那张图”“我的标志”“之前那张主视觉图”);你在构建页面时需要图片,而用户更倾向于使用自己库中的素材而非新生成的媒体。

可复用的素材范围包括:通过 OD Clipper 截取的图片、手动上传的内容、智能体生成的媒体,以及设计系统素材。

主要能力与接口

该技能提供两个接口,均使用本次运行的 tool token(OD_TOOL_TOKEN,由守护进程注入)进行认证,并作用于本次运行所属的项目。

搜索

POST /api/tools/library/search

{ "query": "blue hero background", "kind": "image", "limit": 20 }

返回格式:

{ "results": [{ "asset": { "id": "...", "kind": "image", "sourceTitle": "...", "width": 1600, "height": 900, "sources": [...] }, "score": 0 }], "semantic": false }

其中 semantic: false 表示当前为关键词/元数据匹配(未配置嵌入模型),因此需要你根据素材元数据自行过滤和排序结果。

应用

POST /api/tools/library/apply

{ "assetId": "<id from search>", "dir": "assets" }

该接口会把素材复制到项目中(默认子目录为 library/,也可指定传入的 dir),并返回 { "relPath": "assets/<hash>.png" }。你可以在编写的 HTML/CSS 中引用该 relPath,例如:

<img src="assets/ab12cd34ef.png">

使用方式

推荐流程(Recipe):

  1. 用精确的查询语句搜索你需要的类型。
  2. 根据尺寸、标题、来源挑选最佳结果。
  3. 调用 apply 获得项目相对路径。
  4. 把该路径接入你正在编辑的产物中。

适用场景

  • 用户希望对已有素材进行复用,而不是重新生成或重新上传。
  • 在构建页面、编写 HTML/CSS 时需要图片,且用户倾向使用自己库中的素材。
  • 需要把设计系统素材应用到当前项目。

限制与注意事项

  • 如果搜索没有返回结果,应回退到媒体生成方案,而不是猜测路径;绝不能臆造 apply 未返回的 relPath。
  • 搜索在当前配置下为关键词/元数据匹配(semantic: false),结果需要自行过滤与排序。
  • 两个接口都依赖本次运行的 OD_TOOL_TOKEN 认证,且只作用于本次运行所属的项目。
  • 关于收费、价格、平台支持范围等信息,资料暂未提供。