ViewDesignEngine/docs/12-v3.3-开发计划.md

ViewDesignEngine v3.3 工业级强化计划

制定: 2026-07-24 | 状态: 执行中

---

1. 🎯 B-Rep 面分割（Face Splitting）

当前布尔运算用 centroid 射线法分类，精度差。需要真正的面-面求交分割。

• 实现 split_face_by_plane(face, plane) — 平面分割单个面
• 实现 split_face_by_face(face_a, face_b) — 两个曲面求交分割
• 集成到 brep_boolean.cpp 替换 centroid 分类
• Validity 测试：分割后的面子集构成合法壳

2. 📐 NURBS 曲面求交

核心工业几何算法。B-Rep 布尔依赖此。

• 实现 intersect_surfaces(surf_a, surf_b) → 交线曲线列表
• 算法：递归细分 + bounding box 剔除 + 牛顿精化
• 支持平面-曲面、曲面-曲面的交线计算
• 测试：平面交平面、平面交圆柱、圆柱交球

3. 🖥️ WebGL 查看器

在线预览 GLB/STL，嵌入 Gitea Wiki。

• 创建 viewer/ 目录，含 Three.js 单页应用
• 拖拽上传 GLB/STL 文件，Three.js 渲染
• 嵌入到 Wiki Home 页
• 支持旋转、缩放、线框/实体切换

4. 📦 Linux 包

降低安装门槛。

• 创建 packaging/DEBIAN/ 目录
• control + rules + cmake 安装
• make deb 目标
• 测试 apt install ./vde-3.3.0.deb

5. 📖 教程文档

从零开始的实用指南。

• docs/tutorial/01-quickstart.md — 5 分钟上手
• docs/tutorial/02-sdf-modeling.md — SDF 隐式建模
• docs/tutorial/03-brep-modeling.md — B-Rep 工业建模
• docs/tutorial/04-export.md — STEP/STL/GLB 导出

6. 🧪 模糊测试

随机几何输入 + 断言，发现隐蔽 bug。

• tests/fuzz/fuzz_boolean.cpp — 随机 B-Rep 布尔
• tests/fuzz/fuzz_sdf.cpp — 随机 SDF 参数
• tests/fuzz/fuzz_iges.cpp — 随机 IGES round-trip
• CI 集成：每次 push 跑 100 轮模糊测试