茂之钳
174 lines
7.4 KiB
Markdown
174 lines
7.4 KiB
Markdown
# 更新日志
|
||
|
||
## [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 绑定 ✅
|