SuperAPI AI 工具集

oas-extensions

数据与分析

查看项目

更新于 10-15 17:21

技能介绍

用途:当任务涉及在 Core 或 Layout 文档之外附加领域特定数据时使用本技能,包括工业机械、材料、MEP 系统、场地环境或供应商元数据(Autodesk/Revit 族、APS URN)。若数据可直接归入 Core 实体(如家具摆放),应保留在 Core 中,不使用扩展。

主要类型:扩展信封(顶层 extensions 字典,以扩展名为键);Machinery(多轴旋转的工业设备及 CAD 几何来源);Material(供 Core/Layout 实体按 id 引用的材料定义);Site(边界、朝向、周边环境);AutodeskMetadata(Revit 族名、APS URN、供应商标识符)。

关键规则:OAS 1.1.0+ 使用字典格式 "extensions": { "oas-machinery": { "version": "..." }, "oas-autodesk": { ... } },解析器仍须接受旧的数组形式,但新文档应输出字典;Furniture 与 3D 字段不再是扩展,已移入 Core,oas-furniture 和 oas-3d 为已弃用扩展名,应直接写在 Core 实体上;每个扩展各自携带独立于文档版本的版本字段,遵循 Semver;Machinery 有三个独立旋转轴——rotation_deg(Z,默认)、rotation_x_deg、rotation_y_deg,分别以度为单位,不可合并为一个;Machinery id 必须在整个文档全局唯一,而非仅在 machinery 数组内;geometry_ref 与 geometry_source:基础 oas-machinery 使用简单 geometry_ref URI/路径字符串,当 oas-autodesk 同时启用时,machinery 可携带结构化 geometry_source 对象(urn、external_id、item_id、file_name、is_y_up、import_mode、mesh_quality)用于 APS Model Derivative / ACC 导入;供应商专属名称放在其扩展中,不放在 Core,如 Revit 的 revit_family / revit_type、APS 的 external_id 等归入 oas-autodesk,绝不内联到 Core Wall.type_name;扩展不得覆盖 Core 不变量——不得使用十进制坐标、不得重定义 Room/Wall/Opening、不得破坏 mm 整数规则。

完整模式见 docs/extensions.md,含字典信封、各扩展模式(machinery、autodesk、MEP、materials、site)及 1.0→1.1 迁移说明。相关技能:oas-core(扩展所增补的文档)、oas-layout(扩展也附加到已解析布局,如放置在地板上的机械)。