字数
560 字
阅读时间
3 分钟
牛牛状态 bot_status
查看牛牛在线情况、报数，并在离线时发送邮件提醒。
安装方式
可在控制台插件商店安装，或执行 uv run pallas ext install pallas-plugin-bot-status。
怎么使用
| 口令 / 触发 | 场景 | 说明 |
|---|---|---|
牛牛在吗 | 群内 / 私聊 | 查看在线或离线情况。 |
牛牛报数 / 牛牛出列 | 群内 | 在线牛牛依次报到。 |
测试邮件 | 群内 / 私聊 | 测试邮件通知是否可用。 |
详细用法、限制条件和可用范围以帮助为主。
命令权限
| 命令 ID | 默认等级 |
|---|---|
bot_status.status | 号主 |
bot_status.count | 所有人 |
bot_status.test_mail | 仅超管 |
配置项
可在控制台对应插件页中修改。
牛牛状态常用配置包括 SMTP、通知邮箱、离线宽限时间，以及 在吗 名册范围。
| 键 | 说明 |
|---|---|
bot_status_list_mode | 控制 在吗 和名册的统计范围 |
排障
| 现象 | 处理 |
|---|---|
| 收不到邮件 | 检查 SMTP 配置和收件邮箱。 |
| 误报离线 | 适当调大离线宽限时间。 |
实现
源码位置：官方插件扩展仓 pallas-plugin-bot-status
关键文件：
- 扩展仓
src/pallas_plugin_bot_status/__init__.py：注册命令、权限和帮助元数据。 - 在线状态统计文件：负责汇总在线情况与名册展示。
- 邮件通知文件：负责离线通知和测试邮件发送。
实现要点：
牛牛在吗与牛牛报数的目标不同，一个偏状态查看，一个偏群内点名。- 多牛部署时，名册范围受配置影响，不一定只看当前进程。
- 邮件提醒只是兜底能力，能否送达取决于 SMTP 和收件设置。
