LightSNS聊天监控 AI 版-功能更新说明(v4.0)

LightSNS 聊天监控 AI 版 – 功能更新说明 (v4.0)

插件简介
本插件专为 LightSNS 主题开发，旨在解决群聊与私聊内容的合规性监控问题。采用“本地关键词 + DeepSeek AI”双重检测机制，在确保拦截效率的同时，大幅提升对隐晦违规内容的识别能力，并保障用户流畅的聊天体验。

🚀 v4.0 核心更新亮点

1. 新增 DeepSeek API 连接测试

• 功能：在 API Key 输入框旁增加了“测试连接”按钮。

• 作用：无需保存设置或发送真实消息，点击按钮即可向 DeepSeek 发送测试请求。这能帮助管理员快速判断 API Key 是否填写正确以及服务器与 DeepSeek 的网络连接是否通畅。

2. 新增智能超时控制 (Fail-open 机制)

• 功能：后台新增“API 超时设置”选项（默认为 3 秒）。

• 作用：平衡安全性与用户体验。

• 当 DeepSeek 接口响应迅速时，进行严格的 AI 审核。

• 当网络波动导致 AI 响应时间超过设定值（如 3 秒）时，插件会自动停止等待并放行该条消息。

• 意义：防止因为审核接口卡顿导致用户发送消息一直转圈或发送失败，确保聊天功能的可用性。

🛡️ 完整功能特性

1. 双重清洗机制（漏斗式过滤）

• 第一重：本地关键词库（秒级拦截）

• 优先匹配后台自定义的违禁词库。

• 匹配成功直接拦截，不消耗 AI API 额度，响应速度极快（毫秒级）。

• 第二重：DeepSeek AI 智能识别（深度审核）

• 只有未命中本地关键词的内容，才会提交给 AI。

• AI 能够理解上下文语义，识别变体、黑话、隐晦的色情/诈骗/引流内容（例如没有敏感词但意图违规的内容）。

2. 颗粒度权限控制

• 独立开关：可以分别开启或关闭“群聊监控”和“私聊监控”。

• AI 开关：可以一键关闭 AI 功能，仅保留本地关键词拦截模式（降级为基础版）。

3. 暴力阻断技术

• 不依赖主题钩子，直接在 PHP 初始化阶段（Init Hook）识别 LightSNS 的特定请求路径（msg-group.php / msg.php）。

• 一旦判定违规，直接终止程序执行 (exit)，确保违规数据绝对不会写入数据库。

4. 详细的违规审计日志

• 记录内容：包括违规时间、用户ID/用户名、聊天类型（群/私）、目标ID、触发原因（本地词汇或AI判定结果）以及完整的违规内容。

• 管理便捷：后台直接查看日志文件内容，并提供一键清空日志功能。

5. 友好的前端交互

• 拦截时返回符合 LightSNS 前端标准的 JSON 数据格式。

• 用户端会收到清晰的“发送失败”提示，而不是程序报错或页面无反应。

📋 推荐配置建议

• API 超时：国内服务器建议设置 3秒，海外服务器建议设置 5秒。

• 关键词库：建议将明显的违规词（如具体的博彩网站名、明显的脏话）放入本地词库，将复杂的审核交给 AI。