SuperAPI AI 工具集

threejs-physics-integration

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:为 Three.js WebGPU/TSL 场景选择、集成并验证物理架构,先选定满足可观察契约的最小求解器架构,再经共享物理 ABI 接入渲染;ABI 只协调求解器,并非通用求解器。

主要能力:提供一致性剖面(render-only、presentation-consumer、query-provider、one-way、two-way、external-solver)作为能力边界;决策协议要求冻结可观察量、单位、帧、时钟、拓扑与误差界,至少产出五种实质不同的方案,按真值保真、目标成本、集成复杂度、确定性、恢复与证据可行性打分,并单独记录硬门失败。

覆盖范围:表示形式选择(解析形状、凸形、三角网格、SDF/场代理、复合代理)、求解器家族比较(解析/仅查询、授权运动学、本地 CPU 刚体、受限 GPU 专用、外部引擎适配、离线录制)、宽相/窄相/CCD/约束/耦合算法、执行架构(单一 PhysicsContext 与 PhysicsGraph 阶段顺序)、碰撞与约束积分、睡眠状态迁移、物理域间信号与表面交换、外部求解器适配器要求、表现层发布(快照密封与提交)、低端与移动端预算以及质量迁移与恢复。

使用方式:先从 $threejs-choose-skills 开始;阅读规范性物理域与交互契约、求解器选择与架构、外部求解器边界;对受限浮体先读动态滑艇架构决策;用 examples/external-physics-adapter-conformance/decision-record.js 校验决策记录。

限制:不得因物体移动就引入物理引擎;不得从 Three.js 材质推断密度、摩擦、弹性或碰撞过滤;每项状态方程只能有一个推进所有者;禁止逐帧 GPU 到 CPU 回读;目标项目一致性夹具须拒绝少于五种方案、缺失决策轴、事后改选、隐式所有权、SI/帧/时钟映射错误、能力含糊、缺失精确一次支持等情形。契约夹具通过仅证明选择与边界不变量,原生 WebGPU 执行、物理正确性、性能与恢复需在目标项目机制诊断与限定测量后才能声明。