AstrBot 群发言统计插件

🤖 此插件由AI辅助生成

一个功能强大的AstrBot群消息统计插件，支持自动统计群成员发言次数并生成排行榜。

🚀 安装说明

方式一：直接下载

1. 下载插件压缩包 astrbot_plugin_message_stats.zip
2. 解压到AstrBot插件目录：/AstrBot/data/plugins/
3. 重启AstrBot

方式二：Git克隆

cd /AstrBot/data/plugins/
git clone https://github.com/xiaoruange39/astrbot_plugin_message_stats.git

📖 使用方法

基础命令

查看排行榜

• #发言榜 - 查看总发言排行榜
• #今日发言榜 - 查看今日发言排行榜
• #本周发言榜 - 查看本周发言排行榜
• #本月发言榜 - 查看本月发言排行榜
• #本年发言榜 - 查看本年发言排行榜
• #去年发言榜 - 查看去年发言排行榜

管理命令

• #设置发言榜数量 [数量] - 设置排行榜显示人数（1-100）
• #设置发言榜图片 [模式] - 设置显示模式（1=图片，0=文字）
• #清除发言榜单 - 清除本群发言统计数据

缓存管理命令

• #刷新发言榜群成员缓存 - 手动刷新群成员缓存
• #发言榜缓存状态 - 查看缓存状态

定时功能命令

• #发言榜定时状态 - 查看定时任务状态
• #手动推送发言榜 - 手动推送排行榜
• #设置发言榜定时时间 [时间] - 设置定时推送时间
• #设置发言榜定时群组 [群号] - 添加定时推送群组
• #设置发言榜定时群组 [群号1] [群号2] - 添加多个定时推送群组
• #删除发言榜定时群组 [群号] - 删除定时推送群组
• #启用发言榜定时 - 启用定时推送
• #禁用发言榜定时 - 禁用定时推送
• #设置发言榜定时类型 [类型] - 设置定时推送类型

使用示例

#发言榜
总发言排行榜
发言总数: 156
━━━━━━━━━━━━━━
第1名：小明·45次（占比28.85%）
第2名：小红·32次（占比20.51%）
第3名：小刚·28次（占比17.95%）

#设置发言榜数量 10
排行榜显示人数已设置为 10 人！

#设置发言榜图片 1
排行榜显示模式已设置为 图片模式！

#设置发言榜定时时间 20:00
定时推送时间已设置为 20:00

⚙️ 配置说明

插件配置

插件支持以下配置选项：

• rand: 排行榜显示人数（默认20人，范围1-100）
• if_send_pic: 显示模式（1=图片模式，0=文字模式）
• timer_enabled: 定时推送开关（0=关闭，1=开启）
• timer_time: 定时推送时间（格式：HH:MM）
• timer_groups: 定时推送群组列表
• timer_type: 定时推送类型（1=图片，0=文字）
• blocked_users: 屏蔽用户列表（不统计发言且不显示在排行榜）
• blocked_groups: 屏蔽群聊列表（不统计发言且无法使用指令）

配置方式

1. 通过命令配置（推荐）
2. 编辑配置文件：data/config.json

📁 文件结构

astrbot_plugin_message_stats/
├── main.py                 # 主程序文件
├── metadata.yaml          # 插件元数据
├── README.md              # 说明文档
├── requirements.txt       # 依赖包
├── config.yaml           # 配置文件
├── example_config.json   # 配置示例
├── _conf_schema.json     # 配置架构
├── data/                 # 数据目录
│   └── config.json       # 用户配置
├── templates/            # 模板目录
│   ├── __init__.py
│   ├── rank_template.html # 排行榜模板
│   └── user_item_macro.html # 用户项模板
└── utils/                # 工具模块
    ├── __init__.py
    ├── data_manager.py   # 数据管理
    ├── data_stores.py    # 数据存储
    ├── date_utils.py     # 日期工具
    ├── file_utils.py     # 文件工具
    ├── image_generator.py # 图片生成
    ├── models.py         # 数据模型
    ├── timer_manager.py  # 定时管理
    └── validators.py     # 数据验证

📝 更新日志

v1.7.4 (2026-01-02)

• ✅ 添加屏蔽群聊列表配置项
• ✅ 添加本年发言榜、去年发言榜指令

v1.6.5 (2025-11-24)

• ✅ 指令别名支持
• ✅ 昵称同步修复
• ✅ 添加屏蔽用户列表配置项

v1.6.0 (2025-11-05)

• ✅ 完善定时推送功能
• ✅ 增强缓存管理机制
• ✅ 提升代码质量和错误处理

v1.0 (2025-11-02)

• ✅ 完整群昵称获取功能
• ✅ 群名称自动获取
• ✅ 异步调用优化
• ✅ 配置界面清理
• ✅ 错误处理增强

v0.9 (之前版本)

• 基础消息统计功能
• 排行榜生成
• 图片模式支持

🤝 贡献指南

欢迎提交Issue和Pull Request！

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

xiaoruange39

• GitHub: @xiaoruange39
• 插件开发：AstrBot生态贡献者

🙏 致谢

感谢以下项目和插件的参考：

• AstrBot框架 - 强大的多平台聊天机器人框架
• yunzai-plugin-example - 原始插件基础架构参考

如果这个插件对您有帮助，请给个⭐支持一下！