using System.Collections.Generic; namespace FurnitureExporter; /// /// 导出数据(JSON 根对象) /// public class ExportData { /// /// 数据格式版本 /// public string Version { get; set; } = "2.6"; /// /// 导出时间 (ISO 8601) /// public string ExportedAt { get; set; } = ""; /// /// 源文件名 /// public string SourceFile { get; set; } = ""; /// /// 导出软件 /// public string Software { get; set; } = ""; /// /// 插件版本 /// public string PluginVersion { get; set; } = ""; /// /// 板材模型文件名 /// public string ModelFile { get; set; } = ""; /// /// 板材数量 /// public int PanelCount { get; set; } /// /// 图纸单位(毫米/厘米/米等) /// public string Units { get; set; } = "毫米"; /// /// CAD 世界坐标系标识。 /// 当前导出统一按 AutoCAD 世界坐标:X 向右,Y 向前,Z 向上。 /// Web 端后续做孔位吸附时,不再需要靠启发式猜测坐标系。 /// public string CoordinateSystem { get; set; } = "AUTOCAD_WORLD_Z_UP"; /// /// 原点偏移 [X, Y, Z] (mm) /// 所有坐标已应用此偏移,使模型居中于原点 /// public double[]? OriginOffset { get; set; } /// /// 模型包围盒 [minX, minY, minZ, maxX, maxY, maxZ] (mm) /// 坐标已应用 OriginOffset,与导出的 OBJ 坐标系保持一致。 /// public double[]? ModelBounds { get; set; } /// /// 导出模式: /// - product_bundle:旧整套家具兼容导出 /// - single_asset:资产中心单资产导出 /// public string? ExportMode { get; set; } /// /// 资产类型提示(仅 single_asset 模式使用): /// BOARD / COMPONENT / HARDWARE /// public string? AssetTypeHint { get; set; } /// /// 本次导出的源实体数量(便于排查“选少了/选多了”) /// public int? SourceEntityCount { get; set; } /// /// 板材列表(v2.0 新增) /// public List Panels { get; set; } = new(); /// /// 孔位列表(v2.0 新增) /// public List Holes { get; set; } = new(); /// /// 被过滤/排除的孔位列表(兜底用)。 /// /// 说明: /// - Holes 是“默认展示/默认参与关联”的孔位; /// - ExcludedHoles 用于排查/兜底模式:当过滤规则误判导致漏孔时,Web 端可让设计师手动复核并启用。 /// - Reason 必须为中文,便于非技术用户理解。 /// public List? ExcludedHoles { get; set; } /// /// 逻辑孔位分组(v2.2.4 新增) /// 典型用法:偏心件孔(大孔+侧孔)在几何上是两个圆柱孔,但业务上希望计为 1 个“孔位”。 /// public List HoleGroups { get; set; } = new(); /// /// 安装图样(v2.5 兼容字段)。 /// 新方案主字段是 SnapPatterns;这里继续保留给旧 Web 端兼容。 /// public List MountPatterns { get; set; } = new(); /// /// 吸附图样(v2.6 新主字段)。 /// 内容与 MountPatterns 保持一致,Web 端后续优先读取 snapPatterns。 /// public List SnapPatterns { get; set; } = new(); /// /// 吸附面(v2.6 新增)。 /// 每块板件至少提供 6 个轴向外表面,用于辅助装配阶段做面级吸附候选。 /// public List SnapSurfaces { get; set; } = new(); /// /// 逻辑孔位数量(v2.2.4 新增) /// 计算方式:以 HoleGroupId 合并计数(HoleGroupId 为空则按 Hole.Id 计数)。 /// public int? LogicalHoleCount { get; set; } /// /// 边缘特征列表(倒角/圆角)(v2.1 新增) /// public List EdgeFeatures { get; set; } = new(); /// /// 五金件类型列表 /// public List HardwareTypes { get; set; } = new(); /// /// 图层信息映射(v2.2 新增) /// key: 图层名称, value: 图层分类信息 /// public Dictionary Layers { get; set; } = new(); /// /// 五金件按图层分类汇总(v2.2 新增) /// public List HardwareSummary { get; set; } = new(); /// /// 装配语义导出层(v2.4 草稿) /// 说明: /// - 仅导出“板件如何与其他板件/五金发生装配关系”的语义线索; /// - 不包含最终安装顺序,安装顺序仍由 Web 端人工设定。 /// public AssemblyData? Assembly { get; set; } } /// /// 装配语义导出层 /// public class AssemblyData { /// /// 装配语义格式版本 /// public string Version { get; set; } = "1.0"; /// /// 每块板件的装配语义 /// public List PanelAssemblies { get; set; } = new(); /// /// 板件之间的连接关系 /// public List Connections { get; set; } = new(); } /// /// 单块板件的装配语义 /// public class PanelAssemblyInfo { public string PanelId { get; set; } = ""; /// /// 装配模式:slide_in / drop_in / rotate_into_place / unknown /// public string MountMode { get; set; } = "unknown"; /// /// 主装配轴(单位向量,表示从最终位往外拉开的方向) /// public double[] AssemblyAxis { get; set; } = new double[3]; /// /// 离散装配方向:left / right / front / back / top / bottom / unknown /// public string AssemblyDirection { get; set; } = "unknown"; /// /// 进入装配前建议预偏移向量(mm) /// public double[]? PreAssembleOffset { get; set; } /// /// 建议装配移动距离(mm) /// public double TravelDistance { get; set; } /// /// 依赖的支撑/目标板件 ID /// public List DependsOn { get; set; } = new(); /// /// 主要支撑板件 ID /// public string? PrimarySupportPanelId { get; set; } /// /// 目标板件 ID 列表 /// public List TargetPanelIds { get; set; } = new(); /// /// 板件级配合面映射(left/right/front/back/top/bottom) /// public PanelAssemblyMateMap Mates { get; set; } = new(); /// /// 语义置信度(0-1) /// public double Confidence { get; set; } /// /// 风险/歧义提示 /// public List Warnings { get; set; } = new(); /// /// 是否为自动推导结果 /// public bool AutoGenerated { get; set; } = true; } /// /// 板件之间的连接关系 /// public class AssemblyConnectionInfo { public string SourcePanelId { get; set; } = ""; public string TargetPanelId { get; set; } = ""; /// /// 连接类型:hole_group_hardware / hole_hardware / panel_hardware / adjacent_face / panel_type_fallback /// public string ConnectionType { get; set; } = "adjacent_face"; public string SelfFace { get; set; } = "unknown"; public string TargetFace { get; set; } = "unknown"; public double Confidence { get; set; } } /// /// 板件级配合面映射 /// public class PanelAssemblyMateMap { public List? Left { get; set; } public List? Right { get; set; } public List? Front { get; set; } public List? Back { get; set; } public List? Top { get; set; } public List? Bottom { get; set; } } /// /// 板材信息(v2.0 新增) /// public class PanelInfo { /// /// 板材 ID(自动生成,如 panel_001) /// public string Id { get; set; } = ""; /// /// 源实体句柄 /// public string SourceHandle { get; set; } = ""; /// /// 源图层名 /// public string? SourceLayer { get; set; } /// /// 推断的板件类型(v2.2 新增) /// public string? PanelType { get; set; } /// /// 中心位置 [X, Y, Z] (mm) /// public double[] Position { get; set; } = new double[3]; /// /// 尺寸 [长, 宽, 厚] (mm),已排序 /// public double[] Size { get; set; } = new double[3]; /// /// 板材法向量(厚度方向)[X, Y, Z] /// public double[] Normal { get; set; } = new double[3]; /// /// 边界框 /// public BoundingBox3D? BoundingBox { get; set; } /// /// 该板材上的孔位列表 /// public List Holes { get; set; } = new(); /// /// 该板件上的逻辑孔位分组(v2.2.4 新增) /// public List HoleGroups { get; set; } = new(); /// /// 该板件上的安装图样(v2.5 兼容字段) /// public List MountPatterns { get; set; } = new(); /// /// 该板件上的吸附图样(v2.6 新主字段) /// public List SnapPatterns { get; set; } = new(); /// /// 该板件的吸附面(v2.6 新增) /// public List SnapSurfaces { get; set; } = new(); } /// /// 被排除的孔位(用于兜底/排查模式) /// public class ExcludedHoleInfo { /// /// 孔位数据(与 Holes 相同结构) /// public HoleInfo Hole { get; set; } = new(); /// /// 排除原因(中文) /// public string Reason { get; set; } = ""; } /// /// 孔位信息(v2.0 新增) /// public class HoleInfo { /// /// 孔位 ID(如 panel_001_hole_001) /// public string Id { get; set; } = ""; /// /// 孔中心位置 [X, Y, Z] (mm) /// public double[] Position { get; set; } = new double[3]; /// /// 孔方向(法向量)[X, Y, Z] /// public double[] Normal { get; set; } = new double[3]; /// /// 孔直径 (mm) /// public double Diameter { get; set; } /// /// 孔半径 (mm) /// public double Radius { get; set; } /// /// 孔深度 (mm) /// public double Depth { get; set; } /// /// 所属板材 ID /// public string PanelId { get; set; } = ""; /// /// 孔位检测来源: /// - brep:来自板件实体 Brep 真孔 /// - marker:来自图纸标注/块/点位兜底识别 /// public string DetectionSource { get; set; } = "brep"; /// /// 孔位与板件的绑定来源: /// - panel_brep:在当前板件实体内直接提取 /// - marker_face:标注孔贴面匹配到板件 /// - marker_box:标注孔按包围盒退化匹配到板件 /// public string BindingSource { get; set; } = "panel_brep"; /// /// 孔位与板件绑定的置信度(0-1) /// public double BindingConfidence { get; set; } = 1.0; /// /// 孔位整体可用置信度(0-1) /// 说明: /// - BindingConfidence 只表示“孔位和板件绑定得稳不稳”; /// - Confidence 表示“这个孔位几何与语义整体是否可信”。 /// public double Confidence { get; set; } = 1.0; /// /// 绑定原因说明(调试/回放) /// public string? BindingReason { get; set; } /// /// 孔类型:"through"(通孔)| "blind"(盲孔) /// public string Type { get; set; } = "blind"; /// /// 逻辑孔位分组 ID(v2.2.4 新增) /// 偏心件等复合孔会被分到同一个 HoleGroupId,便于“按孔位”计数与展示。 /// public string? HoleGroupId { get; set; } /// /// 逻辑孔位分组类型(v2.2.4 新增) /// 例如:eccentric_screw /// public string? HoleGroupType { get; set; } /// /// 当前孔在分组中的角色(v2.2.4 新增) /// 例如:main(主孔)/ side(侧孔) /// public string? HoleGroupRole { get; set; } /// /// 当前孔实际打在板件外表面的面标签。 /// 盲孔通常只有 1 个面;通孔通常会有 2 个相对面。 /// 例如:top / bottom / left / right / front / back /// public string[] SurfaceFaces { get; set; } = System.Array.Empty(); /// /// 推断的用途(根据直径) /// public string? InferredUsage { get; set; } /// /// 低置信度或歧义提示 /// public List Warnings { get; set; } = new(); /// /// 针对该孔位的紧固件建议(v2.3 新增) /// 说明: /// - 这是“插件端基于几何特征的候选建议”,不是最终装配 BOM。 /// - 常见场景:通过孔径/深度/通孔或盲孔特征,把孔映射到更可能的螺丝直径(例如 4.8mm 的盲孔导孔通常更像 M6)。 /// - Web 端可以直接展示 Top1/Top2,并在低置信度时引导人工复核(不要求设计师额外操作)。 /// public List? SuggestedFasteners { get; set; } } /// /// 紧固件建议(v2.3 新增) /// public class FastenerSuggestion { /// /// 建议类别:screw(螺丝)/ connector(连接件)等 /// 当前版本主要用于 screw /// public string Category { get; set; } = "screw"; /// /// 公称直径(mm),例如 6 表示 M6 /// public double NominalDiameter { get; set; } /// /// 常见规格示例(来自五金标准库的“常用项”,用于 UI 展示/人工复核) /// 注意:孔的几何通常无法唯一推断螺丝长度,所以这里给的是候选样例。 /// public List? CommonSpecs { get; set; } /// /// 置信度(0-1),用于排序与低置信度提示 /// public double Confidence { get; set; } /// /// 可读原因(给调试/回放用) /// public string? Reason { get; set; } } /// /// 逻辑孔位分组(v2.2.4 新增) /// public class HoleGroupInfo { /// /// 分组 ID(如 panel_001_group_001) /// public string Id { get; set; } = ""; /// /// 所属板件 ID /// public string PanelId { get; set; } = ""; /// /// 分组类型:eccentric_screw / unknown 等 /// public string GroupType { get; set; } = "unknown"; /// /// 该逻辑孔位包含的几何孔 ID 列表 /// public string[] HoleIds { get; set; } = System.Array.Empty(); /// /// 逻辑孔位参考点(默认取主孔中心)[X, Y, Z] (mm) /// public double[] Position { get; set; } = new double[3]; /// /// 逻辑孔位参考方向(默认取主孔法向)[X, Y, Z] /// public double[] Normal { get; set; } = new double[3]; /// /// 置信度(0-1),用于调试与后续 Web 端提示 /// public double Confidence { get; set; } /// /// 可读原因(调试/回放) /// public string? Reason { get; set; } /// /// 当前孔组默认作用的安装面。 /// 例如:top / bottom / left / right / front / back / unknown /// public string MountFace { get; set; } = "unknown"; /// /// 逻辑孔位实际落在哪些板件外表面上。 /// 默认按主孔 + 组内成员孔合并去重。 /// public string[] SurfaceFaces { get; set; } = System.Array.Empty(); /// /// 低置信度或歧义提示 /// public List Warnings { get; set; } = new(); } /// /// 安装图样(v2.5 新增) /// public class MountPatternInfo { /// /// 图样 ID(如 panel_001_mount_top_001) /// public string Id { get; set; } = ""; /// /// 所属板件 ID /// public string PanelId { get; set; } = ""; /// /// 默认安装面:top / bottom / left / right / front / back / unknown /// public string MountFace { get; set; } = "unknown"; /// /// 图样类型:single / line_2 / triangle_3 / rectangle_4 / generic /// public string PatternType { get; set; } = "generic"; /// /// 属于该图样的几何孔位 ID /// public string[] HoleIds { get; set; } = System.Array.Empty(); /// /// 必需命中的孔位 ID /// public string[] RequiredHoleIds { get; set; } = System.Array.Empty(); /// /// 可选命中的孔位 ID /// public string[] OptionalHoleIds { get; set; } = System.Array.Empty(); /// /// 吸附成立所需的最少命中孔数 /// public int MinRequiredHoles { get; set; } /// /// 推荐命中孔数(越接近越稳) /// public int PreferredHoleCount { get; set; } /// /// 是否允许对称复用 /// public bool Symmetry { get; set; } /// /// 图样参考点(默认取图样中心) /// public double[] Position { get; set; } = new double[3]; /// /// 图样参考法向(默认取安装面法向) /// public double[] Normal { get; set; } = new double[3]; /// /// 图样置信度(0-1) /// public double Confidence { get; set; } /// /// 低置信度或歧义提示 /// public List Warnings { get; set; } = new(); } /// /// 吸附面信息(v2.6 新增) /// public class SnapSurfaceInfo { /// /// 吸附面 ID(如 panel_001_snap_top) /// public string Id { get; set; } = ""; /// /// 面标签:left / right / front / back / bottom / top /// public string Face { get; set; } = ""; /// /// 所属板件 ID /// public string PanelId { get; set; } = ""; /// /// 外法向量 [X, Y, Z] /// public double[] Normal { get; set; } = new double[3]; /// /// 面中心 [X, Y, Z] (mm) /// public double[] Center { get; set; } = new double[3]; /// /// 面边界框。薄轴最小值和最大值相同,表示该外表面所在平面。 /// public BoundingBox3D Bounds { get; set; } = new(); /// /// 推导置信度(0-1) /// public double Confidence { get; set; } } /// /// 3D 边界框 /// public class BoundingBox3D { /// /// 最小点 [X, Y, Z] /// public double[] Min { get; set; } = new double[3]; /// /// 最大点 [X, Y, Z] /// public double[] Max { get; set; } = new double[3]; } /// /// 五金件类型(按几何特征分组) /// public class HardwareType { /// /// 类型 ID (导出时生成,如 type_001) /// public string TypeId { get; set; } = ""; /// /// 几何特征(用于匹配五金件库) /// public GeometrySignature Signature { get; set; } = new(); /// /// 此类型的所有实例(安装位置) /// public List Instances { get; set; } = new(); /// /// 匹配到的五金件库 ID(服务端填充) /// public string? MatchedHardwareId { get; set; } /// /// 主要来源图层名(v2.2 新增) /// public string? PrimaryLayerName { get; set; } /// /// 根据图层名推断的五金件类型(v2.2 新增) /// public string? InferredHardwareType { get; set; } } /// /// 几何特征签名(用于五金件匹配) /// public class GeometrySignature { /// /// 边界框宽度 (mm) - 最大尺寸 /// public double Width { get; set; } /// /// 边界框高度 (mm) - 中间尺寸 /// public double Height { get; set; } /// /// 边界框深度 (mm) - 最小尺寸 /// public double Depth { get; set; } /// /// 体积 (mm³),0 表示未知 /// public double Volume { get; set; } /// /// 图块名(如果是图块引用) /// public string? BlockName { get; set; } } /// /// 五金件实例(单个安装位置) /// public class HardwareInstance { /// /// 安装位置 (mm) /// public Position3D Position { get; set; } = new(); /// /// 旋转角度 (弧度) /// public Rotation3D Rotation { get; set; } = new(); /// /// 缩放比例 /// public Scale3D? Scale { get; set; } /// /// 源图层名 /// public string? SourceLayer { get; set; } /// /// 源实体句柄 /// public string? SourceHandle { get; set; } /// /// 源图块名(如果是图块) /// public string? SourceBlockName { get; set; } // ========== v2.0 新增:关联信息 ========== /// /// 最近的孔位 ID(CAD 层面的初步判断) /// public string? NearestHoleId { get; set; } /// /// 主绑定板件 ID(优先由孔位/孔组反推) /// public string? PrimaryPanelId { get; set; } /// /// 次绑定板件 ID(常见于连接两块板件的五金) /// public string? SecondaryPanelId { get; set; } /// /// 主绑定逻辑孔组 ID(如偏心件孔组、合页孔组) /// public string? BoundHoleGroupId { get; set; } /// /// 当前五金件绑定到的孔位 ID 列表 /// public string[]? BoundHoleIds { get; set; } /// /// 绑定模式: /// - hole_group:按逻辑孔组绑定 /// - hole:按单孔绑定 /// - panel_bbox:按板件包围盒绑定 /// - panel_center:按板件中心邻近绑定 /// - none:未绑定 /// public string? BindingMode { get; set; } /// /// 五金件绑定置信度(0-1) /// public double? BindingConfidence { get; set; } /// /// 绑定原因说明(调试/回放) /// public string? BindingReason { get; set; } /// /// 附近的板材 ID 列表 /// public string[]? NearbyPanelIds { get; set; } /// /// 与最近孔位的距离 (mm) /// public double? DistanceToNearestHole { get; set; } } /// /// 3D 位置 /// public class Position3D { public double X { get; set; } public double Y { get; set; } public double Z { get; set; } } /// /// 3D 旋转 /// public class Rotation3D { public double X { get; set; } public double Y { get; set; } public double Z { get; set; } } /// /// 3D 缩放 /// public class Scale3D { public double X { get; set; } = 1; public double Y { get; set; } = 1; public double Z { get; set; } = 1; } /// /// 图层信息(v2.2 新增) /// public class LayerInfo { /// /// 图层名称 /// public string Name { get; set; } = ""; /// /// 图层分类:panel(板件)| hardware(五金件)| other(其他) /// public string Category { get; set; } = "other"; /// /// 推断的五金件类型(如:hinge, screw, connector 等) /// public string? HardwareType { get; set; } /// /// 该图层上的实体数量 /// public int EntityCount { get; set; } } /// /// 五金件按图层汇总(v2.2 新增) /// public class HardwareLayerSummary { /// /// 图层名称 /// public string LayerName { get; set; } = ""; /// /// 推断的五金件类型 /// public string HardwareType { get; set; } = "unknown"; /// /// 数量 /// public int Count { get; set; } /// /// 该类型的所有实例 ID /// public List InstanceIds { get; set; } = new(); }