AI 智能套件

把 Halo 博客变成一个能回答、会检索、可辅助创作，也懂内容运营的 AI 知识站。

AI 智能套件面向 Halo 2.25+，提供 RAG 智能问答、AI 搜索、写作辅助、文章摘要、交互脑图、效果评测、意图路由与运营智能体。模型能力统一接入 Halo AI Foundation；检索使用内置 Lucene，无需额外部署向量数据库。

主要功能

• RAG 智能问答：基于已发布文章进行多轮问答、流式输出和引用溯源。
• AI 搜索：在关键词结果之外生成可追溯的综合回答。
• 编辑器写作辅助：润色、续写、扩写、简化、翻译和大纲生成。
• 摘要与脑图：单篇或批量生成摘要，生成可交互文章脑图。
• 意图路由：对最新文章、热门内容、标签文章等确定性问题执行可配置 Pipeline。
• 效果评测与运营智能体：维护评测集，从真实访客问题中分析内容缺口。
• 用量与审计：记录模型 Token、调用明细、失败率、限额和检索链路。

安装要求

• Halo >= 2.25.0
• Java 21（随 Halo 运行环境）
• 必须先安装并启用 Halo AI Foundation（插件 ID：ai-foundation）
• 使用 AI 搜索访客入口时，需有兼容的主题搜索入口或 Halo 官方搜索插件

安装与首次配置

1. 先安装并启用 Halo AI Foundation。
2. 在 AI Foundation 中配置语言模型和 Embedding 模型；Rerank、Query Rewrite 模型可选。
3. 安装并启用 AI 智能套件。
4. 进入「AI 智能套件 → 模型配置」，选择对应的 AI Foundation 模型资源并执行连通性测试。
5. 在「索引中心」执行全量索引重建。
6. 先在后台完成问答测试，再按需开启访客聊天、AI 搜索、脑图、摘要和写作辅助。

完整安装说明：https://ai-suite-docs.rainwu.cn/getting-started/installation

外部服务、费用与数据说明

插件本身免费开源，不包含模型额度。模型调用可能产生第三方 API 费用，费用由站点管理员与所选模型服务商结算。用于问答、Embedding、摘要、脑图、写作或评测的站点内容，会通过 Halo AI Foundation 发送给管理员自行配置的模型服务商。请根据站点内容、隐私要求和供应商条款决定是否启用相关功能。

AI 智能套件不保存模型供应商 API Key；供应商、Base URL、API Key 和默认模型由 Halo AI Foundation 管理。插件普通配置保存在 Halo ConfigMap，问答记录和评测数据保存在 Halo Extension，Lucene 索引保存在 Halo 数据目录。

生产环境注意事项

访客聊天和 AI 搜索使用 SSE 流式响应。通过 Nginx、CDN 或 WAF 部署时，应关闭响应缓冲并保证长连接超时足够。详见：生产部署说明。

升级、禁用与卸载

• 升级前建议备份 Halo 数据目录和数据库，并保留上一版本 JAR。
• Embedding 模型或向量维度变化后，需要重新构建索引。
• 禁用插件后，访客组件、事件监听和后台任务会停止。
• 卸载前如需保留问答、评测或配置数据，请先完成 Halo 数据备份；Lucene 索引属于可重建数据。

升级说明：https://ai-suite-docs.rainwu.cn/operations/upgrade-and-migration

故障排查与支持

• 文档中心：https://ai-suite-docs.rainwu.cn
• GitHub：https://github.com/xianyuwu/halo-plugin-ai-suite
• 问题反馈：https://github.com/xianyuwu/halo-plugin-ai-suite/issues
• 版本下载：https://github.com/xianyuwu/halo-plugin-ai-suite/releases

提交问题时请附上 Halo 版本、插件版本、AI Foundation 版本、模型供应商、相关日志和复现步骤。常见问题可先查阅：故障排查。

开源许可

本项目采用 GPL-3.0 许可证。