修复站内搜索无结果的问题

如果你的 Mintlify 文档站点的内置搜索对任何查询（包括精确的页面标题）都不返回结果，很可能是 docs.json 中的某个 hidden 设置将你的页面从搜索索引中排除了。

在 docs.json 中的版本、锚点、下拉菜单、语言或产品上设置 hidden: true，会将其下的所有页面从搜索索引中排除。如果该元素包含你的全部页面（例如你唯一的版本），搜索索引就会变为空，所有搜索都不会返回任何结果。站点本身仍可正常访问，因为隐藏页面依然可以通过直接 URL 打开。

"navigation": {
  "versions": [
    {
      "version": "v1",
      "hidden": true,
      "groups": [...]
    }
  ]
}

要修复此问题，请选择以下方式之一：

• 从该版本或其他元素中移除 hidden: true。

• 保持该元素在导航中隐藏，但通过在 docs.json 中设置 seo.indexing: "all" 将其页面恢复到搜索和索引中：

  "seo": {
    "indexing": "all"
  }

标签页和分组支持 searchable: true 这一选择性加入方式，版本和其他顶层导航元素不支持。有关每种 hidden 位置的完整可见性和索引行为，请参见隐藏页面。

站点重新构建时会重新编入搜索索引，因此请推送 docs.json 的更改，并等待部署完成后再重新测试。要验证是否修复，请打开你的站点并搜索之前未出现在结果中的某个页面的完整标题。如果该页面出现在下拉列表中，说明索引已成功重建。

• 隐藏的标签页或分组：在标签页或分组上设置 hidden: true 同样会将其页面从搜索中排除。对于标签页和分组，你可以在 hidden: true 之外同时添加 searchable: true，让其子页面仍可被搜索。参见仅包含特定隐藏标签页或分组下的页面。
• 页面未列入导航：对于未列入 docs.json 导航的页面，Mintlify 默认会将其从搜索中排除。
• 页面 frontmatter：页面 frontmatter 中的 hidden: true、noindex: true 或 searchable: false 都会将该页面从站内搜索中排除。