SuperAPI AI 工具集

next-cache-components-optimizer

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:让 Next.js 路由在初次加载(硬导航)或客户端导航(软导航)时立即提交最有意义的可用界面,只把真正需要请求时计算的内容放到之后流式传输。

主要能力:以测试驱动方式建立“未即时→即时”的优化闭环。把目标写成失败的 @next/playwright instant() 测试,修至通过后保留测试作为回归防护。每个目标路由与入口点执行一次,按 P→G 阶段推进,每阶段以门禁结束。

前置条件:Next.js 16.3+,并在 next.config.ts 中设置 cacheComponents: true,否则没有可优化的静态外壳。@next/playwright 需与项目 next 同一版本线。需在 next 运行时暴露测试 API,由 experimental.exposeTestingApiInProductionBuild 控制。升级可用 npx @next/codemod upgrade。

使用方式:在仓库首次使用时建立 rig,并写入 instant-nav.rig.md,后续运行读取该文件。不得用 next dev 测量;测量用生产构建(本地 next build && next start、CI/暂存容器、预览部署均可)。先做未加锁基线确认标记可渲染,再做加锁 instant() 的 RED,验证 RED 可靠后才能修。修复参考“优化静态外壳”指南,按阻塞原因选择模式:静态 UI 被更大加载态遮住、数据获取位置过高、新边界需稳定 fallback、结果可跨请求复用。完成后做 PARITY 校验,再做差分验证(只回退修复→RED,重新应用→GREEN),最后走 PR 审查。

适用场景:希望路由的可用 App Shell 立即出现,且仅请求时工作随后流式呈现的 Next.js 项目。若 URL 专属内容才是唯一缺少的即时界面,则转交 next-partial-prefetching-optimizer。

限制与注意:不得用 export const instant = false、削弱契约或空文档外壳充当优化;不得替换可变读取为构建时导入;不得为方便测试而改动现有数据源、生产选择器或必需路由变体。instant() 是标尺而非计时器。具体平台、环境变量与命令仅作示例,需按自身技术栈改写;资料未提供价格、收费或具体效果数据。