Files
SPHLite/docs/09_release_history.md
T
2026-07-03 23:52:46 +08:00

546 lines
27 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.6.1 发布记录
## 1. 当前状态
SPHLite 当前发布 0.6.1 `Shell` 运动学基线版本。本版本在 0.6.0 Shell 输入与状态基线之上,新增 Shell director、section orientation、参考面积/转动惯量、局部坐标系、角速度/角加速度状态、director 小转动更新、Mindlin-Reissner 小变形应变和厚度积分点应变增量映射。0.6.1 不交付完整 Shell 动力学闭环、Shell 材料点更新、Shell 内力/内力矩、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。
## 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 开发。
### 0.3.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.3.0 是 `Gas` 模块第一个正式开发版本。
- 0.3.0 在 0.2.2 `Water` 稳定化基线之上新增 Gas material、理想气体/JWL/Stiffened gas EOS、Gas 状态初始化、Gas 单相显式推进、summary、bubble metrics、CSV output、restart、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 诊断字段。
- 0.3.0 的 bubble metrics 为单气团近似,只用于 Gas 诊断和小规模链路检查,不作为工程精度气泡脉动 benchmark。
- 0.3.0 不交付 `Explosive` 点火/爆轰/源项注入,不交付 `Solid`、`Shell` 生产路径,不交付真实 FEM-SPH 联合运行。
- 0.3.0 restart 写入 `STATE_0_3`,并保留 `STATE_0_2` 读入容错路径。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:27/27。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
发布建议:
- 若默认 gate、`source_size` 和 `git diff --check` 全部通过,建议发布 0.3.0 作为 Gas 最小闭环版本。
- 0.3.0 发布后,后续主线建议进入 0.4.0 `Explosive`,重点实现解析点火、爆轰传播和向 Gas 注入质量/动量/能量的源项路径。
### 0.3.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.3.1 是 0.3 `Gas` 版本线的稳定化和前置加固版本。
- 0.3.1 支持同一模型中多个 Gas material,并按 material 分派理想气体、JWL 和 Stiffened gas EOS。
- 0.3.1 新增 Gas 质量、动量、能量源项缓存和清零/累计/显式应用/诊断入口,但不实现 `Explosive` 反应。
- 0.3.1 restart 写入 `STATE_0_3_1`,保存 Gas material/EOS 表、源项缓存、dt 和 bubble 历史状态,并保持 0.3.0 `STATE_0_3` 兼容读入。
- 0.3.1 追加 Gas extended/source summary 的 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:37/37。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
不交付范围:
- 0.3.1 不交付 `Explosive` 解析点火、爆轰传播、反应进度或炸药 phase 迁移。
- 0.3.1 不交付 `Solid`、`Shell` 生产路径。
- 0.3.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
发布建议:
- 建议发布 0.3.1 作为 Gas 稳定化版本。
- 0.3.1 发布后,后续主线可进入 0.4.0 `Explosive`,使用 0.3.1 已建立的 Gas 源项缓存作为质量/动量/能量注入入口。
### 0.4.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.4.0 是 `Explosive` 模块的起步闭环版本。
- 0.4.0 支持 `TYPE=EXPLOSIVE` material、`*SPHLITE EXPLOSIVE` programmed burn 控制和 `*SPHLITE IGNITION` 单点点火。
- 0.4.0 使用解析爆轰到达时间,不引入球面经验载荷主模型。
- 0.4.0 支持炸药反应进度、释放质量/动量/能量统计、`CONVERSION=SOURCE` 注入 Gas 源项,以及 `CONVERSION=PHASE` 完全反应后转为 Gas。
- 0.4.0 restart 写入 `STATE_0_4`,保存 Explosive material 表、点火记录和每粒子反应状态,并兼容 0.3.1 restart 读入时初始化空 Explosive 状态。
- 0.4.0 追加 Explosive summary 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI、CSV output 和专项 CTest gate。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:51/51。
- Explosive 专项 gate 通过:14/14。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
不交付范围:
- 0.4.0 不交付 `Solid`、`Shell` 生产路径。
- 0.4.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.4.0 不交付工程级水下爆炸 benchmark、完整化学反应爆轰模型或气泡长周期脉动模型。
发布建议:
- 建议发布 0.4.0 作为 Explosive 起步闭环版本。
- 0.4.0 发布后,后续主线可进入 `Solid`/`Shell` 前置能力或继续加固 Explosive-Gas-Water 链路。
发布记录:
- 0.4.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.0`。
### 0.4.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.4.1 是 0.4 `Explosive` 版本线的稳定化和回归加固版本。
- 0.4.1 支持多点点火取最早到达、多炸药 material 独立 programmed burn 参数和多 product Gas material 映射。
- 0.4.1 冻结每粒子初始反应质量,并用 `delta_lambda` 驱动 release mass、release energy 和 release momentum 一致性统计。
- 0.4.1 新增 release balance、SOURCE target、PHASE 转化和 Water/Gas/Explosive 混合 smoke 诊断。
- 0.4.1 restart 写入 `STATE_0_4_1`,保存反应质量基准、release balance 和 SOURCE/PHASE 诊断,并兼容 `STATE_0_4` 读入。
- 0.4.1 追加 release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI、CSV output 和专项 CTest gate。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:66/66。
- 0.4.1 Explosive 专项 gate 通过:14/14。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
不交付范围:
- 0.4.1 不交付 `Solid`、`Shell` 生产路径。
- 0.4.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.4.1 不交付工程级水下爆炸 benchmark、完整化学反应爆轰模型、球面经验载荷主模型或气泡长周期脉动模型。
发布建议:
- 建议发布 0.4.1 作为 Explosive 稳定化版本。
- 0.4.1 发布后,后续主线可进入 `Solid`/`Shell` 前置能力,或继续加固 Explosive-Gas-Water 的工程输入和 benchmark 链路。
发布记录:
- 0.4.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.1`。
### 0.5.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.5.0 是 `Solid` 3D 实体结构粒子的起步闭环版本。
- 0.5.0 支持 `TYPE=SOLID` material、`*DENSITY`、`*ELASTIC`、Johnson-Cook flow/failure 参数、Solid control softening 参数和 `*SOLID SECTION` 映射。
- 0.5.0 新增 Solid 应力、应变、塑性应变、塑性应变率、温度、damage、softening、内能、失效状态、参考体积和梯度修正占位状态。
- 0.5.0 支持弹性材料点、Johnson-Cook flow、Johnson-Cook failure damage 累积、线性渐进软化和失效状态切换。
- 0.5.0 将 Solid 接入 Velocity-Verlet 显式推进,提供体力驱动 smoke、结构波速稳定时间步、Solid 动能/内能/动量/max von Mises/damage/softening/dt 诊断。
- 0.5.0 restart 写入 `STATE_0_5`,保存 Solid material 表和 per-particle 状态,并兼容 `STATE_0_4_1` 及更早状态读入时初始化空 Solid 状态。
- 0.5.0 追加 Solid summary 和 failure counts 的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:83/83。
- 0.4.1 Explosive 回归 gate 通过:14/14。
- 0.5.0 Solid 专项 gate 通过:17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
- `tests/source_size_exceptions.txt` 未新增 Solid 例外,stale exception 检查通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.5.0 不交付 `Shell` 生产路径。
- 0.5.0 不交付真实水-气-结构工程爆炸响应。
- 0.5.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.5.0 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云或焊缝失效库。
已知限制:
- 0.5.0 Solid 显式推进以最小体力驱动、状态闭环和诊断闭环为主,不代表已经具备工程级结构破裂预测能力。
- 梯度修正和参考构型状态已经建表和验收占位,后续版本仍需继续完善真实结构内力、应变率和断裂传播算法。
- Solid material summary 暂不对外暴露,当前接口只暴露 Solid 计数、能量、动量、damage、softening、dt 和失效统计。
发布建议:
- 建议将 0.5.0 作为 Solid 起步闭环版本发布。
- 0.5.0 发布后,后续主线可继续进入 Solid 内力/断裂加固,或进入 `Shell` 0.6.0 前置设计。
发布记录:
- 0.5.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.0`。
### 0.5.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.5.1 是 0.5 `Solid` 版本线的稳定化和结构算法加固版本。
- 0.5.1 补强 Solid 参考邻域计数、退化状态、修正矩阵状态、修正矩阵行列式诊断和变形梯度状态。
- 0.5.1 新增 Solid 速度梯度、应变率、等效应变率、最小内力、softening 内力折减、最大加速度、最大应变率和内力动量残差诊断。
- 0.5.1 将 Solid 新状态写入 `STATE_0_5_1` restart,并兼容 `STATE_0_5` 读入时初始化新增状态。
- 0.5.1 追加 Solid 粒子级状态、诊断和参考质量的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
- 0.5.1 为 source size 门禁拆分 Solid C ABI、Python Solid 调试包装和 Solid API 查询模块;`src/solid/sph_solid.f90` 作为 Solid 输入/material 表 owner 登记说明性例外。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:99/99。
- 0.5.0 Solid 回归 gate 通过:17/17。
- 0.5.1 Solid 专项 gate 通过:16/16。
- `ctest --test-dir build-codex-unix -R "^(source_size|solid_source_size|solid_051_source_size)$" --output-on-failure` 通过:3/3。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.5.1 不交付 `Shell` 生产路径。
- 0.5.1 不交付真实水-气-结构工程爆炸响应。
- 0.5.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.5.1 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- 0.5.1 Solid 内力仍是小型可测最小路径,不代表工程级结构破裂预测能力。
- 参考修正矩阵提供质量诊断和 fallback,但尚未交付复杂断裂面追踪或碎片云模型。
- `Shell` phase/status 与文档路线仍保留,但板壳生产计算路径尚未实现。
发布建议:
- 建议将 0.5.1 作为 Solid 稳定化版本发布。
- 0.5.1 发布后,后续主线可继续加固 Solid 断裂/接触前置能力,或进入 `Shell` 0.6.0 前置设计。
发布记录:
- 0.5.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.5.1`。
### 0.6.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.6.0 是 0.6 `Shell` 板壳粒子版本线的起点。
- 0.6.0 在 0.5.1 `Solid` 稳定化基线之上新增 `TYPE=SHELL` material 识别、`*SHELL SECTION` 输入解析、Shell section 映射、厚度、3 点/5 点积分规则和剪切修正校验。
- 0.6.0 新增 Shell 粒子级状态数组,包括 active、section/material 映射、厚度、积分点数、剪切修正、director/转动占位、应变、曲率、剪切应变、合力/合力矩和失效状态默认值。
- 0.6.0 新增 Shell 厚度积分点状态数组,包括积分点坐标、权重、应力、应变、塑性应变、等效塑性应变、damage、softening、温度、内能和失效状态默认值。
- 0.6.0 的 Shell 发布范围是输入与状态基线,不是完整 Shell 结构动力学闭环。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:103/103。
- 0.6.0 Shell 输入/状态基线专项 gate 通过:4/4。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.6.0 不交付 director 或法向的真实更新。
- 0.6.0 不交付转动惯量、角速度、角加速度或转动显式推进。
- 0.6.0 不交付 Mindlin-Reissner 应变计算路径。
- 0.6.0 不交付 Shell Johnson-Cook 材料点更新、Shell 内力、Shell 内力矩或 Shell 稳定时间步。
- 0.6.0 不交付 Shell restart、公开 API、C ABI、C++ wrapper、Python ctypes 或 CLI 诊断字段。
- 0.6.0 不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合。
- 0.6.0 不交付工程级船舱破坏 benchmark、复杂撕裂面追踪、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- Shell 状态数组中的 director、转动、应变、曲率、剪切应变、内力和合力矩当前为初始化占位,不参与生产计算。
- Shell section 支持 3 点和 5 点厚度积分规则,但尚未用于真实厚度积分材料更新。
- 当前 Shell gate 只证明输入解析和状态构建可用,不代表工程级板壳变形、损伤或撕裂预测能力。
发布建议:
- 建议将 0.6.0 作为 Shell 输入与状态基线版本发布。
- 0.6.0 发布后,后续主线应继续完成 Shell director/转动、Mindlin-Reissner 应变、材料点、内力、显式推进、restart 和接口层。
发布记录:
- 0.6.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.6.0`。
### 0.6.1 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.6.1 是 0.6 `Shell` 板壳粒子版本线的运动学基线版本。
- 0.6.1 在 0.6.0 Shell 输入与状态基线之上新增显式 director 输入、`*ORIENTATION` 解析、Shell section orientation 引用和未使用 orientation warning。
- 0.6.1 支持从显式 set、section orientation、三角形/四边形参考面或局部粒子云推断 active Shell director,并记录 director 来源、退化数量和长度偏差诊断。
- 0.6.1 新增 active Shell 参考面积、等效转动惯量、局部 `e1/e2/e3` 坐标系、角速度、角加速度、最大角速度和 director 小转动更新入口。
- 0.6.1 新增 Mindlin-Reissner 小变形膜应变、弯曲应变、横向剪切应变、厚度积分点应变增量映射和运动学诊断查询入口。
- 0.6.1 的 Shell 发布范围仍是可测运动学基线,不是完整 Shell 结构动力学闭环。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:113/113。
- 0.6.0 Shell 输入/状态基线专项 gate 通过:4/4。
- 0.6.1 Shell 运动学专项 gate 通过:13/13。
- `ctest --test-dir build-codex-unix -R "^(source_size|shell_061_source_size)$" --output-on-failure` 通过:2/2。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.6.1 不交付 Shell Johnson-Cook 材料点更新。
- 0.6.1 不交付 Shell 内力、Shell 内力矩或 Shell 稳定时间步。
- 0.6.1 不交付完整显式推进生产路径、Shell restart、公开 C ABI、C++ wrapper、Python ctypes 或 CLI 诊断字段。
- 0.6.1 不交付真实水-气-结构工程爆炸响应、真实 FEM-SPH 接触耦合或连续体耦合。
- 0.6.1 不交付工程级船舱破坏 benchmark、复杂撕裂面追踪、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- Shell 小变形路径当前只形成运动学基线和积分点应变映射,不驱动材料点、内力或显式推进生产计算。
- `src/shell/sph_shell.f90` 暂作为 0.6.1 Shell 输入、状态、几何和运动学 owner 保留说明性 source size 例外,后续在材料点、内力、restart 或接口层进入前应优先拆分 geometry、kinematics 和 diagnostics 子模块。
- Shell 厚度积分点应变增量已经可测,但尚未用于真实厚度积分材料更新或失效演化。
发布建议:
- 建议将 0.6.1 作为 Shell 运动学基线版本发布。
- 0.6.1 发布后,后续主线应优先完成 Shell 材料点、内力/内力矩、稳定时间步和最小显式推进闭环;若 `sph_shell.f90` 继续增长,应先完成 Shell 子模块拆分。
发布记录:
- 0.6.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.6.1`。
### 0.7.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.7.0 是水-气-结构局部爆炸 smoke 起点版本。
- 0.7.0 在 0.6.1 Shell 运动学基线之上,新增 `*SPHLITE BLAST REGION` 输入控制、源/目标筛选、局部源项快照和结构外载荷缓存。
- 0.7.0 将局部爆炸外载荷接入显式推进中的 Solid/Shell 平动响应路径,并保留 Shell 内力和内力矩闭环的受控占位边界。
- 0.7.0 新增 Blast summary Fortran 查询、summary CSV 调试字段、粒子 CSV 结构外载荷字段和 restart 边界测试。
- 0.7.0 的局部爆炸诊断不进入公开 C ABI/C++/Python 稳定接口,也不写入正式 `STATE_0_7` restart。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:127/127。
- 0.7.0 局部爆炸专项 gate 通过:14/14。
- source size 相关 gate 通过:7/7。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.7.0 不交付真实工程级水下接触爆炸响应。
- 0.7.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.7.0 不交付完整舱段破坏 benchmark。
- 0.7.0 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
- 0.7.0 不宣称 Shell 完整动力学闭环;Shell 外载荷当前仅进入受控平动响应路径。
已知限制:
- 局部爆炸载荷为 smoke 级调试投影,不是工程级近场爆炸载荷算法。
- restart 仍保持既有 `STATE_0_5_1` 状态边界,Blast 控制和诊断在 0.7.0 不作为正式 restart state 保存。
- C ABI、C++ wrapper、Python ctypes 和 CLI 暂不公开 Blast 调试查询函数。
发布建议:
- 建议将 0.7.0 作为局部爆炸 smoke 起点版本发布。
- 0.7.0 发布后,后续主线应优先完善真实压力载荷投影、Shell 动力学闭环、restart 状态和稳定公开接口边界。
发布记录:
- 0.7.0 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.7.0`。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
## 4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。