前置：React 组件与 Hooks、Promise；已完成环境搭建。适用 TanStack Query v5。目标是亲手验证读取、错误、写入、失效四个行为。

Headless 把行为与外观分开。表格库可以知道排序方向，却不知道你要蓝色按钮还是无边框表头。

QueryClient 保存查询缓存，Provider 让组件访问同一个实例。每次渲染都创建新实例，会让缓存身份变得不稳定。

Next.js 完整框架：把路由、渲染、取数、缓存和部署拆成五个决定。先确定代码执行位置，再决定数据新鲜度，最后用测量选择优化。

前置：已有能启动的 Next.js App Router + TypeScript 项目，知道客户端组件与事件处理器。本文包含多个独立片段，Context、Zustand、查询库与表单部分不是一套可直接拼接的应用；先只接入下文 Counte