175 lines
4.5 KiB
Markdown
175 lines
4.5 KiB
Markdown
# 蛋定助手插件文档
|
||
|
||
## 项目概述
|
||
|
||
蛋定助手是一个基于NoneBot2框架开发的QQ机器人，提供多种功能插件，包括AI聊天、管理API、自动撤回消息等。该机器人主要面向特定用户群体，提供游戏辅助和社群管理功能。
|
||
|
||
## 插件总览
|
||
|
||
| 插件名称 | 描述 | 权限要求 |
|
||
|---------|------|---------|
|
||
| chatai | AI聊天功能，对接DeepSeek | 所有用户 |
|
||
| auto_recall | 消息自动撤回 | 系统自动执行 |
|
||
| damo_balance | 大漠账户余额查询 | 特定用户 |
|
||
| danding_api | 蛋定助手管理API | 超级用户 |
|
||
| danding_help | 帮助信息 | 特定群用户 |
|
||
| command_list | 命令列表管理 | 系统使用 |
|
||
|
||
## 详细插件文档
|
||
|
||
### 1. chatai - AI聊天插件
|
||
|
||
#### 功能描述
|
||
基于DeepSeek AI的聊天功能，支持将AI回复转换为图片形式，并在一定时间后自动撤回。
|
||
|
||
#### 使用方法
|
||
- 发送以 `*` 开头的消息触发AI回复
|
||
- AI回复会自动转为图片显示
|
||
- 回复会在120秒后自动撤回
|
||
|
||
#### 配置项
|
||
```env
|
||
DEEPSEEK_TOKEN=你的DeepSeek API密钥
|
||
```
|
||
|
||
#### 技术实现
|
||
- 使用OpenAI客户端连接DeepSeek API
|
||
- 使用Pyppeteer将Markdown转为图片
|
||
- 内置Chrome浏览器实例管理
|
||
|
||
#### 示例
|
||
用户: *你好，请介绍一下自己
|
||
AI: [图片形式回复] 👋 你好呀！我是蛋定助手，一个活泼可爱的AI助手！😊 很高兴认识你！有什么我能帮到你的吗？✨
|
||
|
||
---
|
||
|
||
### 2. auto_recall - 自动撤回插件
|
||
|
||
#### 功能描述
|
||
监控所有发出的消息，并在指定时间后自动撤回，保持聊天环境整洁。
|
||
|
||
#### 使用方法
|
||
- 无需手动调用，插件会自动监控并撤回消息
|
||
|
||
#### 配置项
|
||
```env
|
||
RECALL_DELAY=110 # 撤回延迟时间，单位为秒
|
||
```
|
||
|
||
#### 技术实现
|
||
- 使用NoneBot的API拦截功能
|
||
- 异步定时任务管理
|
||
- 错误处理与日志记录
|
||
|
||
---
|
||
|
||
### 3. damo_balance - 大漠账户余额查询
|
||
|
||
#### 功能描述
|
||
查询大漠平台账户余额，需要验证码验证。
|
||
|
||
#### 使用方法
|
||
- 命令：`大漠余额`或`余额查询`
|
||
- 需要验证码验证
|
||
|
||
#### 权限要求
|
||
- 仅特定用户(ID:1424473282)可使用
|
||
|
||
---
|
||
|
||
### 4. danding_api - 蛋定助手管理API
|
||
|
||
#### 功能描述
|
||
提供管理员操作接口，包括在线人数查询、卡密管理和用户时长管理功能。
|
||
|
||
#### 使用方法
|
||
主要命令：
|
||
- `在线人数`：查询当前在线用户数
|
||
- `添加卡密 [类型] [卡密]`：添加指定类型的卡密
|
||
- `生成卡密 [类型]`：生成新卡密
|
||
- `用户加时 [用户名] [类型]`：为指定用户增加使用时长
|
||
|
||
#### 卡密类型
|
||
- 天卡/day/Day/DAY/天
|
||
- 周卡/week/Week/WEEK/周
|
||
- 月卡/month/Month/MONTH/月
|
||
|
||
#### 权限要求
|
||
- 仅超级用户可使用
|
||
|
||
#### 配置项
|
||
```env
|
||
SUPERUSERS=["1424473282"] # 超级用户ID列表
|
||
```
|
||
|
||
#### 示例
|
||
```
|
||
在线人数
|
||
> 当前在线用户数: 42
|
||
|
||
添加卡密 天卡 ABCD1234
|
||
> 添加卡密成功：天卡 ABCD1234
|
||
|
||
生成卡密 周卡
|
||
> 生成卡密成功：周卡 XYZ789ABC
|
||
|
||
用户加时 test_user 月卡
|
||
> 用户加时成功：test_user 增加了30天
|
||
```
|
||
|
||
---
|
||
|
||
### 5. danding_help - 帮助信息
|
||
|
||
#### 功能描述
|
||
提供各种帮助信息和指南，支持图片形式的教程和指引。
|
||
|
||
#### 使用方法
|
||
主要命令：
|
||
- `帮助`：显示帮助菜单
|
||
- `下载`：显示下载信息
|
||
- `公益版`/`正式版`：显示版本信息
|
||
- `正式版御魂双开`：显示双开教程
|
||
- `正式版如何运行`：显示运行教程
|
||
- `正式版内测计划`：显示内测信息
|
||
|
||
#### 权限要求
|
||
- 仅在特定群(621016172)可用
|
||
|
||
#### 技术实现
|
||
- 使用图片回复提供直观的教程
|
||
- 文本与图片混合响应
|
||
|
||
---
|
||
|
||
### 6. command_list - 命令列表管理
|
||
|
||
#### 功能描述
|
||
管理系统命令列表，提供命令过滤和权限控制。
|
||
|
||
#### 使用方法
|
||
- 系统内部使用，不直接暴露给用户
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 如何启动蛋定助手？
|
||
A1: 使用`nb run`命令启动，确保已安装所有依赖。
|
||
|
||
### Q2: 机器人回复后自动撤回的时间可以修改吗？
|
||
A2: 可以，在`.env`文件中修改`RECALL_DELAY`的值（单位为秒）。
|
||
|
||
### Q3: 如何成为超级用户？
|
||
A3: 在`.env`文件的`SUPERUSERS`列表中添加您的QQ号。
|
||
|
||
### Q4: AI聊天功能如何配置？
|
||
A4: 需要在`.env`文件中设置`DEEPSEEK_TOKEN`，填入您的DeepSeek API密钥。
|
||
|
||
### Q5: 为什么帮助命令在某些群不可用？
|
||
A5: 帮助命令仅在特定群(621016172)内可用，这是一种权限控制机制。
|
||
|
||
## 技术支持
|
||
|
||
如有问题，可以：
|
||
1. 在群内@机器人并提问
|
||
2. 访问帮助文档：https://www.danding.icu
|
||
3. 联系超级用户获取支持 |