用途:审计并减少 Next.js 应用浏览器初始加载的工作量,适用于路由启动慢、客户端包过大、浏览器依赖重复,或可延迟到交互后再加载的功能。默认分析整个应用,覆盖全部路由与共享客户端依赖;仅在用户指定路由、依赖或功能时收窄范围。
主要能力:提供审计与修复两种模式。审计为默认模式,生成分析产物并报告候选项,不改动应用源码、依赖与锁文件;修复模式需用户明确要求才会改动应用。涉及可见行为、时序、兼容性或信任边界的改动需先询问。若关注路由的静态 App Shell 或导航预取,资料分别指向 next-cache-components-optimizer 与 next-partial-prefetching-optimizer,需先安装。
使用方式:在应用目录用其包管理器运行。先捕获并导出基线,命令示例:pnpm exec next analyze --output --snapshot 'audit-before-unique-1',再 pnpm exec next analyze export --snapshot 'audit-before-unique-1' | gzip > /tmp/analyze-app-before.jsonl.gz。若沙箱阻止 TCP 端口绑定(如 Codex),必须在沙箱外执行捕获。导出为每行一条 JSON 记录,错误写入 stderr;自定义 distDir 需用 --dist-dir 重放。导出校验按单路由进行,失败可能留下不完整归档,需丢弃输出。
分析与验证:从已安装 Next.js 解析 graph-v1.schema.json,用 gzip -dc 流式分析,解读各路由的客户端/服务端贡献并选择指标。候选人需记录范围、覆盖、归因、可达性、源码检查与方法等清单项。修复模式每次只做一处小改动,前后快照用不同名称对比同一范围、输出类别与指标,并运行行为测试与类型检查,指标改善且行为通过才保留改动。
限制:报告需区分源码事实、构建证据、启发式与运行时事实;关于浏览器请求、时序或传输节省的断言需另行取证。未提供的价格、平台支持与具体效果暂未说明。