一个为 NoneBot2 框架设计的插件,用于监听群聊上报舞萌DX服务器状态,并提供实时状态查询。
- 实时状态查询:
/net或发送「网咋样」「炸了吗」,直接获取服务器当前状态 - 手动上报:通过
/report命令上报故障类型 - 自动监听:在群聊中自动识别玩家自然语言,无需手动触发命令
- 冯氏指数:自动识别「老冯起飞/返航」
- 断网播报:服务器宕机时自动推送告警(含宕机服务清单),恢复后推送通知到配置的群
- 广播公告:服务端推送公告时,
/net自动显示
nb plugin install nonebot-plugin-maimaimonitor或通过 pip:
pip install nonebot-plugin-maimaimonitor在 .env 文件中配置:
| 环境变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
MAIMAI_BOT_CLIENT_ID |
str |
无 | 由您自行提供,联系申请私钥 |
MAIMAI_BOT_PRIVATE_KEY |
str |
无 | 与 ClientID 配套的私钥,申请时一并提供 |
MAIMAI_BOT_DISPLAY_NAME |
str |
qwq |
Bot显示名称,上报时展示 |
MAIMAI_WORKER_URL |
str |
https://maiapi.chongxi.us |
上报API地址 |
MAIMAI_BROADCAST_GROUP_IDS |
list[int] |
[] |
广播推送的群组列表 |
MAIMAI_BROADCAST_INTERVAL |
int |
300 |
广播轮询检测间隔(秒) |
MAIMAI_BROADCAST_ALL_GROUPS |
bool |
false |
向bot所在所有群播报,谨慎使用 |
MAIMAI_BROADCAST_TIME_RANGES |
str |
无 | 推送时间白名单,格式如 8-11,13-20,空时不限制。左闭右开(8-11 包含 8 点不包含 11 点),跨天用 22-6(晚上 10 点到早上 6 点) |
MAIMAI_BROADCAST_SERVERS |
list[str] |
[] |
要播报的服务器列表,可填 key 或名字(如 ["net","aime"])。留空默认全部服务(NET/会员/标题/公众号(NET)/公众号(二维码)/计费)都播报宕机提示 |
申请 Client ID:Client ID 由您自行提供,任意 ASCII 字符串,联系 qwq@chongxi.us 或 chongxi3555@proton.me 获取对应私钥。
发送 /net、网咋样 或 炸了吗
【舞萌DX游戏服务器状态】
🟢 一切正常
【服务状态】
🟢 NET 42ms
🟢 会员 38ms
🟢 标题 45ms
🟢 公众号(NET) 51ms
🟢 公众号(二维码) 60ms
🟢 计费 62ms
⏱ 当前延迟:42ms|服务器负载:流畅|延迟稳定
💬 服务器运行正常
• 1小时前 中国 机台断网
• 4小时前 JP 机台无法登录
🔗 详情请查看 https://mai.chongxi.us/
/report 断网
/report 小黑屋
/report 被发票
/report 罚站 300
/report help
插件会自动识别群聊中的以下说法并上报,无需手动触发:
异常触发(主语+动词组合)
- 主语:华立、SEGA、服务器、机台、NET 等
- 动词:炸、挂、死、坏、崩 等
- 示例:「服务器又炸了」「SEGA挂了」「机台灰网」「游客了」「20min了」
正常触发
- 示例:「服务器好了」「华立稳了」「绿网了」
冯氏指数
- 起飞(异常):「华立冯飞了」「SEGA老冯起飞」
- 返航(正常):「华立冯返航了」「SEGA老冯落地」
配置 MAIMAI_BROADCAST_GROUP_IDS 或开启 MAIMAI_BROADCAST_ALL_GROUPS 后,服务器宕机时自动推送(默认全部服务的宕机都会播报,可用 MAIMAI_BROADCAST_SERVERS 限定播报范围):
【舞萌DX服务器断网播报】
🔴 部分服务宕机
宕机服务:NET、标题
💬 过去1小时有5条异常上报,延迟934ms
• 刚刚 BOT 机台断网
• 2分钟前 中国 机台断网
🔗 详情请查看 https://mai.chongxi.us/
恢复后自动推送:
【舞萌DX服务器状态恢复】
🟢 一切正常
本次约持续 1hr 23min
🔗 详情请查看 https://mai.chongxi.us/
数据由 isMaiDown 提供
完整接口说明及在线调试工具请访问 isMaiDown API Docs
Caution
client.py 包含核心签名算法,任何改动都可能导致与服务端验证不兼容。如需扩展功能请只添加新方法,不要修改 _calculate_hmac_sha256、_generate_sha256_hash、send_report 的任何逻辑。
- Auth v2:新密钥体系,支持
v2_前缀 Client ID,兼容现有 v1 用户 - 主动断网通知:服务器状态变化时自动推送告警和恢复通知
欢迎提交 PR。
感谢 @Jackdwh 对此项目调试做出的巨大贡献
本人同时维护前端/后端/探针及bot服务,更新可能有延迟,望谅解。