Files
CCLite/SPHLite/docs/cclite_worker_mock_plan.md
T
2026-07-05 22:48:27 +08:00

55 lines
1.5 KiB
Markdown

# CCLite Worker Mock Plan
文档状态:0.8.x mock 设计稿
本文记录当前 CCLite mock 联调覆盖范围。mock 只在内存中模拟 command block 和 data block,不代表真实 CCLite 进程或 Windows IPC 已经接入。
## 1. Mock 数据
command block 字段:
| 字段 | 含义 |
|---|---|
| `sequence` | command sequence,必须严格递增 |
| `command` | worker command id |
| `dt` | `ADVANCE` 的时间步占位 |
data block 字段:
| 字段 | 含义 |
|---|---|
| `input_read` | 是否执行 READ_INPUT |
| `model_built` | 是否执行 BUILD_MODEL |
| `step_id` | mock advance 步数 |
| `particle_count` | mock 导出粒子数 |
| `facet_count` | mock 导出 facet 数 |
| `force_count` | mock 接收粒子力数 |
| `facet_load_count` | mock 接收 facet load 数 |
| `output_count` | mock 写输出次数 |
| `stopped` | 是否收到 STOP |
| `last_ack_sequence` | 最近 ack 序号 |
| `last_state` | 最近 worker state |
| `last_error_code` | 最近 error code |
## 2. 覆盖命令
当前 mock 测试覆盖:
- `INIT`
- `READ_INPUT`
- `BUILD_MODEL`
- 空 `EXPORT_INTERFACE`
- 固定粒子/facet `EXPORT_INTERFACE`
- 空 `IMPORT_LOADS`
- 粒子力 `IMPORT_LOADS`
- facet load `IMPORT_LOADS`
- 单步 `ADVANCE`
- `WRITE_OUTPUT`
- `STOP`
- 100 step 空耦合
- 异常命令
## 3. 后续接入
真实 CCLite 联调时,应把 mock command/data block 替换为 IPC adapter 打开的 shared memory,并保持 protocol、dispatch、diagnostics 的测试继续通过。