该技能用于在 Blender 主版本之间迁移、移植、更新或升级 Python 脚本与插件,覆盖 3.x、4.x、5.x。
用途:当代码需要跨版本升级时,按系统化流程识别源版本与目标版本、扫描受影响 API、逐版本应用替换、更新元数据并校验。
主要能力:提供支持的迁移路径表(含复杂度与关键变化,如 4.0 上下文覆盖、网格属性、节点接口、骨骼集合;4.3 蜡笔重写;5.0 BGL 移除等);给出必须按顺序执行的迁移步骤,强调不得跳过中间版本;按版本给出查找替换表(3.x→4.0、4.0→4.1、4.1→4.2、4.2→4.3、4.3→4.4、4.x→5.0、5.0→5.1);提供兼容层与条件导入模式,以及 EEVEE 标识符查询与扩展系统(4.2+)迁移步骤。
使用方式:先依据代码信号判断版本(如 bl_info、blender_manifest.toml、import bgl、context 覆盖字典、mesh.use_auto_smooth 等),再按目标版本范围决定做干净迁移还是兼容层;4.2+ 扩展需创建 blender_manifest.toml、移除 bl_info,并设置 blender_version_min 等字段。关键命令与代码片段保持原样,例如 gpu.shader.create_from_info()、gpu.state.blend_set('ALPHA')、bpy.context.temp_override()、super().init(*args, **kwargs)。
适用场景:为分发到多个 Blender 版本的插件做升级;内部工具从旧版本迁移到新版本;评估跨版本改动范围。
限制:仅覆盖资料中列出的版本与替换项,其他 API 变化暂未提供;需配合依赖项 blender-core-versions 与 blender-errors-version 使用;实际迁移结果与验证需在目标 Blender 版本中自行确认。