牛牛状态 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 邮箱。
- 分片模式下,报数和状态统计会受当前配置的名册范围影响。
相关链接
Metadata
Release files for pallas-plugin-bot-status 4.0.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pallas_plugin_bot_status-4.0.26.tar.gz | 1.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pallas_plugin_bot_status-4.0.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / pallas_plugin_bot_status-4.0.26.tar.gz
| Download URL | pallas_plugin_bot_status-4.0.26.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
85ff8c9665cf2caeca2c9087ca8759dc89e83e02ff30b0a7bc879898b79287ad
|
|
BLAKE2b-256 checksum How to use checksums |
b89dd9b30a578d536b58c141971a38b07a88a30c6006400028c2c0e7f2eab998
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.
Transparency logRelease files / pallas_plugin_bot_status-4.0.26-py3-none-any.whl
| Download URL | pallas_plugin_bot_status-4.0.26-py3-none-any.whl |
|---|---|
| Size | 43.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3b971c143655108d3377e177d23f00bc7556fa838821ca477fb23cc780eceee7
|
|
BLAKE2b-256 checksum How to use checksums |
1a1ff3f27257221070cb9f110f24591a3d873b5c02005f08d620b88275a4a9ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.
Transparency log