Files
CCLite/docs/07_real_worker_access_audit.md
T

3.4 KiB
Raw Blame History

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 应支持:

<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 执行,并生成:

build-codex-gcc/output/real_worker_gap_report.json

SPHLite 标准 IPC worker 探测:

worker_state: ERROR
solver_id: SPH
error_message: CCLite worker IPC is not implemented yet

FEMLite 标准 IPC worker 探测:

unknown worker argument: --solver-id

FEMLite worker mock 探测:

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 验收。