概念

扫描配置

inspect.software 方法论的部分内容如何按扫描逐次关闭——以及每份报告如何准确记录哪些内容被衡量、哪些没有。

方法论 v1.13.0更新于 2026-07-13

一次扫描可以关闭方法论的任何部分——单个组成部分、整个指标,或整个类别。此机制服务于正当的范围收窄(例如排除流行度信号的内部政策、仅限安全的认证),同时确保每个已发布的结果保持诚实:配置 嵌入在报告本身之中,因此哪些内容被衡量、哪些没有,始终一目了然。

禁用如何生效

禁用的行为与缺失数据完全一致(参见健康指数):被禁用的项目被排除,其余权重重新归一化。结果始终保持在 1–100 分值上,绝不会因刻意不衡量的内容而被零分拖低。禁用某类别中的全部指标——或禁用类别本身——会将该类别从总指数中移除,其权重重新分配。

// scan-config.json
{
  "disabled_categories": ["security"],
  "disabled_metrics": ["popularity"],
  "disabled_components": {
    "documentation": ["Wiki", "Topics"]
  }
}

类别与指标的键名即各维基条目中记载的标识符(securitypopularitysecurity_posture……);组成部分名称为指标卡片上显示的确切名称(WikiStarsREADME……)。未知键名将作为警告报告并被忽略。

配置不能做什么

配置只选择固定方法论中哪些部分处于启用状态——它绝不改变任何公式、权重或等级阈值。这些仍由版本化方法论管辖(参见 方法论版本)。不存在任何机制——无论付费与否——可以调整某个启用中指标的计算方式。

经配置的扫描如何呈现

  • 每份报告在顶层携带其配置,因此结果可按发布原样复现。
  • 报告会渲染一个扫描配置章节,列出所有被禁用的内容——或声明完整方法论已运行。
  • 每个受影响指标的 note 都记录了重新归一化,恰在读者会查看的位置。
透明规则。范围收窄的扫描是对一个更窄问题的有效度量——而报告始终说明所问的是哪个问题。

相关条目:健康指数 · 信号,而非担保