当前位置：首页 > news >正文

基于Spring Boot的智能机器人框架——WiseRobot

news 2026/5/12 0:53:32

🌟 开源推荐 | 基于Spring Boot的智能机器人框架——WiseRobot

前言

大家好，今天给大家推荐一个功能强大的智能机器人开源项目——WiseRobot。该项目基于Spring Boot开发，集成了CoolQ、WebSocket、插件系统等核心功能，可以轻松实现QQ/微信群管理、消息处理、自动化客服等功能。

项目简介

WiseRobot 是一个现代化的即时通讯机器人框架，采用微服务架构设计，支持多种消息渠道的统一处理。项目代码结构清晰，遵循阿里编码规范，便于二次开发和维护。

技术栈

后端框架: Spring Boot 2.x
消息协议: CoolQ HTTP API
通信方式: WebSocket
数据存储: 支持扩展（可接入MySQL、MongoDB等）
核心库:
- Lombok（简化代码）
- Hutool（工具集）
- FastJSON（JSON处理）

核心功能

1. 插件系统

项目采用灵活的插件架构，支持按顺序执行多个插件：

publicclassPluginConfig{publicstaticList<CQPlugin>pluginList=newArrayList<>();static{pluginList.add(newStatusPlugin());// 状态监控pluginList.add(newPrefixPlugin());// 对话控制pluginList.add(newExportPlugin());// 数据导出pluginList.add(newExamplePlugin());// 示例插件pluginList.add(newFilePlugin());// 群文件管理}}

2. 事件处理

统一的事件处理机制，支持多种事件类型：

消息事件: 私聊消息、群消息、讨论组消息
请求事件: 加好友请求、加群请求
通知事件: 群成员变动、群禁言、文件上传等
元事件: 心跳检测、生命周期

3. 多渠道消息发送

统一的消息发送接口，支持QQ和微信：

@ServicepublicclassUnifiedMessageService{@AutowiredprivateWeChatMessageSenderweChatSender;@AutowiredprivateQQMessageSenderqqSender;publicvoidsendMessage(ClientTypeEnumclientType,EventMessageTypeEnummessageType,StringtargetId,Stringcontent){// 根据渠道选择对应的发送器}}

4. 敏感词过滤

内置Trie树算法实现的高效敏感词过滤：

@ComponentpublicclassBusinessPluginRegistry{privateTrietrie=newTrie();publicvoidloadSensitiveWords(List<String>words){words.forEach(trie::insert);}publicbooleancontainsSensitiveWord(Stringtext){returntrie.search(text);}}

项目结构

src/main/java/com/eul/web/ ├── bot/ # 机器人业务插件 │ ├── plugin/ # 插件实现 │ └── entity/ # 实体类 ├── cq/ # CoolQ相关 │ ├── event/ # 事件定义 │ ├── entity/ # 实体类 │ ├── retdata/ # 返回数据 │ ├── robot/ # 核心机器人类 │ └── websocket/ # WebSocket处理 ├── config/ # 配置类 ├── controller/ # 控制器 ├── domain/ # 领域模型 ├── factory/ # 工厂模式 ├── plugin/ # 插件系统 └── service/ # 服务层

快速开始

克隆项目

gitclone https://gitee.com/blps/wise-robot.git

配置application.yaml

server:port:8888spring:application:name:wx-robot

运行项目

mvn spring-boot:run

配置CoolQ

安装 CoolQ Pro 或 CoolQ HTTP API 插件
配置 WebSocket 地址：ws://127.0.0.1:8888/ws/

插件开发示例

创建一个简单的插件只需继承CQPlugin：

publicclassMyPluginextendsCQPlugin{@OverridepublicintonPrivateMessage(CoolQcq,CQPrivateMessageEventevent){Stringmessage=event.getMessage();if(message.contains("hello")){cq.sendPrivateMsg(event.getUserId(),"你好！很高兴见到你~",false);}returnMESSAGE_IGNORE;}}