Files
CCLite/docs/0.2.x_release_notes.md
T
2026-07-06 09:45:38 +08:00

105 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CCLite 0.2.x 发布说明
## 1. 版本定位
0.2.x 是 CCLite 的基础 SPH 粒子-FEM facet penalty contact 版本。该版本在 0.1.x 主控、IPC、mock worker、AoR v1 和空耦合闭环基础上,首次形成可自动验收的接触力闭环。
发布候选号:
```text
CCLite 0.2.10
```
## 2. 已完成功能
0.2.x 完成以下能力:
1. `.inp` 支持 `*CCLITE SURFACE INTERACTION`,并支持 `NORMAL=PENALTY`、`KN`、`CN`、`FRICTION=0`;
2. `.inp` 支持 `*CCLITE CONTACT PAIR`,并支持 `TYPE=SPH_PARTICLE_TO_FEM_FACE`;
3. SPH particle view 可从 AoR v1 `SPH_TO_CCL_PARTICLE` payload 构建;
4. FEM facet view 可从 AoR v1 `FEM_TO_CCL_FACET` payload 构建;
5. Vec3、AABB、point-segment、point-triangle 和四边形拆三角形最小路径已进入测试;
6. uniform hash grid 可生成并去重 SPH particle-FEM facet 候选对;
7. 窄相可生成 gap、penetration、normal、shape weight 和跳过原因计数;
8. 法向 penalty force 和基础法向阻尼可生成 SPH 接触力;
9. FEM 节点反力按 shape weight 分配,满足作用-反作用合力平衡;
10. `CCL_TO_SPH_FORCE` 和 `CCL_TO_FEM_LOAD` 可写入非空载荷并被 mock worker 消费;
11. `contact_report.csv`、`candidate_report.csv`、`force_balance.csv` 和 `ipc_report.csv` 可由 checker 自动检查;
12. `V020_GEOMETRY_PRIMITIVES`、`V020_SINGLE_PARTICLE_WALL`、`V020_MULTI_PARTICLE_PLANE`、`V020_FORCE_BALANCE` 已进入回归;
13. `V020_SINGLE_REAL_WORKER_SMOKE` 已形成真实 worker gate 报告,当前状态为 `CONTROLLED_PROTOCOL_GAP`。
## 3. 验证状态
0.2.10 发布候选验证范围:
1. 0.1.x smoke、parser、IPC、command/data block 和空耦合回归;
2. 0.2.x contact parser、interface view、geometry、broad phase、narrow phase、penalty force 单元测试;
3. 双 mock worker 的接触 controller 集成测试;
4. 单粒子撞面、多粒子压面、force balance 算例;
5. 真实 worker 能力查询、attach 探测和 gate 报告检查;
6. UTF-8 without BOM 检查;
7. 干净构建目录重建与全量测试。
当前自动测试集合包含 37 个 CTest 测试项。0.2.10 发布候选提交前已执行:
```text
build-codex-gcc: 37/37 PASS
build-codex-gcc-clean-0210-unix: 37/37 PASS
cclite --version: CCLite 0.2.10
```
## 4. 真实 Worker Gate
真实 worker gate 编号:
```text
V020_SINGLE_REAL_WORKER_SMOKE
```
当前结论:
```text
EXTERNAL_WORKERS_READY_CCLITE_PROTOCOL_ADAPTER_REQUIRED
gate_status: CONTROLLED_PROTOCOL_GAP
```
含义:
1. SPHLite 和 FEMLite 均可报告 CCLite worker 能力;
2. 两侧均报告 Windows shared memory/named event 的真实 IPC 后端能力;
3. 两侧 worker CLI 均能进入真实 IPC attach 尝试;
4. CCLite 与真实 worker 的命名、command block 和 data header 仍需要 adapter;
5. 0.2.x 不声明真实 SPHLite/FEMLite 外部进程物理联调完成。
详细记录见 `docs/07_real_worker_access_audit.md`。
## 5. 未完成能力
以下能力不属于 0.2.x 已完成范围:
1. Coulomb 摩擦;
2. 完整 edge fallback;
3. 四边形双线性投影;
4. 壳厚度高级接触;
5. contact persistence;
6. 自动 penalty 参数估计;
7. 接触稳定时间步;
8. 接触能量诊断;
9. tied coupling 和 release;
10. pressure projection、boundary/ghost particle 和 Riemann FSI;
11. SoA v2 性能布局;
12. Linux/MPI 生产后端;
13. 工程级水下爆炸或船体局部破坏算例。
## 6. 后续 0.3.x 入口条件
0.3.x 建议从以下方向开始:
1. 完整 edge fallback 验收;
2. 四边形接触一致性补强;
3. 壳厚度几何和接触距离补强;
4. contact persistence 初步;
5. 真实 SPHLite/FEMLite adapter 的 1 step 和 100 step 空耦合 gate。
0.3.x 开发不得把 0.2.x 的 `CONTROLLED_PROTOCOL_GAP` 解释为真实外部物理联调已经完成。