Files
CCLite/docs/07_real_worker_access_audit.md
T

96 lines
3.4 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.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 验收。