用途:设计、实现、审查或调试 TanStack Start 与 TanStack Router 的路由,适用于文件路由结构、根路由、布局、参数、搜索参数校验等任务。
主要能力与做法:先阅读 ../../docs/routing-and-data.md,检查源路由文件、生成的路由树、router context 以及被修改的具体 URL,确认任务影响直接请求、客户端导航还是两者。用现有文件路由约定表达层级;在路由边界校验路径与搜索输入;在 loader dependencies 中声明每个 loader 输入;避免在同构 loader 中放置密钥或直接访问数据库;受保护的服务器工作使用 server functions;使用类型化链接、导航、重定向和路由 API;提供明确的 pending、error 与 not-found 行为。将 beforeLoad 视为导航与上下文控制,并在 server function 或 server route 中再次强制受保护数据访问。
性能与验证:并行化独立的 loader 工作;仅在网络与计算成本合理时使用预加载;在生产输出中验证自动或显式代码分割是否生效,而非假设已发生。运行路由树生成与类型检查;测试有效与无效参数/搜索、直接加载、客户端导航、loader 失效、pending 状态、错误边界与 not-found 状态;对导航可见的改动使用浏览器验证。
限制:资料未提供具体安装命令、版本要求或收费信息;实际实现需以项目现有约定与文档为准。