用途:当 size-limit GitHub Action 失败,说明一个或多个 bundle 场景超过了 .size-limit.js 中配置的字节阈值。该技能引导完成构建、测量,并只上调需要调整的限额。
主要能力与用法:
- 构建全部包(含 CDN bundle),因为 size-limit 测量的是实际编译产物:yarn build。此步骤需数分钟,packages/browser/build/bundles/ 中的 CDN bundle 必须为最新,开发构建不够。
- 以 JSON 模式运行体积检查:yarn test:size-limit。JSON 输出为对象数组,每个对象含 name(场景标签)、passed(是否在限额内)、size(实际字节数)、sizeLimit(配置限额字节数)。
- 筛选 "passed": false 的条目,这些才是需要上调的场景。
- 计算新限额:将实际体积向上取整到下一个整 KB(此处 1 KB = 1000 字节,与 size-limit 解释 .size-limit.js 限额的方式一致)。例如实际 129,127 字节,新限额为 130 KB(即 130,000 字节)。该启发式偏保守,只给刚好够用的余量。
- 打开仓库根目录的 .size-limit.js,更新每个失败场景的 limit 字段,限额为类似 '130 KB' 的字符串。只改实际失败的场景,不要动通过的场景。
- 验证:重新运行 yarn test:size-limit 确认全部通过。若某场景仍失败(如取整边界情况),将该限额再上调 1 KB 并重跑。
适用场景:size-limit CI 检查失败、bundle 体积超限需要调整阈值时。
限制:仅适用于使用 .size-limit.js 与 size-limit 的仓库;需先完成完整构建;只应上调失败场景的限额。其他细节暂未提供。