Files
SPHLite/docs/09_release_history.md
2026-07-05 21:41:34 +08:00

771 lines
40 KiB
Markdown
Raw Permalink 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.8.3 发布记录
## 1. 当前状态
SPHLite 当前发布版本为 0.8.3 CCLite worker 集成加固版本。0.8.3 在 0.8.2 worker mock 契约基础上新增能力查询、Windows shared memory/named event IPC 适配器自测、AOR v1 粒子/力数据块、contact state 导入、`*SPHLITE CCLITE` 输入开关、worker 诊断文件和 CCLite mock 命令闭环加固 gate。0.8.3 不交付真实外部 CCLite 进程联调、真实 FEM-SPH 接触搜索、生产级 FSI 或工程级水下接触爆炸舱段破坏 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`。
### 0.7.1 本地验收记录
记录日期:2026-07-04
本地构建目录:`build-codex-unix`
版本定位:
- 0.7.1 是局部爆炸链路稳定化版本。
- 0.7.1 在 0.7.0 blast smoke 起点之上,新增多 blast region 输入、禁用 region、重复 region 错误检查和源/目标统计加固。
- 0.7.1 补强 Solid/Shell 结构载荷叠加、诊断有限性、显式推进顺序和 no-active-target 回归。
- 0.7.1 新增 `blast_smoke_071`,覆盖 Solid、Shell、Solid/Shell 混合多 region、小型禁用载荷和无 active target 样例。
- 0.7.1 仍不新增公开 Blast C ABI/C++/Python 稳定接口,也不新增正式 Blast restart state。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:139/139。
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、16/16、27/27、31/31、13/13。
- 0.7.0 blast 回归 gate 通过:14/14。
- 0.7.1 blast 专项 gate 通过:12/12。
- source size 相关 gate 通过:7/7。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.7.1 不交付真实工程级水下接触爆炸响应。
- 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.7.1 不交付完整舱段破坏 benchmark。
- 0.7.1 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
- 0.7.1 不宣称 Shell 完整动力学闭环;Shell blast 仍只覆盖受控平动响应和诊断边界。
已知限制:
- Blast 外载荷仍是 smoke 级调试投影,不是工程级近场爆炸载荷算法。
- restart 仍保持既有 `STATE_0_5_1` 状态边界,Blast 控制和诊断不作为正式 restart state 保存。
- C ABI、C++ wrapper、Python ctypes 和 CLI 暂不公开 Blast 调试查询函数。
发布建议:
- 建议将 0.7.1 作为局部爆炸稳定化版本记录。
- 0.7.1 之后,若继续沿 blast 主线推进,应优先进入 0.8.0 的耦合边界设计或真实压力载荷投影设计。
发布记录:
- 0.7.1 已于 2026-07-04 完成本地发布记录提交,并准备标记 `v0.7.1`。
### 0.8.0 本地验收记录
记录日期:2026-07-04
本地构建目录:`build-codex-unix`
版本定位:
- 0.8.0 是 SPHLite 侧中立接触耦合接口起步版本。
- 0.8.0 新增并验收 `*SPHLITE COUPLING REGION` 的 0.8 子集、active/disabled region 构建、phase/material/section 过滤和 `TYPE=CONTACT` 启用路径。
- 0.8.0 支持按 region 导出粒子状态和 Shell Facet Proxy,导入外部粒子力、facet load 和 direct motion boundary。
- 0.8.0 将 coupling 外部载荷接入显式步,记录当前力、冲量、做功、动量/能量交换、stale/skipped/nonfinite/imported 计数和最大响应诊断。
- 0.8.0 新增 `STATE_0_8` restart,保存 coupling region、导入缓存、运动边界和累计诊断,并兼容既有 restart 读入时初始化空 coupling 状态。
- 0.8.0 追加 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 的 coupling 查询、导出、导入和诊断入口。
- 0.8.0 新增 `coupling_smoke_080`,覆盖 Solid mock contact、Shell mock contact、Solid/Shell 混合、disabled region、no-active response 和 stale/repeated import。
验收结果:
- `cmake --build build-codex-unix` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:163/163。
- 0.8.0 coupling 专项 gate 通过:24/24。
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、19/19、28/28、33/33、14/14。
- 0.7.0 blast 回归 gate 通过:19/19。
- 0.7.1 blast 专项 gate 通过:7/7。
- source size 相关 gate 通过:8/8。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录未新增 FEMLite 或 CouplingModule 直接依赖。
- 输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
不交付范围:
- 0.8.0 不交付真实 FEMLite 联合运行。
- 0.8.0 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。
- 0.8.0 不交付连续体一部分 FEM 一部分 SPH 的生产级连续体耦合。
- 0.8.0 不交付生产级接触搜索、接触约束、摩擦、接触稳定化或工程接触参数库。
- 0.8.0 不交付工程级船舶水下接触爆炸舱段破坏 benchmark。
- 0.8.0 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- Facet Proxy 当前仍是 Shell 粒子级中立代理,不等价于真实外表面重构。
- Mock coupling smoke 只验证 SPHLite 侧接口链路和受控响应,不代表真实外部耦合模块。
- Source size 中对 0.8.0 接口层、restart、CLI、Python/C++ wrapper 和 CouplingInterface 主文件登记了说明性例外;后续版本应优先拆分。
发布建议:
- 建议将 0.8.0 作为 SPHLite 侧中立接触耦合接口起步版本发布。
- 0.8.0 发布后,后续主线应优先推进接口拆分、耦合边界稳定性、真实外部耦合模块对接设计和连续体耦合的需求拆分。
发布记录:
- 0.8.0 已于 2026-07-04 完成本地发布 gate,并准备标记 `v0.8.0`。
### 0.8.1 发布记录
记录日期:2026-07-04
本地构建目录:`build-codex-unix`
版本定位:
- 0.8.1 是 SPHLite 侧中立接触耦合接口稳定化版本。
- 0.8.1 在 0.8.0 coupling region、粒子/Facet Proxy 导出、外部载荷/运动边界导入和 diagnostics 基础上,新增 `LOAD_MODE=PRESSURE`、`LOAD_MODE=TRACTION`、facet resultant、`DISTRIBUTION=UNIFORM/AREA/MASS` 和 `CONTACT_STATE=IMPORT` 的稳定化测试。
- 0.8.1 新增 contact flag、normal、gap、penetration、contact pressure 缓存,以及 active/skipped contact、stale/repeated/nonfinite/bad area/invalid weight、最大 pressure/traction/penetration 和载荷守恒诊断。
- 0.8.1 将新增 contact 和载荷守恒字段写入 summary CSV、粒子 CSV 和 `STATE_0_8_1` restart,并兼容读入 `STATE_0_8` coupling restart 后初始化 0.8.1 新增状态。
- 0.8.1 追加 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI inspect 的 pressure、traction、contact state、load balance 和 contact diagnostics 入口。
- 0.8.1 新增 `coupling_smoke_081`,覆盖 Solid 等效 surface pressure、Shell pressure、traction、pressure-motion 混合和 stale epoch mock coupling 样例。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:189/189。
- 0.8.1 coupling 专项 gate 通过:26/26。
- 0.8.0 coupling 回归 gate 通过:24/24。
- Water/Gas/Explosive/Solid/Shell 分类 gate 通过:6/6、19/19、29/29、33/33、14/14。
- 0.7.0 blast 回归 gate 通过:15/15。
- 0.7.1 blast 专项 gate 通过:11/11。
- source size 相关 gate 通过:9/9。
- `git diff --check` 通过。
- 代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- 输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
不交付范围:
- 0.8.1 不交付真实 FEMLite 联合运行。
- 0.8.1 不交付外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。
- 0.8.1 不交付连续体一部分 FEM 一部分 SPH 的生产级连续体耦合。
- 0.8.1 不交付生产级接触搜索、接触约束、摩擦、接触稳定化或工程接触参数库。
- 0.8.1 不交付工程级船舶水下接触爆炸舱段破坏 benchmark。
- 0.8.1 不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
已知限制:
- Solid surface pressure smoke 当前使用等效粒子力验证 Solid 受压方向响应,不表示 0.8.1 已实现 Solid 实体表面 facet pressure 重构。
- Shell Facet Proxy 当前仍是 Shell 粒子级中立代理,不等价于真实外表面重构。
- Mock coupling smoke 只验证 SPHLite 侧接口链路和受控响应,不代表真实外部耦合模块。
- Source size 中对 0.8.1 相关接口层、restart、输出、测试和 CouplingInterface 主文件继续通过 source size gate 约束;后续版本应继续拆分 owner 文件。
发布记录:
- 0.8.1 已于 2026-07-04 完成本地发布 gate,并标记 `v0.8.1`。
后续建议:
- 0.8.1 发布后,后续主线可进入 0.8.2 接口清理/错误路径加固,或进入 0.9.0 连续体耦合需求拆分,但不应在 0.8.1 内宣称真实 FEMLite 联合运行。
### 0.8.2 发布记录
记录日期:2026-07-05
本地构建目录:`build-codex-unix`
版本定位:
- 0.8.2 是 CCLite worker 集成预研版本。
- 0.8.2 稳定 worker 入口、能力查询、mockable adapter、Windows shared memory/named event attach/loop 自测、数据契约、诊断格式和 CCLite mock command/data block;不宣称真实外部 CCLite 进程联调完成。
- 0.8.2 不改变 `STATE_0_8_1` restart schema;当前版本号更新为 0.8.2,restart 格式继续兼容 0.8.1 持久状态边界。
完成内容:
- 新增 CCLite coupling manifest,记录 region、particle、facet、load、contact、motion、diagnostics 和 v2 预留字段。
- 新增 `--cclite-worker` CLI 参数解析和 `--cclite-capabilities` 能力查询,保留普通 CLI 行为不变。
- 新增 worker 状态/命令/error code、ack 序号语义、IPC adapter mock、Windows shared memory/named event attach/loop 自测和命令到现有 SPHLite API 的动作映射表。
- 新增 AOR v1 粒子/力数据块、valid flags、contact state 扩展、拒绝原因、stale/repeated/nonfinite 计数、总力/总力矩统计和 boundary/ghost 预留缓存清零策略。
- 新增 `*SPHLITE CCLITE` 输入开关、worker log、particle report、force report 输出工具,并确认 VTU/PVD 可继续用于 worker 结果复核。
- 新增 CCLite mock command/data block 闭环,覆盖 INIT、READ_INPUT、BUILD_MODEL、EXPORT_INTERFACE、IMPORT_LOADS、ADVANCE、WRITE_OUTPUT、STOP、100 step 空耦合和异常命令。
不交付范围:
- 不交付真实外部 CCLite 进程联调。
- 不交付真实 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:200/200。
- worker/coupling 专项 gate 通过:55/55。
- source size 相关 gate 通过:9/9。
- `git diff --check` 通过。
- `examples/infinite_underwater_explosion` 双击脚本验证通过,并生成 VTU/PVD。
- `tools/publish_to_cclite.bat -SkipBuild -DryRun -TargetRoot ..\CCLite\SPHLite` 验证通过。
发布记录:
- 0.8.2 已于 2026-07-05 完成本地发布 gate,并准备标记 `v0.8.2`。
本地提交说明建议:
```text
Pre-research CCLite worker integration contract
- add CCLite coupling manifest, worker protocol, IPC adapter mock,
API mapping, diagnostics format and mock command loop
- add worker CLI, capabilities and Windows IPC self-test path
- add worker and coupling regression gates; keep ordinary CLI behavior intact
```
### 0.8.3 发布记录
记录日期:2026-07-05
本地构建目录:`build-codex-unix`
版本定位:
- 0.8.3 是 CCLite worker 集成加固版本。
- 0.8.3 将算法核心继续约束为 Fortran 95,worker、CLI、IPC 等外围集成层可放宽到 Fortran 2018。
- 0.8.3 在 0.8.2 worker mock 契约基础上,完成 SPHLite 侧 Windows shared memory/named event attach/loop self-test、AOR v1 粒子/力数据块、contact state 导入和 worker 诊断文件。
- 0.8.3 不改变 `STATE_0_8_1` restart schema;当前版本号更新为 0.8.3,restart 格式继续兼容 0.8.1 持久状态边界。
完成内容:
- `--cclite-capabilities` 输出 solver、worker、IPC backend、command block version、data layout、平台相关 `supports_real_ipc` 和记录容量。
- Windows 构建下新增 shared memory/named event attach、READY、命令 ack、DONE、STOP、timeout 和异常输入 self-test;非 Windows 平台仍返回受控 unsupported。
- 新增 AOR v1 particle/force block 校验,覆盖 external id、export/internal index、valid flags、stale/repeated/nonfinite 拒绝、contact state 和总力/总力矩统计。
- 新增 `*SPHLITE CCLITE` 输入关键词,提供 worker、region、export radius/sound speed、contact/boundary accept 开关。
- 新增 worker runtime report 文件写入和路径管理,完善 worker log、particle report 和 force report。
- 更新 README、06/09/11/12 号文档、worker protocol、IPC adapter、diagnostics、API mapping 和 coupling manifest。
不交付范围:
- 不交付真实外部 CCLite 进程联调。
- 不交付真实 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
- 不交付生产级 CCLite 载荷求解或工程级船舶水下接触爆炸舱段破坏 benchmark。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:200/200。
- worker/coupling 专项 gate 通过:55/55。
- source size 相关 gate 通过:9/9。
- `git diff --check` 通过。
- `examples/infinite_underwater_explosion` 双击脚本验证通过,并生成 VTU/PVD。
- `tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite` 实际发布通过,目标 manifest 版本为 0.8.3。
发布记录:
- 0.8.3 于 2026-07-05 完成本地发布 gate,并准备提交、标记 `v0.8.3` 和推送。
后续每个版本应记录:
- 完成能力。
- 明确不交付范围。
- 本地构建命令。
- CTest 结果。
- benchmark/checker 结果。
- 已知限制。
## 4. 待讨论问题
- 是否需要在 0.3 前完成最小可视化输出。
- 0.8 和 0.9 是否拆分为独立大版本。