SuperAPI AI 工具集

start-core

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:在搭建 TanStack Start 项目、接入构建工具或排查安装问题时提供指导,适合需要 SSR、流式渲染与类型安全服务端函数的新项目。

主要能力:明确 Start 基于 TanStack Router 与 Vite(也支持 Rsbuild),并非 Next.js,没有 getServerSideProps、"use server" 指令与 app/layout.tsx。路由位于 src/routes/,服务端专用逻辑使用 createServerFn,代码默认同构(loader 在服务端与客户端都会运行),类型完全推断,不应对推断值做类型断言或标注。

必要用法:每个应用需要两个手写接线文件与一个生成文件——src/router.tsx 提供返回 createRouter({ routeTree }) 的 getRouter() 工厂;src/routes/__root.tsx 作为文档外壳,含 html、HeadContent、Outlet、Scripts;src/routeTree.gen.ts 由插件生成,不可编辑。Vite 配置中 Start 插件必须排在 React 插件之前;可用 npx @tanstack/cli@latest create 脚手架,或克隆官方示例。

限制与禁止:React Vite 插件放在 tanstackStart() 之前会破坏生成;编辑 routeTree.gen.ts;在 __root.tsx 遗漏 Scripts 会导致无法水合;启用 verbatimModuleSyntax 会把服务端代码泄漏到客户端包;使用 Next.js/Remix 模式。执行前的 API 核对与具体脚本步骤属该技能工作流,资料未提供细节;深入的执行边界、代码组织等由其他技能处理。本技能针对 @tanstack/react-start v1.168.58。