`discount_overlaps` 是 Elasticsearch/Lucene 相似度模型（Similarity）里的一个布尔参数，用来决定：

> 在计算文档长度归一化因子（norm）时，是否忽略“重叠 token”（即位置增量 positionIncrement=0 的 token）。

---

✅ 默认值与含义

参数值 含义 

`true`（默认） 重叠 token 不计入文档长度，不影响 norm 

`false` 重叠 token 会计入文档长度，参与 norm 计算 

---

✅ 使用场景举例

- 如果你使用了 同义词过滤器（synonym filter），多个同义词可能会落在 同一位置，这些 token 的 `positionIncrement=0`。

- 默认 `discount_overlaps=true` 会让这些 token 不影响文档长度，从而避免重复同义词“人为”拉长文档。

- 如果你希望这些 token 也参与长度计算，可设为 `false`。

---

✅ 配置示例（BM25）

```json

PUT /my_index

{

  "settings": {

    "index": {

      "similarity": {

        "my_bm25": {

          "type": "BM25",

          "k1": 1.2,

          "b": 0.75,

          "discount_overlaps": false

        }

      }

    }

  },

  "mappings": {

    "properties": {

      "title": {

        "type": "text",

        "similarity": "my_bm25"

      }

    }

  }

}

```