AI智能套件

v0.4.4 更新说明

问题修复

• 修复 Chat、查询改写、Rerank 和图像模型点击“测试连通性”时，部分请求返回 HTTP 400 的问题。
• 测试请求格式错误时，显示更明确的中文提示。

升级说明

• 需要 Halo 2.26.0 及以上版本、Halo AI Foundation 1.1.1 及以上版本。
• 从 v0.4.3 升级无需迁移配置或重建 RAG 索引。建议升级前备份数据并保留旧版插件包。

完整更新记录：https://github.com/xianyuwu/halo-plugin-ai-suite/releases/tag/v0.4.4
在线文档：https://ai-suite-docs.rainwu.cn/

更新内容

• 智能搜索改为点击搜索图标或按回车后提交，输入过程中不再连续调用模型；首个回答片段到达前持续显示等待状态。
• 搜索流提前结束、服务端错误或模型异常结束时，明确提示回答可能不完整，并保留已收到的内容。
• 搜索弹框下方的文章列表优先使用 Halo 核心搜索引擎，引擎不可用时回退到插件 Lucene；优化长问句的相关文章排序，并支持展开宽泛结果。
• 调整搜索弹框顶部控件与结果区滚动，避免长结果列表挤压操作按钮。

兼容性与升级

• 要求 Halo 2.26.0+、Halo AI Foundation 1.1.1+、Java 21。
• 从 v0.4.2 升级无需迁移配置；模型和向量维度不变时，无需重建本插件的 RAG 索引。
• 请保持 Halo 核心搜索引擎的文章索引可用。
• 建议升级前备份 Halo 数据、插件配置和旧版 JAR。

完整发布说明与 SHA-256 校验值见 GitHub Release。

0.4.2 更新内容

• 新增 AI 标签：可为草稿和已发布文章生成候选标签，人工选择后应用；优先复用已有标签，并保留文章原有标签。
• 文章列表的操作菜单新增「AI 生成标签」，可在弹窗中完成生成和应用。
• 新增内容创作默认语言模型；AI 摘要、AI 标签、写作辅助也可分别指定模型。
• AI 标签生成用量可单独查看。

安装与升级

• 需要 Halo 2.26.0 或更高版本，以及 AI Foundation 1.1.1 或更高版本。
• 支持从 0.4.1 升级，无需迁移配置或重建文章索引。
• 使用说明：https://ai-suite-docs.rainwu.cn/user-guide/ai-tags

修复与优化

• 对话、查询改写、Embedding、Rerank 和图像生成模型的连通性测试统一改为后台任务与状态轮询，改善慢模型在反向代理环境下的测试体验。
• 优化错误提示：HTTP 错误、空响应和非 JSON 响应现在会显示明确的中文说明。
• 查询中断时显示“状态待确认”，支持继续查询原任务；刷新当前标签页后可恢复查询。
• 增加重复请求保护，恢复查询不会自动重新提交模型调用，减少重复费用风险。

兼容性与升级

• 需要 Halo 2.26.0 或更高版本，以及已安装并启用的 Halo AI Foundation 1.1.1 或更高版本。
• 从 0.4.0 升级无需迁移配置或重建索引。
• 查询中断时请优先点击“继续查询”；主动“开始新测试”可能产生额外模型调用费用。
• 测试任务记录保存在内存中，服务重启后会失效。

新增功能

• 新增交互宠物：薄荷机器人、奶油橘猫、星云小精灵三款内置皮肤，支持状态变化与聊天头像。
• 新增 AI 宠物制作：上传参考图生成专属角色，支持精致立体、复古像素两种风格。
• 支持母版与表情逐张检查、单张重新生成、表情及姿势变化、宠物改名和生成进度提示。
• 新增背景编辑工具：按颜色选择、圆形橡皮擦、缩放与平移、边缘预览和去白边；已确认图片可再次编辑。

修复与兼容

• 修复 AI Foundation 正式版接口变化导致写作辅助出现 NoSuchMethodError、等待超时的问题（GitHub Issue #7）。
• 最低要求 Halo 2.26.0、AI Foundation 1.1.1；已在 Halo 2.26.1、AI Foundation 1.1.1 环境验证。

升级提醒

• 请先备份数据库、Halo 数据目录和插件配置，再升级 Halo、AI Foundation 与本插件。
• 升级后检查知识库索引；遇到索引兼容错误时按升级指南重建。更换向量模型或维度时需重建索引。
• AI 宠物制作需配置支持参考图生成的生图模型。已验证 Qwen Image 2.0 Pro、3.0 Pro 和豆包 Seedream 5；其他模型建议先测试。
• 若后台经过 EdgeOne 等代理，生图连通性测试可能受回源超时限制；该测试当前需等待生图完成，宠物生成则使用后台任务。

文档

• 使用文档
• 交互宠物制作指南
• 升级与迁移

问题修复

• 修复插件启动或重新启用后，对已有完整索引重复执行全量重建的问题。
• 启动时会检查现有索引是否完整且可读，符合条件时直接复用。
• 修复部分固定维度 Embedding 模型不支持 dimensions 参数而导致连接失败的问题。
• 自适应处理 Embedding 向量维度，已验证硅基流动 BAAI/bge-m3 可正常返回 1024 维向量。

升级说明

• 本次升级不涉及数据迁移和索引结构变更。
• Embedding 模型和向量维度不变时，无需重新建立索引。
• 现有插件配置和索引数据不受影响。
• 要求 Halo >=2.25.0。
• 必须安装并启用 Halo AI Foundation。

验证

• 文档检查通过。
• Gradle 完整测试与构建通过。
• Halo 2.25.4 与 Halo AI Foundation 1.0.1 实机验证通过。
• 插件重启后未触发重复索引，原有索引数据保持正常。
• 硅基流动 BAAI/bge-m3 连接测试通过，向量维度为 1024。
• SHA-256：5a2c95982ccca513366d27d6995b9c42cd2ce643085d02f4fe0eb60ec6fef93e

问题修复

• 修复关闭游客聊天功能后，AI 脑图同时消失的问题。
• 修复上述配置导致 AI 搜索无法初始化的问题。
• 解耦游客聊天、AI 搜索和 AI 脑图的前台资源加载与访问控制。
• 关闭游客聊天时仅隐藏聊天入口；AI 搜索保持可用，AI 脑图仅由自身开关控制。

升级说明

• 本次升级不涉及数据迁移。
• 现有插件配置和索引数据不受影响。
• 要求 Halo >=2.25.0。
• 必须安装并启用 Halo AI Foundation。

验证

• JavaScript 语法检查通过。
• Gradle 完整测试与构建通过。
• SHA-256：e86bb7895995b70a99f58c7206304ca6858e71abd93c3ab6861824ade0169ffa

首次公开版本

• 基于 Halo AI Foundation 统一管理 Chat、Embedding、Rerank 和 Query Rewrite 模型能力
• 提供 RAG 智能问答、AI 搜索、文章摘要、交互脑图与编辑器写作辅助
• 提供意图路由、效果评测、内容缺口运营智能体及模型用量审计
• 使用内置 Lucene 混合检索，无需额外部署向量数据库
• 补齐应用市场要求的仓库、问题反馈、主页、许可证与自定义 Logo 元数据

安装要求

Halo >= 2.25.0，必须先安装并启用 Halo AI Foundation。

升级与迁移

这是应用市场首个公开版本。从早期 ai-assistant 插件升级时，插件会迁移兼容数据；Embedding 模型或向量维度变化后需要重建索引。

注意事项

模型调用可能产生第三方费用，站点内容会发送给管理员配置的模型服务商。