nonebot-plugin-dialectlist 3.0.1__tar.gz → 3.1.0__tar.gz

{nonebot_plugin_dialectlist-3.0.1/nonebot_plugin_dialectlist.egg-info → nonebot_plugin_dialectlist-3.1.0}/PKG-INFO

@@ -1,31 +1,31 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: nonebot-plugin-dialectlist
-Version: 3.0.1
+Version: 3.1.0
 Summary: 看看你群群友有多能说
-Author-email: Chen_Xu233 <woyerpa@outlook.com>
+Author-Email: Chen_Xu233 <woyerpa@outlook.com>
 License: MIT
-Requires-Python: <4.0,>=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
+Requires-Python: <4.0,>=3.10
+Requires-Dist: nonebot2>=2.4.0
 Requires-Dist: nonebot-plugin-chatrecorder>=0.7.0
-Requires-Dist: nonebot-plugin-orm[default]
-Requires-Dist: nonebot-plugin-apscheduler>=0.4.0
+Requires-Dist: nonebot-plugin-orm[sqlite]>=0.8.0
 Requires-Dist: nonebot-plugin-alconna>=0.50.2
-Requires-Dist: nonebot-plugin-cesaa>=0.4.0
+Requires-Dist: nonebot-plugin-uninfo>=0.8.0
 Requires-Dist: nonebot-plugin-userinfo>=0.2.6
-Requires-Dist: nonebot-plugin-htmlrender>=0.3.3
-Requires-Dist: nonebot2>=2.3.2
+Requires-Dist: nonebot-plugin-htmlrender<0.9,>=0.6.6
+Requires-Dist: playwright>=1.48.0
+Requires-Dist: nonebot-plugin-send-anything-anywhere>=0.7.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: jinja2>=3.0.3
+Requires-Dist: sqlalchemy>=2.0.0
 Requires-Dist: pillow>=11.3.0
-Requires-Dist: nonebot-plugin-uninfo>=0.1.1
 Provides-Extra: dev
 Requires-Dist: ruff>=0.5.5; extra == "dev"
-Requires-Dist: setuptools>=80.9.0; extra == "dev"
 Requires-Dist: twine>=6.2.0; extra == "dev"
 Requires-Dist: nb-cli>=1.4.2; extra == "dev"
 Requires-Dist: py-spy>=0.3.14; extra == "dev"
 Provides-Extra: test
 Requires-Dist: nonebot-adapter-onebot>=2.4.4; extra == "test"
-Dynamic: license-file
+Description-Content-Type: text/markdown
 
 <div align="center">
   <a href="https://v2.nonebot.dev/store"><img src="./docs/NoneBotPlugin.svg" width="400" alt="NoneBotPluginLogo"></a>
@@ -44,7 +44,7 @@ nonebot-plugin-dialectlist
     <img src="https://img.shields.io/pypi/v/nonebot-plugin-dialectlist.svg" alt="pypi">
   </a>
 
-  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
+  <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
   
   <a href="https://qm.qq.com/q/Yty2yc9Bee">
     <img src="https://img.shields.io/badge/QQ%E7%BE%A4-1128359833-orange?style=flat-square" alt="QQ Chat Group">
@@ -75,15 +75,30 @@ nb plugin install nonebot-plugin-dialectlist
 
 ### ✅ 插件依赖于
 
