diff --git a/CMakeLists.txt b/CMakeLists.txt index 6edbcf2..58fcb9e 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.20) -project(SPHLite VERSION 0.2.1 LANGUAGES C CXX Fortran) +project(SPHLite VERSION 0.2.2 LANGUAGES C CXX Fortran) set(CMAKE_C_STANDARD 99) set(CMAKE_C_STANDARD_REQUIRED ON) diff --git a/README.md b/README.md index 61a5816..658ebc3 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ SPHLite 是一个面向船舶水下接触爆炸的轻量级 SPH 多物理仿真软件。项目目标是支持水、爆炸产物气体、实体结构粒子、板壳结构粒子、破裂损伤,以及通过外部耦合模块与 FEMLite 进行接触和连续体耦合。 -当前目标版本:0.2.1。该版本定位为 `Water` 基础 SPH 加固版,在 0.2.0 最小闭环基础上加固输入校验、粒子状态一致性、核函数/邻域边界、Tait EOS、连续性方程、人工黏性、压力力、显式推进、CSV 输出、restart、CLI/API、CouplingInterface 占位和 pressure wave smoke。不交付 `Gas`、`Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 +当前目标版本:0.2.2。该版本定位为 `Water` 基础 SPH 稳定化补丁版,在 0.2.1 加固基线基础上复核版本发布、输入解析、粒子状态一致性、Water 数值行为、显式推进、CSV 输出、restart、CLI/API、CouplingInterface 边界和 release gate。不交付 `Gas`、`Explosive`、`Solid`、`Shell` 的生产路径,也不交付真实 FEM-SPH 联合运行。 代码仓库地址: @@ -63,13 +63,13 @@ SPHLite 的编译和测试要求应与 FEMLite 保持一致风格: ## 当前状态 -0.2.1 当前实现重点包括: +0.2.2 当前实现重点包括: - CMake/CTest 工程骨架和 Fortran 95 核心库。 - C ABI、C++ 头文件薄包装和 Python `ctypes` 调试入口。 - Abaqus `.inp` 明确子集解析,以及 `*SPHLITE EOS`、`*SPHLITE VISCOSITY`、`*SPHLITE PARTICLE CONTROL`、`*SPHLITE BODY FORCE`。 - 3D Water 粒子的 Wendland/Cubic 核函数、uniform cell 邻域搜索、Tait EOS、Monaghan 人工黏性、连续性方程和 Velocity-Verlet 显式推进。 - Water summary、稳定时间步诊断、CSV output、restart 和双 pressure wave smoke 小算例。 -- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.1 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 -- `Gas`、`Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.2.1 交付生产计算路径。 -- 0.2.1 release gate 与 source size 门禁。 +- CouplingInterface 的中立数据导出、外部粒子力导入和诊断占位;0.2.2 不暴露 CouplingInterface C ABI,真实 FEM-SPH 联合运行仍由外部 CouplingModule 后续实现。 +- `Gas`、`Explosive`、`Solid`、`Shell` 仍为后续阶段,不在 0.2.2 交付生产计算路径。 +- 0.2.2 release gate 与 source size 门禁。 diff --git a/docs/09_release_history.md b/docs/09_release_history.md index c6e37f4..5ac4bbe 100644 --- a/docs/09_release_history.md +++ b/docs/09_release_history.md @@ -1,10 +1,10 @@ # 09 版本历史与验收记录 -文档状态:0.2.1 本地验收通过 +文档状态:0.2.2 开发中 ## 1. 当前状态 -SPHLite 当前进入 0.2.1 `Water` 基础 SPH 加固版本。本版本在 0.2.0 最小闭环基础上加固输入、状态一致性、Water 算法边界、output、restart、API/CLI、CouplingInterface 占位和 pressure wave smoke;`Gas`、`Explosive`、`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。 +SPHLite 当前进入 0.2.2 `Water` 基础 SPH 稳定化补丁版本。本版本在 0.2.1 加固基线基础上复核版本发布、输入解析、状态一致性、Water 算法边界、output、restart、API/CLI、CouplingInterface 中立边界和 release gate;`Gas`、`Explosive`、`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。 ## 2. 规划版本线 @@ -112,6 +112,23 @@ cmake --build build-codex-unix - 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 结果将在本版本完成时记录。 + 后续每个版本应记录: - 完成能力。 diff --git a/docs/11_benchmark_matrix.md b/docs/11_benchmark_matrix.md index f034dba..0c7b37c 100644 --- a/docs/11_benchmark_matrix.md +++ b/docs/11_benchmark_matrix.md @@ -1,10 +1,10 @@ # 11 Benchmark 与验收矩阵 -文档状态:0.2.1 gate 记录 +文档状态:0.2.2 gate 记录占位 ## 1. 当前状态 -0.2.1 在 0.2.0 `Water` 基础弱可压 SPH 最小可测试 gate 上进行加固,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 pressure wave smoke 只用于小规模数值链路检查,不作为工程精度 benchmark。 +0.2.2 在 0.2.1 `Water` 基础弱可压 SPH 加固基线上进行稳定化复核,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 pressure wave smoke 只用于小规模数值链路检查,不作为工程精度 benchmark。 ## 2. 0.1.0 Release Gate @@ -107,6 +107,39 @@ |---|---|---| | 2026-07-02 | `build-codex-unix` | 0.2.1 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过 | +## 2.4 0.2.2 Release Gate + +0.2.2 继续使用 0.2.1 已建立的默认 gate,目标是复核 Water 路径、接口兼容性、restart/output 稳定性和文档边界,不新增 Gas、Explosive、Solid、Shell 或真实 FEM-SPH 联合运行验收。 + +| 测试名 | 类型 | 验收点 | +|---|---|---| +| `smoke` | Fortran smoke | 版本 0.2.2、生命周期和显式步进错误路径 | +| `input` | Fortran input | Abaqus 子集、Water 关键词、warning/error 路径 | +| `kernel` | Fortran unit | 核函数边界、错误路径和有限性 | +| `neighbor` | Fortran unit | 邻域边界、容量、统计和小规模一致性 | +| `water_eos` | Fortran module | Tait EOS、负压策略、声速和 summary | +| `water_density` | Fortran module | 连续性方程、跳过规则和低密度错误路径 | +| `water_viscosity` | Fortran module | Monaghan 参数、方向、有限性和跳过规则 | +| `water_force` | Fortran module | 压力力、body force、外部粒子力占位和跳过规则 | +| `solver_water` | Fortran module | 显式推进、stable dt、API 兼容和错误默认值 | +| `output` | Fortran output | 自动输出、手动输出不改状态、CSV 字段和目录错误路径 | +| `restart` | Fortran restart | STATE_0_2 状态版本、Water 状态、诊断、读回和非法文件 | +| `coupling_interface` | Fortran coupling | Water 状态导出、外力导入、work/momentum/energy 诊断 | +| `c_api` | C ABI | 空指针、小容量、错误码透传和 Water 诊断 | +| `cpp_api` | C++ wrapper | RAII 生命周期、薄包装和 Water 诊断 | +| `python_debug` | Python `ctypes` | C ABI 加载、inspect/run、Water 诊断和错误路径 | +| `cli` | CLI | version、inspect、check、run、output 和错误输入 | +| `pressure_wave_smoke` | Fortran smoke | 5 粒子线性和 3D 非共线压力扰动、小规模趋势检查 | +| `source_size` | 工具门禁 | Fortran/C/C++/Python 文件和 stale exception | + +0.2.2 不验收 `Gas`、`Explosive`、`Solid`、`Shell` 的生产级物理结果,也不验收真实 FEM-SPH 联合运行。CouplingInterface 不在 0.2.2 暴露 C ABI。 + +本地验收记录: + +| 日期 | 构建目录 | 结果 | +|---|---|---| +| 2026-07-03 | `build-codex-unix` | 待最终 gate 回填 | + ## 3. 基础数值矩阵 | 领域 | 测试或 benchmark | 验收点 | diff --git a/docs/v2.2_development_plan.md b/docs/v2.2_development_plan.md new file mode 100644 index 0000000..e6f07bd --- /dev/null +++ b/docs/v2.2_development_plan.md @@ -0,0 +1,247 @@ +# SPHLite 0.2.2 开发计划 + +## 1. 文档定位 + +本文档用于规划 SPHLite 0.2.2 版本的开发范围。0.2.2 不作为新的物理功能主版本,而作为 0.2 水相能力完成后的补丁、稳定化与 0.3 Gas 开发前的交接版本。 + +0.2.2 的核心目标是:在不扩大软件功能边界的前提下,修正 0.2.1 可能遗留的问题,巩固已有 Water 求解路径,补齐验收与发布记录,并为 0.3.0 的 Gas 模块开发提供清晰入口。 + +## 2. 依据文件 + +本计划依据以下文档制定: + +- `README.md` +- `docs/01_project_overview.md` +- `docs/02_software_architecture.md` +- `docs/03_data_model.md` +- `docs/04_numerical_algorithms.md` +- `docs/05_interfaces_and_coupling.md` +- `docs/06_testing_and_validation.md` +- `docs/v2.0_development_plan.md` +- `docs/v2.1_development_plan.md` + +## 3. 版本定位 + +### 3.1 与 0.2.1 的关系 + +0.2.1 已完成 0.2 阶段 Water 求解路径的主要加固工作,包括输入、数据库、邻域搜索、水相 EOS、密度连续性方程、人工黏性、压力力、显式时间推进、输出、重启动、API、CLI 与测试门禁。 + +0.2.2 应保持 0.2.1 的计算行为稳定,不主动引入新的物理模型或新的模块级架构。 + +### 3.2 与 0.3.0 的关系 + +0.3.0 应作为 Gas 模块的正式开发起点。0.2.2 只允许为 0.3.0 做接口、文档、测试命名和风险边界方面的准备,不应提前实现 Gas 生产求解路径。 + +若 0.2.1 发布后未发现需要修复的稳定性问题,0.2.2 可以作为预留版本,不强制实施完整开发,可直接进入 0.3.0。 + +## 4. 开发原则 + +### 4.1 保持模块边界 + +SPHLite 仍然只修改本文件夹内容,不修改 FEMLite 或其他外部模块。SPHLite 不直接依赖 FEMLite,后续耦合仍通过独立 CouplingModule 或其可能的新名称完成。 + +### 4.2 保持求解器定位 + +SPHLite 是求解器,不承担几何建模、网格生成或粒子生成职责。0.2.2 不新增内置建模器、网格器或粒子生成器。 + +### 4.3 保持语言和环境约束 + +核心代码继续遵守 Fortran 95 规范,支持环境与 FEMLite 保持一致。C、C++ 和 Python 接口保持轻量封装原则,不引入会破坏可移植性的外部依赖。 + +### 4.4 保持显式动力学路线 + +时间推进仍以显式动力学为唯一方式,采用 Velocity-Verlet 积分路线。0.2.2 不引入隐式求解器、不引入 Newmark 路线,也不恢复不需要的历史积分方案。 + +### 4.5 保持 Abaqus 子集策略 + +输入文件继续解析 SPHLite 支持的 Abaqus `.inp` 子集。能复用 Abaqus 关键词时不重新定义关键词;确需 SPHLite 扩展时使用清晰的 `*SPHLITE` 前缀。 + +## 5. 交付目标 + +0.2.2 建议交付以下内容: + +1. 0.2.1 Water 求解路径的稳定性复核。 +2. 输入解析、数据库、邻域搜索、Water、输出、重启动、API、CLI 的回归检查。 +3. 已知问题、警告策略和错误策略的整理。 +4. 发布说明和版本记录的补齐。 +5. 0.3.0 Gas 开发前的准备清单。 +6. 默认测试门禁和源码规模门禁的再确认。 + +## 6. 非交付范围 + +0.2.2 不应交付以下内容: + +1. 不实现 Gas 的正式生产求解路径。 +2. 不实现 JWL、理想气体或 Stiffened gas 的完整 Gas 模块。 +3. 不实现 Explosive 的点火爆炸生产算法。 +4. 不实现 Solid 的 Johnson-Cook 材料模型和失效模型。 +5. 不实现 Shell 的 Mindlin-Reissner 生产求解路径。 +6. 不实现 FEM-SPH 连续体耦合算例。 +7. 不把 CouplingModule 作为直接依赖。 +8. 不新增几何、网格或粒子生成能力。 +9. 不扩大 Abaqus 兼容范围到完整 Abaqus 输入。 +10. 不引入新的大型第三方依赖。 + +## 7. 建议工作包 + +### 7.1 基线复核 + +确认 0.2.1 当前代码状态、测试门禁和文档状态,建立 0.2.2 的开发基线。 + +建议检查内容: + +- 工作区是否干净。 +- 0.2.1 本地提交是否完整。 +- README、01-06 号文档和 0.2 系列开发计划是否互相一致。 +- 当前测试门禁是否仍可重复执行。 + +### 7.2 版本与发布记录整理 + +若决定实际发布 0.2.2,需要将版本号、发布记录和测试记录统一更新到 0.2.2。若 0.2.2 仅作为预留版本,则不应修改运行时版本号。 + +建议检查内容: + +- 版本号是否只在必要位置更新。 +- 发布说明是否说明 0.2.2 是补丁或稳定化版本。 +- 文档是否避免宣称未实现的 Gas、Explosive、Solid、Shell 或耦合能力。 + +### 7.3 Water 行为回归 + +复核 0.2.1 Water 求解路径,确保 0.2.2 不改变以下行为: + +- 密度采用连续性方程更新。 +- 默认 EOS 使用 Tait 模型。 +- Stiffened gas 仅作为后续或备选策略,不作为 0.2.2 新增生产能力。 +- `rho < rho0` 时保留负压,不进行压力截断。 +- 空化暂不作为 0.2.2 的实现内容。 +- 人工黏性和压力力的开关、参数和诊断行为保持稳定。 + +### 7.4 输入解析回归 + +确认 0.2.1 支持的 Abaqus 子集仍保持兼容,错误和警告策略不发生漂移。 + +建议检查内容: + +- 不影响程序运行的问题报 warning。 +- 缺失必要关键词导致无法运行时报 error。 +- `*SPHLITE` 扩展关键词边界清晰。 +- 不新增与 Abaqus 关键词冲突的 SPHLite 关键词。 + +### 7.5 数据库与相变边界复核 + +继续采用集中型数据管理模式,粒子数据统一管理。Water、Gas、Explosive、Solid 和 Shell 共享基础粒子数据,但计算路径保持独立。 + +0.2.2 只复核既有 phase 机制,不新增复杂相变模型。若发现 phase 改变相关问题,应以修复状态一致性为目标,不扩大到新物理。 + +### 7.6 重启动完整性复核 + +重启动继续按模块级完整重启动的方向维护。0.2.2 应重点确认当前版本写出的 restart 数据能够恢复 Water 求解状态。 + +建议检查内容: + +- 坐标、速度、密度、质量、相标识和材料标识保存完整。 +- Water 相关状态变量保存完整。 +- 时间步、步数和输出计数恢复一致。 +- 不在 0.2.2 引入复杂跨版本迁移机制。 + +### 7.7 API 兼容性复核 + +C ABI、C++ 封装和 Python ctypes 接口应保持 0.2.1 兼容。0.2.2 只允许修复错误,不主动调整公开接口名称、参数顺序或返回约定。 + +建议检查内容: + +- C ABI 可被 C++ 和 Python 稳定调用。 +- C++ 继续作为轻量 RAII 封装。 +- Python 继续作为轻量 ctypes 封装。 +- CLI 行为不因内部整理发生不兼容变化。 + +### 7.8 CouplingInterface 中立性复核 + +SPHLite 继续保留中立耦合接口概念,但不直接依赖 FEMLite。0.2.2 可复核文档和接口命名,确保后续 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite 等外部名称变化不会影响 SPHLite 内部边界。 + +0.2.2 不实现真实 FEM-SPH 耦合算法,不把 FEMLite 数据结构引入 SPHLite。 + +### 7.9 测试门禁复核 + +0.2.2 应继续使用 0.2.1 已建立的默认测试门禁,并保留源码规模检查。 + +建议默认门禁: + +```powershell +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 +ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure +git diff --check +``` + +若当前环境不能运行完整测试,应在发布记录中明确说明原因和剩余风险。 + +### 7.10 0.3.0 Gas 交接准备 + +为 0.3.0 准备但不实现以下内容: + +- Gas 输入关键词草案。 +- Gas 状态变量清单。 +- Gas EOS 测试命名建议。 +- Water 与 Gas 共享粒子数据但独立计算路径的边界说明。 +- Explosive 作用到 Gas 后形成 Bubble 的长期路线说明。 +- 0.3.0 首批最小可验收算例建议。 + +## 8. 建议待办阶段 + +若后续需要根据本计划生成 `todo.md`,建议采用以下阶段: + +1. 基线与版本状态复核。 +2. 文档一致性与发布记录整理。 +3. 输入解析回归检查。 +4. 数据库和 phase 状态回归检查。 +5. Water EOS、密度、黏性、压力力回归检查。 +6. 显式时间推进与输出回归检查。 +7. 重启动完整性回归检查。 +8. C、C++、Python 和 CLI 接口兼容性检查。 +9. CouplingInterface 中立性检查。 +10. 0.3.0 Gas 交接清单整理。 +11. 默认门禁和源码规模门禁执行。 +12. 0.2.2 发布决策记录。 + +## 9. 验收标准 + +0.2.2 若实际实施,应满足以下验收标准: + +1. 0.2.1 已支持的 Water 测试全部通过。 +2. 输入解析错误和 warning 行为符合 02 号文档要求。 +3. 重启动测试可恢复 Water 求解关键状态。 +4. C、C++、Python 和 CLI 基础测试通过。 +5. 默认门禁和源码规模门禁通过。 +6. 文档没有宣称尚未实现的 Gas、Explosive、Solid、Shell 或耦合能力。 +7. 不新增 FEMLite 直接依赖。 +8. 不修改 SPHLite 文件夹之外的内容。 + +## 10. 风险与控制 + +| 风险 | 表现 | 控制方式 | +| --- | --- | --- | +| 0.2.2 范围膨胀 | 提前实现 Gas 或其他新模块 | 将 0.2.2 限定为补丁和稳定化版本 | +| 文档过度承诺 | README 或开发计划宣称未实现能力 | 发布前进行文档一致性复核 | +| Water 行为漂移 | 小修复改变 0.2.1 数值路径 | 通过 Water 回归测试和 pressure wave smoke 测试约束 | +| API 不兼容 | C/C++/Python 调用方式变化 | 0.2.2 不主动调整公开接口 | +| 耦合边界混乱 | 引入 FEMLite 直接依赖 | 只保留中立 CouplingInterface 概念 | +| 发布记录不清 | 无法判断 0.2.2 是否应发布 | 记录 0.2.2 是实际补丁还是预留版本 | + +## 11. 发布建议 + +建议将 0.2.2 作为可选版本处理: + +1. 若 0.2.1 发现明确缺陷,则实施 0.2.2,修复后发布。 +2. 若 0.2.1 稳定且无必须修复事项,则保留本计划作为预案,直接启动 0.3.0。 +3. 若 0.2.2 仅包含文档整理,不改变代码行为,应在发布记录中明确说明其性质。 + +## 12. 0.3.0 启动条件 + +满足以下条件后,可以启动 0.3.0: + +1. 0.2.1 或 0.2.2 的 Water 基线稳定。 +2. 默认测试门禁可重复执行。 +3. 文档确认 0.3.0 的主要目标是 Gas 模块。 +4. Gas 与 Water 的共享数据和独立计算边界已经明确。 +5. 0.3.0 的首批待办事项能够围绕 Gas 输入、状态、EOS、输出、重启动和测试展开。 + diff --git a/src/core/sph_precision.f90 b/src/core/sph_precision.f90 index 0bcea45..2e9fd17 100644 --- a/src/core/sph_precision.f90 +++ b/src/core/sph_precision.f90 @@ -4,7 +4,7 @@ module sph_precision integer, parameter :: rk = selected_real_kind(12, 100) integer, parameter :: SPH_VERSION_MAJOR = 0 integer, parameter :: SPH_VERSION_MINOR = 2 - integer, parameter :: SPH_VERSION_PATCH = 1 + integer, parameter :: SPH_VERSION_PATCH = 2 integer, parameter :: SPH_NDIM = 3 integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256 integer, parameter :: SPH_PATH_LEN = 1024 diff --git a/tests/interface/test_c_api.c b/tests/interface/test_c_api.c index e6d6ef6..5a7d959 100644 --- a/tests/interface/test_c_api.c +++ b/tests/interface/test_c_api.c @@ -78,7 +78,7 @@ int main(void) ierr = sphlite_get_version(&major, &minor, &patch); if (ierr != 0) return fail("get_version failed"); - if (major != 0 || minor != 2 || patch != 1) return fail("unexpected version"); + if (major != 0 || minor != 2 || patch != 2) return fail("unexpected version"); snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR); ierr = sphlite_read_inp(path); diff --git a/tests/interface/test_cpp_api.cpp b/tests/interface/test_cpp_api.cpp index 7efd70d..a4d928a 100644 --- a/tests/interface/test_cpp_api.cpp +++ b/tests/interface/test_cpp_api.cpp @@ -14,7 +14,7 @@ int main() { sphlite::Session session; sphlite::Version version = sphlite::version(); - if (version.major != 0 || version.minor != 2 || version.patch != 1) { + if (version.major != 0 || version.minor != 2 || version.patch != 2) { return 1; } diff --git a/tests/unit/test_smoke.f90 b/tests/unit/test_smoke.f90 index 9a068ae..b656593 100644 --- a/tests/unit/test_smoke.f90 +++ b/tests/unit/test_smoke.f90 @@ -37,7 +37,7 @@ program test_smoke call sph_get_version(major, minor, patch, ierr) call assert_ok(ierr, 'version failed') - if (major /= 0 .or. minor /= 2 .or. patch /= 1) call fail('unexpected version') + if (major /= 0 .or. minor /= 2 .or. patch /= 2) call fail('unexpected version') call sph_db_allocate(2, ierr) call assert_ok(ierr, 'database allocation failed') diff --git a/todo.md b/todo.md index 610a5f5..4d2b90f 100644 --- a/todo.md +++ b/todo.md @@ -1,476 +1,148 @@ # SPHLite TODO -当前目标版本:0.2.1 +当前目标版本:0.2.2 -本文档依据 `docs/v2.1_development_plan.md` 拆分。0.2.1 是 `Water` 加固版本,目标是增强 0.2.0 已有水相弱可压 SPH 路径的可靠性、可验证性和接口一致性,不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径,不交付真实 FEM-SPH 联合运行,不新增几何、网格或粒子生成能力。 +本文档依据 `docs/v2.2_development_plan.md` 拆分。0.2.2 定位为 0.2 Water 阶段后的补丁、稳定化与 0.3.0 Gas 开发前的交接版本。所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。 -## 阶段 A:版本和基线检查 +执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。 -- [x] 将 `sph_precision` 中的软件版本更新为 `0.2.1`。 -- [x] 将 CMake 项目版本更新为 `0.2.1`。 -- [x] 更新 CLI `--version` 的版本期望。 -- [x] 更新 Fortran smoke 测试中的版本期望。 -- [x] 更新 C API 测试中的版本期望。 -- [x] 更新 C++ API 测试中的版本期望。 -- [x] 更新 Python debug 测试中的版本期望。 -- [x] 确认 `sphlite_core` 仍以 Fortran 95 核心源文件为主。 -- [x] 确认 `sphlite_c` 仍为 C ABI 薄封装库。 -- [x] 确认 `sphlite_c_shared` 仍可构建。 -- [x] 确认 `sphlite` CLI 仍通过公共接口调用求解器。 -- [x] 确认不新增 `geometry/` 目录。 -- [x] 确认不新增 `mesh/` 目录。 -- [x] 确认不新增粒子生成器作为求解器功能。 -- [x] 跑通 0.2.0 发布状态的默认 gate。 -- [x] 跑通 `source_size` 门禁。 -- [x] 跑通 `git diff --check`。 -- [x] 记录 0.2.1 基线检查结果。 +## 阶段 A:基线与版本状态 -基线检查记录(2026-07-02):0.2.1 版本号迁移后,`cmake --build build-codex-unix` 通过;默认 `ctest` 18/18 通过;单独 `source_size` 通过;`git diff --check` 通过;未新增 `geometry/`、`mesh/` 或粒子生成器目录。 +- [x] 确认当前 git 状态并记录 0.2.2 开发起点。 +- [x] 确认 0.2.1 最终本地提交可作为 0.2.2 基线。 +- [x] 确认 `docs/v2.2_development_plan.md` 与 01-06 号文档无范围冲突。 +- [x] 确认 0.2.2 不新增 Gas 生产求解路径。 +- [x] 确认 0.2.2 不新增 Explosive 生产算法。 +- [x] 确认 0.2.2 不新增 Solid 生产求解路径。 +- [x] 确认 0.2.2 不新增 Shell 生产求解路径。 +- [x] 确认 0.2.2 不新增真实 FEM-SPH 耦合运行。 +- [x] 确认 0.2.2 不新增几何、网格或粒子生成目录。 +- [x] 记录 0.2.2 是否作为实际补丁版本发布的初始判断。 -## 阶段 B:0.2.1 输入测试数据 +## 阶段 B:版本号与发布文档 -- [x] 创建 0.2.1 Water 最小合法输入文件。 -- [x] 创建 Water material 大小写兼容测试输入文件。 -- [x] 创建 Water material 缺少 `*DENSITY` 的错误输入文件。 -- [x] 创建 `*SECTION` 指向不存在 material 的错误输入文件。 -- [x] 创建缺失 `*SPHLITE EOS, TYPE` 的错误输入文件。 -- [x] 创建缺失 `*SPHLITE EOS, MATERIAL` 的错误输入文件。 -- [x] 创建缺失 `*SPHLITE EOS, RHO0` 的错误输入文件。 -- [x] 创建缺失 `*SPHLITE EOS, C0` 的错误输入文件。 -- [x] 创建缺失 `*SPHLITE EOS, GAMMA` 的错误输入文件。 -- [x] 创建非法 `*SPHLITE EOS, B` 的错误输入文件。 -- [x] 创建非 `TYPE=TAIT` 的 EOS 类型测试输入文件。 -- [x] 创建缺失 `*SPHLITE VISCOSITY` 字段的错误输入文件。 -- [x] 创建非法 `*SPHLITE VISCOSITY` 数值的错误输入文件。 -- [x] 创建非法 `*SPHLITE PARTICLE CONTROL` 数值的错误输入文件。 -- [x] 创建非法 `*SPHLITE BODY FORCE` 字段的错误输入文件。 -- [x] 创建非法 `*SPHLITE TIME CONTROL` 数值的错误输入文件。 -- [x] 创建未知但不影响运行的 `*SPHLITE` warning 输入文件。 -- [x] 创建重复坐标 Water 粒子输入文件。 -- [x] 创建稀疏 Water 粒子输入文件。 -- [x] 创建非共线 3D pressure wave 输入文件。 +- [x] 将核心软件版本更新或确认到 `0.2.2`。 +- [x] 将 CMake 项目版本更新或确认到 `0.2.2`。 +- [x] 更新或确认 CLI `--version` 的 0.2.2 期望。 +- [x] 更新或确认 Fortran smoke 测试中的版本期望。 +- [x] 更新或确认 C API 测试中的版本期望。 +- [x] 更新或确认 C++ API 测试中的版本期望。 +- [x] 更新或确认 Python debug 测试中的版本期望。 +- [x] 更新 README 中的当前版本与 0.2.2 定位说明。 +- [x] 更新 `docs/09_release_history.md` 中的 0.2.2 条目。 +- [x] 更新 `docs/11_benchmark_matrix.md` 中的 0.2.2 gate 记录占位。 -## 阶段 C:输入解析加固 +## 阶段 C:文档一致性复核 -- [x] 加固 `*MATERIAL, TYPE=WATER` 大小写解析。 -- [x] 加固 Water material 与 `*DENSITY` 的绑定校验。 -- [x] 加固 `*SECTION` material 引用存在性校验。 -- [x] 加固 set 只作为集合、不作为类型判断的测试。 -- [x] 加固 `*SPHLITE EOS` 的 `TYPE` 字段校验。 -- [x] 加固 `*SPHLITE EOS` 的 `MATERIAL` 字段校验。 -- [x] 加固 `*SPHLITE EOS` 的 `RHO0` 字段校验。 -- [x] 加固 `*SPHLITE EOS` 的 `C0` 字段校验。 -- [x] 加固 `*SPHLITE EOS` 的 `GAMMA` 字段校验。 -- [x] 加固 `*SPHLITE EOS` 的可选 `P0` 字段解析。 -- [x] 加固 `*SPHLITE EOS` 的可选 `B` 字段解析。 -- [x] 保持未给定 `B` 时由 `rho0*c0*c0/gamma` 推导。 -- [x] 明确非 `TYPE=TAIT` 的 EOS 处理策略。 -- [x] 加固 `*SPHLITE VISCOSITY` 的 `TYPE` 字段校验。 -- [x] 加固 `*SPHLITE VISCOSITY` 的 `MATERIAL` 字段校验。 -- [x] 加固 `*SPHLITE VISCOSITY` 的 `ALPHA` 字段校验。 -- [x] 加固 `*SPHLITE VISCOSITY` 的 `BETA` 字段校验。 -- [x] 加固 `*SPHLITE VISCOSITY` 的 `ETA2` 字段校验。 -- [x] 加固 `*SPHLITE PARTICLE CONTROL` 的 `H` 正值校验。 -- [x] 加固 `*SPHLITE PARTICLE CONTROL` 的 `MASS` 正值校验。 -- [x] 加固 `*SPHLITE PARTICLE CONTROL` 的 `VOLUME` 正值校验。 -- [x] 加固 `*SPHLITE BODY FORCE` 三维分量解析。 -- [x] 加固 `*SPHLITE TIME CONTROL` 的 `DT` 正值校验。 -- [x] 加固 `*SPHLITE TIME CONTROL` 的 `TIME` 正值校验。 -- [x] 加固 `*SPHLITE TIME CONTROL` 的 `STEPS` 正值校验。 -- [x] 加固 `*SPHLITE TIME CONTROL` 的 `SAFETY` 正值校验。 -- [x] 确认 unsupported-but-safe 关键词报 warning。 -- [x] 确认无法运行的缺失关键词报 error。 -- [x] 确认输入错误消息包含文件名。 -- [x] 确认输入错误消息包含行号或定位上下文。 +- [ ] 复核 README 未宣称 0.2.2 已实现 Gas 生产能力。 +- [ ] 复核 README 未宣称 0.2.2 已实现 Explosive 生产能力。 +- [ ] 复核 README 未宣称 0.2.2 已实现 Solid 生产能力。 +- [ ] 复核 README 未宣称 0.2.2 已实现 Shell 生产能力。 +- [ ] 复核 README 未宣称 0.2.2 已实现真实 FEM-SPH 耦合。 +- [ ] 复核 01 号文档中长期目标与 0.2.2 交付范围区分清楚。 +- [ ] 复核 02 号文档中求解器定位与 0.2.2 范围一致。 +- [ ] 复核 03 号文档中集中型数据管理描述与当前代码一致。 +- [ ] 复核 04 号文档中 Water 算法策略与当前代码一致。 +- [ ] 复核 05-06 号文档中接口和测试边界与 0.2.2 一致。 -## 阶段 D:Database 状态一致性 +## 阶段 D:输入解析回归 -- [x] 确认 `particle_id_ext` 在 build 后稳定。 -- [x] 确认 `particle_id_ext` 在 restart 读回后稳定。 -- [x] 确认 `particle_phase` 在 build 后一致。 -- [x] 确认 `particle_status` 在 build 后一致。 -- [x] 确认 `material_id` 在 build 后一致。 -- [x] 确认 `section_id` 在 build 后一致。 -- [x] 确认 `x0(3,npart)` 初始化路径一致。 -- [x] 确认 `x(3,npart)` 初始化路径一致。 -- [x] 确认 `v(3,npart)` 初始化路径一致。 -- [x] 确认 `a(3,npart)` 初始化路径一致。 -- [x] 确认 `vhalf(3,npart)` 初始化路径一致。 -- [x] 确认 `mass(npart)` 初始化路径一致。 -- [x] 确认 `rho(npart)` 初始化路径一致。 -- [x] 确认 `volume(npart)` 初始化路径一致。 -- [x] 确认 `pressure(npart)` 初始化路径一致。 -- [x] 确认 `temperature(npart)` 初始化路径一致。 -- [x] 确认 `h(npart)` 初始化路径一致。 -- [x] 确认 `drho_dt` 每步计算前正确重置。 -- [x] 确认 `acc_pressure` 每步计算前正确重置。 -- [x] 确认 `acc_viscosity` 每步计算前正确重置。 -- [x] 确认 `acc_body` 保留或重置策略明确。 -- [x] 确认 Water 诊断在 build 后可重复计算。 -- [x] 确认 Water 诊断在 advance 后可重复计算。 -- [x] 确认 Water 诊断在 restart read 后可重复计算。 -- [x] 确认非 Water 粒子仍可通过通用查询导出。 -- [x] 确认 inactive 粒子不参与 Water 相互作用。 -- [x] 确认重复 `sph_initialize` 后状态干净。 -- [x] 确认重复读取模型前旧状态被释放。 +- [ ] 复核 Abaqus 子集解析仍不追求完整 Abaqus 兼容。 +- [ ] 复核可复用 Abaqus 关键词时未新增重复 SPHLite 关键词。 +- [ ] 复核 unsupported-but-safe 关键词继续报 warning。 +- [ ] 复核缺失必要关键词时继续报 error。 +- [ ] 复核输入错误信息仍包含足够定位上下文。 +- [ ] 复核 `*MATERIAL, TYPE=WATER` 大小写兼容。 +- [ ] 复核 Water material 与 `*DENSITY` 绑定校验。 +- [ ] 复核 `*SECTION` material 引用存在性校验。 +- [ ] 复核 `*SPHLITE EOS, TYPE=TAIT` 校验。 +- [ ] 复核 `*SPHLITE TIME CONTROL` 正值校验。 -## 阶段 E:Kernel 加固 +## 阶段 E:数据模型与邻域回归 -- [x] 加固 Wendland C2 的 `h <= 0` 错误路径。 -- [x] 加固 Wendland C4 的 `h <= 0` 错误路径。 -- [x] 加固 cubic spline 的 `h <= 0` 错误路径。 -- [x] 加固未知 kernel type 错误路径。 -- [x] 加固 `r = 0` 时核函数值有限。 -- [x] 加固 `r = 0` 时核函数梯度为零向量。 -- [x] 加固接近支持半径时核函数值有限。 -- [x] 加固接近支持半径时核函数梯度有限。 -- [x] 加固超出支持半径时 `W = 0`。 -- [x] 加固超出支持半径时 `grad W = 0`。 -- [x] 加固对称粒子对梯度反对称。 -- [x] 加固不同 `h(i)` 的核函数结果有限。 -- [x] 确认默认 kernel 仍为 Wendland C2。 -- [x] 确认 kernel 测试不变成长跑积分 benchmark。 +- [ ] 复核集中型粒子数据管理未被绕开。 +- [ ] 复核 Water、Gas、Explosive、Solid、Shell 共享基础粒子数据结构。 +- [ ] 复核 Water 计算路径不依赖 Gas 状态变量。 +- [ ] 复核 phase 改变机制不引入新的不可控相变模型。 +- [ ] 复核 inactive 粒子不参与 Water 相互作用。 +- [ ] 复核 failed 粒子不参与 Water 相互作用。 +- [ ] 复核粒子 `h(i)` 的独立支持仍可用。 +- [ ] 复核 kernel 在 `h <= 0` 时保持错误路径。 +- [ ] 复核 neighbor 搜索在重复坐标粒子下保持稳定。 +- [ ] 复核 neighbor 搜索在稀疏粒子布局下保持稳定。 -## 阶段 F:Neighbor 加固 +## 阶段 F:Water 数值行为回归 -- [x] 加固空模型邻域构建。 -- [x] 加固单粒子邻域构建。 -- [x] 加固双粒子支持半径内判定。 -- [x] 加固双粒子支持半径外判定。 -- [x] 加固支持半径边界附近判定。 -- [x] 加固重复坐标粒子的邻域构建。 -- [x] 加固极近坐标粒子的邻域构建。 -- [x] 加固负坐标粒子的邻域构建。 -- [x] 加固稀疏粒子的包围盒计算。 -- [x] 加固稀疏粒子的 cell 维度控制。 -- [x] 加固不同 `h(i)` 对搜索半径的影响。 -- [x] 加固粒子移动后邻域重建。 -- [x] 加固邻域容量不足错误路径。 -- [x] 加固 naive `O(n^2)` 对比辅助检查。 -- [x] 加固 neighbor stats 最大邻居数。 -- [x] 加固 neighbor stats 平均邻居数。 -- [x] 确认 neighbor 测试保持小规模。 +- [ ] 复核 Water 密度仍采用连续性方程更新。 +- [ ] 复核 summation density 未进入主求解流程。 +- [ ] 复核默认 Water EOS 仍为 Tait 模型。 +- [ ] 复核 `B` 未显式给定时仍由 `rho0*c0*c0/gamma` 推导。 +- [ ] 复核显式给定 `B` 时结果保持当前策略。 +- [ ] 复核 `rho < rho0` 时继续保留负压。 +- [ ] 复核 0.2.2 不新增压力截断策略。 +- [ ] 复核 0.2.2 不新增空化生产模型。 +- [ ] 复核人工黏性参数和诊断行为保持 0.2.1 兼容。 +- [ ] 复核 pressure wave smoke 不被扩展为工程精度 benchmark。 -## 阶段 G:Water EOS 加固 +## 阶段 G:求解、输出与重启动 -- [x] 加固 `rho = rho0` 时压力接近 `p0`。 -- [x] 加固 `rho > rho0` 时压力单调增加。 -- [x] 明确 `rho < rho0` 时负压策略。 -- [x] 为当前负压策略增加测试。 -- [x] 加固 `rho <= 0` 错误路径。 -- [x] 加固 `rho0 <= 0` 错误路径。 -- [x] 加固 `c0 <= 0` 错误路径。 -- [x] 加固 `gamma <= 0` 错误路径。 -- [x] 加固 `B <= 0` 错误路径。 -- [x] 加固声速诊断保持正值。 -- [x] 加固压力计算结果有限。 -- [x] 加固 `B` 自动推导结果。 -- [x] 加固显式给定 `B` 的结果。 -- [x] 加固 Water summary 中最大压力诊断。 -- [x] 在文档中记录 0.2.1 Tait EOS 当前策略。 +- [ ] 复核显式时间推进仍采用 Velocity-Verlet 路线。 +- [ ] 复核 0.2.2 不引入隐式求解器。 +- [ ] 复核 stable dt 诊断仍覆盖 CFL、加速度和黏性约束。 +- [ ] 复核 `TIME` 与 `STEPS` 双约束运行逻辑。 +- [ ] 复核最后小步不超过 `end_time`。 +- [ ] 复核粒子 CSV 输出字段保持 0.2.1 兼容。 +- [ ] 复核 summary CSV 输出字段保持 0.2.1 兼容。 +- [ ] 复核手动输出不改变物理状态。 +- [ ] 复核 restart 写入 Water 求解关键状态。 +- [ ] 复核 restart 读回后可继续 Water 显式步。 -## 阶段 H:连续性方程加固 +## 阶段 H:接口与耦合边界 -- [x] 加固双粒子压缩时 `drho_dt` 符号。 -- [x] 加固双粒子拉伸时 `drho_dt` 符号。 -- [x] 加固静止均匀粒子组密度变化接近零。 -- [x] 加固非 Water 粒子跳过密度贡献。 -- [x] 加固 inactive 粒子跳过密度贡献。 -- [x] 加固 failed 粒子跳过密度贡献。 -- [x] 加固 `drho_dt` 每步重置。 -- [x] 加固密度更新结果有限。 -- [x] 加固低密度输入的错误路径。 -- [x] 加固邻域为空时密度变化处理。 -- [x] 确认 summation density 不进入主流程。 -- [x] 保留 summation density 后续 checker 入口说明。 +- [ ] 复核 Fortran 公共 API 保持 0.2.1 兼容。 +- [ ] 复核 C ABI 头文件保持 0.2.1 兼容。 +- [ ] 复核 C wrapper 不重新定义物理语义。 +- [ ] 复核 C++ wrapper 仍为轻量 RAII 封装。 +- [ ] 复核 Python wrapper 仍通过 C ABI 调用。 +- [ ] 复核 Python 不直接访问 Fortran 内部符号。 +- [ ] 复核 CLI 不绕过公共生命周期接口。 +- [ ] 复核 CouplingInterface 不出现 FEMLite 内部结构依赖。 +- [ ] 复核 CouplingInterface 命名不绑定外部模块最终名称。 +- [ ] 复核默认 gate 不运行真实 FEM-SPH 联合测试。 -## 阶段 I:人工黏性加固 +## 阶段 I:测试门禁 -- [x] 加固接近粒子产生人工黏性贡献。 -- [x] 加固远离粒子不产生压缩型人工黏性贡献。 -- [x] 加固零距离粒子人工黏性有限。 -- [x] 加固极小距离粒子人工黏性有限。 -- [x] 加固 `alpha < 0` 错误路径。 -- [x] 加固 `beta < 0` 错误路径。 -- [x] 加固 `eta2 <= 0` 错误路径。 -- [x] 加固人工黏性加速度方向。 -- [x] 加固人工黏性加速度有限性。 -- [x] 加固人工黏性动量趋势。 -- [x] 加固非 Water 粒子跳过黏性贡献。 -- [x] 加固 inactive 粒子跳过黏性贡献。 -- [x] 加固 viscosity 参数读入后与计算一致。 -- [x] 确认人工黏性测试保持小规模。 +- [ ] 完整配置 CMake 构建目录。 +- [ ] 完整编译 `sphlite_core`。 +- [ ] 完整编译 `sphlite_c`。 +- [ ] 完整编译 `sphlite_c_shared`。 +- [ ] 完整编译 `sphlite` CLI。 +- [ ] 完整编译 Fortran 测试目标。 +- [ ] 完整编译 C/C++ 测试目标。 +- [ ] 运行默认 gate 中的 smoke 测试。 +- [ ] 运行默认 gate 中的 input 测试。 +- [ ] 运行默认 gate 中的 Water 数值测试集合。 +- [ ] 运行默认 gate 中的 output 与 restart 测试。 +- [ ] 运行默认 gate 中的 API 与 CLI 测试。 +- [ ] 运行默认 gate 中的 coupling_interface 测试。 +- [ ] 运行默认 gate 中的 pressure_wave_smoke 测试。 +- [ ] 运行 `source_size` 门禁。 +- [ ] 运行 `git diff --check`。 -## 阶段 J:压力力和外载加固 +## 阶段 J:发布决策与 0.3.0 交接 -- [x] 加固双粒子压力力方向。 -- [x] 加固零压力时压力力接近零。 -- [x] 加固均匀压力组净力趋势。 -- [x] 加固压力力结果有限。 -- [x] 加固 `acc_pressure` 合成前重置。 -- [x] 加固 `acc_viscosity` 合成前重置。 -- [x] 加固 `acc_body` 合成策略。 -- [x] 加固 body force 对速度方向的影响。 -- [x] 加固 body force 对加速度缓存的影响。 -- [x] 加固外部粒子力进入显式步外载占位。 -- [x] 加固非 Water 粒子跳过压力力。 -- [x] 加固 inactive 粒子跳过压力力。 -- [x] 加固 failed 粒子跳过压力力。 -- [x] 确认总加速度合成顺序清晰。 - -## 阶段 K:Solver 和时间步加固 - -- [x] 加固未 initialize 时 `sph_advance_explicit` 错误路径。 -- [x] 加固未 build model 时 `sph_advance_explicit` 错误路径。 -- [x] 加固未 build model 时 `sph_run_explicit` 错误路径。 -- [x] 加固负 `dt` 错误路径。 -- [x] 加固零 `dt` 错误路径。 -- [x] 加固非法 Water 状态下 stable dt 错误路径。 -- [x] 加固 CFL 时间步约束诊断。 -- [x] 加固加速度时间步约束诊断。 -- [x] 加固黏性时间步约束诊断。 -- [x] 加固 safety factor 正值生效路径。 -- [x] 加固非法 safety factor 处理。 -- [x] 加固 `TIME` 与 `STEPS` 双约束运行。 -- [x] 加固最后小步不超过 `end_time`。 -- [x] 加固单步 Water 推进。 -- [x] 加固多步 Water 推进。 -- [x] 加固 `sph_run_explicit` Water 闭环。 -- [x] 加固自动输出间隔触发。 -- [x] 加固未启用输出时不自动写文件。 -- [x] 加固 restart 后继续显式步。 -- [x] 加固当前时间和步号查询。 - -## 阶段 L:Output 加固 - -- [x] 确认粒子 CSV 包含 id 字段。 -- [x] 确认粒子 CSV 包含 phase 字段。 -- [x] 确认粒子 CSV 包含 status 字段。 -- [x] 确认粒子 CSV 包含 material 字段。 -- [x] 确认粒子 CSV 包含 section 字段。 -- [x] 确认粒子 CSV 包含坐标字段。 -- [x] 确认粒子 CSV 包含速度字段。 -- [x] 确认粒子 CSV 包含 rho 字段。 -- [x] 确认粒子 CSV 包含 pressure 字段。 -- [x] 确认粒子 CSV 包含 temperature 字段。 -- [x] 确认粒子 CSV 包含 h 字段。 -- [x] 确认 summary CSV 包含 step 字段。 -- [x] 确认 summary CSV 包含 time 字段。 -- [x] 确认 summary CSV 包含 water mass 字段。 -- [x] 确认 summary CSV 包含 water momentum 字段。 -- [x] 确认 summary CSV 包含 max pressure 字段。 -- [x] 确认 summary CSV 包含 min/max density 字段。 -- [x] 确认 summary CSV 包含 dtcrit 字段。 -- [x] 加固输出目录不存在时的处理。 -- [x] 加固非法输出目录错误路径。 -- [x] 确认手动 `sph_write_output` 不改变物理状态。 -- [x] 确认 CLI `--run --output` 使用实际 step/time。 - -## 阶段 M:Restart 加固 - -- [x] 确认 restart header 可识别。 -- [x] 确认 restart state version 记录 0.2.1 策略。 -- [x] 确认 restart 写入 current time。 -- [x] 确认 restart 写入 current step。 -- [x] 确认 restart 写入 output control。 -- [x] 确认 restart 写入 safety factor。 -- [x] 确认 restart 写入 Water EOS 参数。 -- [x] 确认 restart 写入 viscosity 参数。 -- [x] 确认 restart 写入 body force 参数。 -- [x] 确认 restart 写入粒子通用状态。 -- [x] 确认 restart 写入 rho。 -- [x] 确认 restart 写入 pressure。 -- [x] 确认 restart 写入 h。 -- [x] 确认 restart 写入 v、a、vhalf。 -- [x] 确认 restart 写入 Water 诊断状态。 -- [x] 确认 restart 读回 current time。 -- [x] 确认 restart 读回 current step。 -- [x] 确认 restart 读回 Water 参数。 -- [x] 确认 restart 读回粒子状态。 -- [x] 确认 restart 读回后重建邻域。 -- [x] 确认 restart 读回后继续 Water 显式步。 -- [x] 加固非法 restart 文件错误路径。 - -## 阶段 N:Fortran API 加固 - -- [x] 确认生命周期 API 兼容 0.2.0。 -- [x] 确认 `.inp` 读取 API 兼容 0.2.0。 -- [x] 确认 build model API 兼容 0.2.0。 -- [x] 确认 stable dt API 兼容 0.2.0。 -- [x] 确认 advance/run explicit API 兼容 0.2.0。 -- [x] 确认 current time API 兼容 0.2.0。 -- [x] 确认 particle count/state API 兼容 0.2.0。 -- [x] 确认 output/restart API 兼容 0.2.0。 -- [x] 确认 error query API 兼容 0.2.0。 -- [x] 确认 neighbor rebuild API 兼容 0.2.0。 -- [x] 确认 neighbor stats API 兼容 0.2.0。 -- [x] 确认 water summary API 兼容 0.2.0。 -- [x] 确认 water dt limits API 兼容 0.2.0。 -- [x] 加固新增 API 未初始化错误路径。 -- [x] 加固新增 API 未 build 错误路径。 -- [x] 确认错误返回前输出参数为安全默认值。 -- [x] 确认 API 不暴露内部 allocatable 指针。 - -## 阶段 O:C ABI、C++ 和 Python 加固 - -- [x] 确认 C ABI 头文件保持 0.2.0 兼容。 -- [x] 加固 `sphlite_get_water_summary` 空指针错误路径。 -- [x] 加固 `sphlite_get_water_dt_limits` 空指针错误路径。 -- [x] 加固 `sphlite_get_particle_state` 空指针错误路径。 -- [x] 加固 `sphlite_get_particle_state` 小容量错误路径。 -- [x] 确认 C 参数错误返回 `-1`。 -- [x] 确认 Fortran 错误码原样返回 C 调用方。 -- [x] 确认 C wrapper 不重新定义物理语义。 -- [x] 确认 C++ wrapper 只做薄封装。 -- [x] 加固 C++ water summary 测试。 -- [x] 加固 C++ water dt limits 测试。 -- [x] 加固 C++ 生命周期 RAII 测试。 -- [x] 确认 Python 通过 C ABI 调用。 -- [x] 加固 Python water summary 包装。 -- [x] 加固 Python water dt limits 包装。 -- [x] 加固 Python inspect 辅助函数。 -- [x] 加固 Python run 辅助函数。 -- [x] 加固 Python 缺失输入错误路径。 -- [x] 加固 Python 缺失 Water 参数错误路径。 -- [x] 确认 Python 不直接访问 Fortran 内部符号。 - -## 阶段 P:CLI 加固 - -- [x] 保持 `sphlite --version` 可用。 -- [x] 保持 `sphlite model.inp` inspect 模式可用。 -- [x] 保持 `sphlite model.inp --check` 模式可用。 -- [x] 保持 `sphlite model.inp --run` 模式可用。 -- [x] 保持 `sphlite model.inp --run --output output` 可用。 -- [x] 确认 CLI 输出 `version` 字段。 -- [x] 确认 CLI 输出 `input` 字段。 -- [x] 确认 CLI 输出 `mode` 字段。 -- [x] 确认 CLI 输出 `particles` 字段。 -- [x] 确认 CLI 输出 `warnings` 字段。 -- [x] 确认 CLI 输出 `time` 字段。 -- [x] 确认 CLI 输出 `step` 字段。 -- [x] 确认 CLI 输出 `water_particles` 字段。 -- [x] 确认 CLI 输出 `water_mass` 字段。 -- [x] 确认 CLI 输出 `max_pressure` 字段。 -- [x] 确认 CLI 输出 `dtcrit` 字段。 -- [x] 确认 CLI 输出 `status` 字段。 -- [x] 加固缺少输入文件的错误路径。 -- [x] 加固输入文件不存在的错误路径。 -- [x] 加固 `--run` 与 `--check` 同时给出的错误路径。 -- [x] 加固 `--output` 缺少路径的错误路径。 -- [x] 加固 Water 参数缺失的错误路径。 -- [x] 加固输出目录非法的错误路径。 -- [x] 确认 CLI 不绕过公共生命周期接口。 - -## 阶段 Q:CouplingInterface 加固 - -- [x] 确认 Water 运行后 coupling particle count 可用。 -- [x] 确认 Water 运行后 coupling particle state 导出可用。 -- [x] 确认 coupling particle 导出包含 id。 -- [x] 确认 coupling particle 导出包含 position。 -- [x] 确认 coupling particle 导出包含 velocity。 -- [x] 确认 coupling particle 导出包含 phase。 -- [x] 确认 coupling particle 导出包含 material。 -- [x] 确认 coupling particle 导出包含 pressure。 -- [x] 确认外部粒子力导入接口可用。 -- [x] 确认外部粒子力影响显式步。 -- [x] 确认 coupling work 诊断继续记录。 -- [x] 确认 coupling momentum 诊断继续记录。 -- [x] 确认 coupling energy 诊断继续记录。 -- [x] 保持接触耦合类型字段。 -- [x] 保持连续体耦合类型字段。 -- [x] 确认接口命名不出现 FEMLite 内部结构。 -- [x] 确认默认 gate 不运行真实 FEM-SPH 联合测试。 -- [x] 评估 0.2.1 是否暴露 C ABI coupling 接口。 -- [x] 若不暴露 C ABI coupling 接口,在文档中记录原因。 - -## 阶段 R:Pressure Wave Smoke 加固 - -- [x] 保持已有 5 粒子 pressure wave smoke 可用。 -- [x] 评估是否增加非共线 3D 粒子布置。 -- [x] 若增加非共线布置,创建对应输入文件。 -- [x] 加固初始压力扰动设置。 -- [x] 加固运行步数检查。 -- [x] 加固 checker 阈值说明。 -- [x] 检查压力扰动传播方向。 -- [x] 检查输出有限性。 -- [x] 检查质量趋势。 -- [x] 检查动量趋势。 -- [x] 检查粒子 CSV 输出字段。 -- [x] 检查 summary CSV 输出字段。 -- [x] 确认 pressure wave smoke 不作为工程精度 benchmark。 -- [x] 确认 pressure wave smoke 保持小规模。 -- [x] 确认 pressure wave smoke 进入默认 gate。 - -## 阶段 S:Source Size 和默认 Gate - -- [x] 确认 source size 覆盖 Fortran 文件。 -- [x] 确认 source size 覆盖 C 文件。 -- [x] 确认 source size 覆盖 C++ 头文件。 -- [x] 确认 source size 覆盖 Python 文件。 -- [x] 为新增大文件登记必要例外。 -- [x] 确认 stale exception 检查有效。 -- [x] 运行 `smoke` 测试。 -- [x] 运行 `input` 测试。 -- [x] 运行 `kernel` 测试。 -- [x] 运行 `neighbor` 测试。 -- [x] 运行 `water_eos` 测试。 -- [x] 运行 `water_density` 测试。 -- [x] 运行 `water_viscosity` 测试。 -- [x] 运行 `water_force` 测试。 -- [x] 运行 `solver_water` 测试。 -- [x] 运行 `output` 测试。 -- [x] 运行 `restart` 测试。 -- [x] 运行 `coupling_interface` 测试。 -- [x] 运行 `c_api` 测试。 -- [x] 运行 `cpp_api` 测试。 -- [x] 运行 `python_debug` 测试。 -- [x] 运行 `cli` 测试。 -- [x] 运行 `pressure_wave_smoke` 测试。 -- [x] 运行 `source_size` 测试。 -- [x] 运行 `git diff --check`。 - -## 阶段 T:文档同步 - -- [x] 更新 README 当前版本为 0.2.1。 -- [x] 更新 README 的 0.2.1 实际能力说明。 -- [x] 记录 0.2.1 交付 Water 加固能力。 -- [x] 记录 0.2.1 不交付 Gas 生产路径。 -- [x] 记录 0.2.1 不交付 Explosive 生产路径。 -- [x] 记录 0.2.1 不交付 Solid 生产路径。 -- [x] 记录 0.2.1 不交付 Shell 生产路径。 -- [x] 记录 0.2.1 不交付真实 FEM-SPH 联合运行。 -- [x] 更新 `docs/09_release_history.md` 的 0.2.1 条目。 -- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.2.1 gate。 -- [x] 确认 01-06 文档与 0.2.1 实际能力不冲突。 -- [x] 确认文档使用 UTF-8 without BOM。 -- [x] 确认文档不宣称已实现完整水下爆炸。 -- [x] 确认文档不宣称已实现生产级多物理耦合。 -- [x] 记录 restart 格式版本策略。 -- [x] 记录非 `TYPE=TAIT` EOS 的 0.2.1 处理策略。 -- [x] 记录 Water 拉伸压力策略。 -- [x] 记录 CouplingInterface C ABI 是否进入 0.2.1。 -- [x] 记录 VTK 是否进入 0.2.1。 - -## 阶段 U:0.2.1 验收 - -- [x] 完整配置 CMake。 -- [x] 完整编译 `sphlite_core`。 -- [x] 完整编译 `sphlite_c`。 -- [x] 完整编译 `sphlite_c_shared`。 -- [x] 完整编译 `sphlite`。 -- [x] 完整编译新增 Fortran 测试目标。 -- [x] 完整编译新增 C/C++ 测试目标。 -- [x] 运行 `ctest -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)$"`。 -- [x] 运行 `ctest -R "^source_size$"`。 -- [x] 运行 `git diff --check`。 -- [x] 确认没有提交 build 目录。 -- [x] 确认没有提交 Python 缓存。 -- [x] 确认没有提交 CSV 临时结果。 -- [x] 确认没有提交 VTK 临时结果。 -- [x] 确认没有提交 restart 临时结果。 -- [x] 确认没有残留旧模块命名。 -- [x] 确认没有新增 FEMLite 源码依赖。 -- [x] 确认没有新增几何生成能力。 -- [x] 确认没有新增网格生成能力。 -- [x] 确认没有新增粒子生成能力。 -- [x] 记录 0.2.1 release gate 结果。 +- [ ] 确认没有提交 build 目录。 +- [ ] 确认没有提交 Python 缓存。 +- [ ] 确认没有提交 CSV 临时结果。 +- [ ] 确认没有提交 restart 临时结果。 +- [ ] 确认没有提交 VTK 临时结果。 +- [ ] 记录 0.2.2 release gate 结果。 +- [ ] 记录 0.2.2 中实际修复的问题列表。 +- [ ] 记录 0.2.2 中未修复但可接受的剩余风险。 +- [ ] 整理 0.3.0 Gas 输入关键词草案入口。 +- [ ] 整理 0.3.0 Gas 状态变量清单入口。 +- [ ] 整理 0.3.0 Gas EOS 测试命名入口。 +- [ ] 整理 Water 与 Gas 共享数据但独立计算的边界说明。 +- [ ] 整理 Explosive 作用到 Gas 后形成 Bubble 的长期路线说明。 +- [ ] 给出 0.2.2 是否发布或跳过的最终建议。 +- [ ] 确认工作区只保留应提交的 0.2.2 变更。 diff --git a/tools/testing/test_cli.py b/tools/testing/test_cli.py index 62719e7..2f107de 100644 --- a/tools/testing/test_cli.py +++ b/tools/testing/test_cli.py @@ -52,7 +52,7 @@ def main() -> int: version = run_command([exe, "--version"]) require_field(version.stdout, "version") - if "0.2.1" not in version.stdout: + if "0.2.2" not in version.stdout: raise AssertionError("CLI version mismatch") inspect = run_command([exe, model]) @@ -72,7 +72,7 @@ def main() -> int: ): require_field(inspect.stdout, field) inspect_fields = read_fields(inspect.stdout) - if inspect_fields["version"] != "0.2.1": + if inspect_fields["version"] != "0.2.2": raise AssertionError("inspect version field mismatch") if Path(inspect_fields["input"]) != Path(model): raise AssertionError("inspect input field mismatch") diff --git a/tools/testing/test_python_debug.py b/tools/testing/test_python_debug.py index 9a934b9..b3c50db 100644 --- a/tools/testing/test_python_debug.py +++ b/tools/testing/test_python_debug.py @@ -27,7 +27,7 @@ def main() -> int: raise AssertionError("Python constants are not locked") if not hasattr(solver.lib, "sphlite_get_water_summary"): raise AssertionError("Python wrapper is not using the C ABI library") - if solver.version() != (0, 2, 1): + if solver.version() != (0, 2, 2): raise AssertionError("Python version mismatch") solver.initialize()