NoneBot Plugin: Maimai Monitor#

一个为 NoneBot2 框架设计的插件，用于通过聊天指令上报 maimai 服务器状态

功能#

• 状态上报: 通过简单的聊天指令（如 /report 断网）上报服务器状态
• 数据聚合: 自动缓存用户上报数据，每 30 秒打包发送至后端 API
• 自定义命令别名: 允许用户在配置中定义简洁的命令别名 映射到复杂的报告指令
• 直接抓取页面并渲染

安装#

你可以通过 NoneBot 的脚手架工具 nb-cli 安装：

1
nb plugin install nonebot-plugin-maimaimonitor

或者通过 pip 安装：

1
pip install nonebot-plugin-maimaimonitor

配置#

插件的配置项通过 NoneBot 的统一配置方式进行管理，你需要在你的 NoneBot 项目根目录下的 .env 文件中设置

1
# .env 文件 (位于你的 NoneBot 项目根目录)
2

3
# --- NoneBot Plugin Maimai Monitor 插件核心配置 ---
4
MAIMAI_BOT_CLIENT_ID="YOUR_BOT_CLIENT_ID"
5
MAIMAI_BOT_PRIVATE_KEY="YOUR_BOT_PRIVATE_KEY"
6
MAIMAI_BOT_DISPLAY_NAME="qwqbot"
7
MAIMAI_WORKER_URL="https://maiapi.chongxi.us"
8

9
# --- 自定义命令别名配置 (使用单行 JSON 字符串) ---
10
# 左边是用户输入的新命令，右边是它映射的内部报告指令参数字符串。
11
# 右边的字符串会被插件解析，并作为 /report 命令的参数部分。
12
COMMAND_ALIASES="{ \
13
    \"ctk\": \"被发票\", \
14
    \"清票\": \"被发票\", \
15
    \"服务器炸了\": \"断网\", \
16
    \"打不开公众号\": \"NET打不开\", \
17
    \"变游客了\": \"无法登录\", \
18
    \"黑屋了\": \"小黑屋\", \
19
    \"被发舞神了\": \"其他扫号行为\", \
20
    \"罚站300秒\": \"罚站 300\", \
21
    \"罚站一小时\": \"罚站 3600\", \
22
    \"帮助\": \"help\" \
23
}"

使用#

在你的 NoneBot 项目 bot.py 文件中加载插件：

1
import nonebot
2

3
# ... 其他初始化代码 ...
4

5
nonebot.load_plugin("nonebot_plugin_maimaimonitor")
6

7
# ... nonebot.run() ...

插件加载成功后，你可以在与机器人聊天的任何地方发送以下指令：

• /report help 或 /上报 帮助: 查看全部可用的上报类型和帮助信息
• 使用自定义命令别名: 例如，如果你在 COMMAND_ALIASES 中配置了 "ctk": "被发票"，那么直接发送 ctk 即可触发 /report 被发票 的功能

部分命令示例:

• /report 断网 或 配置的别名（如 炸了）: 上报一次机台网络断开事件
• /report 罚站 [秒数] 或 配置的别名（如 罚站五分钟）: 上报玩家罚站时长，例如 /report 罚站 300 表示罚站 5 分钟

主动 Dashboard 渲染#

未来将会支持直接将前端渲染为SVG并转化为图片，当前仍需要截取 https://blog.chongxi.us/go/?url=https://mai.chongxi.us/?share=true&dark=auto

share 为 bot 特殊优化的页面，dark 用于切换深色模式，auto 会自动根据时间切换。