Release SPHLite 0.8.2
This commit is contained in:
@@ -0,0 +1,43 @@
|
||||
# CCLite Worker API Mapping
|
||||
|
||||
文档状态:0.8.x mock 设计稿
|
||||
|
||||
本文记录 worker 命令到 SPHLite 现有 API 的映射。当前实现为动作映射表,用于保证命令分发表不遗漏关键 ABI;真实执行将在 IPC 数据块和 worker 主循环稳定后接入。
|
||||
|
||||
## 1. 命令映射
|
||||
|
||||
| Worker 命令 | SPHLite 动作 |
|
||||
|---|---|
|
||||
| `INIT` | `INIT_STATE` |
|
||||
| `READ_INPUT` | `sphlite_read_inp` |
|
||||
| `BUILD_MODEL` | `sphlite_build_model` |
|
||||
| `EXPORT_INTERFACE` | `sphlite_coupling_get_region_count` |
|
||||
| `EXPORT_INTERFACE` | `sphlite_coupling_get_region_info` |
|
||||
| `EXPORT_INTERFACE` | `sphlite_coupling_export_particles` |
|
||||
| `EXPORT_INTERFACE` | `sphlite_coupling_export_facets` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_particle_forces` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_facet_pressures` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_facet_tractions` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_facet_resultants` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_contact_state` |
|
||||
| `IMPORT_LOADS` | `sphlite_coupling_apply_motion_boundary` |
|
||||
| `ADVANCE` | `sphlite_advance_explicit` |
|
||||
| `WRITE_OUTPUT` | `sphlite_write_output` |
|
||||
| `STOP` | `STOP` |
|
||||
|
||||
## 2. 错误映射
|
||||
|
||||
当前策略:
|
||||
|
||||
```text
|
||||
SPHLite API status 0 -> worker OK
|
||||
SPHLite API status 非 0 -> worker INTERNAL
|
||||
```
|
||||
|
||||
真实执行阶段应在返回 `INTERNAL` 前读取 `sphlite_get_last_error`,并把 last error 写入 worker log 和 command block error message。
|
||||
|
||||
## 3. 验收边界
|
||||
|
||||
本阶段只保证命令到动作的映射完整,并提供 mock 测试。它不保证 shared memory 数据布局、真实载荷导入、真实推进或真实 CCLite 联调已经完成。
|
||||
|
||||
v2 预留字段、valid flags、contact state 扩展、拒绝原因和 boundary/ghost 缓存语义记录在 [CCLite Coupling Manifest](cclite_coupling_manifest.md),并由 `sph_worker_contract` 的 smoke 测试守住命名和清零策略。
|
||||
Reference in New Issue
Block a user