AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 TanStack 文档整理。TanStack Query 与 TanStack Start 的 API 和发布状态会演进，请以各篇文档中标注的版本、资料日期与官方文档为准。
这里集中维护 TanStack Router、TanStack Query、TanStack Start 以及它们与 Convex、Cloudflare 等技术组合时的工程资料。站内所有以 TanStack 为主题或深度使用 TanStack 的文档统一带 TanStack 标签，可按标签聚合检索。
推荐阅读顺序#
- TanStack Router 入门：文件路由、类型安全导航、Loader 与 Search Params：先把应用骨架立起来——路由树、类型注册、Search Params 与路由级取数。
- TanStack Query v5 基础：从 Server State 到 Query、Mutation 与缓存：再完成查询、写入、失效与缓存生命周期的 v5 基础闭环。
- 全面掌握 TanStack Query：现代 React 应用的数据管理利器：作为历史 v4+ 参考阅读；新项目以 v5 文档与当前 lockfile 为准。
- Convex + TanStack Query：
useQuery与useSuspenseQuery的选择、原理与场景：进入实时订阅、Suspense、SSR 与条件查询的组合场景。 - TanStack Start Static Prerendering、经典 SSR 与 Cloudflare Workers Cache：区分构建期预渲染、运行时 SSR 与 HTTP 缓存的职责边界。
- ClawHub 源码分析：Convex 架构、缓存、数据流与 PostgreSQL 选型：观察 TanStack Start/Router 如何与 direct Convex calls、Nitro proxy、SSR snapshot 和 reactive handoff 组合。
- Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天：明确 Router、Query、Mutation 与 Agent transcript 在持久聊天中的职责边界。