SuperAPI AI 工具集

next-cache-components-optimizer

前端与建站

查看项目

更新于 10-16 08:46

技能介绍

用途:优化启用了 cacheComponents: true 的 Next.js 应用,二选一:提升单页首屏的静态壳(页面渲染循环 ppr-loop.md),或改善 A 到 B 的应用内导航体验(导航循环 instant-nav-loop.md)。

前置条件:需先启动 next-dev-loop,它会打开有头浏览器、提供 agent-browser CLI 和 mcp get_logs 的 dev MCP 服务器;next.config.ts 中必须有 cacheComponents: true,否则拒绝执行。用户需自行在有头浏览器中登录并准备好页面状态,本技能无法处理登录、SSO 或 MFA。

主要能力与用法:两循环共享 instant cookie(next-instant-navigation-testing,待锁元组 [0, "p<random>"]),冻结动态数据写入后捕获静态壳与 Suspense 回退。共用重构手段包括 Push down(把 I/O 提取到 Suspense 包裹的子组件)与 Cache('use cache' + cacheLife 配置,需询问新鲜度)。每次重构经 plan mode 提出方案后再应用。验证要求前后截图可见差异,需先隐藏 nextjs-portal。

适用场景:单路由初始加载问题选页面渲染,跨路由导航问题选导航循环,含糊时询问。

限制:若路由完全阻塞(blocking-route 或 NEXT_STATIC_GEN_BAILOUT 500、无 Suspense 边界)则无壳可优化,需先自行包裹 Suspense。反模式:不要用顶层 loading.tsx 或全局 Skeleton 替代细粒度 Suspense 边界。开发环境不预取、路由首次命中才编译,需轮询 DOM 稳定后再截图;诊断管线可能不稳定,结果异常时重跑 2–3 次。收尾需用过期时间覆盖 cookie 删除,勿用无参 cookies clear。