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