7.2 KiB
7.2 KiB
SPHLite TODO
当前目标版本:0.2.2
本文档依据 docs/v2.2_development_plan.md 拆分。0.2.2 定位为 0.2 Water 阶段后的补丁、稳定化与 0.3.0 Gas 开发前的交接版本。所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。
执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。
阶段 A:基线与版本状态
- 确认当前 git 状态并记录 0.2.2 开发起点。
- 确认 0.2.1 最终本地提交可作为 0.2.2 基线。
- 确认
docs/v2.2_development_plan.md与 01-06 号文档无范围冲突。 - 确认 0.2.2 不新增 Gas 生产求解路径。
- 确认 0.2.2 不新增 Explosive 生产算法。
- 确认 0.2.2 不新增 Solid 生产求解路径。
- 确认 0.2.2 不新增 Shell 生产求解路径。
- 确认 0.2.2 不新增真实 FEM-SPH 耦合运行。
- 确认 0.2.2 不新增几何、网格或粒子生成目录。
- 记录 0.2.2 是否作为实际补丁版本发布的初始判断。
阶段 B:版本号与发布文档
- 将核心软件版本更新或确认到
0.2.2。 - 将 CMake 项目版本更新或确认到
0.2.2。 - 更新或确认 CLI
--version的 0.2.2 期望。 - 更新或确认 Fortran smoke 测试中的版本期望。
- 更新或确认 C API 测试中的版本期望。
- 更新或确认 C++ API 测试中的版本期望。
- 更新或确认 Python debug 测试中的版本期望。
- 更新 README 中的当前版本与 0.2.2 定位说明。
- 更新
docs/09_release_history.md中的 0.2.2 条目。 - 更新
docs/11_benchmark_matrix.md中的 0.2.2 gate 记录占位。
阶段 C:文档一致性复核
- 复核 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:输入解析回归
- 复核 Abaqus 子集解析仍不追求完整 Abaqus 兼容。
- 复核可复用 Abaqus 关键词时未新增重复 SPHLite 关键词。
- 复核 unsupported-but-safe 关键词继续报 warning。
- 复核缺失必要关键词时继续报 error。
- 复核输入错误信息仍包含足够定位上下文。
- 复核
*MATERIAL, TYPE=WATER大小写兼容。 - 复核 Water material 与
*DENSITY绑定校验。 - 复核
*SECTIONmaterial 引用存在性校验。 - 复核
*SPHLITE EOS, TYPE=TAIT校验。 - 复核
*SPHLITE TIME CONTROL正值校验。
阶段 E:数据模型与邻域回归
- 复核集中型粒子数据管理未被绕开。
- 复核 Water、Gas、Explosive、Solid、Shell 共享基础粒子数据结构。
- 复核 Water 计算路径不依赖 Gas 状态变量。
- 复核 phase 改变机制不引入新的不可控相变模型。
- 复核 inactive 粒子不参与 Water 相互作用。
- 复核 failed 粒子不参与 Water 相互作用。
- 复核粒子
h(i)的独立支持仍可用。 - 复核 kernel 在
h <= 0时保持错误路径。 - 复核 neighbor 搜索在重复坐标粒子下保持稳定。
- 复核 neighbor 搜索在稀疏粒子布局下保持稳定。
阶段 F:Water 数值行为回归
- 复核 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:求解、输出与重启动
- 复核显式时间推进仍采用 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:接口与耦合边界
- 复核 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:测试门禁
- 完整配置 CMake 构建目录。
- 完整编译
sphlite_core。 - 完整编译
sphlite_c。 - 完整编译
sphlite_c_shared。 - 完整编译
sphliteCLI。 - 完整编译 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:发布决策与 0.3.0 交接
- 确认没有提交 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 变更。