用途:为 TanStack Start 项目选择、实现、审查或调试渲染行为。先阅读 ../../docs/rendering.md,记录 SEO、首屏渲染、个性化、交互性、缓存、运行时与部署需求,再决定渲染模式。
主要能力与模式选择:请求时生成 HTML 用 SSR;构建期已知的有限公开路由用静态预渲染;仅在缓存语义明确安全时用 ISR;可接受客户端渲染外壳时用 SPA 模式;同一路由树不同分支行为不同用选择性 SSR;希望先出 HTML、交互稍后激活用延迟水合;仅在项目支持的构建集成与明确序列化约束下用 RSC。
正确性要求:首次客户端渲染需与服务端 HTML 一致;未弄清不一致原因前不要抑制水合警告;不得公开缓存用户特定输出;SPA 重写需保留 server function 与 server route 路径。
验证方式:同时测试直接请求与客户端导航,检查服务端 HTML、水合控制台输出、流式响应、缓存头、CDN 行为、禁用 JavaScript 流程、延迟交互与生产构建产物。
输出报告:说明所选模式、被否决的替代方案、缓存边界与运行时证据。
限制:资料未提供具体安装命令、代码示例、版本要求与平台支持细节。