r3f-interaction 是为 React Three Fiber 场景添加选择、拖动和输入控制的 Skill。它先分清由谁移动物件、由谁控制镜头,再接事件。
射线命中按距离传递,阻止传播会影响后面物件,却不会撤销已经做过的检测。拖动还要把世界坐标转成父级的局部坐标,二维鼠标位置不能直接当三维位移。
物件拖动时协调镜头控制,松开、取消、失去捕获或卸载后都要恢复;拖出画布、触摸和焦点丢失也在验收范围。只测一次正常鼠标拖拽会漏恢复路径。
重要动作还需画布外的可访问 DOM 控件,网格点击本身没有键盘入口。主文例子面向 Fiber 9 与 React 19,安装版本要先核;它解决交互,不等于动画或物理模拟已完成。