用途：为 React Three Fiber 场景实现交互，包括指针事件、对象拾取、拖拽、键盘输入与相机控制，并处理事件传播与交互归属。
主要能力：说明 R3F 事件语义——带处理器的对象参与射线检测，按距离投递并沿祖先冒泡；event.object 为命中对象，event.eventObject 为持有处理器的对象。stopPropagation() 会阻止向更远命中和祖先投递，但不取消已执行的射线检测，可能立即触发后方对象的 pointerout。event.point 为世界坐标，需克隆并转换到父级局部空间后再赋给局部变换；2D 拖拽映射到 3D 需要平面交点或深度参考。可用 Canvas 的 onPointerMissed 处理背景取消选中，并区分点击与拖拽。指针捕获通过 event.target.setPointerCapture(event.pointerId) 及对应释放方法完成，还需处理取消与丢失捕获。相机在指针静止时移动，可能需要 state.events.update() 刷新悬停结果，仅在需要时调用。昂贵拾取可用简化命中代理或图层过滤，不能只靠视觉透明避免相交。
使用方式：先确认已安装的 Fiber、Drei 与输入库版本，示例面向 Fiber 9 / React 19。先确定相机移动、对象移动与 UI 输入各自的归属再连接处理器。可选中对象示例挂载在 Canvas 下，重要操作应保留 Canvas 外的可访问 DOM 控件，因为网格指针处理器本身不提供键盘访问。轨道用 OrbitControls，脚本化过渡与更丰富相机行为用 CameraControls；复制属性或方法前先核对已安装版本。makeDefault 可向协作助手暴露控制实例；TransformControls 拖拽时可暂停默认控制，需确认自定义控制也被正确禁用与恢复。对象拖拽按约束选择 DragControls、PivotControls 或 TransformControls，避免同时应用受控矩阵与自动变换。自定义拖拽需保存初始变换、捕获指针、投影到选定平面，并在 pointerup、取消与卸载时恢复相机控制，同时遵守事件目标上的 touch-action 要求。共享 DOM 事件源需使用与事件目标和画布矩形一致的坐标前缀，并测试滚动与覆盖层。键盘用 Drei KeyboardControls 提供命名动作，在 useFrame 内读取 getter 做移动，离散事件才订阅并清理；对角移动需归一化，视觉移动乘以 delta，物理体应把输入送入物理步进逻辑。高频指针位置用 ref，语义事件用 React state；失焦时清除按住输入并尊重文本框焦点。ScrollControls 创建滚动上下文，useScroll 须在其下使用，其归一化偏移与增量不是像素距离。
适用场景：需要为 R3F 场景添加选择、拖拽、键盘移动或相机控制的交互开发。
限制：资料未提供具体收费、价格、平台与效果信息；示例版本针对 Fiber 9 / React 19，其他版本需自行核对 API。