8.7 KiB
8.7 KiB
id: OVERVIEW status: resolved severity: medium category: analysis date: 2026-07-27 updated: 2026-07-28 (Batch 8: vd_core_views + vd_core_xref + vd_core_groups) 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 | ✅ 已构建 |
反馈闭环验证
VDE-019~026 全部 Fixed。v1.0.1 更新修复了 make_box/cylinder/sphere 位置偏移、make_cone/torus、mesh→profile、edge/face ID 一致性、contour 提取、Assembly 批量构建、BVH 索引查询。良性迭代机制运转良好。
累计集成模块: 78 个 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) |
当前可用模块（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 下可构建。
后续重点关注
所有已知问题已全部修复。后续关注：
- 在 ViewDesign 端进行回归测试，验证 VDE-019~026 的全部修复
- 持续监控 ViewDesign 构建集成，确保无新增编译错误
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 的战略路径
当前: 27/27 问题已修复 / 10/10 模块可用 / 全面 VDE
近期: 在 ViewDesign 中验证 VDE-019~026 修复效果
远期: 全面 VDE / OCCT 逐步移除
此文件由 ViewDesign 工程生成，提供 VDE 集成体验的宏观评估。