📖 介绍
本插件基于 MsgRankCard 项目改写，是一个 NoneBot2 插件，用于记录群聊消息并生成精美的每日水群排行榜图片。
功能特点：
- 📝 自动记录群聊消息数量和在线时长
- 🎨 生成精美的排行榜图片，支持自定义背景、边框和字体
- 🥇 自动使用排行榜第一名的 QQ 头像作为背景
- 🕐 排行榜图片显示当前北京时间，发图前会播报日报/周报/月报类型
- 🖼️ 自动获取用户 QQ 头像
- 🏆 支持查看今日、本周和本月水群排行榜
- 🔔 支持 Superuser 开启排名变动提醒，名次变化后自动重发榜单
- ⏰ 支持按小时定时发送日榜，以及每天定时发送周榜和月榜
- 🧹 支持自动清理过期数据，默认保留35天
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行，输入以下指令即可安装
nb plugin install nonebot-plugin-msg-rank-card
使用包管理器安装
在 nonebot2 项目的插件目录下，打开命令行，根据你使用的包管理器，输入相应的安装命令
pip
pip install nonebot-plugin-msg-rank-card
poetry
poetry add nonebot-plugin-msg-rank-card
打开 nonebot2 项目根目录下的 pyproject.toml 文件，在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_msg_rank_card"]
⚙️ 配置
在 nonebot2 项目的 .env 文件中添加下表中的配置
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| msg_rank_data_path | 否 | data/msg_rank | 数据存储路径 |
| msg_rank_resource_path | 否 | 插件目录/resources | 资源文件路径（背景图、边框、字体） |
| msg_rank_max_count | 否 | 10 | 排行榜最大显示人数 |
| msg_rank_auto_clean | 否 | true | 是否每天自动清理过期数据 |
| msg_rank_data_retention_days | 否 | 35 | 每日统计数据保留天数（最低31天） |
| msg_rank_title | 否 | 今日水群排行榜 | 排行榜标题 |
🎉 使用
指令表
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
| 水群榜 / msgrank | 群员 | 否 | 群聊 | 查看今日水群排行榜 |
| 周水群榜 / 周榜 | 群员 | 否 | 群聊 | 查看本周一至今日的汇总排行榜 |
| 月水群榜 / 月榜 | 群员 | 否 | 群聊 | 查看本月1日至今日的汇总排行榜 |
| 排名变动提醒 开启|关闭|状态 | Superuser | 否 | 群聊 | 管理本群排名变动提醒 |
| 日榜定时 1-168|关闭|状态 | Superuser | 否 | 群聊 | 按指定小时间隔自动发送今日榜 |
| 周榜定时 HH:MM|关闭|状态 | Superuser | 否 | 群聊 | 每天指定时间自动发送本周榜 |
| 月榜定时 HH:MM|关闭|状态 | Superuser | 否 | 群聊 | 每天指定时间自动发送本月榜 |
| 清理水群数据 / clean_msgrank | 群主/管理员 | 否 | 群聊 | 清理过期数据 |
排名变动提醒默认关闭，开关按群保存。开启后，只有榜单成员或名次顺序发生变化时才会提醒；消息数增加但名次不变时不会重复发送。
定时任务默认关闭，按群保存，机器人重启后会自动恢复。HH:MM 使用 NoneBot APScheduler 配置的时区（默认 Asia/Shanghai）。
效果图
插件会自动记录群聊消息，发送 /水群榜 即可生成精美排行榜图片。
馒头好感度联动（可选）
同时加载 nonebot-plugin-mantou-affection 后，日榜、周榜、月榜和定时榜单都会在每位成员旁显示
“馒头好感 + 当前关系称号”。好感数据按群读取；未加载好感度插件时卡片保持原样。
自定义资源
当第一名头像下载失败时，插件才会回退到 resources 文件夹中的背景图。你可以替换这些资源文件：
bg/- 背景图片（随机选择）frame/- 排名边框装饰ttf/- 自定义字体（第一个 ttf 文件会被使用）
📄 许可证
本项目基于 MsgRankCard 改写，采用 MIT 许可证。
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-msg-rank-card 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_msg_rank_card-0.1.6.tar.gz | 9.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_msg_rank_card-0.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.0 MB
Release files / nonebot_plugin_msg_rank_card-0.1.6.tar.gz
| Download URL | nonebot_plugin_msg_rank_card-0.1.6.tar.gz |
|---|---|
| Size | 9.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c4e1def2a96f6b4e9e98f222abee4eb7a50b347e59aa6efcdab1b31a8ad9d31a
|
|
BLAKE2b-256 checksum How to use checksums |
71212ba8b04bd6107867c2b8b16bec6cb3763957f8ef34906500279bf6fbfc93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.9
|
Release files / nonebot_plugin_msg_rank_card-0.1.6-py3-none-any.whl
| Download URL | nonebot_plugin_msg_rank_card-0.1.6-py3-none-any.whl |
|---|---|
| Size | 9.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ba725c603b9faa712755b8655f4944aa14181a0add653246354980fc7584a543
|
|
BLAKE2b-256 checksum How to use checksums |
64c81300b503f6e03030373a8498bc88f8b77e1cd1d039ad0c1ef4ddeb297a9c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.9
|
