茂之钳
93ca49cb4f
VDE-028 (step_export.cpp): - Remove unused - Fix 4x misleading-indentation in write_bspline_surface loops VDE-029 (class_a_surfacing.cpp): - Initialize Vector3D move = Vector3D::Zero() (2 occurrences) VDE-030 (industrial_formats.cpp): - Remove unused brep_version read, fix pos_ offset - Fix misleading-indentation: split one-liner if-statements All 30 VDE issues now resolved (30/30).
179 lines
11 KiB
Markdown
179 lines
11 KiB
Markdown
---
|
||
id: OVERVIEW
|
||
status: resolved
|
||
severity: medium
|
||
category: analysis
|
||
date: 2026-07-27
|
||
updated: 2026-07-28 (Batch 11: VDE-028~030 编译警告已修复 — 全部 30 个 VDE Issue 已解决)
|
||
reporter: ViewDesign
|
||
---
|
||
|
||
# ViewDesignEngine 集成综合评估
|
||
|
||
> 基于 VDE v1.0.1+ 在 ViewDesign 工程中的集成经验，从多个维度评估 VDE 的优势与不足。
|
||
|
||
## 最新集成状态 (2026-07-28)
|
||
|
||
### 本次新增集成模块
|
||
|
||
| 模块 | 内容 | 状态 |
|
||
|------|------|:--:|
|
||
| vd_vis_visualize | Shape-based BVH构建 + 射线追踪 + AABB计算 | ✅ 已构建 |
|
||
| vd_core_snap | Shape顶点提取端点捕捉 + 最近点捕捉 + 质心计算 | ✅ 已构建 |
|
||
| vd_core_coordsys | Shape主轴对齐UCS创建 + 主惯性轴计算 | ✅ 已构建 |
|
||
| vd_core_xr | VR Shape射线求交 + AABB空间布局 + 抓取锚点 | ✅ 已构建 |
|
||
| vd_vis_composer | Shape驱动爆炸方向+距离自动生成 + 多Shape联合包围盒 | ✅ 已构建 |
|
||
| vd_block | Shape-based块定义+插入 + 质心/包围盒自动提取 | ✅ 已构建 |
|
||
| vd_vis_edrawings | Shape网格数据导入eDrawings + LOD统计估算 | ✅ 已构建 |
|
||
| vd_industry_elec | Shape电气几何分析: 组件包围盒+布线估算+体积计算 | ✅ 已构建 |
|
||
| vd_web_viewer | Shape-to-web模型注册 + 网格统计 + 场景网格生成 | ✅ 已构建 |
|
||
| vd_vis_xr | Shape导出XR格式 + 预导出验证 + LOD场景信息计算 | ✅ 已构建 |
|
||
| vd_render | Shape包围盒渲染 + 三角面片化 + 相机Shape适配 | ✅ 已构建 |
|
||
| vd_mobile_viewer | Shape导入+相机自适应 + 性能预估 + AABB适配 | ✅ 已构建 |
|
||
| vd_standards | Shape GD&T验证 + 公差表合规 + 标准等级推荐 | ✅ 已构建 |
|
||
| vd_pdm | Shape入库验证 + BOM几何属性填充 + 文件统计 | ✅ 已构建 |
|
||
| vd_surfacing | Shape-based曲面分析: surfaceToShape + 曲率+拔模+面积+Class-A | ✅ 已构建 |
|
||
| vd_ai_mfg (process_planner) | Shape机床选型 + 毛坯尺寸估算 + 装夹规划 + 加工时间预估 | ✅ 已构建 |
|
||
| vd_ai_mfg (quality_predictor) | Shape质量预测 + 几何复杂度评估 + 网格质量评分 | ✅ 已构建 |
|
||
| vd_ai_vision (weld_detector) | Shape焊缝缺陷检测 + 焊道剖面提取 + 焊缝体积计算 + AWS D1.1验证 | ✅ 已构建 |
|
||
| vd_ai_generative (image_to_3d) | Shape mesh双向转换: meshToShape + shapeToMesh + 几何分析 | ✅ 已构建 |
|
||
| vd_ai_generative (lattice_generator) | 点阵→Shape自动转换 + 体积计算 + 过悬垂检测 | ✅ 已构建 |
|
||
| vd_ai_generative (text_to_3d) | CSG树→Shape评估: 基本体映射 + 布尔融合/切割/求交 | ✅ 已构建 |
|
||
| vd_render (viewport) | Shape加载渲染: loadShape + 相机自动适配 + 实时更新 | ✅ 已构建 |
|
||
| vd_script_python (python_bridge) | Shape Python API: registerShapeModule + shapeToJson + executeShapeScript | ✅ 已构建 |
|
||
| vd_ai_multimodal (multimodal_manager) | 手势→Shape转换: gestureToShape + gesturePathToShape + recognizeDrawingGesture | ✅ 已构建 |
|
||
| vd_ai_collab (design_reviewer) | Shape对比审查: compareShapeGeometry + computeShapeReviewScore + detectShapeChange | ✅ 已构建 |
|
||
| vd_core_selfilter (selection_filter) | 几何筛选: 体积/面积/包围盒范围过滤 + passesGeometryFilter + passesFilter | ✅ 已构建 |
|
||
| vd_core_reporting (report_manager) | Shape自动报告: geometrySection + geometrySnapshot + quickGeometryReport | ✅ 已构建 |
|
||
| vd_script_autolisp (autolisp_interpreter) | AutoLISP Shape内置函数: shape-create + shape-volume + shape-area + evalToShapeJson | ✅ 已构建 |
|
||
| vd_core_clipboard (clipboard_manager) | Shape复制粘贴: copyShape + pasteShape + shapeToClipJson + shapeFromClipJson | ✅ 已构建 |
|
||
| vd_project_manager (project_manager) | 项目几何验证: validateProjectGeometries + computeProjectBoundingBox + computeGeometryStats | ✅ 已构建 |
|
||
| vd_core_views (view_manager) | 相机几何: cameraToViewMatrix + computePickRay + isShapeVisible + shapeScreenCoverage | ✅ 已构建 |
|
||
| vd_core_xref (xref_manager) | 参照变换: xrefTransformMatrix + computeXrefBoundingBox + transformShapeByXref | ✅ 已构建 |
|
||
| vd_core_groups (group_manager) | 组几何: computeGroupBoundingBox + computeGroupVolume + computeGroupSurfaceArea + countIntersectingShapes | ✅ 已构建 |
|
||
| vd_core_hatch (hatch_manager) | 填充几何: estimateHatchLineCount + hatchDensity + recommendPattern | ✅ 已构建 |
|
||
| vd_core_enttemplate (entity_template_manager) | 模板验证: validateTemplateForShape + recommendLineweight | ✅ 已构建 |
|
||
| vd_core_selsets (selection_set_manager) | 选择集空间查询: computeSetBoundingBox + computeSetGeometryStats + filterBySpatialRegion | ✅ 已构建 |
|
||
| vd_core_linetypes (linetype_manager) | 线型几何分析: recommendLTScale + estimatePatternRepeats | ✅ 已构建 |
|
||
| vd_core_styles (style_manager) | 样式几何匹配: recommendTextHeight + recommendArrowSize + estimateTextCapacity | ✅ 已构建 |
|
||
| vd_core_units (unit_manager) | 单位几何转换: shapeLength + shapeVolume + shapeArea | ✅ 已构建 |
|
||
| vd_core_undo (undo_manager) | 几何快照估算: estimateShapeSnapshotSize + estimateMaxShapeOperations | ✅ 已构建 |
|
||
| vd_core_annotscale (annotation_scale_manager) | 注释比例匹配: recommendScaleForShape + estimateViewportScale | ✅ 已构建 |
|
||
|
||
### Batch 11: vd_geom 核心能力扩展 (2026-07-28)
|
||
|
||
| 能力 | API | 底层 VDE 接口 | 状态 |
|
||
|------|-----|-------------|:--:|
|
||
| 特征识别 | recognizeFeatures | vde::brep::recognize_features | ✅ 已构建 |
|
||
| 去特征化 | defeature / removeHoles / removeFillets / simplifyForMeshing | vde::brep::defeature / remove_holes / remove_fillets / simplify_for_meshing | ✅ 已构建 |
|
||
| 直接建模 | tweakFace / pushPull / offsetFace / scaleBody / mirrorBody / draftFace | vde::brep::tweak_face / push_pull / offset_face / scale_body / mirror_body / draft_face | ✅ 已构建 |
|
||
| 高级过渡曲面 | variableRadiusBlend / multiFaceBlend / rollingBallBlend | vde::brep::variable_radius_blend / multi_face_blend / rolling_ball_blend | ✅ 已构建 |
|
||
|
||
### 反馈闭环验证
|
||
|
||
VDE-001~030 全部 Fixed。v1.0.1 更新修复了 make_box/cylinder/sphere 位置偏移、make_cone/torus、mesh→profile、edge/face ID 一致性、contour 提取、Assembly 批量构建、BVH 索引查询。VDE-028~030 编译代码整洁度警告（step_export / class_a_surfacing / industrial_formats）已修复。良性迭代机制运转良好。
|
||
|
||
### 累计集成模块: 83 个 ViewDesign 模块已通过 vd_geom 间接使用 VDE
|
||
|
||
核心几何功能（布尔运算/测量/验证/干涉/GD&T等）→ vd_geom 统一抽象层 → 全 ViewDesign 模块共享
|
||
|
||
## v1.0.1+ 更新总结
|
||
|
||
VDE 团队快速响应了反馈，v1.0.1+ 更新修复了 7 个问题，引入了 3 个新问题。
|
||
|
||
### 已修复（7 个）
|
||
|
||
| 问题 | 内容 | 状态 |
|
||
|------|------|:--:|
|
||
| VDE-001/005/010 | 两阶段名称查找 | 大部分 brep 文件已修复 |
|
||
| VDE-002 | 子模块 include 路径 | 改用 CMAKE_CURRENT_SOURCE_DIR |
|
||
| VDE-006 | vde_mesh↔vde_brep 循环依赖 | 已解除 |
|
||
| VDE-009 | 缺少 C API 文档 | 新增 basic_usage.cpp |
|
||
| VDE-011 | write_stl 返回 void | 改为 bool |
|
||
| VDE-012 | double/float 精度 | 新增 StlTrianglef |
|
||
|
||
### 新增（3 个）— 全部已修复
|
||
|
||
| 问题 | 内容 | 状态 |
|
||
|------|------|:--:|
|
||
| VDE-014 | write_stl 新旧声明并存 | 已修复 (v1.0.2) |
|
||
| VDE-015 | Vector3F/Point3F 拼写错误 | 已修复 (v1.0.2) |
|
||
| VDE-016 | ssi_boolean.cpp 两阶段查找修正不完整 | 已修复 (v1.0.2) |
|
||
| VDE-017 | configure_file CMAKE_SOURCE_DIR | 已修复 (v1.0.2) |
|
||
|
||
### v1.0.3 修复（1 个）
|
||
|
||
| 问题 | 内容 | 状态 |
|
||
|------|------|:--:|
|
||
| VDE-027 | face_centroid 作用域错误 | 已修复 (v1.0.3) |
|
||
|
||
### 待修复（0 个）— 全部已修复
|
||
|
||
| 问题 | 内容 | 严重度 | 状态 |
|
||
|------|------|:--:|:--:|
|
||
| VDE-028 | step_export.cpp 误导缩进 + 未使用变量 | Low | Fixed |
|
||
| VDE-029 | class_a_surfacing.cpp Vector3D move 可能未初始化 | Low | Fixed |
|
||
| VDE-030 | industrial_formats.cpp 误导缩进 + 未使用变量 | Low | Fixed |
|
||
|
||
### 当前可用模块（10/10）
|
||
|
||
```
|
||
vde_foundation ✓ vde_core ✓
|
||
vde_curves ✓ vde_spatial ✓
|
||
vde_collision ✓ vde_sketch ✓
|
||
vde_brep ✓ vde_mesh ✓
|
||
vde_boolean ✓ vde_sdf ✓
|
||
vde_capi ✓
|
||
```
|
||
|
||
### VDE-019~026 全部已修复（v1.0.1+）
|
||
|
||
| 问题 | 内容 | 严重度 | 修复版本 |
|
||
|------|------|:--:|:--:|
|
||
| VDE-019 | make_box/cylinder/sphere 不支持位置偏移 | Medium | v1.0.1 — 添加 center 参数 |
|
||
| VDE-020 | 缺少 make_cone 和 make_torus | Medium | v1.0.1 — 新增基本体 |
|
||
| VDE-021 | 缺少 mesh→profile 曲线提取 API | High | v1.0.1 — mesh_boundary_to_curve + mesh 扫掠重载 |
|
||
| VDE-022 | BrepModel↔mesh 往返丢失 edge/face ID | High | v1.0.1 — brep_position.h 位置查询 API |
|
||
| VDE-023 | Assembly 约束 ID 失配 | High | v1.0.1 — VDE-022 位置 API 解决 ID 映射 |
|
||
| VDE-024 | 缺少 mesh contour 提取 API（CAM） | High | v1.0.1 — cam_mesh.h mesh contour 提取 |
|
||
| VDE-025 | 缺少 MeshData→Assembly 批量构建 API | Medium | v1.0.1 — build_assembly_from_meshes |
|
||
| VDE-026 | BVH query 不返回三角形索引 | Medium | v1.0.3 — HitResult 添加 tri_index |
|
||
|
||
### P0 已全部解决
|
||
|
||
所有 P0 阻塞问题（VDE-001/002/005/010/013/016/017/018/027）已解决。VDE 全部 10 个模块在 GCC 下可构建。
|
||
|
||
### 后续重点关注
|
||
|
||
1. ~~VDE-028~030：编译时代码整洁度警告~~ — ✅ 已全部修复
|
||
2. 在 ViewDesign 端进行回归测试，验证 Batch 11 新增的 VDE 核心能力（特征识别、去特征化、直接建模、高级过渡曲面）
|
||
3. 持续监控 ViewDesign 构建集成，确保无新增编译错误
|
||
4. 下一批目标：vd_drawing、vd_core_layers、vd_core_smart_fasteners、vd_industry_mep 等 50+ 个未集成模块
|
||
|
||
---
|
||
|
||
## VDE vs OCCT 对比
|
||
|
||
| 维度 | OCCT | VDE | 结论 |
|
||
|------|------|-----|------|
|
||
| 代码体积 | ~1GB+，构建 30min+ | 轻量，构建秒级 | VDE 胜 |
|
||
| 数学库 | 自研 gp_*，API 陈旧 | Eigen3，现代 C++ | VDE 胜 |
|
||
| API 风格 | 重型，Handle<> 到处飞 | 简洁值语义 | VDE 胜 |
|
||
| B-rep | 完整、成熟 | 全部可用，细粒度 API 待完善 | OCCT 胜 |
|
||
| STL I/O | 无便捷函数 | read_stl() / write_stl() | VDE 胜 |
|
||
| 跨平台 | 全通过 | 10/10 模块可用（GCC） | 持平 |
|
||
| 文档 | 丰富 | 正在改善（basic_usage.cpp） | OCCT 胜 |
|
||
| 许可证 | LGPL-like，商用需谨慎 | AGPL v3 | VDE 胜 |
|
||
| 集成门槛 | 需要 SDK 安装 | submodule + Eigen3 | VDE 胜 |
|
||
|
||
## ViewDesign 的战略路径
|
||
|
||
```
|
||
当前: 30/30 问题已修复 / 10/10 模块可用 / 全面 VDE
|
||
近期: 在 ViewDesign 中验证 VDE-019~026 修复效果
|
||
远期: 全面 VDE / OCCT 逐步移除
|
||
```
|
||
|
||
---
|
||
*此文件由 ViewDesign 工程生成，提供 VDE 集成体验的宏观评估。*
|