### [02.04.010 连接Meilisearch并设置搜索范围](https://guaqi.com/docs/77511) **Published:** 2026-09-11T02:19:42 **Author:** 二丿小青年 **Excerpt:** 一、这个功能能做什么 智能搜索连接在 瓜奇 → 综合 → 全局基础数据 → 第三方服务 → 智能搜索 中维护。… [02 网站设置](/docs-archive/1202) / [02.04 搜索与AI](/docs-archive/1207) ## 一、这个功能能做什么 智能搜索连接在 **瓜奇 → 综合 → 全局基础数据 → 第三方服务 → 智能搜索** 中维护。相关索引操作面板提供连接检查、同步范围和内容更新；界面位置随当前权限和版本展示。 ### 每个设置有什么用 | 设置 | 控制什么、会有什么效果 | 怎么填写或选择 | | --- | --- | --- | | 启用智能搜索 | 启用相应搜索能力。 | 先准备搜索服务，再开启；开关不会自动安装服务。 | | 服务地址 | 让后台连接 Meilisearch。 | 默认 http://localhost:7700；localhost 指请求所在服务器。 | | API Key | 提供搜索和同步所需权限。 | 填写该搜索服务的有效密钥。 | | 索引名称 | 决定搜索数据保存在哪个索引中。 | 默认 guaqi\_posts；不要误指向无关索引。 | | 参与搜索的文章类型 | 选择由站点管理的搜索内容类型。 | 只勾选实际需要的类型；扩展插件可能另有固定类型。 | | 同步范围 | 控制本次把哪些内容写入搜索数据。 | 准备好文章后执行同步，连接成功不代表内容已经收录。 | | 语义搜索权重 | 调整关键词与语义搜索的比例。 | 默认 50%，结合实际问题检查搜索结果。 | | 每页结果数 | 控制每次返回的数量。 | 默认 20，面板范围 1 至 50；结果数多不等于更准确。 | ### 先认识这几个词 - **API Key**：访问某项服务的凭据，也称 API 密钥；应填入对应服务的设置中并妥善保管。 - **向量**：把文字转换成便于计算相似程度的数据，用于帮助查找意思相近的内容。 - **索引**：搜索服务为内容建立的可查询资料集；文章存在不等于已经收录进搜索。 ### 搜索入口也能按网站风格设计 | 设置 | 功能与效果 | | --- | --- | | 搜索类型范围 | 选择页面搜索入口使用的适用内容类型 | | 颜色风格 | 默认主题、浅色浮岛、深色浮岛或玻璃质感，搭配不同背景 | | 背部媒体 | 选择无背景、单图、视频或图片轮播，制作首页搜索区 | | 媒体细节 | 设置遮罩透明度、视频封面、循环和自动播放，或轮播切换间隔 | 搜索入口的样式与背景不会扩大用户可检索的内容范围；搜索服务、索引、语言与前端范围仍需正确配置。 ## 二、设置后会有什么效果 访客可以按关键词查找已收录的内容；配置语义搜索后，还可按意思接近的表达查找。结果仍受当前站点的语言、分类范围等条件限制。 ## 三、怎么使用 1. 填写实际 Meilisearch 服务地址、对应密钥及界面要求的索引参数，保存配置。 2. 执行连接检查。连接成功仅表示能访问服务，不表示已有内容进入索引。 3. 选择需要索引的内容类型，再在同步范围中选定本次更新对象，等待操作结果。 4. 用一篇已发布、有明确语言和分类的文章，分别搜索标题和正文中的独特词语。 分类和标签随内容文档写入索引；部分扩展类型由插件注册和同步，不能仅凭文件存在认定已经启用。当前批量同步会在条件满足时复用未变内容的向量。 ### 连接字段与搜索行为速查 先启用“智能搜索”，再填写“Meilisearch 连接”。首次默认服务地址为 `http://localhost:7700`，索引名称为 `guaqi_posts`；localhost 指运行请求的服务器本身，不一定是你的个人电脑。密钥应具备所需搜索和文档写入权限。 搜索行为中，语义搜索权重使用百分比滑块，默认 50%；每页结果数默认 20，面板范围 1 至 50。参与搜索类型按已注册类型显示；插件声明为始终索引的类型可能不在可关闭的选项中。以上是当前设置默认值，不会覆盖已有保存值。 ## 四、常见问题 ### 搜索结果为什么不同 索引可以包含多种语言与多个前端的内容，但当前请求仍会按语言、前端内容范围等条件筛选。A 站点能搜到不代表 B 站点应该搜到。翻译后产生新的文章 ID，也要确认译文已发布并同步，分类关联正确。 若连接失败，检查服务运行、地址、端口、密钥权限及服务器网络；若连接正常但无结果，检查索引内容和搜索范围。不要通过放宽所有前端分类来掩盖归属配置错误。 ---