Update real worker audit for external IPC capabilities

This commit is contained in:
Codex
2026-07-05 22:28:07 +08:00
parent 11c904bbb8
commit bb688d2a19
6 changed files with 273 additions and 82 deletions
+10 -8
View File
@@ -19,23 +19,24 @@
## 3. 验证结果
本地 0.1.8 验证项:
本地 0.1.10 验证项:
1. 全量 CTest 通过;
2. `V010_EMPTY_COUPLING` checker 输出 `PASS`;
3. UTF-8 without BOM 检查通过;
4. 干净构建目录重建和测试通过;
5. 真实 worker audit 输出 SPHLite 标准 IPC 状态、FEMLite 标准 IPC 状态和 FEMLite worker mock 状态。
5. 真实 worker audit 输出 SPHLite/FEMLite 能力查询、标准 IPC attach 探测、FEMLite 显式 IPC backend 探测、FEMLite worker mock 状态和协议对齐状态。
## 4. 真实 worker 状态
当前本地审计结果:
1. SPHLite 0.8.2 能识别 worker CLI,但真实 Windows IPC 返回受控 unsupported;
2. FEMLite 0.6.4 已提供自运行 worker mock,可完成 1 step mock 闭环;
3. FEMLite 0.6.4 尚未接受 CCLite 标准 IPC worker 参数中的 `--solver-id` 和 `--timeout-ms`;
4. 0.1.x 的可执行验收路径仍是 CCLite mock worker;
5. 0.2.x 前必须先在 SPHLite/FEMLite 侧补齐真实 IPC worker adapter。
1. 当前 SPHLite 包报告 `cclite_worker=yes`、`supports_real_ipc=yes`、`supports_sph_to_ccl_particle=yes` 和 `supports_ccl_to_sph_force=yes`;
2. 当前 FEMLite 包报告 `cclite_worker=yes`、`worker_mock=yes`、`supports_real_ipc=yes`、`supports_fem_to_ccl_facet=yes` 和 `supports_ccl_to_fem_load=yes`;
3. 两个 worker 在没有预创建 IPC 资源时均会尝试真实 IPC attach,并返回可识别的 attach/open 失败;
4. FEMLite worker mock 新输出格式已被识别为 `WORKER_MOCK_AVAILABLE`;
5. 当前状态为 `EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED`,即外部 worker 能力已具备,但 CCLite 侧仍需补齐协议/命名 adapter 和进程级 gate;
6. 0.1.x 的可执行验收路径仍是 CCLite mock worker,不声明真实 SPH-FEM 接触物理完成。
## 5. 进入 0.2.x 的条件
@@ -45,4 +46,5 @@
2. CCLite 可按 step 调度两个 worker;
3. 空 force/load 写回路径已存在;
4. checker 可自动判定通信闭环;
5. 真实 worker 缺口已记录,不会误判为物理算法完成。
5. 外部 worker 能力和协议对齐状态已记录,不会把 `supports_real_ipc=yes` 误判为真实物理算法完成;
6. 若 0.2.x 需要直接使用真实 SPHLite/FEMLite worker,应先完成 CCLite 协议 adapter 和 1 step/100 step 外部空耦合 gate。
+95 -50
View File
@@ -2,35 +2,45 @@
## 1. 审计结论
CCLite 0.1.9 已固化真实 worker/service 的启动参数,并完成对当前本地 SPHLite/FEMLite 可执行程序的只读审计。
CCLite 0.1.10 已将真实 worker 审计从“参数是否存在”升级为“能力查询、真实 IPC attach 行为和协议对齐状态”三层检查。
当前结论为受控缺口:
当前结论为:
1. SPHLite 0.8.2 已识别 `--cclite-worker`、`--solver-id`、`--case`、`--ipc-name` 和 `--timeout-ms` 参数,但真实 Windows shared memory / named event IPC 尚未实现,程序返回受控 unsupported。
2. FEMLite 0.6.4 已提供自运行的 CCLite worker mock,可用 `--case`、`--ipc-name`、`--log`、`--output-dir` 和 `--mock-steps` 完成 worker mock 闭环。
3. FEMLite 0.6.4 尚未接受 CCLite 0.1.x 标准 IPC worker 参数中的 `--solver-id` 和 `--timeout-ms`,主程序也尚未切换为真实跨进程 Windows IPC worker 主循环。
4. CCLite 0.1.9 的工程验收路径仍采用内置 mock worker 完成 1 step 与 100 step 空耦合闭环。
5. 真实 IPC worker 不在 0.1.9 中伪装为已接入;后续必须在 SPHLite/FEMLite 侧补齐真实 IPC worker adapter 后再进入真实联调。
```text
EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED
```
含义是:
1. 当前 SPHLite 包已提供 `--cclite-capabilities`,并报告 `cclite_worker=yes`、`supports_real_ipc=yes`、`supports_sph_to_ccl_particle=yes` 和 `supports_ccl_to_sph_force=yes`。
2. 当前 FEMLite 包已提供 `--cclite-capabilities`,并报告 `cclite_worker=yes`、`worker_mock=yes`、`supports_real_ipc=yes`、`supports_fem_to_ccl_facet=yes` 和 `supports_ccl_to_fem_load=yes`。
3. 两个 worker 在没有 CCLite 预创建 IPC 资源时都会尝试打开真实 IPC,并返回可识别的 attach/open 失败,而不是旧版本的参数缺失或未实现。
4. FEMLite worker mock 仍可运行,当前输出为 `CCLite worker completed: mock`。
5. CCLite 0.1.10 尚不声明真实外部 SPHLite/FEMLite 进程联调完成,因为 FEMLite 发布的 IPC 结构和命名规则与 CCLite 0.1.x 当前通用 command/data block 不完全一致,仍需要 CCLite 侧协议/命名 adapter 和进程级 gate。
## 2. CCLite 固化的 worker 参数
真实 worker 应支持:
真实 worker 应至少支持:
```text
<solver.exe> --cclite-worker --solver-id <SPH|FEM> --case <solver.inp> --ipc-name <prefix> --timeout-ms <milliseconds>
```
参数含义:
CCLite 0.1.10 启动 worker 时还会补充新版求解器可识别的辅助参数:
| 参数 | 含义 |
| --- | --- |
| `--cclite-worker` | 进入 CCLite worker/service 模式 |
| `--solver-id` | `SPH` 或 `FEM` |
| `--case` | 求解器自身输入文件 |
| `--ipc-name` | CCLite 分配的 IPC 名称前缀 |
| `--timeout-ms` | worker 等待命令的超时时间 |
```text
--command-block <name>
--data-prefix <prefix>
--worker-id <SPH|FEM>
```
CCLite mock worker 同时兼容旧的 `--ipc-prefix` 和 `--solver-input`,但正式参数以 `--ipc-name` 和 `--case` 为准。
FEMLite worker 额外使用:
```text
--worker-backend ipc
```
这些参数用于补齐启动契约;它们不代表二进制协议已经自动兼容。
## 3. 当前真实 worker 审计结果
@@ -40,56 +50,91 @@ CCLite mock worker 同时兼容旧的 `--ipc-prefix` 和 `--solver-input`,但
build-codex-gcc/output/real_worker_gap_report.json
```
SPHLite 标准 IPC worker 探测:
当前审计报告包含:
1. `sphlite_capabilities`:SPHLite 能力查询;
2. `femlite_capabilities`:FEMLite 能力查询;
3. `sphlite_standard_ipc`:SPHLite 标准 worker 参数 attach 探测;
4. `femlite_standard_ipc`:FEMLite 标准 worker 参数 attach 探测;
5. `femlite_explicit_ipc_backend`:FEMLite `--worker-backend ipc` attach 探测;
6. `femlite_worker_mock`:FEMLite 自运行 worker mock 探测;
7. `protocol_alignment`:CCLite 当前协议与外部 worker 已发布协议的对齐状态。
SPHLite 标准 IPC worker 探测当前应表现为:
```text
worker_state: ERROR
solver_id: SPH
error_message: CCLite worker IPC is not implemented yet
status: IPC_ATTACH_ATTEMPTED
recognized_worker_cli: true
real_ipc_attach_attempted: true
```
FEMLite 标准 IPC worker 探测:
FEMLite 标准 IPC worker 探测当前应表现为:
```text
unknown worker argument: --solver-id
status: IPC_ATTACH_ATTEMPTED
recognized_worker_cli: true
real_ipc_attach_attempted: true
```
FEMLite worker mock 探测:
FEMLite worker mock 探测当前应表现为:
```text
CCLite worker mock completed
status: WORKER_MOCK_AVAILABLE
```
## 4. 后续接入条件
## 4. 协议对齐状态
SPHLite 进入真实空耦合前必须完成:
CCLite 0.1.x 当前内部协议为:
1. 打开 CCLite 创建的 command block;
2. 打开 `SPH_TO_CCL_PARTICLE` 与 `CCL_TO_SPH_FORCE` data block;
3. 打开并等待 command event;
4. 回写 `READY/DONE/STOPPED`、`ack_seq` 和 `error_code`;
5. 导出空或固定 SPH particle block;
6. 接收空 `CCL_TO_SPH_FORCE` block。
```text
command block: CCLite generic command block v1
data header: CCLite generic data block header v0.1
control name: <prefix>_CCL_COMMAND_<solver>
event names: <prefix>_EVENT_COMMAND_<solver>, <prefix>_EVENT_ACK_<solver>
data names: <prefix>_<ROLE>
```
FEMLite 进入真实空耦合前必须完成:
SPHLite 当前文档中的默认命名为:
1. 保留当前 `--cclite-worker` worker mock;
2. 支持与 CCLite 标准 IPC worker 一致的 `--solver-id` 和 `--timeout-ms` 参数;
3. 打开 CCLite 创建的 command block;
4. 打开 `FEM_TO_CCL_FACET` 与 `CCL_TO_FEM_LOAD` data block;
5. 回写 `READY/DONE/STOPPED`、`ack_seq` 和 `error_code`;
6. 导出空或固定 FEM facet block;
7. 接收空 `CCL_TO_FEM_LOAD` block。
```text
<ipc_name>.command
<ipc_name>.command_event
<ipc_name>.done_event
```
## 5. 0.1.9 验收口径
SPHLite 支持 `--command-block` 和 `--data-prefix` 覆盖部分名称,但真实外部 CCLite 进程联调仍需要 CCLite 侧 adapter gate 验收。
0.1.9 不声明真实 SPHLite/FEMLite IPC worker 已接入。
FEMLite 当前发布的真实 IPC worker 使用:
0.1.9 完成以下工程目标:
```text
<prefix>_COMMAND_BLOCK
<prefix>_COMMAND_EVENT
<prefix>_DONE_EVENT
<data-prefix>_FEM_TO_CCL_FACET
<data-prefix>_CCL_TO_FEM_LOAD
```
1. CCLite 主控的 worker 参数已固化;
2. mock worker 使用同一参数集合;
3. 真实 SPHLite/FEMLite 可执行程序审计可自动生成分层能力报告;
4. FEMLite worker mock 可用时,审计报告显示 `WORKER_MOCK_AVAILABLE`;
5. 若本地缺少 SPHLite/FEMLite 包,审计测试不会阻塞 CCLite 自身构建;
6. 0.1.x 通信闭环仍由 CCLite mock worker 验收。
并在 `FEMLite/cpu_release/include/femlite_cclite_ipc.h` 中发布了 `femlite_cclite_command_block` 与 `femlite_cclite_data_header`。该结构与 CCLite 0.1.x 当前通用 block 不是同一二进制布局,因此 CCLite 后续必须增加外部协议 adapter 或统一 05 号接口控制文档中的二进制契约。
## 5. 0.1.10 验收口径
0.1.10 完成以下工程目标:
1. CCLite 可自动读取 SPHLite/FEMLite 的 `--cclite-capabilities` 输出;
2. 真实 worker attach 失败被识别为 `IPC_ATTACH_ATTEMPTED`,不再误判为参数缺失或未实现;
3. FEMLite 新版 mock 输出 `CCLite worker completed: mock` 被识别为 `WORKER_MOCK_AVAILABLE`;
4. 审计报告明确输出 `CCLITE_PROTOCOL_ADAPTER_REQUIRED`;
5. CCLite 主控启动 worker 时补充 `--command-block`、`--data-prefix`、`--worker-id`,FEMLite 补充 `--worker-backend ipc`;
6. 0.1.x 可执行验收路径仍由 CCLite 内置 mock worker 完成;
7. 真实 SPH-FEM 接触力、真实外部双 worker 联调、摩擦、FSI 和 Linux/MPI 不在 0.1.10 中声明完成。
## 6. 后续接入条件
进入真实外部 worker 空耦合前,CCLite 侧必须完成:
1. 明确采用统一 CCLite 05 号通用 block,还是为 SPHLite/FEMLite 各自协议增加 adapter;
2. 建立 `真实 SPHLite + mock FEM` 的 1 step 和 100 step 空耦合 gate;
3. 建立 `mock SPH + 真实 FEMLite` 的 1 step 和 100 step 空耦合 gate;
4. 建立 `真实 SPHLite + 真实 FEMLite` 的 1 step 和 100 step 空耦合 gate;
5. 将能力查询、协议版本、record stride、block 容量和错误码纳入自动报告;
6. 在上述 gate 通过前,不把 `supports_real_ipc=yes` 解释为真实外部联调完成。