# SPHLite v5.0 开发计划 文档状态:0.5.0 开发计划草案 目标软件版本:SPHLite 0.5.0 ## 1. 文档定位 本文档用于规划 SPHLite 0.5.0 版本的开发范围。0.5.0 是 `Solid` 版本线的起步版本,目标是在 0.4.1 已完成 `Water`、`Gas`、`Explosive` 最小稳定闭环的基础上,建立 3D 实体结构 SPH 粒子的输入、状态、本构、失效、显式推进、restart、接口和测试 gate。 0.5.0 不作为完整水-气-结构爆炸响应版本,也不作为 `Shell` 或 FEM-SPH 耦合版本。0.5.0 的重点是让 `Solid` 具备可独立验证的结构材料和显式动力学最小闭环,使后续 0.6 `Shell`、0.7 水-气-结构 smoke 和 0.8/0.9 耦合版本能够依赖稳定的结构粒子状态与接口。 ## 2. 依据文件 本计划依据以下文件制定: - `README.md` - `docs/01_requirements_specification.md` - `docs/02_software_architecture_design.md` - `docs/03_detailed_design.md` - `docs/04_mathematical_model_and_algorithms.md` - `docs/05_interface_control_document.md` - `docs/06_test_and_verification_plan.md` - `docs/v4.1_development_plan.md` - `docs/09_release_history.md` - `docs/10_development_roadmap.md` - `docs/11_benchmark_matrix.md` ## 3. 版本定位 ### 3.1 与 0.4.1 的关系 0.4.1 已完成 `Explosive` 稳定化: - 多点点火和多炸药 material 输入。 - 基于冻结反应质量的释放量统计。 - release balance、SOURCE/PHASE 诊断。 - Water/Gas/Explosive 混合 smoke。 - `STATE_0_4_1` restart 和 `STATE_0_4` 兼容读入。 - release balance 的 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI 和专项 gate。 - 完整 CTest、Explosive 专项 gate、source size 和 `git diff --check` 均已通过。 0.5.0 不重写 `Water`、`Gas` 或 `Explosive` 路线。0.5.0 必须保持 0.4.1 全量 gate 稳定,并在此基础上新增 `Solid` 能力。`Solid` 加入后不得改变 Water-only、Gas-only、Explosive-Gas-Water 算例的既有结果和接口语义。 ### 3.2 与 0.6.0 的关系 0.6.0 建议作为 `Shell` 版本线起点。0.5.0 不实现 Mindlin-Reissner 板壳、厚度积分、director/角速度或板壳撕裂。0.5.0 可以在 material、section、phase/status 和 restart 中保留 `Shell` 已有占位,但不得宣称已实现板壳结构响应。 ### 3.3 与耦合版本的关系 真实 FEM-SPH 接触耦合和连续体耦合仍属于后续 0.8/0.9。0.5.0 只维护 SPHLite 内部 `Solid` 粒子状态和中立 `CouplingInterface` 既有边界,不直接依赖 FEMLite,不修改 FEMLite,也不引入外部 CouplingModule 作为依赖。 ### 3.4 0.5.0 核心目标 0.5.0 的核心目标是形成 3D `Solid` 最小闭环: ```text Solid input/material/section -> Solid particle state allocation -> reference configuration and neighbor/correction state -> elastic and Johnson-Cook material-point update -> Johnson-Cook damage and progressive softening -> Solid explicit step and stable dt contribution -> Solid output/restart/API/CLI/Python diagnostics -> 0.4.1 full regression remains stable ``` ## 4. 开发原则 ### 4.1 保持 0.5 版本线边界 0.5.0 只交付 3D `Solid` 实体结构粒子的最小闭环,不进入 `Shell`、真实水-气-结构耦合、真实 FEM-SPH 耦合或工程级船舱破坏 benchmark。 ### 4.2 保持求解器定位 SPHLite 仍是求解器,不负责几何建模、网格生成或粒子生成。新增 `.inp` 样例和 Python 脚本只能作为测试/示例辅助工具,不作为求解器功能宣传。 ### 4.3 保持 Fortran 95 和集中型数据管理 核心实现继续使用 Fortran 95。`Solid` 状态应纳入集中数据库和模块级状态管理,不采用面向对象粒子类设计。C ABI、C++ wrapper、Python ctypes 和 CLI 继续作为薄接口层。 ### 4.4 保持显式动力学主流程 时间推进继续只支持 Velocity-Verlet 显式动力学。0.5.0 可新增 `Solid` 结构波速稳定时间步约束和结构内力更新,但不引入隐式求解、静力求解、非线性静力求解或隐式-显式混合接口。 ### 4.5 先材料点和小型结构闭环,再工程破坏 Johnson-Cook 材料模型和失效模型必须先通过材料点、小型均匀变形和小型结构 smoke 验收。0.5.0 不追求复杂断裂路径、碎片云、焊缝失效或工程级舱段破坏。 ### 4.6 不破坏既有接口 C ABI 必须追加式扩展。不得改变 0.4.1 已有函数的字段含义、数组长度约定或错误码语义。新增 `Solid` 诊断应优先使用新增函数和新增 CLI/Python 字段。 ## 5. 0.5.0 交付目标 0.5.0 建议交付以下内容: 1. 将软件版本更新为 `0.5.0`。 2. 保持 0.4.1 默认 gate 全部通过。 3. 新增 `TYPE=SOLID` material 输入识别和 Solid section 识别。 4. 支持 Solid material 的密度、弹性参数和 Johnson-Cook 参数读取。 5. 支持 Johnson-Cook 失效参数读取,并为渐进软化保留输入或默认策略。 6. 新增 `Solid` 模块生命周期:reset、allocate/build、advance、finalize。 7. 新增 Solid per-particle 状态数组,包括应力、应变、塑性应变、塑性应变率、温度、损伤、软化和失效状态。 8. 建立参考构型相关状态,包括参考坐标、参考体积、参考邻域或修正梯度所需矩阵。 9. 实现弹性材料点更新,作为 Johnson-Cook 调试和回归退化路径。 10. 实现 Johnson-Cook 流动应力材料点计算。 11. 实现 Johnson-Cook 损伤累积和失效判据的最小闭环。 12. 实现失效后的渐进软化,不删除粒子,使用 `PHASE_SOLID_FAILED` 和 status 表达失效。 13. 实现小型 Solid 显式推进路径,至少能处理 Solid-only 小模型的内力、体力或受控均匀变形 smoke。 14. 将 Solid 结构波速或等价稳定时间步约束纳入 `sph_estimate_stable_dt`。 15. 新增 Solid summary,包括质量、动量、动能、内能、最大应力、塑性应变范围、损伤范围和失效粒子数。 16. 在粒子 CSV 和 summary CSV 中追加 Solid 诊断字段。 17. 将 0.5.0 restart 状态版本更新为 `STATE_0_5`,保存 Solid material 表、Solid 状态和诊断。 18. 保持 `STATE_0_4_1`、`STATE_0_4` 和 `STATE_0_3_1` 等既有 restart 兼容读入,并初始化空 Solid 状态。 19. 新增 Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 的 Solid summary 查询。 20. 新增 0.5.0 Solid 专项 CTest gate,并保持 source size 受控。 21. 更新 README、06、09 和 11 号文档中的 0.5.0 测试和验收记录。 22. 不新增 FEMLite 直接依赖,不修改 SPHLite 文件夹之外的内容。 ## 6. 非交付范围 0.5.0 不交付以下内容: 1. 不实现 `Shell` Mindlin-Reissner 生产求解路径。 2. 不实现板壳厚度积分、director 更新、板壳撕裂或穿孔。 3. 不实现真实水-气-结构耦合载荷闭环。 4. 不实现爆炸载荷作用下的船体破坏工程 benchmark。 5. 不实现真实 FEM-SPH 接触耦合或连续体耦合。 6. 不实现生产级断裂面追踪、裂纹扩展、碎片云或焊缝失效库。 7. 不实现复杂接触、碰撞、摩擦或碎片-流体相互作用。 8. 不实现热传导、熔化、相变或完整热-力耦合。 9. 不实现大规模并行、GPU 后端或性能优化版本。 10. 不新增几何、网格或粒子生成能力。 ## 7. 输入范围 ### 7.1 Solid material 识别 0.5.0 应复用 Abaqus 风格 `.inp` 子集。能复用 Abaqus 关键词时不新增关键词;Abaqus 难以表达的 SPHLite 专有行为才使用 `*SPHLITE ...` 扩展。 建议最小输入形式: ```text *MATERIAL, NAME=STEEL, TYPE=SOLID *DENSITY 7850.0 *ELASTIC 210.0E9, 0.30 *PLASTIC, HARDENING=JOHNSON COOK A, B, N, C, M, EPSDOT0, TROOM, TMELT *DAMAGE INITIATION, CRITERION=JOHNSON COOK D1, D2, D3, D4, D5 *SPHLITE SOLID CONTROL, MATERIAL=STEEL, SOFTENING=LINEAR ``` 如果现有输入层更适合使用已建立的 `*SPHLITE ...` material/control 风格,0.5.0 可在实现阶段收敛语法,但必须满足: - material 可明确识别为 `Solid`。 - 密度缺失时报 error。 - 弹性参数缺失时报 error。 - Johnson-Cook 参数缺失或非法时报 error。 - Johnson-Cook 失效参数缺失时,若本算例请求失效,则报 error。 - 不影响运行的 Abaqus 未支持关键词继续 warning。 ### 7.2 Solid section 3D 实体结构粒子通过 material 识别为 `Solid`,通过 section 识别实体 section 属性。建议支持 Abaqus 风格 `*SOLID SECTION` 或既有等价 section 关键词: ```text *SOLID SECTION, ELSET=HULL_SOLID, MATERIAL=STEEL ``` set 仍只表示集合,不作为类型判断依据。`Solid` 的计算行为必须由 phase、material 和 section 共同确定。 ### 7.3 初始条件和边界 0.5.0 可复用既有粒子位置、速度、体力和时间控制输入。结构专项测试可使用: - 初始速度或体力驱动。 - 小型均匀拉伸/压缩速度场。 - 简化约束或固定粒子 status。 0.5.0 不要求实现完整边界条件库、接触边界或 FEM 驱动边界。 ## 8. Solid 状态设计 ### 8.1 模块级 material 状态 建议新增 Solid material 表,至少保存: - material id 和名称映射。 - 密度 `rho0`。 - 弹性模量 `E`。 - 泊松比 `nu`。 - 剪切模量 `G`。 - 体积模量 `K`。 - 参考声速或结构波速。 - Johnson-Cook 流动参数 `A`、`B`、`n`、`C`、`m`。 - 参考应变率 `epsdot0`。 - 室温 `Troom` 和熔化温度 `Tmelt`。 - 比热或等效温升参数。 - Taylor-Quinney 系数或等效塑性功转温升系数。 - Johnson-Cook 失效参数 `D1` 到 `D5`。 - 软化模型类型和软化参数。 ### 8.2 每粒子 Solid 状态 建议第一阶段保存: ```fortran real(rk), allocatable :: solid_stress(:,:) real(rk), allocatable :: solid_strain(:,:) real(rk), allocatable :: solid_plastic_strain(:) real(rk), allocatable :: solid_plastic_strain_rate(:) real(rk), allocatable :: solid_temperature(:) real(rk), allocatable :: solid_damage(:) real(rk), allocatable :: solid_softening(:) real(rk), allocatable :: solid_internal_energy(:) real(rk), allocatable :: solid_deformation_gradient(:,:,:) real(rk), allocatable :: solid_correction_matrix(:,:,:) integer, allocatable :: solid_failure_status(:) ``` 其中: - `solid_stress(6,npart)` 使用 Voigt 顺序,建议为 `xx, yy, zz, xy, yz, zx`。 - `solid_strain(6,npart)` 保存可恢复的总应变或等价应变状态。 - `solid_deformation_gradient(3,3,npart)` 保存变形梯度或等价 Total Lagrangian 状态。 - `solid_correction_matrix(3,3,npart)` 保存参考构型梯度修正或其占位。 - `solid_damage(i)` 范围为 `[0,1]`。 - `solid_softening(i)` 表示承载能力折减因子,范围为 `[0,1]`。 - `solid_failure_status(i)` 表达未失效、软化中、已失效等状态。 如果实现阶段为了保持 Fortran 95 和 source size 控制而拆分数组,语义必须保持可恢复、可诊断和可测试。 ### 8.3 phase 和 status 0.5.0 应使用已规划的 phase/status: - active Solid 粒子:`PHASE_SOLID`。 - 失效 Solid 粒子:`PHASE_SOLID_FAILED`。 - 失效不删除粒子。 - phase/status 改变是不可逆历史过程。 失效粒子在 0.5.0 中可以继续保留质量、动量和输出状态。其后续接触、碎片或流体相互作用留给后续版本。 ## 9. 本构与失效模型 ### 9.1 弹性退化路径 0.5.0 应先实现弹性退化路径,用于材料点和 Solid-only smoke: - 读取 `E` 和 `nu`。 - 计算 `G`、`K` 或 Lamé 参数。 - 由应变增量更新 Cauchy 应力或等价应力。 - 输出应力、应变、内能和稳定时间步诊断。 弹性路径是调试和回归工具,不替代 Johnson-Cook 主路线。 ### 9.2 Johnson-Cook 流动应力 Johnson-Cook 流动应力建议采用: ```text sigma_y = (A + B * eps_p^n) * (1 + C * ln(epsdot_p / epsdot0)) * (1 - Tstar^m) ``` 其中: ```text Tstar = clamp((T - Troom) / (Tmelt - Troom), 0, 1) ``` 0.5.0 可允许等温退化测试,此时 `T = Troom`,热软化项为 1。即使第一版采用等温退化,数据库和 restart 仍必须保存温度状态。 ### 9.3 塑性更新 0.5.0 建议采用小步显式返回映射或等价稳定的材料点更新: - 计算试应力。 - 计算 von Mises 等效应力。 - 判断屈服。 - 更新等效塑性应变和等效塑性应变率。 - 更新应力和塑性功。 - 更新温度或等效温升占位。 第一版测试应覆盖弹性区、屈服后硬化区和应变率项。 ### 9.4 Johnson-Cook 失效 Johnson-Cook 损伤累积建议采用: ```text D = D + delta_eps_p / eps_f ``` 失效应变 `eps_f` 由 Johnson-Cook 失效参数、应力三轴度、应变率和温度项计算。0.5.0 可先实现最小可测路径: - 对单轴拉伸或给定三轴度材料点计算 `eps_f`。 - 损伤 `D` 单调增加。 - `D >= 1` 时进入失效或软化状态。 - 非法 `eps_f <= 0` 或非有限值时报 error 或受控保护。 ### 9.5 渐进软化 失效后采用渐进软化,不瞬时删除粒子。0.5.0 建议第一版使用线性软化: ```text softening = max(0, 1 - (D - 1) / softening_width) effective_stress = softening * stress ``` 具体公式可在实现阶段微调,但必须满足: - 软化因子单调不增。 - 软化因子限制在 `[0,1]`。 - 失效状态不可逆。 - 输出和 restart 可恢复软化状态。 ## 10. Solid SPH 算法范围 ### 10.1 Total/Corrected Lagrangian 路线 0.5.0 应沿用 04 号文档的 Total Lagrangian / corrected Lagrangian SPH 路线。建议第一版至少建立: - 参考邻域或参考构型权重。 - 梯度修正矩阵或其稳定占位。 - 变形梯度或速度梯度计算入口。 - 内力和能量诊断入口。 如果第一版完整 TL-SPH 内力实现风险过大,可以采用小型、受控的 corrected gradient smoke 作为最小闭环,但必须保留状态和测试边界,避免文档宣称工程级结构响应。 ### 10.2 Solid 显式步 0.5.0 的显式步建议顺序: ```text Velocity-Verlet predictor Water/Gas/Explosive updates when active Solid kinematic gradient update Solid constitutive update Solid internal force and acceleration contribution External body force contribution Velocity-Verlet corrector Diagnostics/output/restart hooks ``` Water-only、Gas-only、Explosive-only 算例不应进入 Solid 更新路径。Solid-only 算例应可在无 Water/Gas/Explosive 输入时单独推进。 ### 10.3 Solid 稳定时间步 Solid 结构波速约束建议为: ```text dt_solid = cfl * h / (c_solid + |v|) ``` 其中 `c_solid` 可由弹性参数估计。0.5.0 gate 应验证: - 无 Solid 粒子时不影响既有 dt。 - Solid 粒子存在时 dt 为有限正值。 - 不同材料参数可改变 Solid dt 限制。 ### 10.4 Solid 诊断 Solid summary 建议包括: - active Solid 粒子数。 - failed Solid 粒子数。 - Solid 总质量。 - Solid 总动量。 - Solid 动能。 - Solid 内能。 - 最大 von Mises 应力。 - 等效塑性应变最小值和最大值。 - 损伤最小值和最大值。 - 最小 softening 因子。 - Solid dt 限制。 ## 11. API、C ABI、C++、Python 和 CLI ### 11.1 Fortran API 建议新增: - `sph_get_solid_summary` - `sph_get_solid_material_summary` - `sph_get_solid_state` - `sph_solid_get_failure_counts` 若实现阶段认为完整 state 查询会导致接口过大,0.5.0 可先交付 summary 和 failure counts,粒子级详细状态通过 CSV 和 restart 验收。 ### 11.2 C ABI C ABI 应保持追加式扩展。建议新增: ```c int sphlite_get_solid_summary(int *active_count, int *failed_count, double *mass, double *momentum, double *energy_values, double *stress_values, double *damage_values); ``` 建议字段: - `momentum[0..2]`:Solid 总动量。 - `energy_values[0]`:动能。 - `energy_values[1]`:内能。 - `stress_values[0]`:最大 von Mises 应力。 - `stress_values[1]`:最大压力或平均等效应力。 - `damage_values[0]`:最小 damage。 - `damage_values[1]`:最大 damage。 - `damage_values[2]`:最小 softening。 所有输出数组由调用方分配。空指针、非正容量或未初始化状态必须走既有错误路径。 ### 11.3 C++ wrapper 和 Python ctypes C++ 和 Python 继续做 C ABI 薄包装,不重新定义 Solid 物理语义。Python checker 应覆盖: - Solid material inspect。 - Solid summary 查询。 - Solid run 后 damage/stress 字段。 - Solid restart 读回后的 summary 一致性。 ### 11.4 CLI CLI inspect/run 应追加 Solid 字段: - `solid_active_particles` - `solid_failed_particles` - `solid_mass` - `solid_max_von_mises` - `solid_plastic_strain_max` - `solid_damage_max` - `solid_dt_limit` CLI 测试应覆盖: - Solid 输入 inspect。 - Solid-only 小模型 run。 - Solid 错误输入。 - Solid restart 读回 inspect 或 run。 ## 12. 输出和 Restart ### 12.1 CSV 输出 0.5.0 建议在 summary CSV 中追加 Solid 字段: - `solid_active_particles` - `solid_failed_particles` - `solid_mass` - `solid_momentum_x` - `solid_momentum_y` - `solid_momentum_z` - `solid_kinetic_energy` - `solid_internal_energy` - `solid_max_von_mises` - `solid_plastic_strain_min` - `solid_plastic_strain_max` - `solid_damage_min` - `solid_damage_max` - `solid_softening_min` - `solid_dt_limit` 粒子 CSV 可追加: - `solid_stress_xx` - `solid_stress_yy` - `solid_stress_zz` - `solid_stress_xy` - `solid_stress_yz` - `solid_stress_zx` - `solid_plastic_strain` - `solid_damage` - `solid_softening` - `solid_failure_status` 如果粒子 CSV 字段过多,0.5.0 可先输出关键字段,并通过 restart/module test 覆盖完整内部状态。 ### 12.2 Restart 0.5.0 restart 建议写入 `STATE_0_5`。必须保存: - 粒子通用状态。 - Velocity-Verlet 所需 `v`、`a`、`vhalf`。 - Water、Gas、Explosive 既有状态。 - Solid material 表。 - Solid per-particle 状态。 - Solid 诊断和 dt 状态。 - 未来 Shell/CouplingInterface 已有占位状态。 兼容读入: - `STATE_0_5`:完整读回。 - `STATE_0_4_1`:初始化空 Solid 状态。 - `STATE_0_4`:初始化空 Solid 状态,并保持 Explosive 兼容读入。 - `STATE_0_3_1` 及更早可支持状态:初始化空 Solid 状态。 restart 后继续显式步不得重复初始化 Solid 应力、塑性应变、损伤或失败状态。 ## 13. 测试计划 ### 13.1 新增 0.5.0 测试 建议新增以下测试: - `input_solid_material`:Solid material、elastic、Johnson-Cook 和 Solid section 输入。 - `input_solid_errors`:缺密度、缺弹性参数、非法 Johnson-Cook 参数、非法 section。 - `solid_state_build`:Solid 状态分配、phase/material/section 识别和默认值。 - `solid_elastic_material`:弹性材料点应力更新。 - `solid_johnson_cook_flow`:Johnson-Cook 流动应力、硬化、应变率项和热项退化。 - `solid_johnson_cook_failure`:Johnson-Cook 损伤累积和失效阈值。 - `solid_progressive_softening`:失效后软化单调、不可逆且不删除粒子。 - `solid_gradient_correction`:参考构型梯度修正或等价占位状态可构建。 - `solid_stable_dt`:Solid 结构波速 dt 约束。 - `solid_explicit_smoke`:Solid-only 小模型可显式推进。 - `solid_output`:summary CSV 和粒子 CSV 的 Solid 字段。 - `solid_restart_050`:`STATE_0_5` 写入读回并继续显式步。 - `solid_restart_041_compat`:`STATE_0_4_1` 兼容读入并初始化空 Solid 状态。 - `solid_c_api`:C ABI Solid summary 查询和错误路径。 - `solid_python`:Python ctypes Solid summary 和 run/inspect 字段。 - `solid_cli`:CLI inspect/run 输出 Solid 字段。 - `solid_source_size`:Solid 模块 source size 和 stale exception 检查。 ### 13.2 既有回归测试 0.5.0 必须继续通过 0.4.1 完整 gate,包括: - Water gate。 - Gas gate。 - Explosive 0.4.0 gate。 - Explosive 0.4.1 gate。 - output/restart gate。 - C API/C++/Python/CLI gate。 - source size gate。 ### 13.3 建议 0.5.0 Release Gate 建议 0.5.0 默认 gate 为: ```powershell cmake --build build-codex-unix --parallel ctest --test-dir build-codex-unix --output-on-failure ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure git diff --check ``` ## 14. 建议开发阶段 若后续根据本计划生成 `todo.md`,建议按以下阶段拆分: 1. 0.5.0 版本号和 0.4.1 发布基线确认。 2. Solid 输入样例和错误输入样例准备。 3. Solid material/section 输入解析。 4. Solid material 表和 Johnson-Cook 参数存储。 5. Solid per-particle 状态数组和生命周期。 6. Solid phase/status 默认值和失效状态枚举复核。 7. 弹性材料点更新和单测。 8. Johnson-Cook 流动应力材料点和单测。 9. Johnson-Cook 损伤/失效材料点和单测。 10. 渐进软化状态和单测。 11. 参考构型、梯度修正或等价 TL-SPH 状态构建。 12. Solid 内力/体力/显式推进最小 smoke。 13. Solid 稳定时间步估计。 14. Solid summary 和 diagnostics。 15. summary CSV 和粒子 CSV 字段扩展。 16. `STATE_0_5` restart 写入。 17. `STATE_0_5` restart 读回。 18. `STATE_0_4_1` 和更早 restart 兼容读入。 19. Fortran API 和 C ABI 追加接口。 20. C++ wrapper、Python ctypes 和 CLI 扩展。 21. source size 复核和必要拆分。 22. 0.4.1 全量回归和 0.5.0 新增 gate。 23. README、06、09 和 11 号文档同步。 ## 15. 验收标准 0.5.0 应满足以下验收标准: 1. 软件版本为 `0.5.0`。 2. 0.4.1 release gate 继续通过。 3. Solid material 和 Solid section 可从 `.inp` 明确识别。 4. 密度、弹性参数、Johnson-Cook 参数和失效参数校验路径清晰。 5. Solid 状态可分配、初始化、清理和重复 build。 6. 弹性材料点测试通过。 7. Johnson-Cook 流动应力测试覆盖硬化、应变率项和热项退化。 8. Johnson-Cook 损伤单调累积,并在达到阈值后触发失效状态。 9. 渐进软化单调、不可逆,且不删除粒子。 10. Solid-only 小模型可执行 Velocity-Verlet 显式推进。 11. Solid 结构波速 dt 约束为有限正值,并可进入全局 dt 估计。 12. Solid summary、CSV output、Fortran API、C ABI、C++ wrapper、Python ctypes 和 CLI 字段可用。 13. `STATE_0_5` restart 可恢复 Solid 状态并继续显式步。 14. `STATE_0_4_1` restart 可兼容读入,并初始化空 Solid 状态。 15. 默认 gate、0.5.0 Solid 专项 gate、source size 和 `git diff --check` 通过。 16. 文档不宣称 0.5.0 已实现 Shell、真实水-气-结构爆炸响应、真实 FEM-SPH 耦合或工程级结构破坏 benchmark。 17. 不新增 FEMLite 直接依赖。 18. 不修改 SPHLite 文件夹之外的内容。 ## 16. 风险与控制 | 风险 | 表现 | 控制方式 | | --- | --- | --- | | 0.5.0 范围膨胀 | 试图同时实现 Shell、水-气-结构工程爆炸或 FEM-SPH 耦合 | 限定为 Solid 最小闭环和 Solid-only gate | | Johnson-Cook 参数语义不稳 | 输入字段顺序、单位或温度项解释不清 | 使用明确输入样例和材料点测试锁定语义 | | TL-SPH 内力实现过大 | 一次性实现完整结构算法导致 source size 和测试风险 | 先材料点、梯度状态和小型 smoke,逐步扩大 | | 失效处理破坏质量守恒 | 删除粒子或改变粒子质量导致诊断跳变 | 失效不删除粒子,仅 phase/status 和 softening 改变 | | Solid 更新影响既有算例 | 无 Solid 输入时仍进入 Solid 路径 | 无 active Solid 时直接跳过,并保持 0.4.1 全量回归 | | API 兼容破坏 | 修改已有 summary 字段或数组约定 | 新增 Solid API,不改变 0.4.1 接口含义 | | restart 不完整 | 读回后应力、塑性、损伤或 softening 丢失 | `STATE_0_5` 保存完整 Solid 模块级状态 | | source size 债务扩大 | Solid 本构、状态和 restart 堆入单个大文件 | 按 state/material/reaction 或 state/material/solid/restart/helper 拆分 | ## 17. 0.6.0 启动条件 满足以下条件后,可以启动 0.6.0 `Shell`: 1. 0.5.0 Solid material、Johnson-Cook 和失效材料点 gate 稳定。 2. Solid 状态、output、restart、API、CLI 和 Python 诊断稳定。 3. Solid-only 显式 smoke 可重复通过。 4. 0.4.1 Water/Gas/Explosive gate 仍可重复通过。 5. 0.5.0 文档明确尚未实现 Shell、真实 FEM-SPH 耦合和工程级水下爆炸结构破坏 benchmark。