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

3.0 KiB
Raw Blame History

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

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

build-codex-gcc/output/real_worker_gap_report.json

SPHLite 当前行为:

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

FEMLite 当前行为:

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