-1. [nonebot-plugin-datastore](https://github.com/he0119/nonebot-plugin-datastore) ————本地化储存
-2. [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) ————获取用户信息
-3. [nonebot-plugin-apscheduler](https://github.com/nonebot/plugin-apscheduler) ————定时发送排行榜信息
-4. [nonebot-plugin-alconna](https://github.com/ArcletProject/nonebot-plugin-alconna) ————实现命令解析
-5. [nonebot-plugin-chatrecorder](https://github.com/noneplugin/nonebot-plugin-chatrecorder) ————实现消息储存
-6. [nonebot-plugin-cesaa](https://github.com/MountainDash/nonebot-plugin-send-anything-anywhere) ————实现多平台
+1. [nonebot-plugin-chatrecorder](https://github.com/noneplugin/nonebot-plugin-chatrecorder) ————实现消息储存
+2. [nonebot-plugin-orm](https://github.com/nonebot/nonebot-plugin-orm) ————数据库
+3. [nonebot-plugin-uninfo](https://github.com/nonebot/nonebot-plugin-uninfo) ————跨平台会话信息
+4. [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) ————获取用户信息
+5. [nonebot-plugin-alconna](https://github.com/ArcletProject/nonebot-plugin-alconna) ————实现命令解析
+6. [nonebot-plugin-send-anything-anywhere](https://github.com/felinae98/nonebot-plugin-send-anything-anywhere) ————实现多平台发送
+7. [nonebot-plugin-htmlrender](https://github.com/nonebot/nonebot-plugin-htmlrender) ————渲染排行榜图片
 
 **⚠ 注意** 若先前没有安装过`nonebot-plugin-chatrecorder`或者`nonebot-plugin-orm`，则会在启动时报错，请按报错的提示安装数据库！
 
+> [!IMPORTANT]
+> **关于 htmlrender 版本**：支持 `nonebot-plugin-htmlrender >= 0.6.6, < 0.9`。
+> 0.6 开箱即用；用 0.7 / 0.8 时上游要求显式指定渲染后端，需要在 `.env` 里加一行：
+>
+> ```dotenv
+> # htmlrender 0.8+
+> RENDER__PROVIDER=playwright
+> # htmlrender 0.7
+> RENDER_BACKEND=playwright
+> ```
+>
+> 模板的样式、字体和头像已全部内联成 data URI，所以 0.8 的本地文件访问限制不影响出图。
+> 首次渲染会自动安装 Chromium，也可以手动执行 `playwright install chromium`。
+
 ## ⚙ 配置
 
 需要**提前配置**本插件所**依赖的插件**！
@@ -92,9 +107,7 @@ nb plugin install nonebot-plugin-dialectlist
 
 ```python
 dialectlist__get_num: int = 5  # 获取人数数量
-dialectlist__font: str = "SimHei"  # 字体格式
 dialectlist__suffix: bool = True  # 是否显示后缀
-dialectlist__excluded_self: bool = True  # 是否排除自己
 dialectlist__visualization: bool = True  # 是否可视化
 dialectlist__show_text_rank: bool = True  # 是否显示文本排名
 dialectlist__excluded_people: List[str] = []  # 排除的人的 QQ 号
@@ -103,11 +116,15 @@ dialectlist__aggregate_transmission: bool = False  # 是否聚合转发消息
 dialectlist__timezone: Optional[str] = "Asia/Shanghai"  # 时区，影响统计时间
 dialectlist__string_suffix: str = "统计花费时间：{timecost}秒"  # 消息格式后缀
 dialectlist__template_path: str = "./template/rank_template.j2"  # 模板路径
-dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条消息、n"  # 消息格式
+dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条消息\n"  # 消息格式
 ```
 
 💭 也可以不进行配置，这将会使插件按照默认配置运行
 
+> [!NOTE]
+> 3.1.0 起模板变量有变化：`inline_css`（内联的样式表与字体）、`i.user_avatar_data_uri`（头像 data URI）。
+> 插件不再向缓存目录写头像文件，也不再向模板传入 `cache_path` / `file_path`；自定义模板请改用新变量。
+
 ### ⚠ 注意！！
 
 > 在旧版插件（2.0.0 以下）中，dialectlist 与后面的配置项只隔了一个下划线，若更新到新版本以后需要俩个下划线。
@@ -130,8 +147,6 @@ dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条
 
 -`/昨日 B 话榜` ————看看昨天的群友发了多少消息！
 
--`/前日 B 话榜` ————看看前天的群友发了多少消息！
-
 -`/本周 B 话榜` ————看看本周的群友发了多少消息！
 
 -`/上周 B 话榜` ————看看上周的群友发了多少消息！
@@ -172,7 +187,10 @@ dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条
 `/kkb @man -k ♂`
 
 > [!IMPORTANT]
-> 关键词支持正则表达式！
+> 关键词按“包含”匹配（不区分大小写的子串匹配），**不支持正则表达式**；输入中的 `%`、`_` 会按普通字符处理。
+
+> [!NOTE]
+> 3.0.2 起移除了从未生效的 `font`（字体固定使用内置字体）与 `excluded_self`（统计本就只算收到的消息）两项配置。
 
 ## 💪 目前支持的平台
 

{nonebot_plugin_dialectlist-3.0.1 → nonebot_plugin_dialectlist-3.1.0}/README.md

@@ -15,7 +15,7 @@ nonebot-plugin-dialectlist
     <img src="https://img.shields.io/pypi/v/nonebot-plugin-dialectlist.svg" alt="pypi">
   </a>
 
-  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
+  <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
   
   <a href="https://qm.qq.com/q/Yty2yc9Bee">
     <img src="https://img.shields.io/badge/QQ%E7%BE%A4-1128359833-orange?style=flat-square" alt="QQ Chat Group">
@@ -46,15 +46,30 @@ nb plugin install nonebot-plugin-dialectlist
 
 ### ✅ 插件依赖于
 
-1. [nonebot-plugin-datastore](https://github.com/he0119/nonebot-plugin-datastore) ————本地化储存
-2. [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) ————获取用户信息
-3. [nonebot-plugin-apscheduler](https://github.com/nonebot/plugin-apscheduler) ————定时发送排行榜信息
-4. [nonebot-plugin-alconna](https://github.com/ArcletProject/nonebot-plugin-alconna) ————实现命令解析
-5. [nonebot-plugin-chatrecorder](https://github.com/noneplugin/nonebot-plugin-chatrecorder) ————实现消息储存
-6. [nonebot-plugin-cesaa](https://github.com/MountainDash/nonebot-plugin-send-anything-anywhere) ————实现多平台
+1. [nonebot-plugin-chatrecorder](https://github.com/noneplugin/nonebot-plugin-chatrecorder) ————实现消息储存
+2. [nonebot-plugin-orm](https://github.com/nonebot/nonebot-plugin-orm) ————数据库
+3. [nonebot-plugin-uninfo](https://github.com/nonebot/nonebot-plugin-uninfo) ————跨平台会话信息
+4. [nonebot-plugin-userinfo](https://github.com/noneplugin/nonebot-plugin-userinfo) ————获取用户信息
+5. [nonebot-plugin-alconna](https://github.com/ArcletProject/nonebot-plugin-alconna) ————实现命令解析
+6. [nonebot-plugin-send-anything-anywhere](https://github.com/felinae98/nonebot-plugin-send-anything-anywhere) ————实现多平台发送
+7. [nonebot-plugin-htmlrender](https://github.com/nonebot/nonebot-plugin-htmlrender) ————渲染排行榜图片
 
 **⚠ 注意** 若先前没有安装过`nonebot-plugin-chatrecorder`或者`nonebot-plugin-orm`，则会在启动时报错，请按报错的提示安装数据库！
 
+> [!IMPORTANT]
+> **关于 htmlrender 版本**：支持 `nonebot-plugin-htmlrender >= 0.6.6, < 0.9`。
+> 0.6 开箱即用；用 0.7 / 0.8 时上游要求显式指定渲染后端，需要在 `.env` 里加一行：
+>
+> ```dotenv
+> # htmlrender 0.8+
+> RENDER__PROVIDER=playwright
+> # htmlrender 0.7
+> RENDER_BACKEND=playwright
+> ```
+>
+> 模板的样式、字体和头像已全部内联成 data URI，所以 0.8 的本地文件访问限制不影响出图。
+> 首次渲染会自动安装 Chromium，也可以手动执行 `playwright install chromium`。
+
 ## ⚙ 配置
 
 需要**提前配置**本插件所**依赖的插件**！
@@ -63,9 +78,7 @@ nb plugin install nonebot-plugin-dialectlist
 
 ```python
 dialectlist__get_num: int = 5  # 获取人数数量
-dialectlist__font: str = "SimHei"  # 字体格式
 dialectlist__suffix: bool = True  # 是否显示后缀
-dialectlist__excluded_self: bool = True  # 是否排除自己
 dialectlist__visualization: bool = True  # 是否可视化
 dialectlist__show_text_rank: bool = True  # 是否显示文本排名
 dialectlist__excluded_people: List[str] = []  # 排除的人的 QQ 号
@@ -74,11 +87,15 @@ dialectlist__aggregate_transmission: bool = False  # 是否聚合转发消息
 dialectlist__timezone: Optional[str] = "Asia/Shanghai"  # 时区，影响统计时间
 dialectlist__string_suffix: str = "统计花费时间：{timecost}秒"  # 消息格式后缀
 dialectlist__template_path: str = "./template/rank_template.j2"  # 模板路径
-dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条消息、n"  # 消息格式
+dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条消息\n"  # 消息格式
 ```
 
 💭 也可以不进行配置，这将会使插件按照默认配置运行
 
+> [!NOTE]
+> 3.1.0 起模板变量有变化：`inline_css`（内联的样式表与字体）、`i.user_avatar_data_uri`（头像 data URI）。
+> 插件不再向缓存目录写头像文件，也不再向模板传入 `cache_path` / `file_path`；自定义模板请改用新变量。
+
 ### ⚠ 注意！！
 
 > 在旧版插件（2.0.0 以下）中，dialectlist 与后面的配置项只隔了一个下划线，若更新到新版本以后需要俩个下划线。
@@ -101,8 +118,6 @@ dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条
 
 -`/昨日 B 话榜` ————看看昨天的群友发了多少消息！
 
--`/前日 B 话榜` ————看看前天的群友发了多少消息！
-
 -`/本周 B 话榜` ————看看本周的群友发了多少消息！
 
 -`/上周 B 话榜` ————看看上周的群友发了多少消息！
@@ -143,7 +158,10 @@ dialectlist__string_format: str = "第{index}名：\n{nickname},{chatdatanum}条
 `/kkb @man -k ♂`
 
 > [!IMPORTANT]
-> 关键词支持正则表达式！
+> 关键词按“包含”匹配（不区分大小写的子串匹配），**不支持正则表达式**；输入中的 `%`、`_` 会按普通字符处理。
+
+> [!NOTE]
+> 3.0.2 起移除了从未生效的 `font`（字体固定使用内置字体）与 `excluded_self`（统计本就只算收到的消息）两项配置。
 
 ## 💪 目前支持的平台
 

{nonebot_plugin_dialectlist-3.0.1 → nonebot_plugin_dialectlist-3.1.0}/nonebot_plugin_dialectlist/__init__.py

@@ -1,12 +1,11 @@
 from nonebot import require
 
 require('nonebot_plugin_chatrecorder')
-require('nonebot_plugin_apscheduler')
 require('nonebot_plugin_htmlrender')
 require('nonebot_plugin_userinfo')
 require('nonebot_plugin_alconna')
 require('nonebot_plugin_uninfo')
-require('nonebot_plugin_cesaa')
+require('nonebot_plugin_saa')
 
 import re
 import time as t
@@ -33,8 +32,6 @@ from nonebot_plugin_alconna import (
 from nonebot_plugin_uninfo import Session, Uninfo, get_session
 
 from .config import Config, plugin_config
-
-# from .storage import build_cache, get_cache
 from .time import (
 	get_datetime_fromisoformat_with_timezone,
 	get_datetime_now_with_timezone,
@@ -110,24 +107,26 @@ async def handle_b_cmd(
 	if not gid:
 		await b_cmd.finish('请指定群号。')
 
-	_keyword = keyword.result
+	# 未使用 -k 时 Match.result 为 None，不能直接拼进文案
+	keyword_text = keyword.result if keyword.available else None
+	keyword_desc = f'关于“{keyword_text}”的' if keyword_text else ''
 
 	d = await get_user_message_counts(
-		keyword=_keyword,
+		keyword=keyword_text,
 		scene_ids=[gid],
 		user_ids=[id],
-		types=['message'],  # 排除机器人自己发的消息
+		types=['message'],  # 只统计收到的消息，机器人自己发的不计入
 		exclude_user_ids=plugin_config.excluded_people,
 	)
 
 	rank = got_rank(d)
 	if not rank:
 		await b_cmd.finish(
-			f'该用户在群“{uninfo.scene.name}”关于“{keyword.result}”的B话数量为0。'
+			f'该用户在群“{uninfo.scene.name}”{keyword_desc}B话数量为0。'
 		)
 
 	await saa.Text(
-		f'该用户在群“{uninfo.scene.name}”关于“{keyword.result}”的B话数量为{rank[0][1]}。'
+		f'该用户在群“{uninfo.scene.name}”{keyword_desc}B话数量为{rank[0][1]}。'
 	).send(reply=True)
 
 
@@ -183,7 +182,6 @@ async def _group_message(
 ):
 	t1 = t.time()
 	state['t1'] = t1
-	dt = get_datetime_now_with_timezone()
 
 	if not group_id:
 		group_id = session.scene.id
@@ -305,10 +303,15 @@ async def handle_rank(
 		).finish()
 
 	rank = got_rank(raw_rank)
-	ids = await persist_id2user_id([int(i[0]) for i in rank])
-	for i in range(len(rank)):
-		rank[i][0] = str(ids[i])
-		logger.debug(rank[i])
+	# 必须按 user_persist_id 精确映射，不能依赖查询返回顺序
+	id_map = await persist_id2user_id([item[0] for item in rank])
+	for item in rank:
+		user_id = id_map.get(item[0])
+		if user_id is None:
+			logger.warning(f'未找到持久化 id {item[0]} 对应的平台用户')
+			user_id = str(item[0])
+		item[0] = user_id
+		logger.debug(item)
 
 	t1 = t.time()
 	rank2 = await get_user_infos(bot, event, rank)

{nonebot_plugin_dialectlist-3.0.1 → nonebot_plugin_dialectlist-3.1.0}/nonebot_plugin_dialectlist/config.py

@@ -6,9 +6,7 @@ from pydantic import BaseModel
 
 class ScopedConfig(BaseModel):
 	get_num: int = 5  # 获取人数数量
-	font: str = 'SimHei'  # 字体格式
 	suffix: bool = True  # 是否显示后缀
-	excluded_self: bool = True  # 是否排除自己
 	visualization: bool = True  # 是否可视化
 	show_text_rank: bool = True  # 是否显示文本排名
 	excluded_people: List[str] = []  # 排除的人的QQ号

nonebot_plugin_dialectlist-3.1.0/nonebot_plugin_dialectlist/schema.py

@@ -0,0 +1,31 @@
+import base64
+from typing import Union
+
+from nonebot_plugin_userinfo import UserInfo
+
+
+def _image_mime(data: bytes) -> str:
+	"""按文件头猜测头像的 MIME 类型"""
+	if data.startswith(b'\x89PNG\r\n\x1a\n'):
+		return 'image/png'
+	if data.startswith(b'GIF8'):
+		return 'image/gif'
+	if data[:4] == b'RIFF' and data[8:12] == b'WEBP':
+		return 'image/webp'
+	return 'image/jpeg'
+
+
+class UserRankInfo(UserInfo):
+	user_bnum: int
+	user_proportion: float
+	user_nickname: str
+	user_index: Union[int, str]
+	user_avatar_bytes: bytes
+
+	@property
+	def user_avatar_data_uri(self) -> str:
+		"""把头像内联成 data URI，模板不再依赖任何本地文件"""
+		return (
+			f'data:{_image_mime(self.user_avatar_bytes)};base64,'
+			+ base64.b64encode(self.user_avatar_bytes).decode('ascii')
+		)

{nonebot_plugin_dialectlist-3.0.1 → nonebot_plugin_dialectlist-3.1.0}/nonebot_plugin_dialectlist/template/rank_template.j2

@@ -5,7 +5,7 @@
         <title>
             在 title 里夹一点私货应该不会被发现吧？——ddl 真是太厉害啦！
         </title>
-        <link rel="stylesheet" href="./css/style.css">
+        <style>{{ inline_css|safe }}</style>
     </head>
     <body>
         <div class="container">
@@ -21,7 +21,7 @@
                         <div class="rank_number rank_number_{{ i.user_index }}">{{ i.user_index }}</div>
                     </div>
                     <div class="avatar">
-                        <img class="profile" src="{{ cache_path }}/{{ i.user_id }}.jpg"/>
+                        <img class="profile" src="{{ i.user_avatar_data_uri }}"/>
                     </div>
                     <div class="rank_card_info">
                         <h1>{{ i.user_nickname }} {{ i.user_gender }}</h1>

nonebot_plugin_dialectlist-3.1.0/nonebot_plugin_dialectlist/time.py

@@ -0,0 +1,52 @@
+from datetime import datetime
+from typing import Union
+from zoneinfo import ZoneInfo
+
+from nonebot.adapters import Message
+from nonebot.params import Arg
+from nonebot.typing import T_State
+from nonebot_plugin_alconna import AlconnaMatcher
+
+from .config import plugin_config
+
+
+def parse_datetime(key: str):
+	"""解析数字，并将结果存入 state 中"""
+
+	async def _key_parser(
+		matcher: AlconnaMatcher,
+		state: T_State,
+		input: Union[datetime, Message] = Arg(key),
+	):
+		if isinstance(input, datetime):
+			return
+
+		plaintext = input.extract_plain_text()
+		try:
+			state[key] = get_datetime_fromisoformat_with_timezone(plaintext)
+		except ValueError:
+			await matcher.reject_arg(
+				key, '请输入正确的日期，不然我没法理解呢！'
+			)
+
+	return _key_parser
+
+
+def get_datetime_now_with_timezone() -> datetime:
+	"""获取当前时间，并包含时区信息"""
+	if plugin_config.timezone:
+		return datetime.now(ZoneInfo(plugin_config.timezone))
+	else:
+		return datetime.now().astimezone()
+
+
+def get_datetime_fromisoformat_with_timezone(date_string: str) -> datetime:
+	"""从 ISO-8601 格式字符串中获取时间，并包含时区信息"""
+	if not plugin_config.timezone:
+		return datetime.fromisoformat(date_string).astimezone()
+	raw = datetime.fromisoformat(date_string)
+	return (
+		raw.astimezone(ZoneInfo(plugin_config.timezone))
+		if raw.tzinfo
+		else raw.replace(tzinfo=ZoneInfo(plugin_config.timezone))
+	)

{nonebot_plugin_dialectlist-3.0.1 → nonebot_plugin_dialectlist-3.1.0}/nonebot_plugin_dialectlist/usage.py

@@ -15,8 +15,6 @@ __usage__ = cleandoc(
 
 -`/昨日B话榜` ————看看昨天的群友发了多少消息！
 
--`/前日B话榜` ————看看前天的群友发了多少消息！
-
 -`/本周B话榜` ————看看本周的群友发了多少消息！
 
 -`/上周B话榜` ————看看上周的群友发了多少消息！