用途
Tailing Build Output 用于在构建过程中实时监控终端输出,及时发现并修复错误,同时收集警告以便构建结束后统一处理。适用于 webpack、turbo、docker、tsc、vite build 等构建流程。
主要能力
- 启动或定位正在运行的构建终端。
- 周期性读取终端文件,识别错误、警告和进度指示。
- 错误类型包括:ERROR / Error: / error TS、Module not found / Cannot find module、SyntaxError / TypeError、Failed to compile。
- 警告类型包括:WARNING / Warning: / warn、Deprecation / deprecated、未使用的导入或变量、包体积过大警告(asset size limit)。
- 进度指示:Webpack 的 [XX%]、modules、chunks;Turbo 的任务完成日志;Docker 的 Step X/Y;TypeScript 的文件计数。
- 构建完成后生成摘要报告,包含状态(失败/成功)、耗时、已修复错误数、剩余警告列表。
使用方式
-
启动构建或查找正在运行的构建终端:
head -n 10 <terminals_folder>/*.txt查找类似 npm run build、pnpm build、turbo build、docker build、tsc、vite build 的命令。
-
周期性轮询终端文件,读取输出。
-
发现错误时立即修复:
- 从错误中提取文件路径和行号。
- 读取并修复源文件。
- 若构建支持 watch 模式,会自动重新触发;否则记录修复并让构建继续,可能暴露更多错误。
-
构建完成后(检查终端页脚的 exit_code)输出摘要报告,格式示例:
Build Summary: Status: Failed (exit code 1) / Succeeded Duration: ~45s Errors fixed: 3 Remaining warnings: 2 - Large bundle: src/pages/Dashboard.tsx (450kb) - Deprecated API: useRouter from 'next/router'
适用场景
- 开发过程中需要快速发现并修复构建错误的场景。
- 使用 watch 模式的构建流程,可自动重新触发验证修复。
- 需要汇总构建警告以便后续优化的场景。
限制与提示
- 构建过程中不要修复警告,应收集后统一处理。
- 对于 turbo build,错误可能出现在并行任务输出中,需检查所有任务日志。
- Docker 构建会缓存层,若修复 Dockerfile 中较早的文件,后续层会重新运行。
- TypeScript 的 --noEmit 可用于仅类型检查而不进行完整构建。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。