bot断连时的通知插件
Project description
📖 介绍
- 可以在bot断开与nonebot的连接时向主人发送例如邮件的通知,用来通知主人bot可能被风控掉线
- 目前支持全部适配器协议,通知方式支持邮件通知
- 如果有其他通知方式的需求,欢迎提issues或pr
断连事件是通过判断nb与bot端的ws连接状态来实现的,当主动停止nonebot框架时,会先断开ws连接,随后再退出,这意味着主动停止nonebot框架时,也会收到插件发送的离线通知消息,这个无法避免,属于正常情况
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-disconnect-notice
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令pdm
pdm add nonebot-plugin-disconnect-notice
poetry
poetry add nonebot-plugin-disconnect-notice
⚙️ 配置
运行插件前,需要在 nonebot2 项目的.env.prod
文件中添加下表中的smtp配置项
如果没有开启smtp看这里
- 以qq邮箱为例,其他邮箱的开启smtp方式是类似的
1.点击qq邮箱的设置
2.点击账户
3.点击管理服务,如果没有开启,这里可能显示的是开启服务
4.点击生成授权码
5.按照要求用密保手机号发送短信验证
6.复制得到的这个授权码
7.得到的这个授权码
就相当于邮箱密码,邮箱账号就是qq邮箱,其他的一些常见邮箱的smtp_server和smtp_port配置参数参考下表
邮箱名 | smtp_server | smtp_port |
---|---|---|
qq邮箱 | smtp.qq.com | 465 |
网易yeah邮箱 | smtp.yeah.net | 465 |
阿里云邮箱 | smtp.aliyun.com | 465 |
网易163邮箱 | smtp.163.com | 465 |
移动139邮箱 | smtp.139.com | 465 |
配置项 | 必填 | 值类型 | 默认值 | 说明 |
---|---|---|---|---|
disconnect_notice_smtp_user | 是 | str | "" | 邮箱账号,如 114514@yeah.net |
disconnect_notice_smtp_password | 是 | str | "" | 邮箱密码或授权码,如 114514 |
disconnect_notice_smtp_server | 是 | str | "" | 邮箱服务器地址,如 smtp.yeah.net |
disconnect_notice_smtp_port | 是 | int | 465 | 邮箱端口号,ssl模式时为465 |
disconnect_notice_notice_email | 是 | str | "" | 收件人邮箱,填写自己邮箱即可 |
disconnect_notice_dev_mode | 否 | bool | False | 开发者模式,该模式下bot断开连接不会触发通知消息,避免本地测试插件时不断重载而导致的大量掉线通知 |
disconnect_notice_max_grace_time | 否 | int | 10 | 断连后最大宽限时长,单位:秒,如果在此期间bot完成了重连,则不触发邮件通知 |
示例配置
# disconnect_notice示例配置
disconnect_notice_smtp_user = "114514@yeah.net" #邮箱账号
disconnect_notice_smtp_password = "114514" #邮箱密码
disconnect_notice_smtp_server = "smtp.yeah.net" #邮箱服务器地址
disconnect_notice_smtp_port = 465 #邮箱端口号
disconnect_notice_notice_email = "114514@qq.com" #收件人邮箱
disconnect_notice_dev_mode = False #开发者模式,该模式下bot断连不会触发通知消息,避免本地测试插件时不断重载而导致的大量掉线通知
disconnect_notice_max_grace_time = 10 #断连后最大宽限时长,单位:秒,如果在此期间bot完成了重连,则不触发邮件通知
🎉 使用
指令表
指令 | 权限 | 需要@ | 范围 | 说明 |
---|---|---|---|---|
断连通知测试 | 主人 | 否 | 所有会话 | 主动触发掉线通知测试,用来测试通知是否正常可用 |
效果图
邮件通知
✨喜欢的话就点个star✨吧,球球了QAQ
⏳ Star 趋势
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for nonebot_plugin_disconnect_notice-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ad29e832566e3c7bb348bccf65b6f94418a0f985404eedcbdd1d733696eb60a2 |
|
MD5 | b5ecb7bd3641e7acb0d879836803bf50 |
|
BLAKE2b-256 | 81a912c706ab5886de1d8c5fa67d8a15d175ed1ab0bf3da935237287c221161c |
Close
Hashes for nonebot_plugin_disconnect_notice-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5bac5d790b8807729a4bae373e57ca75c03d3f8d09b3bab162f526542efb39d8 |
|
MD5 | 08d11e79ac0505272b776fb0a7adeea7 |
|
BLAKE2b-256 | 43cde751498f275ffa95c8253dd53539e3dc768185b39cc9105a57857cd1322c |