ViewDesignEngine/CHANGELOG.md

更新日志

[3.5.0] — 2026-07-24

性能+实战

• 布尔运算缓存加速（mesh_cache + AABB 预检）
• 测量工具：distance / surface_area / volume / centroid
• 实战零件示例：法兰（flange）+ 齿轮（gear）
• 参数特征树：FeatureNode 递归求值 + FeatureHistory undo/redo
• 装配约束：Coincident / Concentric / Tangent / Distance / Parallel / Perpendicular / Angle

[3.4.0] — 2026-07-24

制造就绪

• B-Rep 布尔集成面分割（质量大幅提升）
• CAM 刀具路径：offset_contour + contour_toolpath + pocket_toolpath + G-code 导出
• NURBS 曲面-曲面求交（递归细分 + Newton 精化）

[3.3.0] — 2026-07-24

工业强化

• B-Rep face splitting（split_face_by_plane）
• WebGL 3D 查看器（viewer/index.html，拖放 GLB/STL）
• 教程文档 3 篇（快速开始 / SDF / B-Rep）
• 模糊测试（SDF / Boolean / Format round-trip）
• DEB 打包（packaging/build-deb.sh）

[3.2.0] — 2026-07-24

CI/CD + 3MF + 装配体

• CI/CD 配置（.gitea/workflows/build.yml）
• Python 绑定（pyproject.toml + setup.py）
• 3MF 格式导入/导出（零外部依赖 ZIP 实现）
• B-Rep 装配体树（Assembly + AssemblyNode）
• 性能基准修复 + 基线报告

[3.1.0] — 2026-07-24

文档 + 示例 + NURBS 操作

• Doxygen API 文档（76 头文件，483 页 HTML）
• Gitea Wiki（12 页在线 API 参考）
• Markdown API 参考手册（6942 行）
• 3D 打印示例（08_3d_print）
• B-Rep 制造示例（09_brep_fab）
• Python SDF 优化示例
• NURBS 高级操作（offset / trim / blend / ruled / coons / extrude）
• Marching Cubes SEGFAULT 修复

[3.0.0] — 2026-07-24

全线测试通过（476+ / 476+）

S13 — IGES 导入/导出

• 导入：22 种实体类型（弧、线、B-Spline、圆环、球面等）→ B-Rep
• 导出：B-Rep → 80 列卡片式文件

S12 — 可微分几何

• 自动微分引擎 + 梯度驱动优化 + Torch 桥 + Python API

S11 — SDF 隐式建模

• 15+ 图元 + CSG 树 + SDF→Mesh + Python bindings

全线 bugfix（41→0）

• SDF NaN/边界 + 操作符号 + B-Rep 顶点ID + Parser + 布尔 ON-边界分类

Phase A — GLTF/GLB + 管线示例

[2.0.0] — 2026-07-24

Sprint 10 — B-Rep 完善 + STEP 导入导出 + 工程健壮性

• B-Rep 建模补齐：fillet（恒定半径滚动球倒圆）、chamfer（等距倒角）、shell（抽壳，含侧壁连接面）完整实现
• STEP 导入 (import_step)：ISO 10303-21 解析器，支持 AP203/AP214 标准几何与拓扑实体
• STEP 导出 (export_step)：BrepModel → STEP AP214 字符串/文件，含曲线/曲面类型自动检测
• B-Rep 布尔运算：brep_union / brep_intersection / brep_difference，基于面面求交 + 内/外分类 + 缝合
• B-Rep 验证 (validate)：水密性、悬边、自相交、方向一致性、欧拉示性数检查
• 测试：新增 5 个测试文件（fillet/chamfer/shell、STEP 导入/导出、B-Rep 布尔、B-Rep 验证），共 47 项测试

[1.0.0] — 2026-07-24

首个稳定版本

所有 9 个 Sprint 完成，全部模块实现并通过测试。

指标: 7,800+ 行源码，2,300+ 行头文件，143 测试 100% 通过

M3 性能基准（本轮完成）

• BVH/Delaunay/Curves/Spatial/Boolean 5 套 benchmark 全部通过
• 性能报告: docs/benchmark-report.md

M3 修复（本轮完成）

• Delaunay3D: circumcenter Eigen QR 求解，空外接球验证
• B-Rep: is_valid ID 查找，add_surface/add_edge 返回下标
• BooleanMesh: ray-tri 交点容差 + 面上偏移

[0.9.0] — 2026-07-23

M3 里程碑起步 — 性能基准测试套件

