# SPHLite TODO 当前目标版本:0.7.0 本文档面向用户指定的 `docs/v7.0_development_plan.md`。当前仓库中暂未检出该计划文件;待 `docs/v7.0_development_plan.md` 补入后,应先复核本文档。本清单暂按已发布的 0.6.1、01-06 号文档、`docs/v6.1_development_plan.md` 中的 0.7.0 后续路线拆分。0.7.0 暂定位为水-气-结构局部爆炸 smoke 起点,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。 所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.7.0 不交付真实工程级水下接触爆炸响应,不交付真实 FEM-SPH 接触耦合或连续体耦合,不交付工程级船舱破坏 benchmark,不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。 执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。 ## 阶段 A:版本基线、范围声明与 0.7.0 样例 - [x] 确认当前 git 状态并记录已有未提交内容。 - [x] 确认 `v0.6.1` 标签和远端发布提交可作为 0.7.0 开发基线。 - [x] 复核 `docs/v7.0_development_plan.md` 是否已补入仓库。 - [x] 若 `docs/v7.0_development_plan.md` 缺失,在 todo 顶部保留复核提示。 - [x] 将核心软件版本更新为 `0.7.0`。 - [x] 将 CMake 项目版本更新为 `0.7.0`。 - [x] 更新 Fortran smoke 测试中的版本期望。 - [x] 更新 C API 测试中的版本期望。 - [x] 更新 C++ API 测试中的版本期望。 - [x] 更新 Python debug 测试中的版本期望。 - [x] 更新 CLI `--version` 和 inspect 版本期望。 - [x] 在 README 中记录 0.7.0 水-气-结构局部爆炸 smoke 定位。 - [x] 在 README 中明确 0.7.0 不交付工程级爆炸响应。 - [x] 在 README 中明确 0.7.0 不交付真实 FEM-SPH 耦合。 - [x] 创建 Water/Gas/Explosive/Solid 最小混合输入样例。 - [x] 创建 Water/Gas/Explosive/Shell 最小混合输入样例。 - [x] 创建 Water/Gas/Explosive/Solid/Shell 混合输入样例。 - [x] 创建无结构粒子的局部爆炸 smoke 输入样例。 - [x] 创建无水粒子的 Gas/Explosive/Structure 错误或 warning 样例。 - [x] 创建无 Gas product material 的 Explosive 错误输入样例。 - [x] 创建结构载荷目标 set 缺失错误输入样例。 - [x] 创建结构载荷半径非法错误输入样例。 - [x] 创建结构载荷比例系数非有限错误输入样例。 - [x] 创建 Shell-only 受控爆炸载荷诊断样例。 - [x] 创建 Solid-only 受控爆炸载荷诊断样例。 - [x] 创建 Solid/Shell 混合载荷隔离样例。 - [x] 运行 0.6.1 完整 gate 并记录基线结果。 - [x] 准备阶段 A 本地提交说明。 ## 阶段 B:0.7.0 输入控制、结构目标和局部爆炸区域 - [x] 设计 0.7.0 局部爆炸 smoke 的输入关键词边界。 - [x] 优先复用既有 Abaqus 子集表达材料、section、set 和 element 信息。 - [x] 定义 SPHLite 调试扩展关键词的最小集合。 - [x] 设计局部爆炸区域名称、中心和半径字段。 - [x] 设计结构载荷目标 set 或 elset 字段。 - [x] 设计结构载荷源 phase 过滤字段。 - [x] 设计结构载荷目标 phase 过滤字段。 - [x] 设计压力载荷比例系数字段。 - [x] 设计冲量或时间窗口控制字段。 - [x] 设计载荷投影模式字段。 - [x] 设计 Solid 和 Shell 目标共用的输入约定。 - [x] 支持读取局部爆炸区域控制参数。 - [x] 支持读取结构载荷目标集合名称。 - [x] 支持读取源相过滤参数。 - [x] 支持读取目标相过滤参数。 - [x] 支持读取载荷比例系数。 - [x] 支持读取载荷时间窗口。 - [x] 支持读取载荷投影模式。 - [x] 校验局部爆炸区域半径为正有限值。 - [x] 校验载荷比例系数为有限值。 - [x] 校验时间窗口为非负有限值。 - [x] 校验源 phase 名称合法。 - [x] 校验目标 phase 名称合法。 - [x] 校验目标 set 存在。 - [x] 对未被使用的局部爆炸控制项报 warning。 - [x] 对 active 结构粒子缺失载荷控制保持 no-op。 - [x] 新增 `input_blast_region` 测试。 - [x] 新增 `input_blast_errors` 测试。 - [x] 将输入控制测试接入 CTest。 - [x] 准备阶段 B 本地提交说明。 ## 阶段 C:局部爆炸源项快照和载荷候选筛选 - [x] 设计局部爆炸源项快照数据结构。 - [x] 设计源粒子到结构粒子的邻域筛选规则。 - [x] 设计载荷候选计数诊断。 - [x] 设计载荷源相质量诊断。 - [x] 设计载荷源相能量诊断。 - [x] 设计载荷源相平均压力诊断。 - [x] 设计局部爆炸区域内 Gas 体积诊断。 - [x] 设计局部爆炸区域内 Explosive 反应进度诊断。 - [x] 设计局部爆炸区域内 Water 压力范围诊断。 - [x] 设计局部爆炸区域内结构目标数量诊断。 - [x] 在显式步前刷新 Water 压力快照。 - [x] 在显式步前刷新 Gas 压力快照。 - [x] 在 Explosive 更新后刷新 Gas 源项贡献快照。 - [x] 在载荷构造前刷新结构目标 active 状态。 - [x] 对非 active 源粒子执行跳过规则。 - [x] 对 failed 结构粒子执行受控跳过或保留规则。 - [x] 对非目标 set 结构粒子执行跳过规则。 - [x] 对局部爆炸区域外源粒子执行跳过规则。 - [x] 对局部爆炸区域外目标粒子执行跳过规则。 - [x] 确认无源粒子时返回安全默认诊断。 - [x] 确认无目标粒子时返回安全默认诊断。 - [x] 确认 Water-only 模型不进入结构载荷路径。 - [x] 确认 Gas-only 模型不进入结构载荷路径。 - [x] 确认 Explosive-only 模型不进入结构载荷路径。 - [x] 确认 Solid-only 模型不读取 Gas 源项。 - [x] 确认 Shell-only 模型不读取 Gas 源项。 - [x] 新增 `blast_source_snapshot` 测试。 - [x] 新增 `blast_target_filter` 测试。 - [x] 将源项快照测试接入 CTest。 - [x] 准备阶段 C 本地提交说明。 ## 阶段 D:结构外载荷缓存、投影和守恒诊断 - [x] 设计结构外载荷缓存数组布局。 - [x] 设计 Solid 外载荷缓存字段。 - [x] 设计 Shell 外载荷缓存字段。 - [x] 设计载荷投影的方向约定。 - [x] 设计载荷投影的权重归一化约定。 - [x] 设计压力到力的面积或体积尺度约定。 - [x] 设计载荷做功诊断。 - [x] 设计载荷冲量诊断。 - [x] 设计载荷动量输入诊断。 - [x] 设计载荷能量输入诊断。 - [x] 初始化结构外载荷缓存默认值。 - [x] 在每个显式步开始前清零结构外载荷缓存。 - [x] 将局部 Water 压力贡献映射到候选结构目标。 - [x] 将局部 Gas 压力贡献映射到候选结构目标。 - [x] 将 Explosive release 诊断贡献映射到载荷统计。 - [x] 对 Solid 目标累加外力贡献。 - [x] 对 Shell 目标累加外力贡献。 - [x] 对 Shell 目标累加等效外力矩占位诊断。 - [x] 对权重和为零的候选对报 warning 或跳过。 - [x] 检查外载荷有限性。 - [x] 检查外载荷缓存不污染 Water 粒子。 - [x] 检查外载荷缓存不污染 Gas 粒子。 - [x] 检查外载荷缓存不污染 Explosive 粒子。 - [x] 检查 Solid/Shell 目标之间载荷隔离。 - [x] 检查无 active 结构目标时载荷统计为零。 - [x] 检查无局部爆炸源时载荷统计为零。 - [x] 新增 `blast_load_accumulator` 测试。 - [x] 新增 `blast_load_conservation` 测试。 - [x] 将结构外载荷测试接入 CTest。 - [x] 准备阶段 D 本地提交说明。 ## 阶段 E:显式推进接入、Solid/Shell 响应和隔离规则 - [ ] 设计局部爆炸载荷在 Velocity-Verlet 中的调用顺序。 - [ ] 确认 Explosive 更新早于爆炸载荷投影。 - [ ] 确认 Gas 源项应用早于结构载荷诊断。 - [ ] 确认 Water/Gas 压力更新早于结构载荷投影。 - [ ] 将 Solid 外载荷并入 Solid 加速度或外力入口。 - [ ] 将 Shell 外载荷并入 Shell 受控外力入口。 - [ ] 对尚未完成的 Shell 内力路径保持受控 no-op 或诊断占位。 - [ ] 确认 Shell 外载荷不宣称完整 Shell 动力学闭环。 - [ ] 确认 Solid 外载荷不改变既有 Solid-only gate 结果。 - [ ] 确认 Shell 外载荷不改变既有 Shell 运动学 gate 结果。 - [ ] 确认 Water-only 显式步结果保持稳定。 - [ ] 确认 Gas-only 显式步结果保持稳定。 - [ ] 确认 Explosive-Gas 显式步结果保持稳定。 - [ ] 确认 Solid-only 显式步结果保持稳定。 - [ ] 确认无载荷控制时完整显式步行为不变。 - [ ] 添加局部爆炸载荷启用开关。 - [ ] 添加局部爆炸载荷禁用路径测试。 - [ ] 添加单步载荷施加测试。 - [ ] 添加多步载荷累积测试。 - [ ] 添加载荷时间窗口结束后清零测试。 - [ ] 添加结构加速度方向检查测试。 - [ ] 添加 Shell director 不被外载荷路径非法修改的测试。 - [ ] 添加 failed Solid 目标处理测试。 - [ ] 添加 failed Shell 目标处理测试。 - [ ] 新增 `blast_solver_order` 测试。 - [ ] 新增 `blast_solid_response` 测试。 - [ ] 新增 `blast_shell_response` 测试。 - [ ] 新增 `blast_noop_regression` 测试。 - [ ] 将显式推进接入测试接入 CTest。 - [ ] 准备阶段 E 本地提交说明。 ## 阶段 F:诊断、输出、restart 占位和公开接口边界 - [ ] 设计 0.7.0 局部爆炸 summary 诊断结构。 - [ ] 记录局部爆炸区域 active 源粒子数。 - [ ] 记录局部爆炸区域 active 目标粒子数。 - [ ] 记录 Water 压力贡献统计。 - [ ] 记录 Gas 压力贡献统计。 - [ ] 记录 Explosive release 贡献统计。 - [ ] 记录 Solid 接收总载荷。 - [ ] 记录 Shell 接收总载荷。 - [ ] 记录结构载荷总冲量。 - [ ] 记录结构载荷总做功。 - [ ] 记录结构载荷最大粒子力。 - [ ] 记录结构载荷最大粒子加速度贡献。 - [ ] 记录被跳过源粒子数量。 - [ ] 记录被跳过目标粒子数量。 - [ ] 设计 summary CSV 的 0.7.0 调试字段。 - [ ] 将局部爆炸 summary 写入 summary CSV。 - [ ] 设计粒子 CSV 的 0.7.0 调试字段。 - [ ] 将结构外载荷字段写入粒子 CSV。 - [ ] 确认默认输出不开启时不生成临时结果。 - [ ] 设计 restart 中 0.7.0 状态边界。 - [ ] 明确 0.7.0 是否写入正式 `STATE_0_7`。 - [ ] 若写入 restart,保存局部爆炸控制和诊断状态。 - [ ] 若不写入 restart,在文档中明确为非交付范围。 - [ ] 保持 0.6.1 restart 兼容读入路径稳定。 - [ ] 设计 Fortran 内部诊断查询入口。 - [ ] 明确 C ABI 是否暴露 0.7.0 调试字段。 - [ ] 若暴露 C ABI,补齐小容量和空指针错误路径。 - [ ] 若不暴露 C ABI,在文档中明确为非交付范围。 - [ ] 新增 `blast_summary` 测试。 - [ ] 新增 `blast_output` 测试。 - [ ] 新增 `blast_restart_boundary` 测试。 - [ ] 将诊断输出测试接入 CTest。 - [ ] 准备阶段 F 本地提交说明。 ## 阶段 G:局部爆炸 smoke、回归 gate 和文档发布准备 - [ ] 设计 0.7.0 局部爆炸 smoke 的最小物理链路。 - [ ] 设计 Water/Gas/Explosive/Solid smoke 验收指标。 - [ ] 设计 Water/Gas/Explosive/Shell smoke 验收指标。 - [ ] 设计 Water/Gas/Explosive/Solid/Shell smoke 验收指标。 - [ ] 实现单步局部爆炸 smoke 测试。 - [ ] 实现多步局部爆炸 smoke 测试。 - [ ] 检查 smoke 中 Gas 体积或压力统计方向。 - [ ] 检查 smoke 中 Explosive 反应进度单调性。 - [ ] 检查 smoke 中 Solid/Shell 载荷方向。 - [ ] 检查 smoke 中载荷冲量非负或受控。 - [ ] 检查 smoke 中能量诊断有限性。 - [ ] 检查 smoke 中所有粒子状态有限性。 - [ ] 运行 Water 回归 gate。 - [ ] 运行 Gas 回归 gate。 - [ ] 运行 Explosive 回归 gate。 - [ ] 运行 Solid 回归 gate。 - [ ] 运行 Shell 0.6.1 回归 gate。 - [ ] 运行 CouplingInterface 回归 gate。 - [ ] 运行 output 回归 gate。 - [ ] 运行 restart 回归 gate。 - [ ] 运行完整 CTest。 - [ ] 运行 0.7.0 局部爆炸专项 gate。 - [ ] 运行 source size 相关 gate。 - [ ] 运行 `git diff --check`。 - [ ] 更新 README 中 0.7.0 当前状态和不交付范围。 - [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.0 release gate。 - [ ] 更新 `docs/09_release_history.md` 的 0.7.0 本地验收记录。 - [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.7.0 gate 矩阵。 - [ ] 确认文档不宣称工程级水下接触爆炸响应。 - [ ] 确认文档不宣称真实 FEM-SPH 联合运行。 - [ ] 确认文档不宣称完整舱段破坏 benchmark。 - [ ] 确认输出目录、CSV、VTK、restart 和临时结果未提交。 - [ ] 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。 - [ ] 准备 0.7.0 发布提交说明。