文档导航

AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 TanStack 文档整理。TanStack Query 与 TanStack Start 的 API 和发布状态会演进，请以各篇文档中标注的版本、资料日期与官方文档为准。

这里集中维护 TanStack Router、TanStack Query、TanStack Start 以及它们与 Convex、Cloudflare 等技术组合时的工程资料。站内所有涉及 TanStack 的页面均使用 TanStack 标签，包括仅在依赖或选型比较中提及的内容，可按标签聚合检索。

推荐阅读顺序

1. TanStack Router 入门：文件路由、类型安全导航、Loader 与 Search Params：先把应用骨架立起来——路由树、类型注册、Search Params 与路由级取数。
2. TanStack Query v5 基础：从 Server State 到 Query、Mutation 与缓存：再完成查询、写入、失效与缓存生命周期的 v5 基础闭环。
3. 全面掌握 TanStack Query：现代 React 应用的数据管理利器：作为历史 v4+ 参考阅读；新项目以 v5 文档与当前 lockfile 为准。
4. Convex + TanStack Query：useQuery 与 useSuspenseQuery 的选择、原理与场景：进入实时订阅、Suspense、SSR 与条件查询的组合场景。
5. TanStack Start Static Prerendering、经典 SSR 与 Cloudflare Workers Cache：区分构建期预渲染、运行时 SSR 与 HTTP 缓存的职责边界。
6. ClawHub 源码分析：Convex 架构、缓存、数据流与 PostgreSQL 选型：观察 TanStack Start/Router 如何与 direct Convex calls、Nitro proxy、SSR snapshot 和 reactive handoff 组合。
7. Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天：明确 Router、Query、Mutation 与 Agent transcript 在持久聊天中的职责边界。

相关方案比较

• BoardUI 与 HeroUI Pro：交付机制、设计原语与 Agent 开发体验：比较本地源码与组件包的维护方式，其中 BoardUI Data Table 使用 TanStack Table。

• Stripe 接入指南：角色、对象、Checkout 与 Webhook：说明 Checkout Session、Webhook 履约，以及 TanStack Start 服务端创建会话、TanStack Query 读取应用权限的分工。

• Polar 接入指南：基础概念、Sandbox 调试与商家主体变更：介绍 Checkout、Webhook、权限同步及 TanStack 服务端集成分工。

Skills 与工程工具

• 从两个 Grok Build Demo 学习 Agent Harness：复用边界、交互架构与验证证据：比较导出项目的共享基础与业务模块，说明脚手架依赖不等于当前功能必须启用的能力。

• 本地 Agent Skills 安装清单：查看 TanStack 系列 Skills 及其来源类别。