用途:该技能面向 Speckle 生态的开发者,帮助在使用 Python 或 C# SDK 创建对象、处理 Base 类继承和对象分解(decomposition)时遵循正确模型,避免分离语法错误等常见问题。
主要能力:讲解五层对象模型(Base 原语、DataObject 语义 BIM 元素、Collection 层级分组、Commit 根容器、*Proxy 交叉关系);属性前缀规则(无前缀为内联序列化,@ 为分离序列化,__ 为排除序列化与哈希);核心身份字段 id(SHA256 内容哈希,序列化前为 null)、applicationId、speckle_type、totalChildrenCount;分离(detaching)与分块(chunking)机制及选择决策;displayValue 视觉表示机制;单位(m/mm/cm/ft/in);实例/定义模式用于重复几何。
使用方式:Python 使用 from specklepy.objects.base import Base 与 dataclass,C# 使用 [Serializable] 与 DynamicBase,动态属性通过 obj["customProperty"] 添加,@ 前缀实现分离,[DetachProperty]、[Chunkable(31250)]、[Serializable] 等特性控制序列化。
适用场景:构建 Speckle 对象、实现连接器、优化大几何传输、定义 BIM 语义对象。
限制:Collection 层级必须为严格有向树,不得成环;动态属性名不得含 . 或 /,禁止空字符串与连续 @@;不得在循环内调用 get_id(),不得在读取 id 后修改对象;大几何须用分离属性;几何对象必须带单位。具体 API 签名与示例需查阅资料引用的 references 文件,官方源包括 docs.speckle.systems 与 speckle.guide。