96 lines
3.4 KiB
Markdown
96 lines
3.4 KiB
Markdown
# 07 真实 Worker 最小接入审计
|
||
|
||
## 1. 审计结论
|
||
|
||
CCLite 0.1.9 已固化真实 worker/service 的启动参数,并完成对当前本地 SPHLite/FEMLite 可执行程序的只读审计。
|
||
|
||
当前结论为受控缺口:
|
||
|
||
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 后再进入真实联调。
|
||
|
||
## 2. CCLite 固化的 worker 参数
|
||
|
||
真实 worker 应支持:
|
||
|
||
```text
|
||
<solver.exe> --cclite-worker --solver-id <SPH|FEM> --case <solver.inp> --ipc-name <prefix> --timeout-ms <milliseconds>
|
||
```
|
||
|
||
参数含义:
|
||
|
||
| 参数 | 含义 |
|
||
| --- | --- |
|
||
| `--cclite-worker` | 进入 CCLite worker/service 模式 |
|
||
| `--solver-id` | `SPH` 或 `FEM` |
|
||
| `--case` | 求解器自身输入文件 |
|
||
| `--ipc-name` | CCLite 分配的 IPC 名称前缀 |
|
||
| `--timeout-ms` | worker 等待命令的超时时间 |
|
||
|
||
CCLite mock worker 同时兼容旧的 `--ipc-prefix` 和 `--solver-input`,但正式参数以 `--ipc-name` 和 `--case` 为准。
|
||
|
||
## 3. 当前真实 worker 审计结果
|
||
|
||
本地审计命令由 `Python/checkers/audit_real_workers.py` 执行,并生成:
|
||
|
||
```text
|
||
build-codex-gcc/output/real_worker_gap_report.json
|
||
```
|
||
|
||
SPHLite 标准 IPC worker 探测:
|
||
|
||
```text
|
||
worker_state: ERROR
|
||
solver_id: SPH
|
||
error_message: CCLite worker IPC is not implemented yet
|
||
```
|
||
|
||
FEMLite 标准 IPC worker 探测:
|
||
|
||
```text
|
||
unknown worker argument: --solver-id
|
||
```
|
||
|
||
FEMLite worker mock 探测:
|
||
|
||
```text
|
||
CCLite worker mock completed
|
||
```
|
||
|
||
## 4. 后续接入条件
|
||
|
||
SPHLite 进入真实空耦合前必须完成:
|
||
|
||
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。
|
||
|
||
FEMLite 进入真实空耦合前必须完成:
|
||
|
||
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。
|
||
|
||
## 5. 0.1.9 验收口径
|
||
|
||
0.1.9 不声明真实 SPHLite/FEMLite IPC worker 已接入。
|
||
|
||
0.1.9 完成以下工程目标:
|
||
|
||
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 验收。
|