DDBOT 开源项目教程
项目介绍
DDBOT 是一个基于 MiraiGO 的 QQ 群推送框架,内置支持 B 站直播/动态、斗鱼直播、YTB 直播/预约直播、虎牙直播、ACFUN 直播、微博动态,也可以通过插件支持任何订阅源。DDBOT 专注于 QQ 群推送,设计简洁,交互最小化,旨在减轻重复工作负担。
项目快速启动
环境准备
确保你已经安装了 Go 语言环境。如果没有,请访问 Go 官方网站 进行安装。
克隆项目
git clone https://github.com/Sora233/DDBOT.git
cd DDBOT
安装依赖
go mod download
配置文件
在项目根目录下创建一个 config.json
文件,并根据需要进行配置。以下是一个基本的配置示例:
{
"QQGroupID": 123456789,
"BotQQNumber": 987654321,
"BotPassword": "your_password",
"PushSources": {
"Bilibili": {
"Enable": true,
"Keywords": ["关键字1", "关键字2"]
},
"Douyu": {
"Enable": true
},
"Youtube": {
"Enable": true
},
"Huya": {
"Enable": true
},
"Acfun": {
"Enable": true
},
"Weibo": {
"Enable": true
}
}
}
运行项目
go run main.go
应用案例和最佳实践
案例一:B 站直播推送
假设你是一个 B 站主播,希望在直播开始时自动通知你的 QQ 群成员。你可以通过配置 PushSources
中的 Bilibili
部分来实现这一功能。
案例二:自定义消息模板
DDBOT 支持自定义消息模板,你可以根据需要修改推送消息的格式。例如,你可以创建一个 template.txt
文件,并在其中定义消息格式:
直播开始啦!主播:{{.UserName}},直播间地址:{{.LiveUrl}}
然后在配置文件中指定模板路径:
{
"MessageTemplate": "template.txt"
}
最佳实践
- 权限管理:合理配置命令权限,防止滥用。
- 隐私保护:确保 Bot 密码足够强,不要将 Bot 设置为 QQ 群管理员。
- 稳定性:实现保活机制,确保 Bot 在掉线时能够自动重连。
典型生态项目
MiraiGO
DDBOT 基于 MiraiGO 开发,MiraiGO 是一个高性能的 QQ 机器人框架,支持多种消息类型和丰富的插件系统。
BuntDB
DDBOT 使用 BuntDB 作为嵌入式数据库,BuntDB 是一个快速的、嵌入式的、内存中的键值存储,适用于需要高性能和简单 API 的应用。
Lolicon API
DDBOT 支持随机图片推送,使用 Lolicon API 提供图片资源。Lolicon API 是一个免费的二次元图片 API,支持多种筛选条件。
通过这些生态项目,DDBOT 能够提供稳定、高效、可扩展的 QQ 群推送服务。