From 11c904bbb8f0f5a392f4485c87a29f65970d0d2c Mon Sep 17 00:00:00 2001 From: Codex Date: Sun, 5 Jul 2026 20:41:40 +0800 Subject: [PATCH] Merge external solver follow-up suggestions --- femlite_suggests.md | 48 ++++++++++++++++++++++++++++++++++++++++++++- sphlite_suggests.md | 45 +++++++++++++++++++++++++++++++++++++++++- 2 files changed, 91 insertions(+), 2 deletions(-) diff --git a/femlite_suggests.md b/femlite_suggests.md index 76950f7..4b78100 100644 --- a/femlite_suggests.md +++ b/femlite_suggests.md @@ -494,7 +494,53 @@ femlite_cclite_load_report.csv 4. tie/release 支持; 5. rollback/强耦合预留。 -# 13. 总结 +# 13. 当前补充建议:真实 worker 接入闭环 + +根据 CCLite 0.1.9 对当前本地 FEMLite 的审计结果,FEMLite 已提供自运行的 CCLite worker mock,但尚未完整接受 CCLite 标准 IPC worker 参数,也尚未作为真实 Windows shared memory / named event worker 运行。建议当前保留已有 mock 能力,同时把重点收敛到真实 IPC worker adapter。 + +近期建议按以下顺序推进: + +1. 完整支持 CCLite 标准 worker 参数: + +```text +femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 30000 +``` + +2. 保留现有 worker mock 参数和测试,但在日志、能力输出和文档中明确区分 `worker mock` 与 `real IPC worker`。 +3. 实现真实 IPC worker 主循环,能够打开 CCLite 创建的 command block、data block、command event 和 done event。 +4. worker 启动后应进入 `READY`,每条命令执行后回写 `ack_seq`、`worker_state`、`error_code` 和短消息。 +5. worker 只负责 wait/signal,不负责 reset CCLite 创建的 event。 +6. 优先闭合 `FEM_TO_CCL_FACET`,先支持空 facet、固定 facet,再支持由真实 surface 生成的 facet。 +7. 优先闭合 `CCL_TO_FEM_LOAD`,先支持空 load block,再支持节点力、facet pressure 预留字段和诊断字段导入。 +8. 对所有导出 facet 检查节点数、节点 id、面积、法向、厚度、坐标和速度有限值;退化 facet 应设置 invalid flag 并进入诊断。 +9. 对所有导入 load record 检查节点 id、facet id、有限值、`step_id` 和 `valid_flags`;无法匹配的 record 应拒绝并输出计数。 +10. 增加 CCLite 能力查询入口,建议命令为: + +```text +femlite.exe --cclite-capabilities +``` + +建议输出至少包含: + +```text +solver=FEMLite +cclite_worker=yes +worker_mock=yes/no +ipc_backend=windows_shmem_named_event +command_block_version=1 +data_layout=AOR_V1 +supports_real_ipc=yes/no +supports_fem_to_ccl_facet=yes/no +supports_ccl_to_fem_load=yes/no +max_facet_records=... +max_load_records=... +``` + +11. 增加 FEMLite 侧 self-test 或 smoke case,能够在没有 SPHLite 的情况下验证:worker 启动、IPC attach、`READY`、空 facet 导出、空 load 导入、`STOP` 正常退出。 +12. 与 CCLite 联调时先验收三类路径:`mock SPH + 真实 FEMLite` 的 1 step 空耦合、`mock SPH + 真实 FEMLite` 的 100 step 空耦合、异常输入/超时可控退出。 +13. 在上述闭环完成前,不建议把 FEMLite worker mock 通过视为真实耦合接入完成。 + +# 14. 总结 FEMLite 配合 CCLite 的关键不是重写 FEMLite 接触算法,而是提供稳定的外部边界数据和外部载荷通道。 diff --git a/sphlite_suggests.md b/sphlite_suggests.md index 49a8c67..1b1c436 100644 --- a/sphlite_suggests.md +++ b/sphlite_suggests.md @@ -528,7 +528,50 @@ sphlite_cclite_force_report.csv 5. Riemann FSI EOS 信息; 6. rollback/强耦合预留。 -# 15. 总结 +# 15. 当前补充建议:真实 worker 接入闭环 + +根据 CCLite 0.1.9 对当前本地 SPHLite 的审计结果,SPHLite 已能识别 CCLite worker 启动参数,但真实 Windows shared memory / named event IPC worker 尚未闭合。建议当前不要继续扩散新物理算法需求,先把 SPHLite 与 CCLite 的真实 worker 接入做成可重复验收的最小闭环。 + +近期建议按以下顺序推进: + +1. 完整支持 CCLite 标准 worker 参数: + +```text +sphlite.exe --cclite-worker --solver-id SPH --case sphlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 30000 +``` + +2. 实现真实 IPC worker 主循环,能够打开 CCLite 创建的 command block、data block、command event 和 done event。 +3. worker 启动后应进入 `READY`,每条命令执行后回写 `ack_seq`、`worker_state`、`error_code` 和短消息。 +4. worker 只负责 wait/signal,不负责 reset CCLite 创建的 event。 +5. 优先闭合 `SPH_TO_CCL_PARTICLE`,先支持空粒子、固定粒子,再支持真实 coupling region 粒子导出。 +6. 优先闭合 `CCL_TO_SPH_FORCE`,先支持空 force block,再支持粒子力、接触状态和诊断字段导入。 +7. 对所有导出粒子检查有限值、有效半径、有效质量、有效状态和有效 id;不合格粒子应计入诊断,不应静默写入。 +8. 对所有导入 force record 检查粒子 id、`internal_index`、有限值、`step_id` 和 `valid_flags`;无法匹配的 record 应拒绝并输出计数。 +9. 增加 CCLite 能力查询入口,建议命令为: + +```text +sphlite.exe --cclite-capabilities +``` + +建议输出至少包含: + +```text +solver=SPHLite +cclite_worker=yes +ipc_backend=windows_shmem_named_event +command_block_version=1 +data_layout=AOR_V1 +supports_real_ipc=yes/no +supports_sph_to_ccl_particle=yes/no +supports_ccl_to_sph_force=yes/no +max_particle_records=... +``` + +10. 增加 SPHLite 侧 self-test 或 smoke case,能够在没有 FEMLite 的情况下验证:worker 启动、IPC attach、`READY`、空粒子导出、空 force 导入、`STOP` 正常退出。 +11. 与 CCLite 联调时先验收三类路径:`真实 SPHLite + mock FEM` 的 1 step 空耦合、`真实 SPHLite + mock FEM` 的 100 step 空耦合、异常输入/超时可控退出。 +12. 在上述闭环完成前,不建议把 SPHLite worker mock 或参数识别视为真实耦合接入完成。 + +# 16. 总结 SPHLite 配合 CCLite 的关键不是让 SPHLite 直接处理 FEM 接触,而是提供稳定的粒子/region 数据和外部载荷通道。