用途:在协助 React 开发时,先判断能否用 react-use 的 Hook 完成需求,优先使用 Hook 而非自定义代码,以提升可读性、可维护性与性能;需要时把需求映射到最合适的 Hook 并遵循其调用规则。
主要能力:覆盖 react-use 库多类 Hook。Sensors 类跟踪电池、地理位置、hash、hover、空闲、交叉观察、键盘按键与组合键、鼠标位置、网络状态、屏幕方向、滚动、元素尺寸、窗口尺寸等。UI 类涉及 audio、点击外部、动态 CSS、拖拽、全屏、滑块、语音合成、震动、video。Animations 类含 useInterval、useRaf、useSpring、useTimeout、useTween、useUpdate。Side-Effects 类含 useAsync、useCookie、useCopyToClipboard、useDebounce、useFavicon、useLocalStorage、useSessionStorage、useThrottle、useTitle 等。Lifecycles 类含 useEffectOnce、useIsomorphicLayoutEffect、useMount、useUnmount、useUpdateEffect 等。State 类含 createGlobalState、createReducer、useBoolean、useCounter、useList、useMap、usePrevious、useSet、useToggle 等。Miscellaneous 含 useEnsuredForwardedRef。
使用方式:每个 Hook 条目附带简短说明与详细参考,使用时须查阅 ./references 中对应文档以获取用法与类型声明。注意调用规则:AUTO 表示适用时自动使用;EXTERNAL 仅在用户已安装所需外部依赖时使用,否则重新考虑,确需时再询问安装;EXPLICIT_ONLY 仅在用户明确要求时使用。提示词或 AGENTS.md 中的用户指令可覆盖默认调用规则。
适用场景:React 功能开发中的状态管理、副作用、生命周期、传感器监听、UI 交互与动画等。
限制:资料未提供版本、安装命令、许可证、性能数据与平台兼容性等具体信息。