用途:诊断并解决 Blender 脚本中因版本差异引发的 Python API 错误,适用于遇到 AttributeError、ImportError、TypeError、KeyError、RuntimeError、ValueError 等报错的场景。依赖 blender-core-versions 技能(版本矩阵与检测 API)。
主要能力:提供错误诊断决策树,按错误类型定位问题;给出错误模式速查表,覆盖 Blender 4.0、4.1、4.2、4.3、4.4、5.0 的破坏性变更,如 mesh 属性迁移、auto-smooth 移除、bgl 模块移除、EEVEE 标识符变更、slotted actions、compositor 节点组等;提供弃用时间线,标明各 API 的弃用与移除版本及警告周期;给出诊断模式,包括从错误识别版本、版本安全访问、多版本兼容封装。
使用方式:先确定 Blender 版本,可用 bpy.app.version 打印诊断信息;使用 hasattr() 做优雅降级,不要静默捕获 AttributeError;用 bpy.app.version 或 hasattr() 做版本判断,不要用 try/except AttributeError;使用 context.temp_override() 替代字典上下文覆盖;新代码不要使用 bgl。
适用场景:调试 Blender 插件或脚本的版本兼容问题,迁移旧代码到新版本,编写支持多版本 Blender 的插件。
限制:资料未提供具体安装命令、收费信息或平台支持范围;部分 API 替换细节需参考官方文档与技能内 references 文件。