SuperAPI AI 工具集

jolt-physics

编程与开发

查看项目

更新于 11-07 05:01

技能介绍

jolt-physics 是针对 jrouwe/JoltPhysics 原生 C++ 物理库的操作技能,适用于涉及 JPH 符号、示例集成或既有 Jolt 构建与运行时问题的场景。使用前需从五个互斥模式中选定一个:源码适配(source-fit)、构建计划(build-plan)、原生集成(native-integration)、确定性审计(determinism-audit)或故障排查(failure-triage)。通用 Godot 物理问题不属于本技能范围,JoltPhysics.js 也是独立仓库,需单独审查源码与版本。

使用方式上,技能要求先冻结模式与证据边界,阅读版本、架构、资产许可与平台限制说明,记录现有项目、编译器、架构、构建类型、链接的 Jolt 版本、期望输出与权限范围,并保留既有固定版本。在获得授权后,可在安装目录运行离线预检脚本 python3 scripts/preflight.py --json,或附加 --repo 参数指定已批准的绝对源码根目录;脚本检查选定文件字节、拒绝符号链接穿越与敏感路径,不会运行上游代码。未提供 --repo 时源码检查状态为 false,工具存在也不代表版本或就绪状态。

各模式职责明确:source-fit 区分核心 CPU 库、桌面可视化、GPU ComputeSystem/头发与第三方语言绑定,检查 CPU 指令支持与工具链;build-plan 依据构建文档与检出脚本给出可复现命令、前置条件与输出位置,不擅自升级项目;native-integration 要求先包含 Jolt/Jolt.h,注册分配器与类型、创建工厂、临时分配器与作业系统、持久层过滤器,再初始化 PhysicsSystem,通过 BodyInterface 管理刚体生命周期,使用显式固定步长更新,并在资源结束后注销类型;determinism-audit 核对修改性 API 调用顺序、二进制一致性与浮点设置,必要时对宽相查询、回调与活动刚体顺序做显式排序;failure-triage 收集首个错误、编译链接命令、宏定义、RTTI/LTO 设置与 CPU 标志,用最小复现定位原因。

限制方面,源码下载、依赖安装、编译构建、测试执行、项目修改与签名均需逐项明确授权;根目录 MIT 许可不覆盖全部资产,赛道为 LGPLv3,外部头发与头部模型权利未定;GPU 头发不等于 GPU 刚体模拟;主机平台支持可能需要受限文件。执行前应冻结提交、命令、编译器、标志、测试输入与输出路径,执行后保留退出码与原始输出并检查产物,不得以预检成功、文档声明或构建通过替代运行时、碰撞与性能验证。