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