Files
SPHLite/docs/09_release_history.md
T
2026-07-03 08:45:16 +08:00

174 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 09 版本历史与验收记录
文档状态:0.2.2 开发中
## 1. 当前状态
SPHLite 当前进入 0.2.2 `Water` 基础 SPH 稳定化补丁版本。本版本在 0.2.1 加固基线基础上复核版本发布、输入解析、状态一致性、Water 算法边界、output、restart、API/CLI、CouplingInterface 中立边界和 release gate;`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 仅提供中立数据导出、外部粒子力导入和诊断占位。
### 0.2.1 本地验收记录
记录日期:2026-07-02
本地构建目录:`build-codex-unix`
验收结果:
- `ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$"` 通过,17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$"` 通过,1/1。
- `git diff --check` 通过。
- 0.2.1 交付范围限定为 `Water` 基础路径加固、接口错误路径加固、restart/output 加固和小型 smoke/checker 加固。
- 0.2.1 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.1 不交付真实 FEM-SPH 联合运行;CouplingInterface 仍为中立 Fortran 模块级占位,不暴露 C ABI coupling 接口。
- restart 文件继续写入 `STATE_0_2` 状态版本,并在 0.2.1 gate 中验证 current time、current step、Water 参数、诊断、粒子状态和邻域重建。
- 0.2.1 `Water` 生产 EOS 只接受 `TYPE=TAIT`;非 `TYPE=TAIT` 作为无法运行的输入错误处理。
- 0.2.1 保留 Tait EOS 在 `rho < rho0` 时得到的拉伸负压,不做压力截断或空化修正。
- 0.2.1 不新增 VTK 输出;默认 gate 继续使用 CSV 粒子输出和 summary CSV。
### 0.2.2 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
开发起点:`f8c1c9f Finalize 0.2.1 gate records`
版本定位:
- 0.2.2 是 0.2 `Water` 阶段后的稳定化补丁版本。
- 0.2.2 复核并保持 0.2.1 的 Water 计算行为、接口边界和默认 gate。
- 0.2.2 不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.2 不交付真实 FEM-SPH 联合运行;CouplingInterface 仍为中立 Fortran 模块级占位,不暴露 C ABI coupling 接口。
- 0.2.2 不新增几何、网格或粒子生成能力。
- 0.2.2 release gate 已通过:默认 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过。
验收结果:
- `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` 通过。
- `ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$" --output-on-failure` 通过:17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
实际修复和整理:
- 软件版本、CMake 项目版本、CLI/API 测试期望统一更新为 0.2.2。
- README、09 和 11 号文档记录 0.2.2 稳定化补丁定位。
- 04 号算法文档明确 0.2.2 继续沿用 0.2.1 的 Water 连续性方程、Tait EOS、负压保留和无空化修正策略。
- CouplingInterface 中陈旧的 0.1.1 占位错误信息改为中立表述。
- 新增 `docs/v3.0_gas_handoff.md`,作为 0.3.0 Gas 输入、状态、EOS 测试命名和 Bubble 长期路线入口。
剩余风险和限制:
- 0.2.2 仍不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。
- 0.2.2 仍不交付真实 FEM-SPH 联合运行。
- CouplingInterface 仍不暴露 C ABI coupling 接口。
- VTK 输出仍不进入默认 gate;0.2.2 默认输出为 CSV 和 summary CSV。
- pressure wave smoke 仍只用于小规模链路检查,不作为工程精度 benchmark。
发布建议:
- 建议发布 0.2.2 作为 Water 阶段稳定化补丁版本。
- 0.2.2 发布后,后续主线建议进入 0.3.0 Gas 开发。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
## 4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。