准备搜索服务
连接入口是瓜奇 → 综合 → 全局基础数据 → 第三方服务 → 智能搜索。这里维护系统共用的搜索服务；各前端网站仍会按自己的内容范围和语言筛选结果。
先用管理员账号完成瓜奇初始化，并准备 WordPress 服务器能够访问的 Meilisearch 服务、有效密钥和向量服务。开关不会自动安装这些服务。当前索引准备流程要求 Meilisearch 版本不低于 1.42.1。
索引是搜索服务保存的可查询资料。文章已经发布，只能说明网站有这篇内容，不能说明搜索资料已经准备完成。
填写连接和搜索设置
| 设置 | 填写方法与作用 |
|---|---|
| 启用智能搜索 | 默认关闭。开启后使用 Meilisearch 搜索能力，并显示下方连接、语义模型和搜索行为设置。 |
| 服务地址 | 默认 http://localhost:7700。填写 WordPress 服务器能够访问的地址；这里的 localhost 指 WordPress 所在运行环境，不是访客电脑。 |
| API Key | 填写该 Meilisearch 服务的密钥。后台支持 Master Key；使用受限密钥时，需要具备搜索、文档写入及实际索引维护操作所需的权限。 |
| 索引名称 | 默认 guaqi_posts，用于建立本站搜索资料。不要填写其他业务正在使用的索引名。 |
| AI 语义模型 | 配置智谱、OpenAI Embedding 或 Ollama 向量服务，用于分析内容含义。它与生成回答的 AI 通道分别配置。 |
| 语义搜索权重 | 默认 50%，可在 0% 至 100% 之间按 5% 调整。0% 偏向纯关键词检索，100% 使用纯语义检索；调高不代表结果一定更准确。 |
| 每页结果数 | 默认 20，设置范围为 1 至 50。它是搜索默认返回数量，具体搜索入口还可能指定自己的数量。 |
填写后先保存。默认值只用于尚未配置的项目，不会覆盖已有保存值。
选择长期收录范围
在智能搜索设置中打开“管理搜索与 AI 内容”。当前内容类型和分类范围在这个统一面板中管理，不再只靠旧版“参与搜索的文章类型”选项。
- 进入内容范围设置，选择长期需要使用的内容类型。可选类型取决于当前已注册并支持索引的内容。
- 需要排除演示内容等资料时，选择“排除分类”。排除会包含子分类，原文章仍保留。
- 保存范围。被排除的内容不用于智能搜索、相关文章和 AI 回答。
- 如果此前已经建立索引，按面板提示进入管理选项，检查并应用新范围。仅保存范围不会立即完成已有资料的检查和清理。
长期范围决定后续收录哪些内容。“更新搜索与 AI 内容”中的本次检查范围，只决定这次检查全部内容还是部分类型、分类，不能代替长期范围设置。
准备并更新搜索资料
- 回到内容管理面板，按提示开始准备搜索资料。配置缺失、连接失败或版本不符合要求时，先处理提示中的问题。
- 处理期间保持页面打开。需要离开时可以暂停，下次重新打开后继续已有进度。
- 已有资料需要修复时，先执行检查，再查看待更新数量。系统会区分信息更新和需要重新分析的内容，确认后再处理。
- 如需知识助手根据正文回答，还要配置生成文字的 AI 通道，并完成“准备 AI 回答资料”。搜索准备完成不等于正文知识资料也已完成。
正常情况下，资料准备完成后，新增和修改的内容会自动更新。面板提示自动更新失败时，可在管理选项中重试。未变化且可复用的分析结果会保留；新增、变化或强制重新分析的内容可能产生向量服务费用。
检查搜索结果
- 选择一篇已发布、属于收录范围的文章，确认它在目标前端可以打开。
- 在同一前端、同一语言下搜索完整标题和正文中的独特词语。
- 再用意思相近但用词不同的问题检查语义搜索效果。
- 换到其他前端或语言时重新测试，不要把某个网站的搜索结果当作所有网站的结果。
连接可用只说明能访问搜索服务。没有结果时，还需检查资料是否准备完成、内容类型与分类范围、发布状态和语言。译文有自己的文章 ID，也需要发布并完成收录。
设置页面上的搜索入口
在构建器中选中搜索模块，可调整“搜索类型范围”和“背部媒体”。搜索类型来自内容注册表；至少保留一类，清空时会恢复为全部已注册类型。
背部媒体支持无背景、单图、视频和图片轮播。可设置遮罩透明度、视频封面、循环、自动播放，以及轮播间隔；轮播间隔范围为 1500 至 60000 毫秒。
当前无媒体背景时跟随网站主题，有媒体背景时使用浅色半透明表单与卡片。旧文中的“浅色浮岛、深色浮岛、玻璃质感”不再作为本页的固定颜色选项说明。
模块的搜索类型用于站内检索，不会扩大后台收录范围，也不能代替知识助手的知识范围设置。调整外观后，仍要在前端实际提交搜索进行验证。