https://github.com/stillmisty/nonebot_plugin_summary_group
基于 Nonebot2，使用 AI 分析群聊记录，生成讨论内容的总结。
https://github.com/stillmisty/nonebot_plugin_summary_group
Last synced: 8 months ago
JSON representation
基于 Nonebot2，使用 AI 分析群聊记录，生成讨论内容的总结。
- Host: GitHub
- URL: https://github.com/stillmisty/nonebot_plugin_summary_group
- Owner: StillMisty
- License: apache-2.0
- Created: 2025-01-02T13:52:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-22T10:44:09.000Z (9 months ago)
- Last Synced: 2025-09-22T12:17:23.930Z (9 months ago)
- Language: CSS
- Homepage:
- Size: 245 KB
- Stars: 14
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nonebot_plugin_summary_group
## 📖 介绍
基于Nonebot2，使用 AI 分析群聊记录，生成讨论内容的总结，亦或是总结特定人或事。
## 💿 安装
使用nb-cli安装插件
```shell
nb plugin install nonebot_plugin_summary_group
```
使用pip安装插件
```shell
pip install nonebot_plugin_summary_group
```
## ⚙️ 配置
如无特殊需求，仅需在`env`文件中配置必填项。
| 配置项 | 必填 | 默认 | 说明 |
| :--------------------: | :------------: | :--------------: | :---------------------------------------: |
| gemini_key | 与OpenAI二选一 | None | gemini接口密钥 |
| openai_base_url | 与Gemini二选一 | None | openai接口地址 |
| openai_api_key | 与Gemini二选一 | None | openai接口密钥 |
| summary_model | 是 | gemini-2.5-flash | 模型名称 |
| proxy | 否 | None | 代理设置 |
| summary_max_length | 否 | 1000 | 总结最大长度 |
| summary_min_length | 否 | 50 | 总结最小长度 |
| summary_cool_down | 否 | 0 | 总结冷却时间（0即无冷却，针对人，而非群） |
| time_out | 否 | 120 | API 请求超时时间 |
| summary_in_png | 否 | False | 总结是否以图片形式发送（重要） |
| summary_max_queue_size | 否 | 10 | 请求模型总结队列最大大小 |
| summary_queue_timeout | 否 | 300 | 请求模型总结队列等待超时时间(秒) |
| summary_queue_workers | 否 | 2 | 最大并发请求模型总结 API 数 |
- 使用Gemini需要配置 gemini_key 与 summary_model。
- 使用OpenAI兼容的API则需要配置 openai_base_url 、 openai_api_key 与 summary_model。
若同时配置Gemini与OpenAI，则优先使用Gemini。
使用`nonebot_plugin_htmlrender`渲染图片，为节省不必要的消耗，此包不会作为该项目依赖，需要自行安装并设置`summary_in_png=True`以使用图片发送。
``` shell
nb plugin install nonebot_plugin_htmlrender
```
## 🕹️ 使用
**总结 [消息数量] [特定内容?]** ：生成该群最近消息数量的总结或指定内容的总结，特定内容为可选项。
**总结定时 [时间] [最少消息数量?=summary_max_length]** ：定时生成消息数量的内容总结，时间：0~23，最少消息数量：默认为总结最大长度，每群的定时总结独立计算，默认不启用。
**总结定时取消** ：取消本群的定时内容总结。
## 🙏 感谢
[github-markdown-css](https://github.com/sindresorhus/github-markdown-css) - 用于美化Markdown文档