Files
SPHLite/docs/09_release_history.md
T
2026-07-02 21:44:57 +08:00

110 lines
4.3 KiB
Markdown

# 09 版本历史与验收记录
文档状态:0.2.0 本地验收通过
## 1. 当前状态
SPHLite 当前完成 0.2.0 `Water` 基础 SPH 最小闭环版本的本地验收。该版本交付 3D 水相弱可压 SPH 的最小可测试计算路径;`Gas`、`Explosive`、`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。
## 2. 规划版本线
| 版本线 | 目标 |
|---|---|
| 0.1.0 | 工程骨架、生命周期、错误码、C ABI、CLI、Python 调试入口和测试框架 |
| 0.1.1 | 输入元数据、粒子状态查询、C++ wrapper、CLI/output/restart/CouplingInterface gate 加固 |
| 0.2 | 粒子状态、核函数、邻域搜索和基础 `Water` |
| 0.3 | `Gas`、基础 EOS、气体统计和气泡诊断 |
| 0.4 | `Explosive`、解析点火、爆轰传播和产物气体注入 |
| 0.5 | 3D `Solid` 弹塑性、损伤和基础破裂 |
| 0.6 | `Shell` 板壳变形、损伤和撕裂 |
| 0.7 | 水-气-结构局部爆炸 smoke |
| 0.8 | SPH-FEM 接触耦合 |
| 0.9 | SPH-FEM 连续体耦合 |
| 1.0 | 船舱局部破坏综合 benchmark |
## 3. 验收记录
### 0.1.0 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix --parallel
```
验收结果:
- `sphlite_core`、`sphlite_c` 和 `sphlite` 完整编译通过。
- `ctest -R "^(smoke|input|c_api|python_debug)$"` 通过,4/4。
- `ctest -R "^source_size$"` 通过,1/1。
- `git diff --check` 通过。
- CLI inspect 模式通过:`sphlite tests/data/minimal_particles.inp`。
- CLI run 模式通过:`sphlite tests/data/minimal_particles.inp --run`。
- 已通过 `.gitignore` 排除 build 目录、CSV/VTK/restart 临时结果和 Python 缓存。
- 文档已明确 0.1.0 不交付生产级 Water、Gas、Explosive、Solid、Shell 物理算法。
说明:0.1.0 已提交并推送到远端,标签为 `v0.1.0`。
### 0.1.1 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix --parallel
```
验收结果:
- `sphlite_core`、`sphlite_c`、`sphlite` 和 `test_cpp_api` 完整编译通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过,10/10。
- `source_size` 通过。
- `git diff --check` 通过。
- CLI `--version`、inspect、`--check`、`--run` 和错误输入路径通过。
- output、restart 和 CouplingInterface 占位测试通过。
- 文档已明确 0.1.1 不交付生产级 Water、Gas、Explosive、Solid、Shell 物理算法。
### 0.2.0 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
构建配置:
```powershell
cmake -S . -B build-codex-unix -G "Unix Makefiles" -DCMAKE_C_COMPILER=C:/gcc-16.1.0-64/bin/gcc.exe -DCMAKE_CXX_COMPILER=C:/gcc-16.1.0-64/bin/g++.exe -DCMAKE_Fortran_COMPILER=C:/gcc-16.1.0-64/bin/gfortran.exe -DCMAKE_MAKE_PROGRAM=C:/gcc-16.1.0-64/bin/make.exe
cmake --build build-codex-unix
```
验收结果:
- `sphlite_core`、`sphlite_c`、`sphlite_c_shared`、`sphlite` 和新增测试目标完整编译通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过,18/18。
- `source_size` 通过。
- `git diff --check` 通过。
- `Water` 基础弱可压 SPH 路径通过 kernel、neighbor、EOS、连续性方程、人工黏性、压力力、显式推进、output、restart、pressure wave smoke、C ABI、C++、Python 和 CLI gate。
- 0.2.0 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.0 不交付真实 FEM-SPH 联合运行;CouplingInterface 仅提供中立数据导出、外部粒子力导入和诊断占位。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
## 4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。