用途：面向使用 IfcOpenShell 处理 IFC 模型时的报错排查，提供按异常类型分类的诊断决策树与修复模式。
主要能力：覆盖 12 类错误——schema 不匹配（IFC2X3/IFC4/IFC4X3 实体名不同）、属性大小写错误（须用 PascalCase，如 GlobalId、Name）、关系处理错误（IFC 无 parent/children，须用 ifcopenshell.api.run 创建关系）、几何处理失败（create_shape 需 try/except RuntimeError）、实体删除后引用失效、未检查 None 返回值、直接 model.remove 导致文件损坏、属性类型不匹配、GUID 格式错误、单位换算缺失、重复属性集、IFC2X3 缺 OwnerHistory。
必要用法：变更一律用 ifcopenshell.api.run()，不要直接改关系、空间归属或属性集；用前检查 model.schema；访问属性前检查 None；删除产品用 root.remove_product；不要跨文件修改缓存实体引用；坐标须乘 ifcopenshell.util.unit.calculate_unit_scale(model)；几何处理包 try/except。GUID 用 ifcopenshell.guid.new()。
适用场景：调试 IFC 读写脚本、批量修改模型、几何提取与校验。限制：资料未提供具体版本兼容范围、性能数据或安装步骤。