ViewDesignEngine/docs/feedback/00-overview.md

id, status, severity, category, date, updated, reporter

id	status	severity	category	date	updated	reporter
OVERVIEW	open	medium	analysis	2026-07-27	2026-07-28	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       ✓

仍存在的 API 缺口和设计问题（VDE-019~026）

问题	内容	严重度
VDE-019	make_box/cylinder/sphere 不支持位置偏移	Medium
VDE-020	缺少 make_cone 和 make_torus	Medium
VDE-021	缺少 mesh→profile 曲线提取 API	High
VDE-022	BrepModel↔mesh 往返丢失 edge/face ID	High
VDE-023	Assembly 约束 ID 失配	High
VDE-024	缺少 mesh contour 提取 API（CAM）	High
VDE-025	缺少 MeshData→Assembly 批量构建 API	Medium
VDE-026	BVH query 不返回三角形索引	Medium

P0 已全部解决

所有 P0 阻塞问题（VDE-001/002/005/010/013/016/017/018/027）已解决。VDE 全部 10 个模块在 GCC 下可构建。

后续重点关注

1. VDE-021: mesh→profile 提取 — 解除 extrude/revolve/sweep/loft 的 VDE 集成阻塞
2. VDE-022: edge/face ID 一致性 — 解除 fillet/chamfer/shell 的 VDE 集成阻塞
3. VDE-024: mesh contour 提取 — 解除 CAM 模块的 VDE 集成阻塞

---

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 的战略路径

当前:  10/10 模块可用 / vd_geom 网格路径→VDE / B-rep→OCCT 兜底
近期:  修复 VDE-021~024 → 全面启用建模(CAD)+加工(CAM)
远期:  全面 VDE / OCCT 移除

---

此文件由 ViewDesign 工程生成，提供 VDE 集成体验的宏观评估。