更新日志

本次更新新增垃圾内容检测、AI 群机器人和聊天图片定期清理，完善协议签署流程，并优化聊天界面、消息处理及访问权限校验。

新增功能

垃圾内容检测

• 支持对私聊、群聊和频道消息配置检测范围，默认关闭，由管理员按需启用。
• 文本检测支持本地规则、阿里云内容安全、腾讯云内容安全和 Halo AI Foundation。
• 本地规则支持内置推广词库及自定义拦截词条；自定义词条每行一条，命中即拒绝发送，英文不区分大小写。
• 支持通过 AI Foundation 进行图片内容检测，并对本地或云服务判定为可疑的文本进行 AI 复核。
• 支持超时时间、检测阈值、结果缓存及异常处理策略。检测服务超时或异常时，默认放行并记录告警，也可选择严格拒绝。
• 配置项随检测服务动态显示；模型使用 AI Foundation 模型选择器，云服务凭据使用 Halo 原生 Secret 组件，支持选择或创建密钥。

AI 群机器人

• 接入 Halo AI Foundation 对话能力，支持机器人身份、模型、提示词及群组绑定配置。
• 支持按群配置触发方式、上下文消息数量、冷却时间及使用角色等选项。
• 管理入口整合至「群组管理」：在群组「更多操作」中新增机器人，在「查看成员」中查看和管理群机器人。
• 使用 AI Foundation 提供的模型选择器，简化机器人编辑表单。
• 机器人回复异步处理，并增加并发限制、超时控制、任务恢复和回复去重，提高重启及异常情况下的稳定性。

聊天图片定期清理

• 支持按保留时长、执行时间和批次数量清理聊天图片，默认关闭。
• 仅处理在聊天中发送并被标记的 Halo 图片附件，避免扫描其他业务附件。

协议签署与群组资料

• 更新服务条款、隐私与数据处理说明至 v2.0，新增协议签署页面和签署记录展示。
• 支持本地开发环境及授权中心站点的协议签署豁免，并修复外部访问地址判断。
• 支持群聊和频道资料编辑。

体验与性能优化

• 聊天窗口默认保留 Halo 侧边菜单，支持在浏览器页面内全屏／还原；优化全屏按钮、菜单图标及相关提示样式。
• 链接卡片预览改为消息发送后异步补全，减少获取外部网页信息对发送流程的影响。
• 缓存解析后的检测配置，并对检测结果缓存设置容量边界与隔离规则。
• 群机器人异常提示使用 Halo 统一组件，垃圾内容检测说明与其他设置页保持一致。

问题修复与安全加固

• 修复切换文本检测服务时下拉框、复选框和文本域错误复用的问题，保留隐藏配置项的已填值。
• 修复 @提及输入框占位符及聊天窗口全屏按钮显示问题。
• 修复历史消息分页推进、未读消息 WebSocket 数据结构及隐藏消息过滤问题。
• 加强 WebSocket 身份绑定、会话访问、私聊接收方及群成员查询的权限校验，收紧原始数据访问权限，同时兼容已有群管理权限。
• 增加 WebSocket 消息和队列大小限制，修复发送缓冲区释放问题。
• 加强动态聊天界面内容清理与链接预览抓取防护。
• 修复归档批量配置未生效、归档索引创建失败后的补偿，以及群组创建失败、解散清理的可靠性问题。
• 修复机器人重复回复、过期任务恢复、冷却状态持久化及消息分发异常时的触发问题。
• 调整核心配置隔离与 API 生成流程，降低可选依赖、鉴权配置及 UI 构建对生成 API 客户端的影响。

更新后注意事项

1. 检查运行环境与依赖。 本版本要求 Halo 2.26.0 或以上；当前正式插件描述声明依赖 WebjingMandateCore 2.2.0 或以上，更新前请确认已安装并启用。AI Foundation 为可选依赖，支持 1.0.0 至 2.0.0 之前的版本；使用 AI 检测或机器人时需安装、启用并配置可用模型。
2. 更新前备份数据，更新后刷新页面。 建议备份数据库、插件配置和附件。更新完成后重新打开聊天窗口；旧页面如仍显示旧菜单或控件，请刷新页面以加载新版资源。
3. 检查授权与协议状态。 普通站点请在「协议签署」中确认当前协议状态并按页面提示完成签署。
4. 新功能需要单独启用。 垃圾内容检测、AI 群机器人和聊天图片清理默认关闭。使用机器人时，先开启插件设置中的总开关，再到群组管理中添加、绑定并启用机器人。
5. 核对云服务密钥。 阿里云 Secret 需包含 accessKeyId、accessKeySecret；腾讯云 Secret 需包含 secretId、secretKey。表单仍保存 Secret 资源名称，原有名称配置可继续使用；更新后请确认对应资源存在且字段完整。
6. 区分本地规则与 AI 检测。 本地文本检测是规则与词条匹配；图片服务选择「本地不检测」会直接放行图片。需要识别图片内容时，应选择 AI Foundation 并配置支持 vision 的模型。AI 是否在本地运行取决于 AI Foundation 接入的模型服务。内置推广词命中分数为 0.70，默认阻断阈值为 0.80，命中内置词不代表一定拦截；需要直接拦截的词语可加入自定义词条。
7. 根据业务选择异常策略。 默认放行意味着检测服务不可用时消息仍可发送，告警记录在服务端日志中；严格拒绝会在检测失败或超时时阻止消息。检测在消息保存、分发前执行，启用远程检测会增加一定等待时间；请结合实际服务响应调整超时。机器人调用失败只影响机器人回复，不阻止用户正常发送消息。
8. 启用清理前确认保留期限。 默认保留时长为 30 天，从图片最后一次在聊天中发送开始计算。清理会永久删除符合条件的附件，历史聊天中的对应图片可能无法再查看；如同一附件被其他页面引用，也会受删除影响，请先备份并确认用途。
9. 使用第三方检测或 AI 前确认数据处理范围。 启用后，相关消息内容、图片或机器人上下文可能发送至所配置的服务商；请核对服务商费用、额度及站点隐私告知内容。
10. 使用自定义角色或外部集成的站点需回归验证。 本次收紧了部分访问权限并更新 API 客户端及消息数据结构。升级后建议验证私聊、群聊、历史消息、未读数和机器人；若自定义角色出现无权访问，应按新版权限配置排查，避免通过开放原始聊天数据权限解决。