Vite 产物诊断要不要上 AI：先让确定性插件干完活

Vite 产物诊断要不要上 AI先让确定性插件干完活构建链路中既有适合规则化处理的任务也有需要人工分析的模块边界问题。无论是否使用 AI都不应让它自动修改生产构建配置。构建链优化到底哪些该用死命令和静态脚本哪些才真正值得交给 AI Agent先把这个问题搞清楚你的工程治理才不会跑偏。flowchart TD A[Vite 打包构建产物与日志] -- B{问题场景判定} B -- 规则明确 (如 Chunk 尺寸超标/依赖重复) -- C[确定性 Node.js 静态脚本/Rollup 插件] B -- 场景复杂 (如 隐式循环依赖分析/跨模块 Dynamic Import 重构) -- D[AI Agent 分析与工具调用] C -- E[自动输出确切 manualChunks 规则] D -- F[Agent 生成依赖拆分方案提案] F -- G[人类工程师 Code Review 校验] E -- H[Vite 构建 Pipeline 卡点与产物验证] G -- H1. 别把确定性脚本能做的事硬塞给 AI工程师最容易犯的一个错误是把所有工程难题都当成 AI 的技术试验场。在 Vite 和 Rollup 的构建体系里有太多问题完全是纯数学和规则推导。例如Chunk 体积过大警告 (Chunk Size Limit)根据 Rollup 编译图找到体积最大的node_modules依赖包然后配一个manualChunks将其独立打包。这只需要几十行 JavaScript 脚本就能精准搞定根本不需要消耗 Token 让大模型去思考。重复依赖包检测 (Duplicate Packages)扫描package-lock.json或pnpm-lock.yaml提取版本冲突。静态资源未压缩检查图片和 Font 文件尺寸触发插件自动压缩。这些场景适合用 CLI、锁文件解析和构建插件处理结果可复现也便于在 CI 中验证。AI 的建议应只作为待审阅的提案。AI 真正的能力边界在于非结构化问题的成因诊断与跨模块优化决策。比如两个异构模块之间产生的隐式循环依赖循环Circular Dependency或者根据用户行为日志反向推演的最佳预加载Preload路径策略。2. 编写轻量级 Vite 产物诊断插件在决定要不要调用 AI 之前我们首先需要一个能实时感知构建链路健康度的 Vite 插件。这个插件不仅能准确抓取产物分布还能给出结构化的 JSON 报告作为决定后续是触发“静态脚本”还是“AI 诊断”的数据门槛。import type { Plugin, ResolvedConfig } from vite; import fs from fs; import path from path; export interface ChunkAnalysisReport { timestamp: number; totalSize: number; largeChunks: Array{ fileName: string; sizeKb: number }; hasCircularDeps: boolean; recommendedAction: PASS | RUN_STATIC_FIX | TRIGGER_AI_AGENT; } export function viteBuildHealthGuardPlugin(options { thresholdKb: 500 }): Plugin { let config: ResolvedConfig; return { name: vite-plugin-build-health-guard, apply: build, configResolved(resolvedConfig) { config resolvedConfig; }, writeBundle(outputOptions, bundle) { const largeChunks: Array{ fileName: string; sizeKb: number } []; let totalSize 0; for (const [fileName, chunkInfo] of Object.entries(bundle)) { if (chunkInfo.type chunk) { const sizeKb Buffer.byteLength(chunkInfo.code, utf8) / 1024; totalSize sizeKb; if (sizeKb options.thresholdKb) { largeChunks.push({ fileName, sizeKb }); } } } // 根据阈值决定治理路径 let recommendedAction: ChunkAnalysisReport[recommendedAction] PASS; if (largeChunks.length 0 largeChunks.length 3) { // 少量 Chunk 超标静态规则即可解决 recommendedAction RUN_STATIC_FIX; } else if (largeChunks.length 3) { // 复杂乱麻交织需要触发 Agent 进行依赖链路重构分析 recommendedAction TRIGGER_AI_AGENT; } const report: ChunkAnalysisReport { timestamp: Date.now(), totalSize: Math.round(totalSize), largeChunks, hasCircularDeps: false, // 可结合 external analyzer 拓展 recommendedAction, }; const outputPath path.resolve(config.root, dist/build-health-report.json); fs.writeFileSync(outputPath, JSON.stringify(report, null, 2)); console.log(\n[Vite Build Health Guard] 产物分析报告已存入: ${outputPath}); console.log([Recommended Action Path]: ${recommendedAction}\n); }, }; }3. 分道扬镳静态自动化与 AI Agent 协助当插件测出RUN_STATIC_FIX时我们直接跑基于静态规则的 Rollup 分拆脚本。只有在触发TRIGGER_AI_AGENT阈值时才把构建元数据打包调用 LLM Agent 工具帮我们推演解耦方案。下面是自动化决策分发脚本的代码实现import fs from fs; import path from path; import { ChunkAnalysisReport } from ./vite-plugin-build-health-guard; async function processBuildGovernance() { const reportPath path.resolve(process.cwd(), dist/build-health-report.json); if (!fs.existsSync(reportPath)) { console.error(未找到构建分析报告请先执行 vite build); process.exit(1); } const report: ChunkAnalysisReport JSON.parse(fs.readFileSync(reportPath, utf-8)); switch (report.recommendedAction) { case PASS: console.log(✅ 构建体积与 Chunk 分布符合基线无需拦截。); break; case RUN_STATIC_FIX: console.log( 触发确定性 Node.js 规则脚本自动拆分常规第三方大包...); applyStaticManualChunksRule(report.largeChunks); break; case TRIGGER_AI_AGENT: console.log( 触发 Agent 高级工作流开始分析复杂循环依赖与动态导入路径...); await invokeAIAgentForBundleOptimization(report); break; } } // 路径 1确定性静态规则处理 function applyStaticManualChunksRule(largeChunks: Array{ fileName: string; sizeKb: number }) { const viteConfigPath path.resolve(process.cwd(), vite.config.ts); console.log([Static Rule]: 建议在 ${viteConfigPath} 的 manualChunks 中对以下文件增加分包配置:); largeChunks.forEach((c) console.log( - Vendor Chunk: ${c.fileName} (${c.sizeKb.toFixed(1)} KB))); } // 路径 2AI Agent 辅助决策处理 (工具调用模式) async function invokeAIAgentForBundleOptimization(report: ChunkAnalysisReport) { const prompt 你是一位 Vite/Rollup 构建链调优专家。以下是当前项目的复杂打包健康报告 ${JSON.stringify(report, null, 2)} 请不要给出泛泛而谈的建议。你需要使用 Node.js 分析工具对产生上述大 Chunk 的源码模块提取依赖图并输出具体的代码重构步骤与 manualChunks 替代配置。 ; console.log([Agent Prompt Payload Prepared]: 正在向后台 Agent 服务提交构建依赖图上下文...); // 模拟 Agent 接口调用与提案生成 const agentProposal { strategy: Refactor Dynamic Imports Isolate Node Modules, suggestedConfigFileEdits: manualChunks(id) { if (id.includes(node_modules/lodash-es)) return vendor-lodash; if (id.includes(node_modules/three)) return vendor-three; } , }; console.log([Agent Optimization Proposal Received]:); console.log(agentProposal.suggestedConfigFileEdits); console.log(⚠️ 请人类工程师确认后手工合并该修改严禁 Agent 自动写入生产配置文件。); } processBuildGovernance();4. 治理 Vite 构建链路的工程原则给构建链路加 AI可以先守住三条边界确定性优先能用正则表达式、AST 静态解析或算法解决的问题绝不用 AI。人类为最后一把关人 (Human in the Loop)AI Agent 提出的构建配置修改如vite.config.ts变更必须生成 Markdown Proposal经由 CI 中的 PR 由工程师审核决不允许 Agent 拥有生产编译脚本的直接写入权限。构建耗时可度量记录引入流程前后的耗时、失败率和人工处理时间收益不足时应移除该环节。先用可复现的工具产出事实再让 AI 提出候选解释并由工程师验证和合并变更。构建过程本身仍要保持稳定、可预测。