nonebot-plugin-msg-rank-card 0.1.0__tar.gz

nonebot_plugin_msg_rank_card-0.1.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,39 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - '*'
+  workflow_dispatch:
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+    - name: Install pypa/build
+      run: >-
+        python -m
+        pip install
+        build
+        --user
+    - name: Build a binary wheel and a source tarball
+      run: >-
+        python -m
+        build
+        --sdist
+        --wheel
+        --outdir dist/
+        .
+    - name: Publish distribution to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}

nonebot_plugin_msg_rank_card-0.1.0/.gitignore

@@ -0,0 +1,176 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#   Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm-python
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# VisualStudioCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets

nonebot_plugin_msg_rank_card-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 BigCherryBalls
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_msg_rank_card-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-msg-rank-card
+Version: 0.1.0
+Summary: 每日水群排行榜图片生成插件，记录群聊消息并生成精美排行榜
+Project-URL: Homepage, https://github.com/TonyLiangP2010405/nonebot-plugin-msg-rank-card
+Project-URL: Repository, https://github.com/TonyLiangP2010405/nonebot-plugin-msg-rank-card
+Author: TonyLiangP2010405
+License: MIT
+License-File: LICENSE
+Keywords: card,message,nonebot,nonebot2,plugin,rank
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: nonebot-adapter-onebot>=2.4.0
+Requires-Dist: nonebot2>=2.2.0
+Requires-Dist: pillow>=10.0.0
+Provides-Extra: dev
+Requires-Dist: nonebug>=0.3; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="https://v2.nonebot.dev/store"><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
+  <br>
+  <p><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/NoneBotPlugin.svg" width="240" alt="NoneBotPluginText"></p>
+</div>
+
+<div align="center">
+
+# nonebot-plugin-msg-rank-card
+
+_✨ 每日水群排行榜图片生成插件 ✨_
+
+<a href="./LICENSE">
+    <img src="https://img.shields.io/github/license/TonyLiangP2010405/nonebot-plugin-msg-rank-card.svg" alt="license">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot-plugin-msg-rank-card">
+    <img src="https://img.shields.io/pypi/v/nonebot-plugin-msg-rank-card.svg" alt="pypi">
+</a>
+<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
+
+</div>
+
+## 📖 介绍
+
+本插件基于 [MsgRankCard](https://github.com/TonyLiangP2010405/MsgRankCard) 项目改写，是一个 NoneBot2 插件，用于记录群聊消息并生成精美的每日水群排行榜图片。
+
+功能特点：
+- 📝 自动记录群聊消息数量和在线时长
+- 🎨 生成精美的排行榜图片，支持自定义背景、边框和字体
+- 🖼️ 自动获取用户 QQ 头像
+- 🏆 支持查看今日水群排行榜
+- 🧹 支持自动清理过期数据
+
+## 💿 安装
+
+### 使用 nb-cli 安装
+
+在 nonebot2 项目的根目录下打开命令行，输入以下指令即可安装
+
+```bash
+nb plugin install nonebot-plugin-msg-rank-card
+```
+
+### 使用包管理器安装
+
+在 nonebot2 项目的插件目录下，打开命令行，根据你使用的包管理器，输入相应的安装命令
+
+<details>
+<summary>pip</summary>
+
+```bash
+pip install nonebot-plugin-msg-rank-card
+```
+</details>
+
+<details>
+<summary>poetry</summary>
+
+```bash
+poetry add nonebot-plugin-msg-rank-card
+```
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件，在 `[tool.nonebot]` 部分追加写入
+
+```toml
+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_title | 否 | 今日水群排行榜 | 排行榜标题 |
+
+## 🎉 使用
+
+### 指令表
+
+| 指令 | 权限 | 需要@ | 范围 | 说明 |
+|:-----:|:----:|:----:|:----:|:----:|
+| 水群榜 / msgrank | 群员 | 否 | 群聊 | 查看今日水群排行榜 |
+| 清理水群数据 / clean_msgrank | 群主/管理员 | 否 | 群聊 | 清理过期数据 |
+
+### 效果图
+
+插件会自动记录群聊消息，发送 `/水群榜` 即可生成精美排行榜图片。
+
+### 自定义资源
+
+你可以替换插件目录下 `resources` 文件夹中的资源文件：
+- `bg/` - 背景图片（随机选择）
+- `frame/` - 排名边框装饰
+- `ttf/` - 自定义字体（第一个 ttf 文件会被使用）
+
+## 📄 许可证
+
+本项目基于 [MsgRankCard](https://github.com/TonyLiangP2010405/MsgRankCard) 改写，采用 MIT 许可证。

nonebot_plugin_msg_rank_card-0.1.0/README.md

@@ -0,0 +1,104 @@
+<div align="center">
+  <a href="https://v2.nonebot.dev/store"><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
+  <br>
+  <p><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/NoneBotPlugin.svg" width="240" alt="NoneBotPluginText"></p>
+</div>
+
+<div align="center">
+
+# nonebot-plugin-msg-rank-card
+
+_✨ 每日水群排行榜图片生成插件 ✨_
+
+<a href="./LICENSE">
+    <img src="https://img.shields.io/github/license/TonyLiangP2010405/nonebot-plugin-msg-rank-card.svg" alt="license">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot-plugin-msg-rank-card">
+    <img src="https://img.shields.io/pypi/v/nonebot-plugin-msg-rank-card.svg" alt="pypi">
+</a>
+<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
+
+</div>
+
+## 📖 介绍
+
+本插件基于 [MsgRankCard](https://github.com/TonyLiangP2010405/MsgRankCard) 项目改写，是一个 NoneBot2 插件，用于记录群聊消息并生成精美的每日水群排行榜图片。
+
+功能特点：
+- 📝 自动记录群聊消息数量和在线时长
+- 🎨 生成精美的排行榜图片，支持自定义背景、边框和字体
+- 🖼️ 自动获取用户 QQ 头像
+- 🏆 支持查看今日水群排行榜
+- 🧹 支持自动清理过期数据
+
+## 💿 安装
+
+### 使用 nb-cli 安装
+
+在 nonebot2 项目的根目录下打开命令行，输入以下指令即可安装
+
+```bash
+nb plugin install nonebot-plugin-msg-rank-card
+```
+
+### 使用包管理器安装
+
+在 nonebot2 项目的插件目录下，打开命令行，根据你使用的包管理器，输入相应的安装命令
+
+<details>
+<summary>pip</summary>
+
+```bash
+pip install nonebot-plugin-msg-rank-card
+```
+</details>
+
+<details>
+<summary>poetry</summary>
+
+```bash
+poetry add nonebot-plugin-msg-rank-card
+```
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件，在 `[tool.nonebot]` 部分追加写入
+
+```toml
+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_title | 否 | 今日水群排行榜 | 排行榜标题 |
+
+## 🎉 使用
+
+### 指令表
+
+| 指令 | 权限 | 需要@ | 范围 | 说明 |
+|:-----:|:----:|:----:|:----:|:----:|
+| 水群榜 / msgrank | 群员 | 否 | 群聊 | 查看今日水群排行榜 |
+| 清理水群数据 / clean_msgrank | 群主/管理员 | 否 | 群聊 | 清理过期数据 |
+
+### 效果图
+
+插件会自动记录群聊消息，发送 `/水群榜` 即可生成精美排行榜图片。
+
+### 自定义资源
+
+你可以替换插件目录下 `resources` 文件夹中的资源文件：
+- `bg/` - 背景图片（随机选择）
+- `frame/` - 排名边框装饰
+- `ttf/` - 自定义字体（第一个 ttf 文件会被使用）
+
+## 📄 许可证
+
+本项目基于 [MsgRankCard](https://github.com/TonyLiangP2010405/MsgRankCard) 改写，采用 MIT 许可证。

nonebot_plugin_msg_rank_card-0.1.0/nonebot_plugin_msg_rank_card/__init__.py

@@ -0,0 +1,85 @@
+from nonebot import on_command, on_message
+from nonebot.adapters import Bot, Message
+from nonebot.adapters.onebot.v11 import GroupMessageEvent, MessageSegment
+from nonebot.params import CommandArg
+from nonebot.plugin import PluginMetadata
+
+from .card_generator import MemberInfo, RankCardGenerator, download_avatar
+from .config import Config
+from .data_source import clean_old_data, get_rank_data, record_message
+
+__plugin_meta__ = PluginMetadata(
+    name="每日水群排行榜",
+    description="记录群聊消息，生成精美的每日水群排行榜图片",
+    usage="发送 /水群榜 或 /msgrank 查看今日排行榜",
+    type="application",
+    homepage="https://github.com/TonyLiangP2010405/nonebot-plugin-msg-rank-card",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+)
+
+# 消息监听：记录群聊消息
+msg_handler = on_message(priority=99, block=False)
+
+# 排行榜命令
+rank_cmd = on_command("水群榜", aliases={"msgrank", "msg_rank", "今日水群榜"}, priority=10, block=True)
+
+# 清理命令（仅管理员可用）
+clean_cmd = on_command("清理水群数据", aliases={"clean_msgrank"}, priority=10, block=True)
+
+
+@msg_handler.handle()
+async def handle_message(bot: Bot, event: GroupMessageEvent):
+    """记录群聊消息"""
+    group_id = str(event.group_id)
+    user_id = str(event.user_id)
+    user_name = event.sender.nickname or "未知用户"
+
+    # 记录消息
+    record_message(group_id, user_id, user_name, msg_length=1)
+
+
+@rank_cmd.handle()
+async def handle_rank(bot: Bot, event: GroupMessageEvent, args: Message = CommandArg()):
+    """处理排行榜命令"""
+    group_id = str(event.group_id)
+
+    # 获取排行榜数据
+    rank_data = get_rank_data(group_id)
+
+    if not rank_data:
+        await rank_cmd.finish("今天还没有人水群呢~")
+        return
+
+    # 构建成员信息列表
+    members = []
+    for info in rank_data:
+        # 下载头像
+        avatar = await download_avatar(info["user_id"])
+        member = MemberInfo(
+            name=info["name"],
+            msg_count=info["msg_count"],
+            time_seconds=info["time_seconds"],
+            head_pic=avatar,
+        )
+        members.append(member)
+
+    # 生成图片
+    generator = RankCardGenerator()
+    image_bytes = generator.generate_card_bytes(members)
+
+    # 发送图片
+    await rank_cmd.finish(MessageSegment.image(image_bytes))
+
+
+@clean_cmd.handle()
+async def handle_clean(bot: Bot, event: GroupMessageEvent):
+    """清理过期数据"""
+    # 简单权限检查：只有群主和管理员可以清理
+    sender_role = event.sender.role if hasattr(event.sender, "role") else "member"
+    if sender_role not in ["owner", "admin"]:
+        await clean_cmd.finish("只有群主或管理员才能清理数据哦~")
+        return
+
+    clean_old_data()
+    await clean_cmd.finish("已清理过期数据~")

nonebot_plugin_msg_rank_card-0.1.0/nonebot_plugin_msg_rank_card/card_generator.py

@@ -0,0 +1,279 @@
+import contextlib
+import random
+from io import BytesIO
+from pathlib import Path
+from typing import Optional
+
+import httpx
+from nonebot import get_driver
+from nonebot.log import logger
+from PIL import Image, ImageDraw, ImageFont
+
+from .config import Config
+
+# 资源目录（默认值，会在首次使用时根据配置更新）
+_resource_dir: Path = Path(__file__).parent.parent / "resources"
+
+
+def _get_resource_dir() -> Path:
+    """获取资源目录（延迟加载）"""
+    global _resource_dir
+    try:
+        config = Config.parse_obj(get_driver().config.dict())
+        if config.msg_rank_resource_path:
+            _resource_dir = Path(config.msg_rank_resource_path)
+    except Exception:
+        pass
+    return _resource_dir
+
+
+def _get_bg_dir() -> Path:
+    return _get_resource_dir() / "bg"
+
+
+def _get_frame_dir() -> Path:
+    return _get_resource_dir() / "frame"
+
+
+def _get_ttf_dir() -> Path:
+    return _get_resource_dir() / "ttf"
+
+
+# 画布尺寸
+BG_WIDTH = 672
+BG_HEIGHT = 1080
+CARD_WIDTH = 640
+CARD_HEIGHT = 80
+HEAD_WIDTH = 60
+HEAD_HEIGHT = 60
+HEAD_X = 20
+HEAD_Y = 10
+
+
+class MemberInfo:
+    """成员信息"""
+
+    def __init__(self, name: str, msg_count: int, time_seconds: int, head_pic: Optional[Image.Image] = None):
+        self.name = name
+        self.msg_count = msg_count
+        self.time_seconds = time_seconds
+        self.head_pic = head_pic
+
+
+class RankCardGenerator:
+    """排行榜图片生成器"""
+
+    _instance = None
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._initialized = False
+        return cls._instance
+
+    def __init__(self):
+        if self._initialized:
+            return
+        self._initialized = True
+
+        self.bg_files = self._get_files(_get_bg_dir(), "bg")
+        self.frame_files = self._get_files(_get_frame_dir(), "frame")
+        self.font_file = self._get_first_ttf()
+
+    def _get_files(self, dir_path: Path, name_filter: str) -> list[Path]:
+        """获取目录下的文件"""
+        if not dir_path.exists() or not dir_path.is_dir():
+            return []
+        return [f for f in dir_path.iterdir() if f.is_file() and name_filter in f.name]
+
+    def _get_first_ttf(self) -> Optional[Path]:
+        """获取第一个 ttf 字体文件"""
+        ttf_dir = _get_ttf_dir()
+        if not ttf_dir.exists() or not ttf_dir.is_dir():
+            return None
+        ttfs = [f for f in ttf_dir.iterdir() if f.is_file() and f.suffix.lower() == ".ttf"]
+        return ttfs[0] if ttfs else None
+
+    def _load_font(self, size: int) -> ImageFont.FreeTypeFont:
+        """加载字体"""
+        if self.font_file:
+            try:
+                return ImageFont.truetype(str(self.font_file), size)
+            except Exception:
+                pass
+        # 回退到默认字体
+        try:
+            return ImageFont.truetype("/System/Library/Fonts/PingFang.ttc", size)
+        except Exception:
+            try:
+                return ImageFont.truetype("/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc", size)
+            except Exception:
+                return ImageFont.load_default()
+
+    def _format_time(self, seconds: int) -> str:
+        """格式化时间"""
+        seconds = max(0, seconds)
+        hours = seconds // 3600
+        minutes = (seconds % 3600) // 60
+        remaining = seconds % 60
+
+        parts = []
+        if hours > 0:
+            parts.append(f"{hours}时")
+        if minutes > 0:
+            parts.append(f"{minutes}分")
+        if remaining > 0 or not parts:
+            parts.append(f"{remaining}秒")
+
+        return "".join(parts)
+
+    def _format_bg_image(self, image: Image.Image) -> Image.Image:
+        """格式化背景图：缩放并裁剪到指定尺寸，添加半透明遮罩"""
+        # 计算缩放比例（覆盖模式）
+        scale = max(BG_WIDTH / image.width, BG_HEIGHT / image.height)
+        new_width = int(image.width * scale)
+        new_height = int(image.height * scale)
+
+        # 缩放
+        resized = image.resize((new_width, new_height), Image.Resampling.LANCZOS)
+
+        # 居中裁剪
+        left = (new_width - BG_WIDTH) // 2
+        top = (new_height - BG_HEIGHT) // 2
+        cropped = resized.crop((left, top, left + BG_WIDTH, top + BG_HEIGHT))
+
+        # 添加白色半透明遮罩
+        overlay = Image.new("RGBA", (BG_WIDTH, BG_HEIGHT), (255, 255, 255, 128))
+        result = Image.alpha_composite(cropped.convert("RGBA"), overlay)
+
+        return result
+
+    def _create_head_mask(self) -> Image.Image:
+        """创建圆形头像遮罩"""
+        mask = Image.new("L", (HEAD_WIDTH, HEAD_HEIGHT), 0)
+        draw = ImageDraw.Draw(mask)
+        draw.ellipse((0, 0, HEAD_WIDTH, HEAD_HEIGHT), fill=255)
+        return mask
+
+    def _create_gradient_mask(self, width: int, height: int) -> Image.Image:
+        """创建渐变遮罩（从左到右渐变透明）"""
+        mask = Image.new("L", (width, height), 0)
+        for x in range(width):
+            alpha = int(255 * (1 - x / width))
+            for y in range(height):
+                mask.putpixel((x, y), alpha)
+        return mask
+
+    def _draw_member_card(self, member: MemberInfo, frame_path: Optional[Path], font: ImageFont.FreeTypeFont) -> Image.Image:
+        """绘制单个成员卡片"""
+        # 创建卡片背景
+        card = Image.new("RGBA", (CARD_WIDTH, CARD_HEIGHT), (255, 255, 255, 255))
+        draw = ImageDraw.Draw(card)
+
+        # 加载边框
+        frame = None
+        if frame_path and frame_path.exists():
+            with contextlib.suppress(Exception):
+                frame = Image.open(frame_path).convert("RGBA")
+
+        # 处理头像
+        if member.head_pic:
+            head = member.head_pic.copy()
+            # 缩放头像
+            head = head.resize((HEAD_WIDTH, HEAD_HEIGHT), Image.Resampling.LANCZOS)
+            # 创建圆形遮罩
+            mask = self._create_head_mask()
+            # 应用圆形遮罩
+            head.putalpha(mask)
+            # 粘贴头像
+            card.paste(head, (HEAD_X, HEAD_Y), head)
+
+        # 绘制边框
+        if frame:
+            with contextlib.suppress(Exception):
+                frame_resized = frame.resize((CARD_WIDTH, CARD_HEIGHT), Image.Resampling.LANCZOS)
+                card = Image.alpha_composite(card, frame_resized)
+
+        # 绘制文字
+        name = member.name
+        if len(name) > 12:
+            name = name[:12] + "..."
+
+        # 使用字体
+        name_font = self._load_font(24)
+        count_font = self._load_font(16)
+        time_font = self._load_font(20)
+
+        # 绘制名字
+        draw = ImageDraw.Draw(card)
+        draw.text((100, 15), name, fill=(0, 0, 0, 255), font=name_font)
+
+        # 绘制消息数
+        draw.text((100, 50), f"消息数: {member.msg_count}条", fill=(80, 80, 80, 255), font=count_font)
+
+        # 绘制时长（右对齐）
+        time_str = self._format_time(member.time_seconds)
+        draw.text((440, 40), time_str, fill=(100, 100, 100, 255), font=time_font)
+
+        return card
+
+    def generate_card(self, members: list[MemberInfo], title: Optional[str] = None) -> Image.Image:
+        """生成排行榜图片"""
+        try:
+            config = Config.parse_obj(get_driver().config.dict())
+            title = title or config.msg_rank_title
+        except Exception:
+            title = title or "今日水群排行榜"
+
+        # 创建背景
+        if self.bg_files:
+            try:
+                bg_path = random.choice(self.bg_files)
+                bg_image = Image.open(bg_path).convert("RGBA")
+                background = self._format_bg_image(bg_image)
+            except Exception:
+                background = Image.new("RGBA", (BG_WIDTH, BG_HEIGHT), (255, 255, 255, 255))
+        else:
+            background = Image.new("RGBA", (BG_WIDTH, BG_HEIGHT), (255, 255, 255, 255))
+
+        draw = ImageDraw.Draw(background)
+
+        # 绘制标题
+        title_font = self._load_font(60)
+        # 计算标题居中位置
+        bbox = draw.textbbox((0, 0), title, font=title_font)
+        title_width = bbox[2] - bbox[0]
+        title_x = (BG_WIDTH - title_width) // 2
+        draw.text((title_x, 30), title, fill=(255, 0, 255, 255), font=title_font)
+
+        # 绘制成员卡片
+        size = min(len(self.frame_files), len(members))
+        for idx in range(size):
+            frame_path = self.frame_files[idx] if idx < len(self.frame_files) else None
+            card = self._draw_member_card(members[idx], frame_path, title_font)
+            # 粘贴到背景上
+            card_x = (BG_WIDTH - CARD_WIDTH) // 2
+            card_y = 120 + 95 * idx
+            background.paste(card, (card_x, card_y), card)
+
+        return background
+
+    def generate_card_bytes(self, members: list[MemberInfo], title: Optional[str] = None) -> bytes:
+        """生成排行榜图片并返回 bytes"""
+        image = self.generate_card(members, title)
+        buffer = BytesIO()
+        image.convert("RGB").save(buffer, format="PNG")
+        return buffer.getvalue()
+
+
+async def download_avatar(user_id: str) -> Optional[Image.Image]:
+    """下载用户头像"""
+    try:
+        url = f"https://q1.qlogo.cn/g?b=qq&nk={user_id}&s=640"
+        async with httpx.AsyncClient(timeout=10) as client:
+            response = await client.get(url)
+            if response.status_code == 200:
+                return Image.open(BytesIO(response.content)).convert("RGBA")
+    except Exception as e:
+        logger.warning(f"下载头像失败 {user_id}: {e}")
+    return None

nonebot_plugin_msg_rank_card-0.1.0/nonebot_plugin_msg_rank_card/config.py

@@ -0,0 +1,17 @@
+
+from pydantic import BaseModel
+
+
+class Config(BaseModel):
+    """插件配置"""
+
+    # 数据存储路径
+    msg_rank_data_path: str = "data/msg_rank"
+    # 资源文件路径
+    msg_rank_resource_path: str = ""
+    # 每日排行榜最大显示人数
+    msg_rank_max_count: int = 10
+    # 是否自动清理过期数据（保留最近7天）
+    msg_rank_auto_clean: bool = True
+    # 排行榜标题
+    msg_rank_title: str = "今日水群排行榜"

nonebot_plugin_msg_rank_card-0.1.0/nonebot_plugin_msg_rank_card/data_source.py

@@ -0,0 +1,127 @@
+import json
+import time
+from datetime import datetime, timedelta
+from pathlib import Path
+
+from nonebot import get_driver
+from nonebot.log import logger
+
+from .config import Config
+
+# 数据目录（默认值，会在首次使用时根据配置更新）
+_data_dir: Path = Path("data/msg_rank")
+
+
+def _get_data_dir() -> Path:
+    """获取数据目录（延迟加载）"""
+    global _data_dir
+    if not _data_dir.exists():
+        try:
+            config = Config.parse_obj(get_driver().config.dict())
+            _data_dir = Path(config.msg_rank_data_path)
+        except Exception:
+            _data_dir = Path("data/msg_rank")
+        _data_dir.mkdir(parents=True, exist_ok=True)
+    return _data_dir
+
+
+def get_today_str() -> str:
+    """获取今天的日期字符串"""
+    return datetime.now().strftime("%Y%m%d")
+
+
+def get_group_data_file(group_id: str) -> Path:
+    """获取群数据文件路径"""
+    return _get_data_dir() / f"{group_id}_{get_today_str()}.json"
+
+
+def load_group_data(group_id: str) -> dict:
+    """加载群数据"""
+    file_path = get_group_data_file(group_id)
+    if file_path.exists():
+        try:
+            with open(file_path, encoding="utf-8") as f:
+                return json.load(f)
+        except Exception as e:
+            logger.warning(f"加载群数据失败: {e}")
+    return {}
+
+
+def save_group_data(group_id: str, data: dict):
+    """保存群数据"""
+    file_path = get_group_data_file(group_id)
+    try:
+        with open(file_path, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+    except Exception as e:
+        logger.warning(f"保存群数据失败: {e}")
+
+
+def record_message(group_id: str, user_id: str, user_name: str, msg_length: int = 1):
+    """记录一条消息"""
+    data = load_group_data(group_id)
+
+    if user_id not in data:
+        data[user_id] = {
+            "name": user_name,
+            "msg_count": 0,
+            "time_seconds": 0,
+            "last_msg_time": 0,
+        }
+
+    # 更新消息数
+    data[user_id]["msg_count"] += msg_length
+
+    # 计算在线时长（简单估算：如果距离上次消息在5分钟内，累加时间差）
+    now = int(time.time())
+    last_time = data[user_id].get("last_msg_time", 0)
+    if last_time > 0 and now - last_time < 300:  # 5分钟内
+        data[user_id]["time_seconds"] += now - last_time
+
+    data[user_id]["last_msg_time"] = now
+    data[user_id]["name"] = user_name  # 更新昵称
+
+    save_group_data(group_id, data)
+
+
+def get_rank_data(group_id: str, max_count: int = 10) -> list[dict]:
+    """获取排行榜数据，按消息数排序"""
+    data = load_group_data(group_id)
+
+    rank_list = []
+    for user_id, info in data.items():
+        rank_list.append({
+            "user_id": user_id,
+            "name": info.get("name", "未知用户"),
+            "msg_count": info.get("msg_count", 0),
+            "time_seconds": info.get("time_seconds", 0),
+        })
+
+    # 按消息数降序排序
+    rank_list.sort(key=lambda x: x["msg_count"], reverse=True)
+
+    return rank_list[:max_count]
+
+
+def clean_old_data(days: int = 7):
+    """清理过期数据"""
+    try:
+        config = Config.parse_obj(get_driver().config.dict())
+        if not config.msg_rank_auto_clean:
+            return
+    except Exception:
+        pass
+
+    data_dir = _get_data_dir()
+    cutoff = datetime.now() - timedelta(days=days)
+    cutoff_str = cutoff.strftime("%Y%m%d")
+
+    for file_path in data_dir.glob("*_*.json"):
+        try:
+            # 文件名格式: {group_id}_{date}.json
+            date_str = file_path.stem.split("_")[-1]
+            if date_str < cutoff_str:
+                file_path.unlink()
+                logger.info(f"清理过期数据: {file_path.name}")
+        except Exception:
+            pass

nonebot_plugin_msg_rank_card-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "nonebot-plugin-msg-rank-card"
+version = "0.1.0"
+description = "每日水群排行榜图片生成插件，记录群聊消息并生成精美排行榜"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [
+    { name = "TonyLiangP2010405", email = "" },
+]
+keywords = ["nonebot", "nonebot2", "plugin", "rank", "card", "message"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "nonebot2>=2.2.0",
+    "nonebot-adapter-onebot>=2.4.0",
+    "pillow>=10.0.0",
+    "httpx>=0.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "nonebug>=0.3",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/TonyLiangP2010405/nonebot-plugin-msg-rank-card"
+Repository = "https://github.com/TonyLiangP2010405/nonebot-plugin-msg-rank-card"
+
+[tool.nonebot]
+plugins = ["nonebot_plugin_msg_rank_card"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["nonebot_plugin_msg_rank_card"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "C4", "SIM"]
+ignore = ["E501", "B008"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

nonebot_plugin_msg_rank_card-0.1.0/tests/test_load.py

@@ -0,0 +1,10 @@
+import nonebot
+from nonebot.adapters.onebot.v11 import Adapter
+
+
+def test_plugin_load():
+    nonebot.init()
+    driver = nonebot.get_driver()
+    driver.register_adapter(Adapter)
+    plugin = nonebot.load_plugin("nonebot_plugin_msg_rank_card")
+    assert plugin is not None