Files
FemLite/docs/09_release_history.md
T
shenw 3d009d021e
FemLite CI / build-test (push) Has been cancelled
Release FemLite 0.6.3
2026-07-02 12:40:31 +08:00

91 lines
4.0 KiB
Markdown

# 09 版本历史与验收记录
文档状态:0.6.3 版整理稿
## 1. 版本线摘要
| 版本线 | 重点 |
|---|---|
| V1 | 基础显式动力学、基本单元、CSV 输出和最小可运行流程 |
| V2 | VTK、restart、C ABI/Python 调试入口等接口扩展 |
| V3 | 线性/非线性静力、隐式 Newmark、壳/实体静力基准 |
| V4 | 接触、mortar/AL、摩擦、诊断和 OpenMP 接触性能 smoke |
| V5 | Mohr-Coulomb、strength reduction、屈曲、滚压、cohesive、颗粒 benchmark |
| 0.5.3 | 非线性/contact 诊断硬化 |
| 0.6.0 | nonlinear lifecycle 和 rollback audit 基础设施 |
| 0.6.1 | lifecycle/contact/path 诊断继续硬化 |
| 0.6.2 | 稳定性发布,不新增算法 |
| 0.6.3 | 元素基础设施:`S4R`、受控 `C3D8R`、积分规则库、元素 introspection API |
## 2. 0.6.3 验收记录
0.6.3 已完成:
- Abaqus 风格单元名称 canonicalization。
- `S4R` 拓扑、数据库识别、小应变 reduced integration 路径。
- `S4R` 紧凑 hourglass 稳定性覆盖。
- `C3D8R` 拓扑、数据库识别、1 点积分、刚度/内力/质量/VTK 路径和紧凑 hourglass 稳定性覆盖。
- Gauss-Lobatto 和闭型 Newton-Cotes 四边形/六面体张量积规则。
- Fortran/C 元素 introspection API。
- 文档边界整理。
本地验收命令:
```powershell
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(smoke|element_infrastructure|database_topology|element_stiffness|shell_internal|c_api)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^source_size$" --output-on-failure
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
git diff --check
```
结果:
- 完整编译通过。
- 0.6.3 聚焦回归 6/6 通过。
- `source_size` 1/1 通过。
- examples 精简后,`v5_acceptance` 34/34 通过。
- `git diff --check` 通过。
## 3. 0.6.2 验收摘要
0.6.2 是稳定性发布,重点是 CSV schema、restart 诊断、contact/solver report、INP 错误边界和 CLI 输出目录边界。最终本地 gate 通过:
- 完整编译。
- `source_size`。
- 稳定性聚焦回归。
- `v5_acceptance`。
- version smoke。
- `git diff --check`。
## 4. 0.6.0-0.6.1 验收摘要
0.6.0 引入 nonlinear lifecycle 和 rollback audit。0.6.1 在此基础上扩展 cutback taxonomy、`nonlinear_lifecycle.csv`、contact state counters、Riks/arc path 指标和线性求解器诊断字段。
这些版本不声明完整工业级 AL/mortar 一致切线、mixed-control continuation、cohesive 主线接触或 DEM/FEM 子循环。
## 5. V5 验收摘要
V5 的长期验收入口保留为 `v5_acceptance` 标签。当前 examples 已精简,部分高难度历史示例不再作为当前示例交付项。
V5 当前文档口径主要覆盖:
- Mohr-Coulomb 材料点、driver 和强度折减模块测试。
- 小规模 buckling 模块和 CLI 子集。
- cohesive compact 模块测试。
- particle acceptance 和颗粒耦合模块测试。
- two-block、large-sliding、shell-shell、shell-solid 接触 benchmark。
已从当前 examples 中移除的历史难例包括:`strengthReduction`、`mohr_coulomb_yield_surface`、`ball_adhesion_decohesion`、`Dynamic_Grain_Packing_of_a_Flexible_Container`、`buckling_corrugated_shell`、`roll_forming`、`two_arches`、`block_on_arch`、`blasting_rock`、`failure_prediction_in_a_layered_shell`、`golfBallImpact`、`nonlinear_harmonic`、`stress_dependent_elasticity`、`cylinder_roller_contact`、`euler_column_buckling`、`membrane_airbag_inflation`、`pinched_hemispherical_shell`、`spherical_cap_with_central_point_load`。这些内容若后续恢复,应重新建立输入、checker 和 release gate。
## 6. 历史文件合并说明
以下旧文件内容已合并进本文档、`10_development_roadmap.md` 或 `11_benchmark_matrix.md`,因此不再单独维护:
- `v*_development_plan.md`
- `v*_acceptance_report.md`
- `v*_benchmark_matrix.md`
- `suggests.md`
后续新增版本也应追加到本文件和对应矩阵,不再创建碎片化历史文档。