用途：为 Godot 3D 物理仿真提供专家级实现模式，覆盖 Jolt 与原生物理引擎下的角色移动、刚体、载具、布娃娃、软体、关节约束、射线检测优化与碰撞层架构。
主要能力：提供按症状选择物理体与 API 的决策树，并配套脚本，包括 kinematic_3d_stairs_logic.gd（CharacterBody3D 台阶与吸附）、shapecast_3d_ground_check.gd（体积地面检测）、ragdoll_manager.gd（动画转 PhysicalBone 仿真）、vehicle_simulation_tuning.gd（VehicleBody3D 调参）、soft_body_3d_interaction.gd、physics_ccd_3d_projectile.gd、physics_server_3d_bullets.gd、physics_layers_3d_config.gd、custom_gravity_well_3d.gd、joint_3d_breakage_logic.gd、ray_query_3d_vision.gd、raycast_visualizer.gd。
必要用法与限制：物理体移动必须在 _physics_process() 中进行；不要直接缩放碰撞形状，应调整形状属性；不要直接修改 RigidBody3D 变换，应使用 apply_impulse()、apply_torque() 或 _integrate_forces()；平台跳跃玩家控制器应使用 CharacterBody3D 与 move_and_slide()；CCD 仅用于高速小物体；PhysicsServer3D 的 RID 需手动 free_rid()；楼梯地面检测建议用 ShapeCast3D 而非单条 RayCast3D；正确设置 collision_layer 与 collision_mask；Area3D 用于检测而非高频阻挡。
适用场景：3D 角色移动、载具、布娃娃、软体、子弹防穿透、重力井、AI 视线查询与物理调试。
限制：具体版本迁移与 Jolt 升级步骤见 migration-notes.md；部分深入主题需按需查阅 expert-3d-constraints.md 与官方文档。