# WuHenBot

**Repository Path**: yiwuhen/wu-hen-bot

## Basic Information

- **Project Name**: WuHenBot
- **Description**: 
WuHenBot 是 基于腾讯qq机器人基于webhook连接进行开发的机器人。功能根据天启幻境功能进行调整。

- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://www.wuhen.ltd/
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-08-18
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Bot

## README

# 🤖 WuHenBot

## 📋 项目简介

WuHenBot是一个基于Spring Boot开发的多功能机器人应用，提供了丰富的交互功能和管理界面。该项目基于腾讯官方的 [QQ机器人](https://q.qq.com/qqbot/) ，通过 Webhook 进行连接。游戏功能参考 [天启幻境](https://d.tapdrd.cn/)，

## 📁 项目结构

```plaintext
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── yi/
│   │   │       └── wuhenbot/
│   │   │           ├── Controller/         # 控制器层
│   │   │           ├── Service/            # 业务逻辑层
│   │   │           ├── Utils/              # 工具类
│   │   │           ├── dao/                # 数据访问层
│   │   │           ├── entity/             # 实体类
│   │   │           └── WuHenBotApplication.java  # 应用启动类
│   │   └── resources/
│   │       ├── static/                    # 静态资源文件
│   │       │   ├── admin.html             # 管理员界面
│   │       │   ├── game.html              # 游戏界面
│   │       │   ├── login.html             # 登录页面
│   │       │   └── index.html             # 主页
│   │       ├── application.yml            # 主配置文件
│   │       └── application-prod.yml       # 生产环境配置
│   └── test/                              # 测试目录
├── pom.xml                                # Maven依赖配置
├── package.json                           # npm依赖配置
├── LICENSE                                # 许可证文件
└── .gitignore                             # Git忽略配置
```

## 🚀 功能模块

### 🔐 1. 用户认证与权限管理
- 🔑 JWT令牌认证机制
- 👥 用户类型区分（普通用户/管理员）
- 💾 登录状态持久化
- 🛡️ 权限拦截与校验

### 🤖 2. 机器人控制中心
- 🎮 机器人令牌管理
- 📝 命令映射与处理
- 💬 消息分发与响应
- 📊 状态监控与日志记录

### ⚙️ 3. 内容与指令管理
- 🎯 指令触发与映射关系
- 📋 命令描述与管理
- 🧹 内容判断与过滤

### 🧠 4. Kimi AI模型集成
- 🌐 第三方AI接口调用
- ⚙️ 模型参数配置
- 💡 群提示词管理

### 🛒 5. 钓鱼商店系统
- 📦 商店商品管理
- 👤 用户数据关联

### 🖥️ 6. 管理界面
- 👥 用户管理
- 🔐 权限配置
- ⚙️ 系统参数设置

## 🛠️ 技术栈

### 🔧 后端技术
- **框架**: Spring Boot 3.4.1, Spring WebMVC, Spring Data JPA
- **数据库**: MySQL 8.0, MyBatis 3.0.3, MyBatis-Plus 3.5.4
- **认证**: JWT (JSON Web Token)
- **通信**: WebSocket, HTTP Client
- **工具库**: Hutool, Apache Commons, Lombok, Fastjson2
- **加密**: Bouncy Castle

### 🎨 前端技术
- **基础**: HTML5, CSS3, JavaScript
- **HTTP客户端**: Axios
- **样式框架**: 自定义样式系统

### 🌐 第三方服务
- **AI模型**: Kimi API (moonshot-v1-8k)

## 🏃 快速开始

### ✅ 前提条件

- ☕ JDK 17 或更高版本
- 🔨 Maven 3.6+ 构建工具
- 🗄️ MySQL 8.0 数据库
- 🟢 Node.js 环境 (用于前端依赖管理)

### ⚙️ 配置说明

1. 克隆项目仓库
   ```bash
   git clone https://your-repository-url/wuhenbot.git
   cd WuHenBot
   ```

2. 配置数据库连接
   编辑 `src/main/resources/application-prod.yml` 文件，填写正确的数据库连接信息：
   ```yaml
   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/wuhenbot?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
       username: your-username
       password: your-password
   ```

3. 配置机器人信息和API密钥
   在 `application-prod.yml` 中填写以下配置：
   ```yaml
   bot:
     appid: your-bot-appid
     secret: your-bot-secret
     token: your-bot-token
   
   kimi:
     apikey: your-kimi-apikey
   ```

### 🚀 构建和运行

1. 安装依赖
   ```bash
   mvn install
   ```

2. 构建项目
   ```bash
   mvn clean package
   ```

3. 运行应用
   ```bash
   java -jar target/WuHenBot.jar
   ```

4. 访问应用
   - 🔑 登录页面: http://localhost:9527/login.html
   - 🖥️ 管理员界面: http://localhost:9527/admin.html (需要管理员权限)
   - 🎮 游戏界面: http://localhost:9527/game.html

## 📦 开发依赖

### 🧩 核心依赖

| 依赖 | 版本 | 用途 |
|------|------|------|
| Spring Boot | 3.4.1 | 应用框架 |
| Spring WebSocket | - | 实时通信 |
| MyBatis | 3.0.3 | ORM框架 |
| MyBatis-Plus | 3.5.4 | MyBatis增强工具 |
| MySQL Connector | 8.0.33 | 数据库驱动 |
| JJWT | 0.11.5 | JWT认证 |
| Fastjson2 | 2.0.43 | JSON处理 |
| Hutool | 5.8.22 | 工具类库 |
| OkHttp | 4.12.0 | HTTP客户端 |
| Lombok | - | 代码简化工具 |
| Axios | 1.6.0 | 前端HTTP客户端 |

## 📖 功能使用说明

### 🔐 用户登录

1. 打开登录页面 `login.html`
2. 输入用户名和密码
3. 系统自动根据用户类型跳转到对应页面：
   - 👤 普通用户 → game.html
   - 👑 管理员 → admin.html

### 🤖 机器人命令使用

1. 📝 通过配置命令映射关系，可以自定义触发关键词
2. ⌨️ 使用 `/命令名` 格式触发预设功能
3. 🔧 管理员可以通过后台管理界面配置和管理命令映射

### 🧠 AI功能使用

1. 🤖 系统集成了Kimi AI模型
2. 💡 支持群提示词配置，通过相关命令可以查看或设置
3. 🚀 通过调用AI接口实现智能回复和内容生成

## 🛡️ 安全与最佳实践

1. 🔒 敏感信息（如API密钥、数据库密码）请勿硬编码在源代码中
2. 🔐 JWT密钥应妥善保管并定期更新
3. 🔒 生产环境中建议启用HTTPS
4. 💾 定期备份数据库和配置文件

## 📄 许可证

本项目采用Mulan PSL v2许可证。详情请参阅 [LICENSE](LICENSE) 文件。

## 📧 联系方式

如有问题或建议，请联系项目维护团队。

---

*✨ 最后更新时间：2025-12-09 ✨*