用途:该技能说明如何在 TanStack Start(@tanstack/react-start v1.168.58)中编写服务器路由,即在 src/routes/ 中与页面路由并列定义的原始 HTTP 端点。选用原则是:接口需被应用外部调用(webhook、公开 REST、跨域)时用服务器路由;仅应用内部调用的类型安全 RPC 用服务器函数。
主要能力:通过 createFileRoute 的 server 属性声明 handlers(GET、POST 等);handler 上下文包含 request、params、context、pathname、next;支持文件名带来的动态参数($id)与 splat 参数($);支持 server.middleware 作用于全部 handler,或用 createHandlers 为单个 handler 配中间件;同一文件可同时作为 UI 路由(component)与 API 路由(server)。资料附有带参数与中间件的完整 REST 资源模板。
用法要点:handler 必须返回 Response 或 Promise<Response>,JSON 用 Response.json() 或 new Response(body, { status, headers });必须 await request.json()/.text()/.formData();同一路径只能由一个 handler 文件解析(routes/users.ts、routes/users/index.ts、routes/users.index.ts 都指向 /users,重复会报错)。文档还要求实现前对照 Context7(/websites/tanstack_start_framework_react)与 Exa 核对 API,改动后运行 fuse-ai-pilot:sniper。
限制:不适用于仅本应用可调用的内部 RPC、可复用中间件链以及 UI 路由渲染;其他细节及官方说明暂未提供。