用途：指导在 Speckle 与 Revit 之间发送或接收 BIM 元素时，避免常见的往返保真预期错误和数据丢失问题。
主要能力：资料分别说明 Speckle 侧（Base、speckle_type、displayValue、parameters、applicationId、Collection、各级 Proxy Collections）与 Revit 侧（Family、Family Type、System Family、实例/类型参数、DirectShape、Workset、ElementId）概念；并描述 Speckle Revit 连接器的双向非对称保真、发送粒度（视图、选择集、类别、工作集）、接收结果（默认 DirectShape 或映射原生族）、参数处理、applicationId 更新机制与引用点选择。
发送流程：元素选择（视图/选择集/类别/工作集过滤）、元素拆解（幕墙拆为面板与竖梃、楼梯拆为梯段平台栏杆、组展开）、转换（读取几何、抽取全部类型与实例参数、解析族与类别名、按 Detail Level 生成 displayValue 网格、以 Revit UniqueId 作为 applicationId）、缓存去重、通过 ServerTransport 或 SQLiteTransport 传输。
接收流程：反序列化、类型映射（自动按类别+族+类型名匹配，或手动映射；非 Revit 来源建议手动映射）、无匹配族时创建 DirectShape、材质烘焙、组与层级重建、单一事务提交，失败则整体回滚。
关键限制：往返会丢失参数化智能（回来的是 DirectShape 而非可编辑族）、系统族行为、宿主关系（门/窗与墙）、工作集、设计选项、明细表分组、阶段信息等。v3 中 speckle_type 恒为 Objects.Data.DataObject，应改查 properties.category。需先设定引用点（内部原点/项目基点/测量点，与 GIS 交换时应用测量点）并保持一致，接收前设置 Detail Level。版本上 2022-2024 用 .NET Framework 4.8 与 CefSharp，2025-2026 用 .NET 8.0 与 WebView2，须匹配连接器版本。
使用方式：可通过 UI 连接器操作，也可用 Speckle .NET SDK 编程（AccountManager 认证、ServerTransport、Operations.Send、CommitCreate）。进一步 API、示例与反模式见资料列出的 references 文件与官方链接。