5.5 KiB
5.5 KiB
FemLite TODO
文档状态:根据 docs/12_cclite_integration_suggestions.md 重写。当前待办面向 0.6.5,目标是完成真实 IPC worker 接入闭环。
开发边界
- 保留现有 worker mock,不把 mock 结果描述为真实 IPC worker。
- 保持 FemLite 独立求解器身份,不把 CCLite/SPHLite 算法核心写入 FemLite。
- 本轮只做数据边界、worker 通信、自测和诊断,不做真实 SPH-FEM 接触物理验收。
- 每个开发阶段完成后补充对应 smoke、单元测试或文档验收。
阶段 A:Worker CLI 与能力查询
- 盘点现有
--cclite-worker参数解析、默认值、错误返回和测试覆盖。 - 增加
--solver-id、--timeout-ms、--worker-id参数,并保持旧参数兼容。 - 增加
--command-block、--data-prefix、--worker-backend参数,并明确 mock/ipc 模式选择规则。 - 校验
--solver-id初期只接受FEM或FEMLite,错误时输出稳定错误码。 - 新增
--cclite-capabilitiesCLI,输出稳定key=value文本。 - 为能力查询补充测试,覆盖 mock、Windows IPC 支持状态和非 Windows unsupported 状态。
阶段 B:Worker 命令执行器解耦
- 盘点现有 mock worker 命令状态机和日志字段,找出与 mock backend 绑定的逻辑。
- 抽出 backend 无关的 worker 命令执行器,覆盖
INIT到STOP命令。 - 让 mock worker 改用统一命令执行器,确保原有 100 step 空耦合测试不退化。
- 统一
seq、ack_seq、worker_state、error_code和短错误消息的写回规则。 - 增加命令执行器单元测试,覆盖正常命令、未知命令、错误输入和 STOP 退出。
阶段 C:真实 IPC Worker 主循环
- 将真实 IPC worker 接入现有
femlite_cclite_transportfacade,不新增第二套 IPC 封装。 - 启动真实 IPC worker 时打开 command block、command event 和 done event。
- 在真实 IPC worker 启动后进入 READY 状态,并写回初始 ack/state/error 字段。
- 实现真实 IPC worker 的 wait command、执行命令、写回状态、signal done 主循环。
- 确认 FemLite 只 wait/signal named event,不 reset 由 CCLite 创建的 event。
- 为 IPC attach、READY、STOP、timeout 和 open 失败路径补充测试。
阶段 D:AOR_V1 Data Block
- 设计
AOR_V1data block header,包含 magic、version、capacity、record count 和错误字段。 - 设计
FEM_TO_CCL_FACET最小 facet record,覆盖节点、位置、法向、面积和材料/截面字段。 - 设计
CCL_TO_FEM_LOAD最小 nodal force record,覆盖节点力、source、load mode 和 valid flags。 - 实现 data block 打开、版本检查、容量检查和错误返回,不由 FemLite 创建 data block。
- 实现空 facet、空 load 的读写闭环,作为真实 IPC worker 最小验收路径。
- 将 nodal force records 映射到现有 coupling 节点力导入接口。
- 将 facet records 映射到现有 surface/facet 导出接口,暂以现有字段为准。
- 为 data block header、容量不足、版本不匹配和空记录路径补充测试。
阶段 E:诊断与日志
- 扩展 worker log header,记录 backend、solver_id、worker_id、ipc_name 和 timeout。
- 扩展 worker log header,记录 command_block、data_prefix 和实际 data block 名称。
- 扩展每条命令日志,记录 command_id、step_id、substep_id、iteration_id 和 ack_seq。
- 扩展每条命令日志,记录 worker_state、error_code 和短错误消息。
- 在
WRITE_OUTPUT或每步结束时同步输出 surface/load 诊断统计。 - 保持
femlite_cclite_worker.log、femlite_cclite_surface_report.csv、femlite_cclite_load_report.csv文件名稳定。 - 为日志字段、错误消息和诊断 CSV 输出补充回归测试。
阶段 F:Process-Level 自测与联调准备
- 增加本地 IPC self-test helper,用于创建 shared memory 和 named event 测试对象。
- 增加 process-level worker 自测,覆盖启动、attach、READY、空 facet、空 load 和 STOP。
- 增加 1 step 空耦合进程级 smoke,验证 CCLite mock 驱动真实 FemLite worker。
- 增加 100 step 空耦合进程级 smoke,验证 seq/ack、日志和稳定退出。
- 增加异常输入和 timeout 进程级 smoke,验证可控错误和退出码。
- 将 process-level 自测纳入常规回归入口,必要时按平台跳过 Windows-only 测试。
阶段 G:文档与版本边界
- 更新接口控制文档,说明 worker mock、IPC adapter、real IPC worker 的边界。
- 更新 CCLite 联合改造文档,记录 0.6.5 已完成项和仍暂缓项。
- 更新用户文档,给出
--cclite-worker和--cclite-capabilities示例。 - 更新开发路线图,将 0.6.6/0.6.7 的 surface/body id、facet pressure 和 force balance 边界保持清晰。
- 更新发布检查清单,加入真实 IPC worker 自测、能力查询和日志字段验收。
暂缓到后续版本
- DEFERRED:稳定 surface id 显式映射和真实
body_id映射。 - DEFERRED:facet pressure 中立 data block 导入和完整物理验收。
- DEFERRED:moment 外部载荷导入。
- DEFERRED:kinematic boundary 外部约束导入。
- DEFERRED:真实 SPH-FEM penalty contact 物理验收。
- DEFERRED:FSI 工程算例。
- DEFERRED:tied/release 联合接触。
- DEFERRED:强耦合 rollback 和预测状态接口。
- DEFERRED:删除旧
sph命名接口。