# qqRobot

**Repository Path**: LRTesthhh/qq-robot

## Basic Information

- **Project Name**: qqRobot
- **Description**: 基于qq聊天机器人协议的qq只能聊天机器人，接入openai大模型
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-10-24
- **Last Updated**: 2025-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



根据代码结构和组件信息，以下是适用于该项目的 README.md 内容：

---

# QQ机器人项目

这是一个基于 Java 的 QQ 机器人项目，集成了 AI 聊天、关键词回复以及游戏功能，适用于 Simbot 框架。项目的主要目标是提供一个可扩展的机器人架构，支持自定义命令、聊天处理和互动游戏。

## 功能特性

- **AI 聊天集成**：通过 `AiChatInter` 接口和 `QingYunKeChatImpl` 实现 AI 聊天功能。
- **关键词回复**：支持关键词匹配并自动回复，配置通过 `KetWordsReply` 类进行管理。
- **机器人命令**：通过自定义注解 `@RobotCommand` 注册机器人命令，例如 `/早安`, `/五子棋PK`。
- **消息事件处理**：监听并处理群聊和单聊消息，优先级控制通过 `@Listener` 和 `@Filter` 实现。
- **五子棋游戏**：提供简单的五子棋游戏功能 `WuZiQi`。
- **WebSocket 支持**：通过 `WebSocket` 类连接并处理 WebSocket 消息。

## 项目结构

- `AiChat/`：AI 聊天相关逻辑。
- `Annotation/`：定义自定义注解。
- `Config/`：配置类，如关键词配置。
- `Handle/`：消息事件监听和处理。
- `service/`：核心服务逻辑，包括命令处理、聊天处理和关键词处理。
- `ws/`：WebSocket 客户端相关代码。
- `game/`：游戏模块，如五子棋。

## 使用技术

- Spring Boot
- Simbot
- WebSocket
- Maven
- Java 8+

## 启动项目

1. 确保已安装 JDK 8+ 和 Maven。
2. 配置 `application.yml` 或 `application-dev.yml`。
3. 运行主类 `Simbot01Application.java`。

## 自定义扩展

- 你可以通过实现 `AiChatInter` 接口来添加新的 AI 聊天服务。
- 使用 `@RobotCommand` 注解注册新的机器人命令。
- 在 `application.yml` 中配置新的关键词和回复内容。

## 配置关键词回复

在 `application.yml` 中，可以通过如下方式配置关键词回复：

```yaml
software-tribe:
  keyWords:
    - userMessage: "你好"
      reply: "你好！有什么可以帮助你的吗？"
```

## 许可证

该项目遵循 MIT 许可证，请在使用时确保遵守相关条款。

## 联系我们

如有问题或建议，请在 Gitee 上提交 issue 或联系项目维护者。

---

如需进一步了解代码逻辑或具体实现，可以使用代码搜索工具进行查询。