用途
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):
- 用精确的查询语句搜索你需要的类型。
- 根据尺寸、标题、来源挑选最佳结果。
- 调用 apply 获得项目相对路径。
- 把该路径接入你正在编辑的产物中。
适用场景
- 用户希望对已有素材进行复用,而不是重新生成或重新上传。
- 在构建页面、编写 HTML/CSS 时需要图片,且用户倾向使用自己库中的素材。
- 需要把设计系统素材应用到当前项目。
限制与注意事项
- 如果搜索没有返回结果,应回退到媒体生成方案,而不是猜测路径;绝不能臆造 apply 未返回的 relPath。
- 搜索在当前配置下为关键词/元数据匹配(semantic: false),结果需要自行过滤与排序。
- 两个接口都依赖本次运行的 OD_TOOL_TOKEN 认证,且只作用于本次运行所属的项目。
- 关于收费、价格、平台支持范围等信息,资料暂未提供。