# 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:基线与版本状态 - [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:版本号与发布文档 - [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:文档一致性复核 - [ ] 复核 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` 绑定校验。 - [ ] 复核 `*SECTION` material 引用存在性校验。 - [ ] 复核 `*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`。 - [ ] 完整编译 `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:发布决策与 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 变更。