Finalize CCLite 0.1.8 release candidate

This commit is contained in:
Codex
2026-07-05 17:21:51 +08:00
parent 3bb03bb66a
commit 0d3f0fb7cc
9 changed files with 234 additions and 34 deletions
+86
View File
@@ -0,0 +1,86 @@
# CCLite 0.1.x 接口常量冻结记录
本文记录 0.1.x 已用于测试和 mock worker 闭环的接口常量。0.2.x 起若修改这些常量,必须同步升级 ABI/layout 并补兼容说明。
## 1. Worker 启动参数
正式参数:
```text
--cclite-worker --solver-id <SPH|FEM> --case <solver.inp> --ipc-name <prefix> --timeout-ms <milliseconds>
```
兼容别名:
1. `--ipc-prefix`:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容;
2. `--solver-input`:0.1.5 早期 mock worker 参数,0.1.7 起仅作为兼容。
## 2. Solver Id
| id | 名称 |
| --- | --- |
| 1 | `SPH` |
| 2 | `FEM` |
| 3 | `CCL` |
## 3. Command Id
| id | 名称 |
| --- | --- |
| 1 | `INIT` |
| 2 | `READ_INPUT` |
| 3 | `BUILD_MODEL` |
| 4 | `EXPORT_INTERFACE` |
| 5 | `IMPORT_LOADS` |
| 6 | `ADVANCE` |
| 7 | `WRITE_OUTPUT` |
| 99 | `STOP` |
## 4. Worker State
| id | 名称 |
| --- | --- |
| 1 | `STARTING` |
| 2 | `READY` |
| 3 | `BUSY` |
| 4 | `DONE` |
| 5 | `ERROR` |
| 6 | `STOPPED` |
## 5. Data Layout
| id | 名称 | 0.1.x 状态 |
| --- | --- | --- |
| 1 | `AOR_V1` | 已实现 |
| 2 | `SOA_V2` | 0.8.x 预留,0.1.x 拒绝 |
## 6. Block Role
| role | 名称 | 0.1.x 状态 |
| --- | --- | --- |
| 101 | `SPH_TO_CCL_PARTICLE` | 已实现,mock 可写空 block |
| 102 | `SPH_TO_CCL_FACET` | 预留 |
| 201 | `FEM_TO_CCL_FACET` | 已实现,mock 可写空 block |
| 301 | `CCL_TO_SPH_FORCE` | 已定义,0.1.x 写空 block |
| 302 | `CCL_TO_FEM_LOAD` | 已定义,0.1.x 写空 block |
| 401 | `CCL_DIAGNOSTIC` | 已定义 |
| 901 | `CCL_COMMAND_SPH` | 已定义 |
| 902 | `CCL_COMMAND_FEM` | 已定义 |
## 7. Buffer State
| id | 名称 |
| --- | --- |
| 0 | `EMPTY` |
| 1 | `WRITING` |
| 2 | `READY` |
| 3 | `READING` |
| 4 | `CONSUMED` |
| 5 | `ERROR` |
## 8. 0.1.x 验收算例
| 算例 | 状态 |
| --- | --- |
| `V010_EMPTY_COUPLING` | 通过,mock SPH/FEM worker 完成 100 step 空耦合 |
| 真实 worker gap audit | 通过,输出受控缺口报告,不声明真实 worker 已接入 |
+47
View File
@@ -0,0 +1,47 @@
# CCLite 0.1.x 发布说明
## 1. 发布定位
0.1.x 是 CCLite 的主控、通信、mock worker 和验证闭环版本。该版本完成 Windows/gfortran/本机共享内存下的工程骨架和空耦合闭环,不包含真实 SPH-FEM 接触力、摩擦、tied coupling、FSI 或 Linux/MPI 生产实现。
## 2. 已完成功能
1. `cclite` 独立主控程序;
2. Abaqus 风格 `.inp` 解析和 `check/dry-run/run` 入口;
3. Windows shared memory 与 named event 薄封装;
4. command block、seq/ack、heartbeat 和 timeout;
5. data block header、AoR v1 record 和空载荷 block;
6. mock SPH/FEM worker service 模式;
7. 1 step 与 100 step 空耦合集成测试;
8. `run.log`、`ipc_report.csv`、`force_balance.csv`;
9. Python checker 生成 `verification_report.json`;
10. 真实 SPHLite/FEMLite worker 接入审计和受控缺口报告。
## 3. 验证结果
本地 0.1.8 验证项:
1. 全量 CTest 通过;
2. `V010_EMPTY_COUPLING` checker 输出 `PASS`;
3. UTF-8 without BOM 检查通过;
4. 干净构建目录重建和测试通过;
5. 真实 worker audit 输出 `CONTROLLED_GAP`。
## 4. 真实 worker 状态
当前本地审计结果:
1. SPHLite 0.8.2 能识别 worker CLI,但真实 Windows IPC 返回受控 unsupported;
2. FEMLite 0.6.3 尚未识别 CCLite worker 参数;
3. 0.1.x 的可执行验收路径仍是 CCLite mock worker;
4. 0.2.x 前必须先在 SPHLite/FEMLite 侧补齐 worker adapter。
## 5. 进入 0.2.x 的条件
0.2.x 可以在以下基础上开发基础 penalty contact:
1. SPH particle 与 FEM facet AoR v1 数据布局已冻结;
2. CCLite 可按 step 调度两个 worker;
3. 空 force/load 写回路径已存在;
4. checker 可自动判定通信闭环;
5. 真实 worker 缺口已记录,不会误判为物理算法完成。
+5 -5
View File
@@ -134,8 +134,8 @@ SPHLite 和 FEMLite 必须增加 CCLite worker/service 模式。
推荐命令行:
```powershell
sphlite.exe --cclite-worker sphlite.inp --ipc-prefix CCLITE_CASE001 --solver-name SPH
femlite.exe --cclite-worker femlite.inp --ipc-prefix CCLITE_CASE001 --solver-name FEM
sphlite.exe --cclite-worker --solver-id SPH --case sphlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 5000
femlite.exe --cclite-worker --solver-id FEM --case femlite.inp --ipc-name CCLITE_CASE001 --timeout-ms 5000
```
最小参数:
@@ -143,9 +143,9 @@ femlite.exe --cclite-worker femlite.inp --ipc-prefix CCLITE_CASE001 --solver-nam
| 参数 | 必填 | 含义 |
| --- | --- | --- |
| `--cclite-worker` | 是 | 进入 CCLite worker/service 模式 |
| input file | 是 | 求解器自己的 `.inp` 文件 |
| `--ipc-prefix` | 是 | CCLite 创建的共享对象前缀 |
| `--solver-name` | 是 | `SPH` 或 `FEM` |
| `--solver-id` | 是 | `SPH` 或 `FEM` |
| `--case` | 是 | 求解器自己的 `.inp` 文件 |
| `--ipc-name` | 是 | CCLite 创建的共享对象前缀 |
| `--workdir` | 否 | worker 工作目录 |
| `--timeout-ms` | 否 | worker 默认等待超时 |