用途:用于 SolidStart v2 应用开发,聚焦 Start 特有的架构与服务端边界,涵盖新建路由或页面、服务端读取、写操作与表单流程、认证会话与受保护路由、外部 API 或 webhook、元数据与 SEO、配置迁移与运行时问题。仅当涉及 Solid 核心响应式或组件语义时,才配合对应 Solid 技能使用。
主要能力与默认规则:服务端读取使用 query(..., key),写入与表单提交使用 action(..., key);用 route.preload 提前启动路由工作,除必要阻塞外不要 await;路由组件中用 createAsync(() => queryFn(...)) 消费异步数据;数据库、认证、会话、文件系统与依赖密钥的逻辑放在 "use server" 之后;优先使用原生 HTML 表单对接 action;middleware 处理轻量横切关注点,不作为主要鉴权层;仅在端点需被应用外消费或返回非 HTML 内容时使用 API 路由;保持服务端函数输入输出可序列化。
使用方式:先对任务分类,再选最小的 SolidStart 原生模式;按需查阅参考文件,如 data-and-mutations、auth-middleware-sessions、api-routes-and-responses、app-architecture、seo-meta-and-images、config-and-runtime、v2-changes-and-ecosystem、release-checklist。编辑既有应用时优先局部最小改动,不重写可用路由结构。完成后检查读取是否应建模为 query、写入是否应为 action、服务端专属逻辑是否留在服务端、重定向位置、路由元数据、middleware 轻量性与返回值可序列化性。
限制:版本边界上,Start v2 架构指导不等于应用已使用 Solid 2.x 核心语义,应用 2.x 专属建议前需检查本地已安装包。若本地仓库导出或包名与技能不同,以仓库实际依赖与当前包导出为准;谨慎对待仍提及 Vinxi 时代辅助函数的旧示例,优先使用当前本地导入。资料未提供具体收费、价格与更详细安装步骤。