IfcOpenShell Bonsai扩展导致Blender启动模板崩溃问题分析

问题现象

在Blender 4.2.3 LTS版本中，当用户尝试从启动模板创建新项目时（非"General"选项），系统会出现崩溃现象。经过排查，这一问题与安装的Bonsai扩展（v0.8.0版本）直接相关。

技术分析

崩溃原因

通过错误日志分析，崩溃主要发生在以下两个关键环节：

1. 键映射项移除失败：在Bonsai扩展卸载过程中，尝试移除Object Mode键映射中的空键映射项时失败，抛出RuntimeError。

2. 翻译缓存冲突：在重新注册Bonsai扩展时，系统检测到翻译消息缓存中已存在"bonsai"插件的相关数据，导致ValueError。

深层机制

Blender的模板切换机制会触发以下流程：

1. 卸载当前所有激活的扩展
2. 加载新模板配置
3. 重新注册扩展

Bonsai扩展在此过程中未能正确处理状态迁移，特别是：

• 键映射项的清理不完整
• 翻译缓存未正确重置
• 资源释放不完全（如图像预览集合）

解决方案验证

经过多次测试验证，以下方案可解决该问题：

1. 升级到最新版本：使用Bonsai v0.8.1-alpha241119或更高版本
2. 确保Python版本匹配：必须使用与Blender内置Python版本（3.11.x）对应的Bonsai包
3. 清理残留配置：完全删除Blender配置目录（Application Support/Blender）后重新安装

相关设计考量

值得注意的是，Bonsai扩展会主动禁用Blender的启动画面（Splash Screen），这是其设计特性之一。用户可通过以下方式恢复：

1. 在Bonsai设置中禁用"Setup workspace for BIM"选项
2. 这将恢复Blender默认布局和启动画面

最佳实践建议

对于需要在Blender中使用Bonsai扩展的用户，建议：

1. 优先使用Blender官方渠道下载的最新稳定版
2. 定期检查Bonsai扩展更新
3. 在测试新功能时，先备份用户配置
4. 了解扩展可能修改的默认行为（如启动画面）

该问题的解决体现了开源社区协作的优势，通过用户反馈和开发者响应的良性互动，最终找到了有效的解决方案。