---
id: OVERVIEW
status: resolved
severity: medium
category: analysis
date: 2026-07-27
updated: 2026-07-28
reporter: ViewDesign
---

# ViewDesignEngine 集成综合评估

> 基于 VDE v1.0.1+ 在 ViewDesign 工程中的集成经验，从多个维度评估 VDE 的优势与不足。

## 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 下可构建。

### 后续重点关注

所有已知问题已全部修复。后续关注：
1. 在 ViewDesign 端进行回归测试，验证 VDE-019~026 的全部修复
2. 持续监控 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 集成体验的宏观评估。*