SuperAPI AI 工具集

next-cache-components-optimizer

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:把某条 Next.js 路由从“非即时”驱动到“即时”导航,并保持稳定。核心交付物不是某条路由本身,而是一套可复用的验证循环:用 @next/playwright 的 instant() 编码目标为失败的测试,修到通过后作为回归守卫,每条目标路由执行一次。

主要能力:采用测试驱动的工作流,按 P → G 阶段推进,每阶段设门禁。要求 Next.js 16.3+ 且 next.config.ts 中启用 cacheComponents: true,@next/playwright 与 next 保持同一发布线,并在生产构建中通过 experimental.exposeTestingApiInProductionBuild 暴露测试 API。优化目标为最大化静态壳,让最有意义的内容立即提交,仅真正的请求级数据随后流式输出;修复配方存于 reference/patterns.md 与 reference/real-app-patterns.md,按阶段按需查阅。

使用方式:先满足前置条件,必要时用 npx @next/codemod upgrade 升级。首次在仓库使用时按 rig-template.md 填写 instant-nav.rig.md,记录构建、部署、认证与测试方式。工作流阶段包括 P 前置、0 设置、A RIG 生产构建、B 无锁基线、C 加锁 RED、C-gate 验证 RED 可信、D 修复(下推 Suspense 边界,复用现有 loading UI)、E 对等性、F 差分验证、G 审查。仅 C 阶段的加锁测试需要随 PR 发布,基线测试发布前删除。

适用场景:已启用 Cache Components 的 Next.js 应用,希望改善初次硬导航与客户端软导航的即时性。

限制:不得在 next dev 上测量,须用生产构建;动态段缺少 generateStaticParams 会让路由成为 fallback 路由,layout 中的顶层 await 会阻塞整个子树;现有资料仅覆盖到 F 阶段说明,G 阶段 PR 清单未提供,具体价格与平台绑定信息暂未提供。