> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 搜索

> 配置你的 Mintlify 文档站点上的站内搜索栏，包括排名加权和每次查询返回的结果数量。

配置你 Mintlify 托管的文档站点上的搜索栏的行为。这些设置仅影响站内搜索。它们不会改变外部搜索引擎对你页面的索引方式。

<div id="boost-search-ranking">
  ## 提升搜索排名
</div>

使用 `boost` 让特定页面或章节在站内搜索中获得更高的排名权重。该值是一个应用于每个内容片段相关性得分的数值乘数：`boost: 3` 会使某个片段的相关性提升为没有加权时的三倍。

<div id="boost-a-single-page">
  ### 为单个页面加权
</div>

在页面的 [frontmatter](/zh/organize/pages) 中设置 `boost`，可放大其搜索排名。

```mdx theme={null}
---
title: "Custom domain"
description: "Connect your custom domain to your Mintlify documentation."
boost: 3
---
```

<div id="boost-a-navigation-group">
  ### 为导航分组加权
</div>

在 `docs.json` 导航中的某个分组上设置 `boost`，可将该乘数应用于其下的每个页面。

```json theme={null}
{
  "navigation": {
    "groups": [
      {
        "group": "Get started",
        "boost": 5,
        "pages": [
          "quickstart",
          "concepts"
        ]
      }
    ]
  }
}
```

页面会从最近一个设置了加权值的祖先那里继承加权因子。子页面或嵌套分组可以通过设置自己的 `boost` 值来覆盖继承的加权。页面 frontmatter 中的 `boost` 始终优先于从导航继承的值。

<div id="de-prioritize-content">
  ### 降低内容优先级
</div>

使用小于 `1` 的值可将页面在搜索结果中下推。例如，`boost: 0.5` 会将页面的相关性得分相对于其他页面减半。`boost` 为 `1` 时等同于不加权。

```mdx theme={null}
---
title: "Deprecated API"
description: "Documentation for the deprecated v1 API."
boost: 0.25
---
```

<Note>
  加权因子会与已有的相关性得分相乘。请谨慎使用。过大的乘数会导致相关性较低的页面在搜索结果中占据主导地位，从而降低整体搜索质量。
</Note>

<div id="exclude-a-page-from-search">
  ## 将页面从搜索中排除
</div>

在页面的 [frontmatter](/zh/organize/pages) 中设置 `searchable: false`，可将该页面从文档站点的搜索结果中排除。

```mdx theme={null}
---
title: "内部备注"
description: "不希望出现在搜索结果中的参考资料。"
searchable: false
---
```

与 `noindex` 不同，`searchable: false` 不影响外部 SEO。该页面仍然：

* 可被外部搜索引擎抓取
* 列在你的 `sitemap.xml` 中

它会从文档站点的搜索结果和 AI 助手 context 中被排除。

将 `searchable: false` 用于那些应通过直接链接或外部搜索引擎保持可访问，但不应在用户在你的文档中搜索时出现的页面，例如，深度参考页面、遗留内容，或会挤占更相关结果的辅助资料。

要将页面同时从站点搜索和外部索引中排除，请改用 [`noindex: true`](/zh/optimize/seo#disable-indexing)。

<div id="maximum-search-results">
  ## 最大搜索结果数
</div>

通过控制台控制搜索栏每次查询返回的结果数量。默认值为 `6` 个结果。你可以设置 `1` 到 `100` 之间的任意值。

在控制台中，依次进入 **Settings** > **Deployment** > **Search**，将 **Maximum search results** 设置为你想要的值，然后选择 **Save changes**。

<Frame>
  <img alt="控制台中的搜索设置页面，Maximum search results 步进器设为 6。" className="block dark:hidden" src="https://mintcdn.com/mintlify/nQsqOKYXFsfTuyVh/images/search-settings-light.png?fit=max&auto=format&n=nQsqOKYXFsfTuyVh&q=85&s=aab658c8fe300918bb391995c9d0599e" width="1534" height="1185" data-path="images/search-settings-light.png" />

  <img alt="控制台中的搜索设置页面，Maximum search results 步进器设为 6。" className="hidden dark:block" src="https://mintcdn.com/mintlify/nQsqOKYXFsfTuyVh/images/search-settings-dark.png?fit=max&auto=format&n=nQsqOKYXFsfTuyVh&q=85&s=f142759a815f3484c6fd762366a2a5bd" width="1534" height="1185" data-path="images/search-settings-dark.png" />
</Frame>

较高的值会在每次查询中呈现更多匹配，这对覆盖主题广泛、用户期望浏览许多候选项的站点很有用。较低的值会让结果面板保持紧凑，并促使用户关注排名最高的匹配项。


## Related topics

- [Analytics](/zh/optimize/analytics.md)
- [自定义脚本](/zh/customize/custom-scripts.md)
- [Analytics 集成](/zh/integrations/analytics/overview.md)