Files
ViewDesignEngine/docs/feedback/00-overview.md
T
hm 41d33bbbc2
CI / Build & Test (push) Failing after 16m55s
CI / Release Build (push) Failing after 33s
Build & Test / build-and-test (push) Has been cancelled
Build & Test / python-bindings (push) Has been cancelled
docs: add VDE-014/015/016 + update overview (7 fixed, 3 new, 1 P0 remaining)
2026-07-27 23:12:30 +08:00

81 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: OVERVIEW
status: open
severity: medium
category: analysis
date: 2026-07-27
updated: 2026-07-27
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 新旧声明并存 | open |
| VDE-015 | Vector3F/Point3F 拼写错误 | open |
| VDE-016 | ssi_boolean.cpp 两阶段查找修正不完整 | open |
### 当前可用模块(6/9
```
vde_foundation ✓ vde_core ✓
vde_curves ✓ vde_spatial ✓
vde_collision ✓ vde_sketch ✓
vde_brep ✗ vde_mesh ✗
vde_boolean ✗ vde_sdf ✗
vde_capi ✗
```
### P0 剩余(1 个)
| 优先级 | 问题 | 影响 |
|:--:|------|------|
| P0 | VDE-016: ssi_boolean.cpp 两阶段查找残余 | vde_brep 仍然不可用 |
---
## VDE vs OCCT 对比
| 维度 | OCCT | VDE | 结论 |
|------|------|-----|------|
| 代码体积 | ~1GB+,构建 30min+ | 轻量,构建秒级 | VDE 胜 |
| 数学库 | 自研 gp_*API 陈旧 | Eigen3,现代 C++ | VDE 胜 |
| API 风格 | 重型,Handle<> 到处飞 | 简洁值语义 | VDE 胜 |
| B-rep | 完整、成熟 | brep 仅 1 个文件编译不过 | OCCT 胜(差距缩小) |
| STL I/O | 无便捷函数 | read_stl() / write_stl() | VDE 胜 |
| 跨平台 | 全通过 | 6/9 模块可用(GCC) | OCCT 胜(差距缩小) |
| 文档 | 丰富 | 正在改善(basic_usage.cpp | OCCT 胜 |
| 许可证 | LGPL-like,商用需谨慎 | AGPL v3 | VDE 胜 |
| 集成门槛 | 需要 SDK 安装 | submodule + Eigen3 | VDE 胜 |
## ViewDesign 的战略路径
```
当前: 6/9 模块可用 / vd_geom 网格路径→VDE / B-rep→OCCT 兜底
P0后: 9/9 模块可用 / B-rep→VDE / OCCT 降级为可选
远期: 全面 VDE / OCCT 移除
```
---
*此文件由 ViewDesign 工程生成,提供 VDE 集成体验的宏观评估。*