SuperAPI AI 工具集

blender-agents-code-validator

设计与创作

查看项目

更新于 10-16 06:17

技能介绍

用途:对 Blender Python 代码做系统化校验,适用于代码审查、插件/扩展发布前检查、跨版本迁移(3.x→4.x→5.x)、排查运行时崩溃与上下文错误,以及校验新生成代码。

主要能力:按顺序执行八类检查并分级(BLOCKER 会崩溃或损坏数据、WARNING 为缺陷或弃用、INFO 为最佳实践)。检查项包括:目标版本判定(bpy.app.version、bl_info["blender"]、blender_manifest.toml);上下文安全(draw()、handler、timer、绘制回调、后台线程中禁止 bpy.ops 与 bpy.data 修改,dict 式上下文覆盖在 4.0+ 已移除,应改用 context.temp_override());API 正确性(4.0/5.0/5.1 移除项如 mesh.calc_normals()、bone.layers、bgl、Sequence.frame_final_start 等,以及 EEVEE 标识符随版本变化);数据安全(失效引用、命名冲突、缺少 collection.objects.link()、BMesh 生命周期、from_pydata() 后缺 mesh.update());线程安全;插件注册顺序、handler 清理与 @persistent、EnumProperty 回调缓存;操作符最佳实践;GPU 绘制代码。

使用方式:对目标代码逐项运行检查,按严重度决策树归类,安全处可自动修复(如替换 obj.select_set(True)、补 mesh.update()、补 bm.free() 等),最后输出含目标版本、问题总数与 BLOCKER/WARNING/INFO 及自动修复清单的报告。

限制:需先确定目标 Blender 版本,否则无法判断 API 有效性;自动修复仅在安全时适用;具体规则、示例与反模式见其 references 文档。