SuperAPI AI 工具集

speckle-agents-data-validator

数据与分析

查看项目

更新于 10-15 22:18

技能介绍

用途:在 Speckle 数据发送前做预检、接收后做完整性审计,以及持续的数据质量检查,避免发送畸形对象导致查看器崩溃或数据丢失。

主要能力:按决策树覆盖对象模式校验(speckle_type、动态属性名规则)、几何完整性(网格顶点数可被 3 整除、面索引边界、面顶点数≥3、units 必填)、displayValue 校验(必须为几何类型列表且带 units)、集合树校验(禁止环与共享父节点)、代理引用完整性(按 applicationId 引用、InstanceProxy 的 definitionId 匹配)、单位一致性、完整预检、接收后审计(重复 applicationId、属性覆盖)、代理解析、几何审计、完整性审计与跨版本漂移检测。

使用方式:在 operations.send() 前运行 pre_flight_validate(root_collection, proxies),遍历对象调用 validate_base_object、validate_mesh、validate_display_value 等函数;接收后按清单检查 displayValue、speckle_type、applicationId 唯一性与 units。

限制与警告:不得手动设置 id(内容哈希在序列化时计算),调用 get_id() 后不得再改属性;代理必须用 applicationId 而非 id 引用;集合不得成环;几何必须带 units;applicationId 仅在单一源应用内唯一。具体实现见 references/examples.md 等参考文件。