用途:在 codometer --check 以非零退出、注释预算越限、已提交报告过期或运行直接失败时,按发现类型采取对应处理。
主要能力:区分三类发现。越限指某指标超过为其声明的 limits[] 值:warn 只打印越限、不改变退出码;fail 仅在运行请求 --check limits 门禁时退出 1,裸 measure 不报错。修复方向是减少被测量的实际内容(如裁剪依赖、拆分 bundle、删除死代码),而非提高 limit 值。约定计数越限通常计数准确,应改被计数的代码。注释预算越限按 custom.<label> 指标门禁,实例会给出文件与行号;注意 shell、TOML、SQL、HCL 的行扫描器会把字符串字面量中的注释标记当作注释,Python 在解释器无法运行时完全不测量注释。未声明注释选择器的语言不测量,不算越限。
过期:--check reports 将已提交报告与新鲜测量对比,不一致即失败。原因可能是代码变更后未重新测量(用 --output-json/--output-markdown 刷新),也可能是运行时变化(压缩大小依赖 Node 版本,zlib 随版本不同),应在仓库固定的运行时上检查。越限与过期是独立发现,不可互相当作症状。
运行直接失败:包括 limit 绑定到不存在的指标路径、带 limit 的 input 未匹配任何文件(先查构建步骤)、配置在加载时被拒绝(缺少 format、同类型 outputs 重复、custom 未声明 patterns/symbols/comment、outputs 引用未声明的 custom 标签、导出函数而非普通对象会回退为空配置)。一次运行的所有失败会一起报告,应逐项修复而非重试。
限制:--output-* 与 --check 相互独立,组合使用会被直接拒绝;--inputs 不影响是否门禁或写出;measure 没有 --directory,始终测量进程工作目录,仅 configuration 子命令保留 -d, --directory。资料未提供安装命令、价格与平台信息。