GSAP Observer 是 GSAP 的插件，用于跨设备统一手势检测，把 wheel、touch、pointer、scroll 事件归一到同一套回调，适合制作滑块、滑动切换、滚动劫持和跨设备交互。
安装：npm install gsap。使用前需引入并注册：import { Observer } from 'gsap/Observer'；gsap.registerPlugin(Observer)。
基本用法：Observer.create({ target, type, onUp, onDown, ... })。target 指定监听对象（如 window 或元素），type 可写 'wheel'、'touch'、'pointer'、'scroll' 或其组合，默认覆盖全部类型。
主要能力：方向回调 onUp、onDown、onLeft、onRight；拖拽回调 onPress、onDrag、onDragStart、onDragEnd；悬停回调 onHover、onHoverEnd；方向变化回调 onChange。回调参数 self 提供 deltaX/deltaY（位移）、velocityX/velocityY（速度）、wheelDelta、startX/startY、x/y、event，以及 isDragging 等状态。
配置项：tolerance 设置触发前最小移动量；dragMinimum 设定拖拽最小像素；wheelSpeed 缩放滚轮速度；preventDefault 阻止浏览器默认行为；ignore 指定需忽略的可滚动元素选择器；debounce 对事件去抖。实例方法有 enable()、disable()、kill()、update()；静态方法有 Observer.getAll()，并可设置 Observer.defaults 全局默认。
典型场景：简单滑块、带惯性的 swiper、滚动劫持、可拖拽地图、图库导航、基于速度的快速滑动判断与动量滚动。
限制与注意事项：性能上应仅使用需要的 type，对高开销回调做去抖或节流；使用 preventDefault 时要用 ignore 放行可滚动区域，避免阻断正常滚动；target 应指向容器或 window；需关注可访问性，为滚动劫持提供替代方案，并在不再使用时清理 observer。资料未提供收费、价格与平台兼容性信息。