严重性阈值

Minimum severity to post

Kody 会为每条建议分配严重性,只发布达到或高于你在滑块上所选级别的建议。默认值为 Medium。 Kody 仍然会发现较低严重性的问题,只是不会对它们发表评论。

级别	涵盖内容
Low/All	提升代码质量的细微改进 —— 小幅优化、风格改进、细节打磨。
Medium(默认)	推荐但不紧急的中等改进:最佳实践,预防未来的技术债。
High	应在近期处理的重要问题 —— 关键的质量改进、潜在风险、实质性的技术问题。
Critical	需要立即处理、可能严重影响稳定性、安全性或功能的问题。

大型 PR 上噪音过多,通常是严重性的问题,而不是数量的问题。在尝试其他手段之前先调到 High —— 你会保留所有真正的 bug,只丢掉吹毛求疵的部分。参见如何减少代码审查噪音。

对 Kody Rules 应用阈值

同一卡片中的一个开关,默认关闭。

关闭 —— Kody Rules 的发现会绕过严重性阈值。团队自己编写的规则,无论被判定为何种严重性,都始终会被报告。

开启 —— Kody Rules 与其他建议一样,经过相同的严重性阈值。

除非你的规则产生的噪音多于信号,否则请保持关闭。Kody Rule 的意义正在于:团队已经认定这件事很重要。

在 kodus-config.yml 中,这两项设置位于 suggestionControl 之下:

suggestionControl:
    severityLevelFilter: 'medium' # low | medium | high | critical
    applyFiltersToKodyRules: false

请记住,只有在你启用 kodusConfigFileOverridesWebPreferences 之后,该文件才会被读取 —— 参见通用设置。

减少噪音的其他方式

严重性阈值是一把钝刀。当你需要更有针对性的手段时:

Ignored files —— 完全跳过生成代码、锁文件和 vendored 目录。参见通用设置。

类别 —— 在用不上的代码库中,通过 What to review 上对应的开关直接关闭整个类别(例如 Performance)。

目录级配置 —— 在 monorepo 中按文件夹应用更严格或更宽松的阈值。参见目录级配置。

Kody Rules —— 把团队真正在意的东西固化下来,让信号来自你们的标准,而不是泛泛的建议。

Minimum severity to post