用途:该技能用于排查 Speckle 几何转换失败、接收后属性缺失、Revit 中出现非预期 Direct Shape 等问题,帮助避免静默数据丢失。
主要能力:按错误类别整理症状与严重程度,包括不支持的几何类型、Direct Shape 回退、属性缺失、几何烘焙损失、代理解析失败、单位不匹配、displayValue 错误及连接器特有失败。并提供几何类型支持矩阵、属性往返矩阵、代理类型矩阵、常见缩放因子与诊断决策树,说明各连接器在发布与加载上的差异。
用法要点:先在 Speckle 网页查看器中检查对象的 speckle_type 与 displayValue;再对照支持矩阵判断目标连接器是否支持该几何与代理类型;跨连接器交换优先使用 Mesh 原语;发布前核对源与目标单位及参照点;确保每个对象有稳定 applicationId。Rhino 属性以 user strings 提供,可用 ObjectUserString 读取;Grasshopper 用 Deconstruct 组件取字段;Power BI 用 Speckle.Objects.Properties 提取属性。
限制:Revit 加载始终生成 Direct Shape,不是原生墙板等元素;Revit、Blender、Archicad 不会把自定义属性写到接收对象;Tekla 仅发布、Power BI 只读;AutoCAD/Civil 3D 实体强制转 Mesh 且不可逆;Blender 仅识别 Principled、Diffuse、Emission、Glass 四种着色器且不支持贴图;Revit 仅发布三维透视图;SketchUp 材质需应用于面而非组件。Brep/NURBS 仅在 Rhino 系应用间可靠传递。具体平台、收费与价格信息暂未提供。