nonebot_plugin_dialectlist/README.md
2024-06-18 23:20:03 +08:00

132 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
<a href="https://v2.nonebot.dev/store"><img src="https://s2.loli.net/2022/06/16/opBDE8Swad5rU3n.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
<br>
<p><img src="https://s2.loli.net/2022/06/16/xsVUGRrkbn1ljTD.png" width="240" alt="NoneBotPluginText"></p>
</div>
<div align="center">
# 话痨排行榜
nonebot-plugin-dialectlist
\>💬**看看群友们这些天在群里水了多少话**💬<
</div>
## 💿安装
通过`pip`或`nb`安装;
>**通过pip**安装
`pip install nonebot-plugin-dialectlist`
>**通过nb**安装
`nb plugin install nonebot-plugin-dialectlist`
### ✅插件依赖于
1. [nonebot-plugin-datastore](https://github.com/he0119/nonebot-plugin-datastore) ————储存历史的消息
2. saa 和 定时管理 (下次写个更清晰的)
## ⚙配置
需要**提前配置**本插件所**依赖的插件**
在 .env 中,可以添加以下配置项
```python
dialectlist__string_format = '第{index}名:\n{nickname},{chatdatanum}条消息\n' #消息格式
dialectlist__string_suffix_format = '你们的职业是水群吗————MYX\n计算花费时间:{timecost}秒' #消息后缀格式
dialectlist__get_num = 10 #获取人数数量
dialectlist__visualization = True #是否可视化
dialectlist__visualization_type = '圆环图' #可视化方案
dialectlist__font = 'SimHei'#字体格式
dialectlist__excluded_people = []#排除的人的QQ号(或频道号?(未经测试))
dialectlist__excluded_self = True #是否排除机器人自己QQ
```
💭也可以不进行配置,这将会使插件按照默认配置运行
### ⚠ 注意!!
需要提前安装好[GTK+](https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer)(仅Windows环境下需要安装GTK+)
在Windows以外的环境中可能不存在插件默认的字体请自行改为系统中拥有的字体
## 🗨命令
__注意__
新版本指令调用方式改变改为更易理解也更好打的B话榜。
所以下面的调用需要把群话痨改成B话排行榜改成榜。
即 群话痨 -> B话 排行榜 -> 榜
比如 今日群话痨排行榜 -> 今日B话榜
以此类推。
-`/群话痨排行榜` ————看看有史以来(机器人存在以来)群友们发了多少消息!
-`/今日群话痨排行榜` ————看看今天的群友发了多少消息!
-`/昨日群话痨排行榜` ————看看昨天的群友发了多少消息!
-`/前日群话痨排行榜` ————看看前天的群友发了多少消息!
-`/本周群话痨排行榜` ————看看本周的群友发了多少消息!
-`/上周群话痨排行榜` ————看看上周的群友发了多少消息!
-`/本月群话痨排行榜` ————看看这个月的群友发了多少消息!
-`/年度群话痨排行榜` ————看看今年的群友发了多少消息!
-`/历史群话痨排行榜` ————看看历史上(机器人存在以来)的群友发了多少消息!
## 📖版本
### V1.0
- 看看群里群友能有多话痨
### V1.1
- 支持频道咯!(*^_^*)
### V1.2
- 排行榜可视化
### V1.3
- 添加了一些可配置项
### V1.4
- 适配新版本的chatrecorder,暂时停止频道支持
### V2.0
- 理论支持全平台!暂停图片支持。
## 💧另外
### 感谢
本插件的__init__.py中的处理函数参考了词云中的方法 ~~其实大部分都是Ctrl+C Ctr+V~~
[nonebot-plugin-wordcloud](https://github.com/he0119/nonebot-plugin-wordcloud)
## TODO
- [x] 适配全平台
- [ ] 私聊的查询(超级用户可以任意查询群聊的信息)
- [ ] 关键词查询
- [ ] 尝试利用jinja2模板引擎制作可视化图片(((真的可以吗?)))
待补充......
## 题外话
~~整个项目快被我写成屎山了~~