SuperAPI AI 工具集

blender-asset-source

设计与创作

查看项目

更新于 10-16 08:35

技能介绍

用途:搜索可发现的资产来源,并返回验证后的 AssetDescriptor[],供下游导入流程使用。

主要能力:支持文件系统搜索,遍历本地目录中受支持的 3D 文件格式;支持 Blender 资产库搜索,扫描已注册的资产库;支持类型过滤,可将结果限制为特定格式(如 blend、fbx、obj、usd 等);支持名称匹配,对资产名称做不区分大小写的子串过滤。资产库注册信息来自 bpy.context.preferences.filepaths.asset_libraries。

使用方式:通过 search_assets 工具搜索资产来源并返回验证后的 AssetDescriptor[]。搜索为只读操作,不会刷新 Asset Browser UI,也不会保存偏好设置。context.asset_library_status 可区分 scanned、no_libraries、unavailable、partial 和 error;缺失 API 或无法读取的库不会被当作空的成功库搜索结果。损坏的注册项不会隐藏后续有效库,部分结果会包含明确状态和警告。当 source=all 时,文件系统结果可能随库警告一同返回。达到结果预算时搜索可能被截断。

限制:该工具直接搜索已注册本地目录中受支持的文件,而不是 .blend 文件内部标记为资产的数据块。远程库、目录、标签以及递归依赖发现需要其他独立能力。