SuperAPI AI 工具集

specsfy-specialist-nextjs

前端与建站

查看项目

更新于 10-16 03:49

技能介绍

用途:当项目依赖 next/next.config,且任务涉及路由、layout、Server/Client Component、Server Action、route handler、缓存、middleware、metadata 或部署时触发;也用于诊断数据 waterfall、hydration mismatch、缓存返回过期数据或跨用户串数据。不依赖框架的 hooks、状态与组件组合应交给 $specsfy-specialist-react。

主要能力与用法:先确认 Next.js 版本、App/Pages Router、运行时(Node 或 Edge)、部署目标与实验性开关;映射改动路由的 layout、loading、error、not-found 及数据/交互边界。默认使用 Server Component,仅在真正需要 hook、事件或浏览器 API 的叶子组件标注 "use client"。为每个数据源显式定义缓存、再验证与 tag,把默认行为视为已安装版本的契约。在每个 Server Action 和 route handler 内做输入校验与授权,如同公开 HTTP 端点。设计 metadata、流式渲染(loading.js/Suspense)、图片/字体与错误恢复路径。完成后执行 lint、类型检查、测试、生产构建,并在目标 adapter/host 的真实运行时验证。

关键限制:不要把整棵树改成 "use client";不要在 Client Component 引入密钥、数据库客户端或 server-only 模块;避免多层嵌套重复取数造成顺序请求;变更后需 revalidatePath/revalidateTag,否则 UI 显示旧缓存;内部环境变量在 Client Component 中不存在(需 NEXT_PUBLIC_ 前缀);middleware 仅放短逻辑,重型逻辑放 route handler。验证需覆盖 next build 的路由报告(静态、动态、ISR)与声明意图是否一致,并实测缓存命中/失效、跨会话不泄漏、客户端 bundle 与 Web Vitals。

未在资料中提供的价格、收费、平台支持范围等信息暂未提供。