# CCLite Worker IPC Adapter 文档状态:0.8.x mock 设计稿 本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现是 mockable adapter,不打开真实 Windows shared memory 或 named event;真实 IPC 后续实现时应复用这里的句柄、状态和错误路径。 ## 1. 模块边界 IPC adapter 只负责: - 保存 command block、data block、command event 和 done event 名称。 - 写入 `READY` 和 `DONE` 状态。 - 等待 command event。 - signal done event。 - 把 shared memory 或 event 打开失败、wait 超时等问题转换为 worker error code。 IPC adapter 不负责: - 创建、reset 或销毁 CCLite 持有的 shared memory。 - 创建、reset 或销毁 CCLite 持有的 named event。 - 解析 FEMLite 数据。 - 计算 SPH-FEM 接触或 FSI 载荷。 ## 2. 句柄抽象 当前 `sphlite_worker_ipc_t` 保存以下名称: | 字段 | 默认命名 | |---|---| | `ipc_name` | CCLite 传入的基础名 | | `command_block` | `.command` | | `data_prefix` | `.data` | | `command_event` | `.command_event` | | `done_event` | `.done_event` | 调用方也可以通过 CLI 的 `--command-block` 和 `--data-prefix` 覆盖默认名称。 ## 3. 状态流程 worker IPC 流程: ```text init names open handles write READY loop: wait command event execute command write DONE with ack/state/error signal done event ``` `sphlite_worker_ipc_reset_event` 固定返回 `CONFLICT`,用于锁定 SPHLite 不 reset CCLite event 的约束。 ## 4. 错误路径 | 场景 | 错误码 | |---|---| | shared memory 或 event 尚未打开 | `IPC` | | wait 超时 | `TIMEOUT` | | event reset 尝试 | `CONFLICT` | | Windows 真实 IPC 尚未实现 | `UNSUPPORTED` | | 非 Windows 真实 IPC | `IPC` | mock 模式用于 CTest,不代表真实 IPC 能力完成。