Typesense v0.26.0 版本新增基于标签的搜索覆盖功能

在Typesense最新发布的v0.26.0版本中，引入了一项强大的新功能——基于标签的搜索覆盖规则。这项功能为开发者提供了更精细化的搜索控制能力，可以根据特定的标签条件来触发预定义的搜索结果覆盖规则。

功能概述

搜索覆盖功能允许开发者为特定搜索条件预设自定义的搜索结果。在v0.26.0之前，这种覆盖只能基于搜索查询内容本身。现在，通过新增的标签匹配机制，开发者可以进一步限定覆盖规则的触发条件，使其只在特定的业务场景下生效。

技术实现细节

新版本在覆盖规则配置中增加了tags字段，这是一个字符串数组，用于指定触发该规则所需的标签。当且仅当搜索请求中包含override_tags参数且其值与规则中定义的任一标签匹配时，相应的覆盖规则才会被触发。

配置示例：

{
  "overrides": [
    {
      "id": "custom-rule",
      "includes": [ {"id": "8", "position": 1} ],
      "rule": {
        "match": "contains",
        "query": "the",
        "tags": ["email", "web"]
      }
    }
  ]
}

使用场景

这项功能特别适用于以下场景：

1. 多渠道搜索优化：可以为网站搜索和邮件搜索配置不同的覆盖规则，即使搜索词相同也能返回最适合该渠道的结果。

2. A/B测试：通过为不同测试组分配不同标签，实现搜索结果的差异化展示。

3. 权限控制：基于用户权限标签显示不同的搜索结果，实现数据隔离。

4. 多租户系统：为不同租户定制搜索体验，同时共享基础搜索逻辑。

匹配规则详解

标签匹配遵循以下逻辑：

• 搜索请求必须包含override_tags参数
• 参数值可以是单个标签或多个逗号分隔的标签
• 只要参数值中包含规则定义的任一标签，规则即被触发
• 标签匹配是大小写敏感的

有效触发示例：

• override_tags: email
• override_tags: web,something
• override_tags: something,email
• override_tags: web,email

无效情况：

• 未提供override_tags参数
• 提供的标签与规则中定义的不匹配

最佳实践建议

1. 为标签使用有意义的命名，反映其业务用途而非技术实现。

2. 避免过度使用标签，保持规则的简洁性和可维护性。

3. 考虑将常用标签定义为常量或枚举，确保全系统一致使用。

4. 在文档中记录所有使用的标签及其用途，便于团队协作。

这项功能的加入使Typesense的搜索定制能力更上一层楼，为复杂业务场景下的搜索需求提供了更灵活的解决方案。开发者现在可以基于业务上下文而不仅仅是搜索词本身来定制搜索体验，大大提升了系统的适应性和可扩展性。