用途:面向 TanStack Start 全栈 React 框架的开发模式参考,适用于编写文件路由、API 路由、服务端处理与 TanStack Router 布局,并集成 AI 聊天与 MCP 服务端。
主要能力: 路由:路由文件位于 src/routes/,自动生成 src/routeTree.gen.ts,需提交以支持类型检查。包含 __root.tsx 根布局、index.tsx 索引路由、demo.tsx 布局路由(用 <Outlet /> 包裹 demo/.tsx 子路由)、$param.tsx 动态段。布局路由可在 foo/ 目录旁建 foo.tsx,用 createFileRoute 与 Outlet 包裹子路由。 API 路由:以 api..ts 命名,使用 createFileRoute 的 server.handlers 定义 POST 等处理,返回 Response.json。 AI 聊天:客户端用 @ai-sdk/react 的 useChat 配 DefaultChatTransport 指向接口;服务端用 ai 包的 streamText,配合 OpenRouter provider 与 convertToModelMessages,返回 result.toUIMessageStreamResponse()。 OpenRouter:在 src/lib/openrouter.ts 用 createOpenRouter 创建单例,读取 process.env.OPENROUTER_API_KEY,示例模型为 anthropic/claude-3.5-haiku。 MCP 服务端:用 @modelcontextprotocol/sdk 的 McpServer,结合 zod 定义 inputSchema 注册工具,通过 handleMcpRequest 在路由 POST 处理中调用。 路径别名:@/* 映射到 ./src/*(在 tsconfig.json 配置)。
适用场景:需要在 TanStack Start 中组织路由、定义服务端接口、接入流式 AI 聊天或暴露 MCP 工具时参考。
限制:资料未提供安装步骤、版本要求、依赖清单、定价或完整项目配置,相关细节暂未提供。