用途:管理 Blender 数据块相关操作,包括集合组织、库链接与追加、库覆盖、资产系统以及数据块生命周期,并给出跨版本注意事项。
主要能力: 集合:创建与嵌套集合、对象成员归属与解除、视图层可见性(exclude、hide_viewport)与全局可见性(hide_viewport、hide_render),并遍历集合树。 库链接与追加:使用 bpy.data.libraries.load(),默认 link=False 为追加,链接需显式 link=True;加载后须检查返回是否为 None。 库覆盖:4.0 起用库覆盖替代已移除的代理,提供创建、检查属性与重新同步的操作。 资产系统:asset_mark() 标记资产,设置元数据与标签、目录与预览;4.0+ 使用 context.asset,5.0 起移除 context.asset_file_handle。 数据块:创建、删除、fake user 防止孤儿清理,以及 bpy.ops.outliner.orphans_purge() 清理;批量删除建议先收集再删除。
必要用法要点:不得重命名或删除 scene.collection;4.0+ 不得使用代理;目录自动化不宜依赖 bpy.ops.asset.catalog_new(),可直接编辑 blender_assets.cats.txt;删除数据块须调用对应 remove();Python del 仅移除引用。
适用场景:脚本化处理 Blender 场景层级、外部 .blend 资源引用与覆盖、资产管理及清理。
限制:资料给出 API 与示例,但每项细节与版本兼容性仍以实际 Blender 版本行为为准;未提供界面操作、性能与价格等信息。