Skip to content

About

一个为 NoneBot2 框架设计的插件,用于实时监测舞萌DX服务器状态

Resources

Stars

14 stars

Watchers

0 watching

Forks

Latest commit

 

History

111 Commits

Folders and files

Repository files navigation

NoneBot Plugin: Maimai Monitor



一个为 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/

手动上报 (需要Client ID+私钥才可上报)

/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/

Powered by isMaiDown


数据由 isMaiDown 提供

通用 API 文档

完整接口说明及在线调试工具请访问 isMaiDown API Docs


Caution

client.py 包含核心签名算法,任何改动都可能导致与服务端验证不兼容。如需扩展功能请只添加新方法,不要修改 _calculate_hmac_sha256、_generate_sha256_hash、send_report 的任何逻辑。

开发计划

  • Auth v2:新密钥体系,支持 v2_ 前缀 Client ID,兼容现有 v1 用户
  • 主动断网通知:服务器状态变化时自动推送告警和恢复通知

贡献

欢迎提交 PR。

特别鸣谢

感谢 @Jackdwh 对此项目调试做出的巨大贡献

注

本人同时维护前端/后端/探针及bot服务,更新可能有延迟,望谅解。

About

一个为 NoneBot2 框架设计的插件,用于实时监测舞萌DX服务器状态

Resources

Stars

14 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages