Files
CCLite/docs/07_real_worker_access_audit.md
T
2026-07-05 17:18:01 +08:00

88 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 07 真实 Worker 最小接入审计
## 1. 审计结论
CCLite 0.1.7 已固化真实 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.3 当前尚未识别 `--solver-id` 等 worker 参数,仍按普通输入文件/求解参数路径处理。
3. CCLite 0.1.7 的工程验收路径仍采用内置 mock worker 完成 1 step 与 100 step 空耦合闭环。
4. 真实 worker 不在 0.1.7 中伪装为已接入;后续必须在 SPHLite/FEMLite 侧补齐 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 0.1.7 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 当前行为:
```text
worker_state: ERROR
solver_id: SPH
error_message: CCLite worker IPC is not implemented yet
```
FEMLite 当前行为:
```text
unknown argument: --solver-id
```
## 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` CLI;
2. 支持与 SPHLite 相同的 worker 参数集合;
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.7 验收口径
0.1.7 不声明真实 SPHLite/FEMLite worker 已接入。
0.1.7 完成以下工程目标:
1. CCLite 主控的 worker 参数已固化;
2. mock worker 使用同一参数集合;
3. 真实 SPHLite/FEMLite 可执行程序审计可自动生成受控缺口报告;
4. 若本地缺少 SPHLite/FEMLite 包,审计测试不会阻塞 CCLite 自身构建;
5. 0.1.x 通信闭环仍由 CCLite mock worker 验收。