AI 搜索

适用读者：Halo 站长、主题集成人员

AI 搜索在关键词结果之外生成一段基于站内文章的综合回答，同时保留传统结果供访客继续浏览。

数据路径

关键词结果：GET /search/halo-results，直接读取插件 Lucene 索引。
AI 综合回答：POST /search/answer，进入独立搜索 RAG 流程并使用 SSE。
搜索回答不会进入自定义意图路由。

配置步骤

确保文章索引正常。
开启搜索功能。
按需开启 AI 综合回答。
设置关键词结果数量、专用 System Prompt 和输出上限。
独立设置搜索主题与主题色。
在实时预览中验证关键词结果和回答区域。

提示词建议

搜索回答应短于聊天回答，直接总结结果差异，并避免生成索引中不存在的文章。专用提示词为空时会回退到对话提示词。

常见问题

现象	检查
关键词结果为空	索引、搜索总开关、文章是否公开
有关键词结果但无 AI 回答	`showAiAnswer`、Chat 模型、SSE 代理
搜索入口没有接管主题	主题 DOM 结构、Widget 注入和浏览器控制台
回答最后一次性出现	Nginx/CDN 缓冲
结果摘要含危险 HTML	前端应保持当前清洗逻辑，不直接渲染未知 HTML

验证

使用文章标题中的精确词测试关键词结果。
使用语义问题测试 AI 综合回答。
确认传统结果和 AI 引用指向同一站点文章。
在桌面和移动端分别测试搜索入口与弹框。

相关接口见 Public API。