SuperAPI AI 工具集

solid-tanstack-start

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:为 TanStack Start v1.168.58 项目(Vite 插件 tanstackStart()、src/routes/ 文件路由、createServerFn 服务端函数)提供 SOLID 与整洁架构规范。Start 代码默认同构,架构需显式区分服务端与客户端边界。

主要能力与规则:数据库访问、密钥、文件系统操作必须放在 createServerFn().handler() 或 createServerOnlyFn 内,不能放在裸 loader 中;禁止手改生成的 src/routeTree.gen.ts;禁止在路由或组件文件内声明类型,接口放在 src/modules/[feature]/src/interfaces/;每个导出必须有 JSDoc;禁止 barrel exports(index.ts 再导出)、禁止 any 类型;源文件不得超过 FUSE_SOLID_MAX_LINES;除 cores/ 外,模块不得导入其他功能模块。

使用方式:实现前先探索 src/routes/ 与 modules/ 了解约定,阅读相关路由及其 createServerFn 包装,确认命名、路径别名(~/、@/)与数据流模式。写新代码前先 grep 相似函数、loader 或服务端函数,检查 src/modules/cores/、src/lib/ 是否已有可复用逻辑;被 2 个以上功能使用的逻辑应放入 src/modules/cores/。新建文件后运行 npx jscpd ./src --threshold 3。references/templates/ 提供 route、server-fn、interface、hook 模板。

适用场景:组织 TanStack Start 代码、拆分超大路由或服务端函数、审查架构。

限制:不用于框架初始搭建(用 start-core)、不用于服务端/客户端执行边界深入讲解(用 start-execution-model)、不用于无 Start 路由树的普通 React SPA(用 solid-react)。编码前需先查阅当前文档(Context7 + Exa)。