QQ 机器人 | 基于 Konata.Core | 一键免费部署
QQ 机器人 | 基于 Konata.Core | 一键免费部署
- Web 可视化 - 无需再在 Console 上操作, 轻松上手
- 插件化架构 - 轻松使用插件扩展
注意 : 本项目仅供学习使用, 所有第三方插件与本项目无关
通知: 请尽快 更新到 QQBotHub-v0.5.2 或 更高版本, 旧版本不再做支持
- 在线 QQ 登录
- 其它大部分功能由 插件提供
- 本仓库 维护的 官方插件
- QQHelloWorldPlugin
- 复读好友私聊
- 上下线通知 设置 里的 AdminQQ
- MoLiPlugin
- 对接 茉莉机器人 API
- 自定义知识库, 各种娱乐功能
- 设置 机器人聊天群, 好友
-
@机器人/聊天前缀
- 对接 茉莉机器人 API
- QQStatPlugin
- 收集群聊消息
- 下载 群聊 数据库
-
#日历 -
#折线
- BackupPlugin
- 定时 自动 备份 插件数据
- 将 备份文件 发送到 Telegram
- 备份时消耗较大, 建议 搭配
AutoLoginPlugin使用, 防止备份途中 意外掉线
- AutoLoginPlugin
- 定时 检测在线状态 (频率:1分钟)
- 当由于异常离线后, 自动利用登录成功的数据 重新登录
- 重新登录成功后, 通知
AdminQQ
- QQNotePlugin
- 利用 QQ 写笔记 (随笔/零碎知识点)
- 笔记写入 GitHub 指定仓库的指定文件中
- 利用 QQ 写笔记 (随笔/零碎知识点)
- ZhiDaoPlugin
- 自定义问答
- 群主/管理员/AdminQQ 自定义问答
- 分群自定义问答
- 关键词自动回复
- 自定义问答
- QQHelloWorldPlugin
PluginCore Admin 用户名与PluginCore Admin 密码为你自己设置的后台登录用户名与密码, 随意设置即可, 自己记住就行
- 点击下方按钮 一键部署
- 免费注册, 无需信用卡验证
- Railway 每月有
$5.00免费额度, 若只跑本项目完全够用 (应该说绰绰有余)
| 环境变量名称 | 必填 | 备注 |
|---|---|---|
PLUGINCORE_ADMIN_USERNAME |
√ | PluginCore Admin 用户名 |
PLUGINCORE_ADMIN_PASSWORD |
√ | PluginCore Admin 密码 |
注意:
- Railway 修改环境变量 会 触发 重新 Deploy
- Railway 重新 Deploy 后会删除数据, 你安装的所有插件及数据都将清空。
- 点击下方按钮 一键部署
- 免费注册, 无需信用卡验证
- Heroku 每月有免费时长 500小时, 若使用信用卡验证, 可提升到 免费 1000小时
- Heroku 应用一段时间不访问会自动休眠, 因此为了保证存活, 请使用第三方监控保活, 例如: UptimeRobot: 免费网站监控服务
| 环境变量名称 | 必填 | 备注 |
|---|---|---|
PLUGINCORE_ADMIN_USERNAME |
√ | PluginCore Admin 用户名 |
PLUGINCORE_ADMIN_PASSWORD |
√ | PluginCore Admin 密码 |
docker run -d -p 5004:80 -e ASPNETCORE_URLS="http://*:80" -e ASPNETCORE_ENVIRONMENT="Production" -e TZ="Asia/Shanghai" --name qqbothub yiyungent/qqbothub# 可选, 进入容器 管理, 例如修改 /app/App_Data/PluginCore.Config.json 中的 PluginCore Admin 用户名与密码
docker exec -it qqbothub bash部署完成后
一定要先登录
PluginCore Admin, 因为QQ登录页面与PluginCore Admin使用相同权限
- 访问: https://your-domain/PluginCore/Admin 进入
PluginCore Admin- 访问: https://your-domain 进行 QQ机器人 登录
若为
短信验证, 则直接输入收到的验证码, 点击提交验证即可
若为
滑动验证, 则点击前往验证, 浏览器在滑动验证页面 按F12, 再选择Network, 通过滑动验证后, 复制ticket如下 (不要包括双引号), 将ticket粘贴到输入框, 点击提交验证即可
注意验证不要等待太久, 否则尝试刷新登录页面 以重新登录及获取新验证
注意
当 无法登录 时
- 当
滑动验证验证通过后, 等待一会 , 还是无法进入已登录状态可 下载 Releases - ConsoleApp - Assets 在本地登录成功后,
获取 BotKeyStore.json 后, 在登录页面使用 配置 方式登录
- 大部分人电脑为
Windows 64 位, 点击 ConsoleApp-win-x64.zip 下载即可, 下载到本地解压, 双击 ConsoleApp.exe- 运行
ConsoleApp.exe会自动给出输入提示, 按提示操作即可- 运行
ConsoleApp.exe无需额外安装.NET SDK 或 Runtime, 程序已打包
访问: https://your-domain/PluginCore/Admin 进入 PluginCore Admin
插件:
下载插件包,插件包下载见 Release , 直接插件上传 下载的
QQHelloWorldPlugin-net6.0.zip即可然后直接
上传 -> 安装 -> 文档 -> 设置 -> 启用 -> 文档即可
查看最新版 Releases - QQBotHub
若你使用
Railway一键部署,
只需要修改Railway创建的仓库 (例如:QQBotHub) 里的Dockerfile文件里的yiyungent/qqbothub:v0.5.2, 更新最后的版本号v0.5.2到最新版即可
注意:
请更新前导出插件数据,QQStatPlugin支持下载数据库到本地, 然后下载最新插件包, 解压, 将数据库文件替换为你导出的数据库文件, 然后在有QQStatPlugin.sqlite的路径下打包所有文件 为 zip, 上传插件即可
插件设置可以通过保持打开插件设置页面的方式, 重新安装插件后, 再在此页面点击保存
注意:
所有纯基于PluginCore.IPlugins开发的插件都通用,
下载插件包, 然后上传 -> 安装 -> 设置 -> 启用即可
插件开发 可参考:
QQBotHub 插件开发包
插件开发包中已包含:
Konata.CorePluginCore.IPlugins.AspNetCore
dotnet add package QQBotHub.Sdk注意:
- 本项目目前直接使用的
PluginCore插件框架, 插件采用激发式, 插件工作完成后, 实例会立即销毁, 无法常驻后台- 若需要定时任务, 可以使用
ITimeJobPlugin, 可见PluginCore的文档- 由于 QQBot 本身为常驻, 因此需额外注意
IPluginFinder的服务的生命周期/范围, 这点和在ASP.NET Core的Controller中 直接使用不同
- KonataDev/Konata.Core - QQ Android 协议核心库
- yiyungent/PluginCore - 插件系统
QQBotHub is an GPL-3.0 licensed open source project and completely free to use. However, the amount of effort needed to maintain and develop new features for the project is not sustainable without proper financial backing.
We accept donations through these channels:
QQBotHub © yiyun, Released under the GPL-3.0 License.
Authored and maintained by yiyun with help from contributors (list).
GitHub @yiyungent Gitee @yiyungent