# 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` 解释为真实外部物理联调已经完成。