• 新增 bench/ 目录：Google Benchmark 驱动的性能基准测试套件
• bench_bvh：N=1K/10K/100K 随机三角形 SAH 构建 + 1K 射线最近命中查询
• bench_delaunay：N=100/1K/10K 随机点 2D Bowyer-Watson 三角剖分
• bench_boolean：两个球体 (N=100/500 面) 3D union/intersection 运算
• bench_curves：N=10K/100K 次 Bezier/BSpline evaluate 吞吐量
• bench_spatial：N=1K/10K/100K 点 R-Tree STR 构建 + KD-Tree 构建；kNN(n=10) 查询
• 构建集成：BUILD_BENCHMARKS 选项 (默认 OFF)，Google Benchmark 通过 FetchContent 自动下载
• CTest 集成：ctest -R bench_ 一键运行全部基准

Sprint 9 — 3D Delaunay/B-Rep/Boolean 测试补全

• 测试新增：test_delaunay_3d（6 个用例）、test_boolean_mesh（22 个用例）、test_brep（17 个用例）
• 3D Delaunay 测试：空输入、正四面体、Delaunay 空外接球性质验证、退化点（共面/共线）
• 3D 网格布尔测试：相交/不相交/包含场景的 union/intersection/difference/sym_diff、空网格边界、点分类、invert/merge 辅助函数
• B-Rep 测试：make_box/make_sphere/make_cylinder 实体创建、拓扑查询（face_edges/edge_faces/vertex_edges）、to_mesh 离散化、有效性验证、空模型边缘情况
• 构建更新：tests/CMakeLists.txt 添加 brep 子目录，mesh/boolean CMakeLists 添加新测试
• 文档更新：开发计划 S9 状态更新为进行中

[0.8.0] — 2026-07-23

Sprint 8 收尾 — spatial + mesh

• KD-Tree 完善：priority-queue kNN、ray query、remove 支持
• Octree 完善：ray query 补充
• mesh_simplify：QEM 简化实现验证

[0.7.0] — 2026-07-23

模块补全

• 3D 网格布尔运算：mesh_union/intersection/difference/sym_diff + BVH 射线投射
• 网格平滑扩展：HC Laplacian（体积保持）、双边滤波（特征保留）
• 网格质量评估：三角形/四面体质量、质量报告（A-F 分级）
• R-Tree 完整实现：STR bulk-loading、分层查询、kNN priority-queue
• 碰撞检测扩展：ray-aabb/sphere/mesh/plane、tri-tri 交线
• 曲线曲面补全：Bezier/BSpline 解析导数、自适应细分
• core 补全：distance（6 种扩展）、polygon（三角剖分、凸包、简化）
• foundation 补全：OBJ 纹理坐标、STL ASCII/Binary 双格式

测试覆盖扩展

• 新增 7 个测试文件：polygon、distance、r_tree、ray、quality、smooth
• 测试从 11 文件/25 用例 → 17 文件/92 用例（100% 通过）

修复

• exact_predicates 匿名 namespace 泄漏
• RTree insert/remove 自赋值 bug
• mesh_quality 纵横比公式归一化

文档

• 开发计划 S8 状态更新

[0.1.0] — 2026-07-23

新增

• 基础设施层（foundation）：数学类型、公差系统、精确谓词、OBJ/STL 读写
• 几何核心层（core）：点、线、面、三角形、AABB、几何变换、距离计算、凸包
• 曲线曲面层（curves）：Bezier/B-Spline/NURBS 曲线与曲面、离散化
• 网格处理层（mesh）：半边数据结构、Delaunay 2D 三角剖分
• 空间索引层（spatial）：BVH（SAH 构建）
• 碰撞检测层（collision）：GJK 算法、Möller-Trumbore 射线-三角形相交
• 布尔运算层（boolean）：2D 多边形 Sutherland-Hodgman 裁剪
• 构建系统：CMake + FetchContent（Eigen, GTest 自动下载）
• 测试框架：Google Test，11 个测试文件
• 示例程序：6 个可运行示例

v0.8.0 时已全部完成 ✅

（以下为初始规划时的待完成清单，现已全部实现）

• 网格简化（QEM） ✅
• 网格平滑（Laplacian/Taubin/HC/Bilateral） ✅
• 3D 网格布尔运算 ✅
• Octree、KD-Tree、R-Tree 完整实现 ✅
• 3D Delaunay 剖分 ✅
• B-Rep 支持 ✅
• Python 绑定 ✅