Release SPHLite 0.8.3

This commit is contained in:
Codex
2026-07-05 21:41:34 +08:00
parent 3934dc213b
commit 671e35ff54
48 changed files with 3125 additions and 373 deletions
+14 -6
View File
@@ -2,7 +2,7 @@
文档状态:0.8.x worker adapter 骨架说明
本文记录 SPHLite 侧 CCLite worker 入口的参数、状态、命令和错误语义。当前实现只完成 CLI 解析、纯逻辑状态/命令枚举和测试;Windows shared memory、named event 和真实 CCLite 联调仍未实现。
本文记录 SPHLite 侧 CCLite worker 入口的参数、状态、命令和错误语义。当前实现已完成 CLI 解析、能力查询、状态/命令枚举、mock 测试和 Windows shared memory/named event attach 骨架;真实 CCLite 跨进程联调、生产级接触/FSI 仍未完成。
## 1. CLI 参数
@@ -34,7 +34,15 @@ sphlite.exe model.inp --check
sphlite.exe model.inp --run --output result
```
当前所有必填 worker 参数齐全时,程序会返回受控的 `UNSUPPORTED`,表示 IPC 阶段尚未实现。
当前所有必填 worker 参数齐全时,程序会尝试打开 CCLite 创建的 IPC 资源。若资源不存在或平台不支持,会返回受控的 `IPC` 或 `UNSUPPORTED` 错误,不退回普通 CLI。
能力查询:
```text
sphlite.exe --cclite-capabilities
```
`--cclite-capabilities` 必须单独使用,输出 key=value 能力清单。Windows 构建中 `supports_real_ipc=yes` 表示 SPHLite 侧 shared memory/named event attach、wait、signal 和 close 路径已进入 self-test;非 Windows 构建仍报告 `supports_real_ipc=no`。该标志不代表真实外部 CCLite 进程联调或生产级 FSI 已完成。
## 2. 状态枚举
@@ -54,10 +62,10 @@ sphlite.exe model.inp --run --output result
| `INIT` | 清理 worker 侧状态;允许从 `ERROR` 恢复到可继续状态 |
| `READ_INPUT` | 后续映射到 `sphlite_read_inp` |
| `BUILD_MODEL` | 后续映射到 `sphlite_build_model` |
| `EXPORT_INTERFACE` | 后续映射到 coupling region count/info、particle export 和 facet export |
| `IMPORT_LOADS` | 后续映射到 particle force、facet pressure/traction/resultant、contact state 和 motion boundary 导入 |
| `ADVANCE` | 后续映射到 `sphlite_advance_explicit` 或 worker 控制的子步循环 |
| `WRITE_OUTPUT` | 后续映射到 `sphlite_write_output` |
| `EXPORT_INTERFACE` | 映射到 coupling region count/info 和 particle export 数据块;facet export 后续补齐 |
| `IMPORT_LOADS` | 映射到空导入、particle force 数据块和 contact state 导入;facet load 和 motion boundary 后续补齐 |
| `ADVANCE` | 映射到 `sphlite_advance_explicit`,`dt<=0` 时使用稳定时间步估计 |
| `WRITE_OUTPUT` | 映射到 `sphlite_write_output` |
| `STOP` | 写入完成状态后退出 worker |
未知命令进入 `ERROR`,错误码为 `UNKNOWN_COMMAND`。