koishi-plugin-message-counter
Koishi 的消息数量统计插件。发言排行榜。
注意事项
-
仅记录群聊消息
-
初始化需要权限等级 3 级
-
必需 database 和 cron 服务
关键指令
messageCounter.查询 [指定用户]
查询指定用户的发言次数信息（次数[排名]）。若不带任何选项，则显示所有时段的数据。
选项:
| 参数 | 说明 |
|------|------|
| -d, --day | 今日发言次数[排名] |
| --yd, --yesterday | 昨日发言次数[排名] |
| -w, --week | 本周发言次数[排名] |
| -m, --month | 本月发言次数[排名] |
| -y, --year | 今年发言次数[排名] |
| -t, --total | 总发言次数[排名] |
| --dag | 跨群今日发言次数[排名] |
| --ydag | 跨群昨日发言次数[排名] |
| --wag | 跨群本周发言次数[排名] |
| --mag | 跨群本月发言次数[排名] |
| --yag | 跨群本年发言次数[排名] |
| -a, --across | 跨群总发言次数[排名] |
messageCounter.排行榜 [显示的人数]
发言排行榜。默认为今日发言榜。
选项:
| 参数 | 说明 |
|------|------|
| --yd, --yesterday | 昨日发言排行榜 |
| -w | 本周发言排行榜 |
| -m | 本月发言排行榜 |
| -y | 今年发言排行榜 |
| -t | 总发言排行榜 |
| --dag | 跨群今日发言排行榜 |
| --ydag | 跨群昨日发言排行榜 |
| --wag | 跨群本周发言排行榜 |
| --mag | 跨群本月发言排行榜 |
| --yag | 跨群今年发言排行榜 |
| --dragon | 跨群总发言排行榜（圣龙王榜） |
| --whites | 白名单，只显示白名单用户 |
| --blacks | 黑名单，不显示黑名单用户 |
messageCounter.群排行榜 [number:number]
各群聊的发言排行榜。默认为今日发言榜。
选项:
| 参数 | 说明 |
|------|------|
| --yd, --yesterday | 昨日发言排行榜 |
| -w, -m, -y, -t | 本周/本月/今年/总发言排行榜 |
| -s | 指定用户的群发言排行榜 |
| --whites | 白名单，只显示白名单群 |
| --blacks | 黑名单，不显示黑名单群 |
messageCounter.上传柱状条背景
-
为自己上传一张自定义的水平柱状条背景图片
-
新图片会覆盖旧的图片。若上传失败，旧图片也会被删除
-
使用此指令时需附带图片
messageCounter.重载资源
- 实时重载用户图标、柱状条背景和字体文件，使其更改即时生效（需要权限等级 2）
messageCounter.清理缓存
-
清理过期的头像缓存文件，以释放磁盘空间（需要权限等级 3）
-
用户更换头像后，旧的头像缓存会变成“孤儿缓存”。此指令可以安全地移除它们。
自定义水平柱状图样式
- 重载插件或使用
messageCounter.重载资源指令可使新增的文件立即生效。
1. 用户图标
-
在
data/messageCounter/icons文件夹下添加用户图标 -
文件名格式为
用户ID.png（例：1234567890.png） -
支持多图标，文件名格式为
用户ID-1.png,用户ID-2.png
2. 柱状条背景
-
推荐方式：使用
messageCounter.上传柱状条背景指令 -
手动方式：在
data/messageCounter/barBgImgs文件夹下添加背景图片 -
支持多背景（随机选用），文件名格式为
用户ID-1.png等 -
建议尺寸 850x50 像素，文件名
用户ID.png
3. 自定义字体
-
插件启动时，会自动将内置字体
HarmonyOS_Sans_Medium.ttf拷贝到data/messageCounter/fonts/目录下。 -
您可以将自己喜爱的字体文件放入此文件夹，并在配置项的“字体设置”中填入该字体的文件名称（不带后缀）。
示例截图
致谢
| 项目/贡献者 | 贡献 |
|------------|------|
| Koishi | 机器人框架 |
| Akisa | Akisa 大人 |
| shangxueink | 上学大人 |
| shangxue | 推送所有频道的配置项 |
| nullbczd | 水平柱状图样式等功能 |
QQ 群
- 956758505
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
