牛牛状态 pallas-plugin-bot-status

查看在线情况、群内报数，并在离线时发送邮件提醒。

安装方式

需已安装 Pallas-Bot 4.0 或更高版本。推荐直接在控制台插件商店安装，或在本体项目中执行：

uv run pallas ext install pallas-plugin-bot-status

也可单独安装本包：

uv pip install pallas-plugin-bot-status

怎么使用

口令 / 触发	场景	说明
牛牛在吗	群内 / 私聊	查看在线和离线情况。
牛牛报数 / 牛牛出列	群内	在线牛牛依次报到。
测试邮件	群内 / 私聊	测试邮件通知配置。
离线邮件	群内 / 私聊	超管向离线牛牛号主发送提醒邮件。

详细用法、限制条件和可用范围以帮助为主。

命令权限

命令 ID	默认等级
bot_status.status	号主
bot_status.count	所有人
bot_status.test_mail	仅超管
bot_status.offline_mail	仅超管

配置项

可在控制台对应插件页中修改。

牛牛状态的常用配置包括 SMTP、通知邮箱、离线宽限时间和名册范围模式。

排障

现象	处理
收不到邮件	检查 SMTP 和通知邮箱配置。
报数不全	检查当前群里是否真的在线，以及分片协调是否正常。
误报离线	调大离线宽限时间。

实现

源码位置：src/pallas_plugin_bot_status/

关键文件：

• __init__.py：注册状态查询、报数和测试邮件命令。
• bot_monitor.py：汇总在线状态和群内可见牛牛。
• mail_notifier.py：发送离线通知和测试邮件。

实现要点：

• 牛牛在吗 用于聚合状态，牛牛报数 更偏向当前群里的现场点名。
• 邮件通知除了发到配置邮箱，还会尝试发给对应牛牛管理员的 QQ 邮箱。
• 分片模式下，报数和状态统计会受当前配置的名册范围影响。

相关链接

• 主仓插件文档
• Pallas-Bot