4.5 KiB
4.5 KiB
蛋定助手插件文档
项目概述
蛋定助手是一个基于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秒后自动撤回
配置项
DEEPSEEK_TOKEN=你的DeepSeek API密钥
技术实现
- 使用OpenAI客户端连接DeepSeek API
- 使用Pyppeteer将Markdown转为图片
- 内置Chrome浏览器实例管理
示例
用户: *你好，请介绍一下自己 AI: [图片形式回复] 👋 你好呀！我是蛋定助手，一个活泼可爱的AI助手！😊 很高兴认识你！有什么我能帮到你的吗？✨
2. auto_recall - 自动撤回插件
功能描述
监控所有发出的消息，并在指定时间后自动撤回，保持聊天环境整洁。
使用方法
- 无需手动调用，插件会自动监控并撤回消息
配置项
RECALL_DELAY=110 # 撤回延迟时间，单位为秒
技术实现
- 使用NoneBot的API拦截功能
- 异步定时任务管理
- 错误处理与日志记录
3. damo_balance - 大漠账户余额查询
功能描述
查询大漠平台账户余额，需要验证码验证。
使用方法
- 命令：
大漠余额或余额查询 - 需要验证码验证
权限要求
- 仅特定用户(ID:1424473282)可使用
4. danding_api - 蛋定助手管理API
功能描述
提供管理员操作接口，包括在线人数查询、卡密管理和用户时长管理功能。
使用方法
主要命令：
在线人数：查询当前在线用户数添加卡密 [类型] [卡密]：添加指定类型的卡密生成卡密 [类型]：生成新卡密用户加时 [用户名] [类型]：为指定用户增加使用时长
卡密类型
- 天卡/day/Day/DAY/天
- 周卡/week/Week/WEEK/周
- 月卡/month/Month/MONTH/月
权限要求
- 仅超级用户可使用
配置项
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)内可用，这是一种权限控制机制。
技术支持
如有问题，可以：
- 在群内@机器人并提问
- 访问帮助文档：https://www.danding.icu
- 联系超级用户获取支持