用途：在 React / Next.js 应用中搭建或重构异步状态管理，替代 useEffect + useState 的取数方式，处理缓存、后台同步、请求去重、分页与加载/错误状态。
主要能力：设计基于数组的查询键与查询键工厂；配置全局或单查询的 staleTime、gcTime、retry；编写 useMutation 处理 POST/PUT/DELETE；用 queryClient.invalidateQueries 在变更后失效缓存；实现乐观更新（onMutate 快照、onError 回滚、onSettled 重新拉取）；与 Next.js App Router 集成，包括 QueryClientProvider 初始化、Server Component 预取与 dehydrate/HydrationBoundary 水合。
必要用法：把 useQuery、useMutation 抽象为自定义 hook；查询键用数组并保持顺序；staleTime 控制何时触发后台刷新，gcTime 控制未激活数据在内存中保留时长，gcTime 小于 staleTime 会导致数据先被删除；用 enabled 实现依赖查询。
限制：仅在任务与上述范围明确匹配时使用；输出不能替代针对具体环境的验证、测试或专家审查；缺少必要输入、权限、安全边界或成功标准时应暂停并询问。资料未提供收费、价格与平台信息。