用途:在构建 SolidStart 应用(SSR、文件路由、server functions)时提供规范指引,防止 'use server' 放置错误、水合中断等常见问题。
主要能力:说明架构栈(SolidJS 细粒度响应式、Vite 打包、Nitro 服务端运行时、Vinxi 统一 CLI 与配置);给出项目结构(src/routes 文件路由、entry-client.tsx、entry-server.tsx、app.tsx);列出文件路由约定(index、静态、嵌套、动态 [id]、可选 [[id]]、通配 [...path]、路由组 (admin)、API 路由);数据加载用 query() + createAsync(),变更用 action() 与表单,提交状态用 useSubmission/useSubmissions;server functions 支持函数级与文件级 'use server';SSR 支持 renderToString 与 renderToStream,客户端用 hydrate,并需在 head 中放置 <HydrationScript />;API 路由导出 GET/DELETE 等具名处理器。
必要用法与限制:'use server' 函数必须 async;redirect() 必须 throw 而非 return;不要使用 getServerSideProps、useLoaderData、useEffect 取数等 Next.js/React Router 模式;Route 用 component={Component} 而非 element;不要使用 0.x 的 createServerData$、createServerAction$;server function 参数与返回值必须可序列化(Seroval),不可传 DOM 节点、函数或类实例。
适用场景:SolidStart 1.0+ 的 SSR 页面、动态路由、表单变更、API 端点与迁移旧 0.x 代码。缺失信息:未提供收费、价格、平台与效果数据。