Merge pull request 'fix: 透明底正常生成；静动图分离完成' (#18) from tnot/konabot:fix--修复部分Bug into master

Reviewed-on: #18

.dockerignore

@@ -1,4 +1,5 @@
 /.env
 /.git
+/data
 
 __pycache__

.drone.yml

@@ -26,6 +26,14 @@ steps:
     volumes:
       - name: docker-socket
         path: /var/run/docker.sock
+  - name: 在容器中测试插件加载
+    image: docker:dind
+    privileged: true
+    volumes:
+      - name: docker-socket
+        path: /var/run/docker.sock
+    commands:
+      - docker run --rm gitea.service.jazzwhom.top/mttu-developers/konabot:nightly-${DRONE_COMMIT_SHA} python scripts/test_plugin_load.py
 
 volumes:
   - name: docker-socket

.env.test

@@ -0,0 +1,4 @@
+ENVIRONMENT=test
+ENABLE_CONSOLE=false
+ENABLE_QQ=false
+ENABLE_DISCORD=false

.gitignore

@@ -1,3 +1,4 @@
 /.env
+/data
 
 __pycache__

Dockerfile

@@ -4,5 +4,11 @@ WORKDIR /app
 COPY requirements.txt ./
 RUN pip install -r requirements.txt --no-deps
 
-COPY . .
+COPY bot.py pyproject.toml .env.prod .env.test ./
+COPY assets ./assets
+COPY scripts ./scripts
+COPY konabot ./konabot
+
+ENV PYTHONPATH=/app
+
 CMD [ "python", "bot.py" ]

konabot/common/path.py

@@ -0,0 +1,4 @@
+from pathlib import Path
+
+ASSETS_PATH = Path(__file__).resolve().parent.parent.parent / "assets"
+FONTS_PATH = ASSETS_PATH / "fonts"

konabot/plugins/memepack/__init__.py

@@ -1,14 +1,17 @@
 from io import BytesIO
-from nonebot_plugin_alconna import Alconna, Args, Field, MultiVar, UniMessage, on_alconna
+
+from nonebot_plugin_alconna import (Alconna, Args, Field, MultiVar, UniMessage,
+                                    on_alconna)
 
 from konabot.plugins.memepack.drawing.geimao import draw_geimao
+from konabot.plugins.memepack.drawing.pt import draw_pt
 
 geimao = on_alconna(Alconna(
     "给猫说",
     Args["saying", MultiVar(str, '+'), Field(
         missing_tips=lambda: "你没有写给猫说了什么"
     )]
-), use_cmd_start=True, use_cmd_sep=False, skip_for_unmatch=False)
+), use_cmd_start=True, use_cmd_sep=False, skip_for_unmatch=False, aliases={"给猫哈"})
 
 @geimao.handle()
 async def _(saying: list[str]):
@@ -17,3 +20,19 @@ async def _(saying: list[str]):
     img.save(img_bytes, format="PNG")
 
     await geimao.send(await UniMessage().image(raw=img_bytes).export())
+
+
+pt = on_alconna(Alconna(
+    "pt说",
+    Args["saying", MultiVar(str, '+'), Field(
+        missing_tips=lambda: "你没有写小帕说了什么"
+    )]
+), use_cmd_start=True, use_cmd_sep=False, skip_for_unmatch=False, aliases={"小帕说"})
+
+@pt.handle()
+async def _(saying: list[str]):
+    img = await draw_pt("\n".join(saying))
+    img_bytes = BytesIO()
+    img.save(img_bytes, format="PNG")
+
+    await pt.send(await UniMessage().image(raw=img_bytes).export())

konabot/plugins/memepack/drawing/base/fonts.py

@@ -1,6 +1,12 @@
-from imagetext_py import FontDB
+from imagetext_py import EmojiOptions, FontDB
 
-from .path import assets
+from konabot.common.path import FONTS_PATH
+
+FontDB.LoadFromDir(str(FONTS_PATH))
+
+FontDB.SetDefaultEmojiOptions(EmojiOptions(
+    parse_shortcodes=False, 
+))
 
-FontDB.LoadFromDir(str(assets))
 HARMONYOS_SANS_SC_BLACK = FontDB.Query("HarmonyOS_Sans_SC_Black")
+HARMONYOS_SANS_SC_REGULAR = FontDB.Query("HarmonyOS_Sans_SC_Regular")

konabot/plugins/memepack/drawing/base/path.py

@@ -1,3 +0,0 @@
-from pathlib import Path
-
-assets = Path(__file__).parent.parent.parent / "assets"

konabot/plugins/memepack/drawing/geimao.py

@@ -4,10 +4,11 @@ from typing import Any, cast
 import imagetext_py
 import PIL.Image
 
-from .base.fonts import HARMONYOS_SANS_SC_BLACK
-from .base.path import assets
+from konabot.common.path import ASSETS_PATH
 
-geimao_image = PIL.Image.open(assets / "geimao.jpg").convert("RGBA")
+from .base.fonts import HARMONYOS_SANS_SC_BLACK
+
+geimao_image = PIL.Image.open(ASSETS_PATH / "img" / "meme" / "geimao.jpg").convert("RGBA")
 
 
 def _draw_geimao(saying: str):
@@ -20,6 +21,7 @@ def _draw_geimao(saying: str):
             imagetext_py.TextAlign.Center,
             cast(Any, 30.0),
             imagetext_py.Paint.Color(imagetext_py.Color.from_hex("FFFFFFFF")),
+            draw_emojis=True,
         )
     return img
     

konabot/plugins/memepack/drawing/pt.py

@@ -0,0 +1,27 @@
+import asyncio
+
+import imagetext_py
+import PIL.Image
+
+from konabot.common.path import ASSETS_PATH
+
+from .base.fonts import HARMONYOS_SANS_SC_REGULAR
+
+pt_image = PIL.Image.open(ASSETS_PATH / "img" / "meme" / "ptsay.png").convert("RGBA")
+
+
+def _draw_pt(saying: str):
+    img = pt_image.copy()
+    with imagetext_py.Writer(img) as iw:
+        iw.draw_text_wrapped(
+            saying, 259, 278, 0.5, 0.5, 360, 48, HARMONYOS_SANS_SC_REGULAR,
+            imagetext_py.Paint.Color(imagetext_py.Color.from_hex("000000FF")),
+            1.0,
+            imagetext_py.TextAlign.Center,
+            draw_emojis=True,
+        )
+    return img
+
+
+async def draw_pt(saying: str):
+    return await asyncio.to_thread(_draw_pt, saying)

konabot/plugins/roll_dice/__init__.py

@@ -1,19 +1,47 @@
+from typing import Optional, Union
 from nonebot.adapters import Event as BaseEvent
 from nonebot.adapters.console.event import MessageEvent as ConsoleMessageEvent
 from nonebot.adapters.discord.event import MessageEvent as DiscordMessageEvent
-from nonebot_plugin_alconna import Alconna, UniMessage, on_alconna
+from nonebot_plugin_alconna import Alconna, Args, UniMessage, on_alconna
 
-from konabot.plugins.roll_dice.roll_dice import roll_dice
+from konabot.plugins.roll_dice.roll_dice import generate_dice_image
+from konabot.plugins.roll_dice.roll_number import get_random_number, get_random_number_string, roll_number
 
 evt = on_alconna(Alconna(
-    "摇骰子"
+    "摇数字"
 ), use_cmd_start=True, use_cmd_sep=False, skip_for_unmatch=True)
 
 @evt.handle()
 async def _(event: BaseEvent):
     if isinstance(event, DiscordMessageEvent):
-        await evt.send(await UniMessage().text("```\n" + roll_dice() + "\n```").export())
+        await evt.send(await UniMessage().text("```\n" + roll_number() + "\n```").export())
     elif isinstance(event, ConsoleMessageEvent):
-        await evt.send(await UniMessage().text(roll_dice()).export())
+        await evt.send(await UniMessage().text(roll_number()).export())
     else:
-        await evt.send(await UniMessage().text(roll_dice(wide=True)).export())
+        await evt.send(await UniMessage().text(roll_number(wide=True)).export())
+
+evt = on_alconna(Alconna(
+    "摇骰子",
+    Args["f1?", str]["f2?", str]
+), use_cmd_start=True, use_cmd_sep=False, skip_for_unmatch=True)
+
+@evt.handle()
+async def _(event: BaseEvent, f1: Optional[str] = None, f2: Optional[str] = None):
+    # if isinstance(event, DiscordMessageEvent):
+    #     await evt.send(await UniMessage().text("```\n" + roll_dice() + "\n```").export())
+    # elif isinstance(event, ConsoleMessageEvent):
+    number = ""
+    if(f1 is not None and f2 is not None):
+        number = get_random_number_string(f1, f2)
+    elif f1 is not None:
+        if(float(f1) > 1):
+            number = get_random_number_string("1", f1)
+        elif (float(f1) > 0):
+            number = get_random_number_string("0", f1)
+        else:
+            number = get_random_number_string(f1, "0")
+    else:
+        number = get_random_number_string()
+    await evt.send(await UniMessage().image(raw=await generate_dice_image(number)).export())
+    # else:
+    #     await evt.send(await UniMessage().text(roll_dice(wide=True)).export())

konabot/plugins/roll_dice/base/path.py

@@ -0,0 +1,3 @@
+from pathlib import Path
+
+ASSETS = Path(__file__).parent.parent / "assets"

konabot/plugins/roll_dice/roll_dice.py

@@ -1,54 +1,399 @@
-number_arts = {
-    1: '''  _ 
- / |
- | |
- | |
- |_|
+from io import BytesIO
+
+import cv2
+import numpy as np
+from PIL import Image, ImageDraw, ImageFont
+
+from konabot.common.path import ASSETS_PATH, FONTS_PATH
+
+
+def text_to_transparent_image(text, font_size=40, padding=0, text_color=(0, 0, 0)):
+    """
+    将文本转换为带透明背景的图像，图像大小刚好包含文本
+    """
+    # 创建临时图像来计算文本尺寸
+    temp_image = Image.new('RGB', (1, 1), (255, 255, 255))
+    temp_draw = ImageDraw.Draw(temp_image)
     
-''',
-    2: '''  ____  
- |___ \\ 
-   __) |
-  / __/ 
- |_____|
-        ''',
-    3: '''  _____ 
- |___ / 
-   |_ \\ 
-  ___) |
- |____/ 
-        ''',
-    4: '''  _  _   
- | || |  
- | || |_ 
- |__   _|
-    |_|  
-         ''',
-    5: '''  ____  
- | ___| 
- |___ \\ 
-  ___) |
- |____/ 
-        ''',
-    6: '''   __   
-  / /_  
- | '_ \\ 
- | (_) |
-  \\___/ 
-        '''
-}
+    font = ImageFont.truetype(FONTS_PATH / "montserrat.otf", font_size)
+    
+    # 获取文本边界框
+    bbox = temp_draw.textbbox((0, 0), text, font=font)
+    text_width = bbox[2] - bbox[0]
+    text_height = bbox[3] - bbox[1]
+    
+    # 计算图像大小（文本大小 + 内边距）
+    image_width = int(text_width + 2 * padding)
+    image_height = int(text_height + 2 * padding)
+    
+    # 创建RGBA模式的空白图像（带透明通道）
+    image = Image.new('RGBA', (image_width, image_height), (0, 0, 0, 0))
+    draw = ImageDraw.Draw(image)
+    
+    # 绘制文本（考虑内边距）
+    x = padding - bbox[0]  # 调整起始位置
+    y = padding - bbox[1]
+    
+    # 设置文本颜色（带透明度）
+    if len(text_color) == 3:
+        text_color = text_color + (255,)  # 添加完全不透明的alpha值
+    
+    draw.text((x, y), text, fill=text_color, font=font)
+    
+    # 转换为OpenCV格式（BGRA）
+    image_cv = cv2.cvtColor(np.array(image), cv2.COLOR_RGBA2BGRA)
+    return image_cv
 
-def get_random_number(min: int = 1, max: int = 6) -> int:
-    import random
-    return random.randint(min, max)
+def perspective_transform(image, target, corners):
+    """
+    对图像进行透视变换（保持透明通道）
+    target: 画布
+    corners: 四个角点的坐标，顺序为 [左上, 右上, 右下, 左下]
+    """
+    height, width = image.shape[:2]
+    
+    # 源点（原始图像的四个角）
+    src_points = np.array([
+        [0, 0],           # 左上
+        [width-1, 0],     # 右上
+        [width-1, height-1], # 右下
+        [0, height-1]     # 左下
+    ], dtype=np.float32)
+    
+    # 目标点（变换后的四个角）
+    dst_points = np.array(corners, dtype=np.float32)
+    
+    # 计算透视变换矩阵
+    matrix = cv2.getPerspectiveTransform(src_points, dst_points)
+    
+    # 获取画布大小
+    target_height, target_width = target.shape[:2]
 
-def roll_dice(wide: bool = False) -> str:
-    raw = number_arts[get_random_number()]
-    if wide:
-        raw = (raw
-            .replace("/", "／")
-            .replace("\\", "＼")
-            .replace("_", "＿")
-            .replace("|", "｜")
-            .replace(" ", "　"))
-    return raw
+    # 应用透视变换（保持所有通道，包括alpha）
+    transformed = cv2.warpPerspective(image, matrix, (target_width, target_height), flags=cv2.INTER_LINEAR)
+
+    return transformed, matrix
+
+def blend_with_transparency(background, foreground, position):
+    """
+    将带透明通道的前景图像合成到背景图像上
+    position: 前景图像在背景图像上的位置 (x, y)
+    """
+    bg = background.copy()
+    
+    # 如果背景没有alpha通道，添加一个
+    if bg.shape[2] == 3:
+        bg = cv2.cvtColor(bg, cv2.COLOR_BGR2BGRA)
+        bg[:, :, 3] = 255  # 完全不透明
+    
+    x, y = position
+    fg_height, fg_width = foreground.shape[:2]
+    bg_height, bg_width = bg.shape[:2]
+    
+    # 确保位置在图像范围内
+    x = max(0, min(x, bg_width - fg_width))
+    y = max(0, min(y, bg_height - fg_height))
+    
+    # 提取前景的alpha通道并归一化
+    alpha_foreground = foreground[:, :, 3] / 255.0
+    
+    # 对于每个颜色通道进行合成
+    for c in range(3):
+        bg_region = bg[y:y+fg_height, x:x+fg_width, c]
+        fg_region = foreground[:, :, c]
+        
+        # alpha混合公式
+        bg[y:y+fg_height, x:x+fg_width, c] = (
+            alpha_foreground * fg_region + 
+            (1 - alpha_foreground) * bg_region
+        )
+    
+    # 更新背景的alpha通道（如果需要）
+    bg_alpha_region = bg[y:y+fg_height, x:x+fg_width, 3]
+    bg[y:y+fg_height, x:x+fg_width, 3] = np.maximum(bg_alpha_region, foreground[:, :, 3])
+    
+    return bg
+
+def precise_blend_with_perspective(background, foreground, corners):
+    """
+    精确合成：根据四个角点将前景图像透视合成到背景上
+    """
+    # 创建与背景相同大小的空白图像
+    bg_height, bg_width = background.shape[:2]
+    
+    # 如果背景没有alpha通道，转换为BGRA
+    if background.shape[2] == 3:
+        background_bgra = cv2.cvtColor(background, cv2.COLOR_BGR2BGRA)
+    else:
+        background_bgra = background.copy()
+    
+    # 创建与背景相同大小的前景图层
+    foreground_layer = np.zeros((bg_height, bg_width, 4), dtype=np.uint8)
+    
+    # 计算前景图像在背景中的边界框
+    min_x = int(min(corners[:, 0]))
+    max_x = int(max(corners[:, 0]))
+    min_y = int(min(corners[:, 1]))
+    max_y = int(max(corners[:, 1]))
+    
+    # 将变换后的前景图像放置到对应位置
+    fg_height, fg_width = foreground.shape[:2]
+    if min_y + fg_height <= bg_height and min_x + fg_width <= bg_width:
+        foreground_layer[min_y:min_y+fg_height, min_x:min_x+fg_width] = foreground
+    
+    # 创建掩码（只在前景有内容的地方合成）
+    mask = (foreground_layer[:, :, 3] > 0)
+    
+    # 合成图像
+    result = background_bgra.copy()
+    for c in range(3):
+        result[:, :, c][mask] = foreground_layer[:, :, c][mask]
+    result[:, :, 3][mask] = foreground_layer[:, :, 3][mask]
+    
+    return result
+
+def draw_line_bresenham(image, x0, y0, x1, y1, color):
+    """使用Bresenham算法画线，避免间隙"""
+    dx = abs(x1 - x0)
+    dy = abs(y1 - y0)
+    sx = 1 if x0 < x1 else -1
+    sy = 1 if y0 < y1 else -1
+    err = dx - dy
+    
+    while True:
+        if 0 <= x0 < image.shape[1] and 0 <= y0 < image.shape[0]:
+            image[y0, x0] = color
+        
+        if x0 == x1 and y0 == y1:
+            break
+            
+        e2 = 2 * err
+        if e2 > -dy:
+            err -= dy
+            x0 += sx
+        if e2 < dx:
+            err += dx
+            y0 += sy
+
+def slice_and_stretch(image, slice_lines, direction):
+    '''
+    image: 图像
+    slice_lines: 切割线（两个点的列表），一般是倾斜45度的直线
+    direction: 移动方向向量（二元数组）
+    '''
+    # 获取图片的尺寸
+    height, width = image.shape[:2]
+    # 创建一个由移动方向扩充后，更大的图片
+    new_width = int(width + abs(direction[0]))
+    new_height = int(height + abs(direction[1]))
+    new_image = np.zeros((new_height, new_width, 4), dtype=image.dtype)
+    # 先把图片放在新图的和方向相反的一侧
+    offset_x = int(abs(min(0, direction[0])))
+    offset_y = int(abs(min(0, direction[1])))
+    new_image[offset_y:offset_y+height, offset_x:offset_x+width] = image
+    # 切割线也跟着偏移
+    slice_lines = [(x + offset_x, y + offset_y) for (x, y) in slice_lines]
+    # 复制切割线经过的像素，沿着方向移动，实现类似拖尾的效果
+    apply_trail_effect_vectorized(new_image, slice_lines, direction)
+    apply_stroke_vectorized(new_image, slice_lines, direction)
+
+
+    return new_image, offset_x, offset_y
+
+def apply_trail_effect_vectorized(new_image, slice_lines, direction):
+    """向量化实现拖尾效果"""
+    height, width = new_image.shape[:2]
+    
+    # 创建坐标网格
+    y_coords, x_coords = np.mgrid[0:height, 0:width]
+    
+    # 向量化计算点到直线的距离
+    line_vec = np.array([slice_lines[1][0] - slice_lines[0][0], 
+                        slice_lines[1][1] - slice_lines[0][1]])
+    point_vecs = np.stack([x_coords - slice_lines[0][0], 
+                          y_coords - slice_lines[0][1]], axis=-1)
+    
+    # 计算叉积（有向距离）
+    cross_products = (line_vec[0] * point_vecs[:, :, 1] - 
+                     line_vec[1] * point_vecs[:, :, 0])
+    
+    # 选择直线右侧的像素 (d1 > 0)
+    mask = cross_products > 0
+    
+    # 计算目标位置
+    target_x = (x_coords + direction[0]).astype(int)
+    target_y = (y_coords + direction[1]).astype(int)
+    
+    # 创建有效位置掩码
+    valid_mask = mask & (target_x >= 0) & (target_x < width) & \
+                (target_y >= 0) & (target_y < height)
+    
+    # 批量复制像素
+    new_image[target_y[valid_mask], target_x[valid_mask]] = \
+        new_image[y_coords[valid_mask], x_coords[valid_mask]]
+
+def apply_stroke_vectorized(new_image, slice_lines, direction):
+    """使用向量化操作优化笔画效果"""
+    height, width = new_image.shape[:2]
+    
+    # 1. 找到所有非透明像素
+    non_transparent = np.where(new_image[:, :, 3] > 0)
+    if len(non_transparent[0]) == 0:
+        return
+    
+    y_coords, x_coords = non_transparent
+    
+    # 2. 向量化计算点到直线的距离
+    line_vec = np.array([slice_lines[1][0] - slice_lines[0][0], 
+                        slice_lines[1][1] - slice_lines[0][1]])
+    point_vecs = np.column_stack([x_coords - slice_lines[0][0], 
+                                 y_coords - slice_lines[0][1]])
+    
+    # 计算叉积（距离）
+    cross_products = (line_vec[0] * point_vecs[:, 1] - 
+                     line_vec[1] * point_vecs[:, 0])
+    
+    # 3. 选择靠近直线的像素
+    mask = np.abs(cross_products) < 1.0
+    selected_y = y_coords[mask]
+    selected_x = x_coords[mask]
+    selected_pixels = new_image[selected_y, selected_x]
+    
+    if len(selected_x) == 0:
+        return
+    
+    # 4. 预计算采样点
+    length = np.sqrt(direction[0]**2 + direction[1]**2)
+    if length == 0:
+        return
+    
+    # 创建采样偏移
+    dx_dy = np.array([(dx, dy) for dx in [-0.5, 0, 0.5] 
+                     for dy in [-0.5, 0, 0.5]])
+    
+    # 5. 批量计算目标位置
+    steps = max(1, int(length * 2))
+    alpha = 0.7
+    
+    for k in range(1, steps + 1):
+        # 对所有选中的像素批量计算新位置
+        scale = k / steps
+        
+        # 为每个像素和每个采样点计算目标位置
+        for dx, dy in dx_dy:
+            target_x = np.round(selected_x + dx + direction[0] * scale).astype(int)
+            target_y = np.round(selected_y + dy + direction[1] * scale).astype(int)
+            
+            # 创建有效位置掩码
+            valid_mask = (target_x >= 0) & (target_x < width) & \
+                        (target_y >= 0) & (target_y < height)
+            
+            if np.any(valid_mask):
+                valid_target_x = target_x[valid_mask]
+                valid_target_y = target_y[valid_mask]
+                valid_source_idx = np.where(valid_mask)[0]
+                
+                # 批量混合像素
+                source_pixels = selected_pixels[valid_source_idx]
+                target_pixels = new_image[valid_target_y, valid_target_x]
+                
+                new_image[valid_target_y, valid_target_x] = (
+                    alpha * source_pixels + (1 - alpha) * target_pixels
+                )
+
+async def generate_dice_image(number: str) -> BytesIO:
+    # 将文本转换为带透明背景的图像
+    text = number
+
+    # 如果文本太长，直接返回金箍棒
+    if(len(text) > 50):
+        output = BytesIO()
+        push_image = Image.open(ASSETS_PATH / "img" / "dice" / "stick.png")
+        push_image.save(output,format='PNG')
+        output.seek(0)
+        return output
+
+    text_image = text_to_transparent_image(
+        text, 
+        font_size=60, 
+        text_color=(0, 0, 0)  # 黑色文字
+    )
+
+    # 获取长宽比
+    height, width = text_image.shape[:2]
+    aspect_ratio = width / height
+
+    # 根据长宽比设置拉伸系数
+    stretch_k = 1
+    if aspect_ratio > 1:
+        stretch_k = aspect_ratio
+
+    # 骰子的方向
+    up_direction = (51 - 16, 5 - 30)  # 右上角点 - 左上角点
+
+    move_distance = (up_direction[0] * (stretch_k - 1), up_direction[1] * (stretch_k - 1))
+    
+    # 加载背景图像，保留透明通道
+    background = cv2.imread(ASSETS_PATH / "img" / "dice" / "template.png", cv2.IMREAD_UNCHANGED)
+
+    height, width = background.shape[:2]
+
+    background, offset_x, offset_y = slice_and_stretch(background, 
+                                                       [(10,10),(0,0)], 
+                                                        move_distance)
+
+    # 定义3D变换的四个角点（透视效果）
+    # 顺序: [左上, 右上, 右下, 左下]
+    corners = np.array([
+        [16, 30],    # 左上
+        [51 + move_distance[0], 5 + move_distance[1]],     # 右上（上移，创建透视）
+        [88 + move_distance[0], 33 + move_distance[1]],    # 右下
+        [49, 62]     # 左下（下移）
+    ], dtype=np.float32)
+    corners[:, 0] += offset_x
+    corners[:, 1] += offset_y
+
+
+    # 对文本图像进行3D变换（保持透明通道）
+    transformed_text, transform_matrix = perspective_transform(text_image, background, corners)
+    
+    min_x = int(min(corners[:, 0]))
+    min_y = int(min(corners[:, 1]))
+    final_image_simple = blend_with_transparency(background, transformed_text, (min_x, min_y))
+
+    pil_final = Image.fromarray(final_image_simple)
+    # 导入一系列图像
+    images: list[Image.Image] = [Image.open(ASSETS_PATH / "img" / "dice" / f"{i}.png") for i in range(1, 12)]
+    images.append(pil_final)
+    frame_durations = [100] * (len(images) - 1) + [100000]
+    # 将导入的图像尺寸扩展为和 pil_final 相同的大小，随帧数进行扩展，然后不放大的情况下放在最中间
+    if(aspect_ratio > 1):
+        target_size = pil_final.size
+        for i in range(len(images) - 1):
+            k = i / (len(images) - 1)
+            now_distance = (move_distance[0] * k, move_distance[1] * k)
+            img = np.array(images[i])
+            img, _, _ = slice_and_stretch(img,
+                            [(10,10),(0,0)], 
+                            now_distance)
+            # 只扩展边界，图像本身不放大
+            img_width, img_height = img.shape[1], img.shape[0]
+            new_img = Image.new("RGBA", target_size, (0, 0, 0, 0))
+            this_offset_x = (target_size[0] - img_width) // 2
+            this_offset_y = (target_size[1] - img_height) // 2
+            # new_img.paste(img, (this_offset_x, this_offset_y))
+            new_img.paste(Image.fromarray(img), (this_offset_x, this_offset_y))
+            images[i] = new_img
+        
+
+    # 保存为BytesIO对象
+    output = BytesIO()
+    images[0].save(output,
+               save_all=True,
+               append_images=images[1:],
+               duration=frame_durations,
+               format='GIF',
+               loop=1)
+    output.seek(0)
+    # pil_final.save(output, format='PNG')
+    return output

konabot/plugins/roll_dice/roll_number.py

@@ -0,0 +1,72 @@
+number_arts = {
+    1: '''  _ 
+ / |
+ | |
+ | |
+ |_|
+    
+''',
+    2: '''  ____  
+ |___ \\ 
+   __) |
+  / __/ 
+ |_____|
+        ''',
+    3: '''  _____ 
+ |___ / 
+   |_ \\ 
+  ___) |
+ |____/ 
+        ''',
+    4: '''  _  _   
+ | || |  
+ | || |_ 
+ |__   _|
+    |_|  
+         ''',
+    5: '''  ____  
+ | ___| 
+ |___ \\ 
+  ___) |
+ |____/ 
+        ''',
+    6: '''   __   
+  / /_  
+ | '_ \\ 
+ | (_) |
+  \\___/ 
+        '''
+}
+
+def get_random_number(min: int = 1, max: int = 6) -> int:
+    import random
+    return random.randint(min, max)
+
+def get_random_number_string(min_value: str = "1", max_value: str = "6") -> str:
+    import random
+
+    # 先判断二者是不是整数
+    if (float(min_value).is_integer()
+        and float(max_value).is_integer()
+        and "." not in min_value
+        and "." not in max_value):
+        return str(random.randint(int(float(min_value)), int(float(max_value))))
+    
+    # 根据传入小数的位数，决定保留几位小数
+    if "." in str(min_value) or "." in str(max_value):
+        decimal_places = max(len(str(min_value).split(".")[1]) if "." in str(min_value) else 0,
+                             len(str(max_value).split(".")[1]) if "." in str(max_value) else 0)
+        return str(round(random.uniform(float(min_value), float(max_value)), decimal_places))
+    
+    # 如果没有小数点，很可能二者都是指数表示或均为 inf，直接返回随机小数
+    return str(random.uniform(float(min_value), float(max_value)))
+def roll_number(wide: bool = False) -> str:
+    raw = number_arts[get_random_number()]
+    if wide:
+        raw = (raw
+            .replace("/", "／")
+            .replace("\\", "＼")
+            .replace("_", "＿")
+            .replace("|", "｜")
+            .replace(" ", "　"))
+    return raw

konabot/plugins/simple_notify/__init__.py

@@ -0,0 +1,207 @@
+import asyncio
+import datetime
+from pathlib import Path
+from typing import Any, Literal, cast
+
+import nonebot
+from loguru import logger
+from nonebot import on_message
+from nonebot.adapters import Event
+from nonebot.adapters.console import Bot as ConsoleBot
+from nonebot.adapters.console.event import MessageEvent as ConsoleMessageEvent
+from nonebot.adapters.discord import Bot as DiscordBot
+from nonebot.adapters.discord.event import MessageEvent as DiscordMessageEvent
+from nonebot.adapters.onebot.v11 import Bot as OnebotV11Bot
+from nonebot.adapters.onebot.v11.event import \
+    GroupMessageEvent as OnebotV11GroupMessageEvent
+from nonebot.adapters.onebot.v11.event import \
+    MessageEvent as OnebotV11MessageEvent
+from nonebot_plugin_alconna import UniMessage, UniMsg
+from pydantic import BaseModel
+
+from konabot.plugins.simple_notify.parse_time import get_target_time
+
+evt = on_message()
+
+(Path(__file__).parent.parent.parent.parent / "data").mkdir(exist_ok=True)
+DATA_FILE_PATH = Path(__file__).parent.parent.parent.parent / "data" / "notify.json"
+DATA_FILE_LOCK = asyncio.Lock()
+
+
+class Notify(BaseModel):
+    platform: Literal["console", "qq", "discord"]
+
+    target: str
+    "需要接受通知的个体"
+
+    target_env: str | None
+    "在哪里进行通知，如果是 None 代表私聊通知"
+
+    notify_time: datetime.datetime
+    notify_msg: str
+
+    def get_str(self):
+        return f"{self.target}-{self.target_env}-{self.platform}-{self.notify_time}"
+
+
+class NotifyConfigFile(BaseModel):
+    version: int = 1
+    notifies: list[Notify] = []
+    unsent: list[Notify] = []
+
+
+def load_notify_config() -> NotifyConfigFile:
+    if not DATA_FILE_PATH.exists():
+        return NotifyConfigFile()
+    try:
+        return NotifyConfigFile.model_validate_json(DATA_FILE_PATH.read_text())
+    except Exception as e:
+        logger.warning(f"在解析 Notify 时遇到问题：{e}")
+        return NotifyConfigFile()
+
+
+def save_notify_config(config: NotifyConfigFile):
+    DATA_FILE_PATH.write_text(config.model_dump_json(indent=4))
+
+
+async def notify_now(notify: Notify):
+    if notify.platform == 'console':
+        bot = [b for b in nonebot.get_bots().values() if isinstance(b, ConsoleBot)]
+        if len(bot) != 1:
+            logger.warning(f"提醒未成功发送出去：{nonebot.get_bots()} {notify}")
+            return False
+        bot = bot[0]
+        await bot.send_private_message(notify.target, f"代办通知：{notify.notify_msg}")
+    elif notify.platform == 'discord':
+        bot = [b for b in nonebot.get_bots().values() if isinstance(b, DiscordBot)]
+        if len(bot) != 1:
+            logger.warning(f"提醒未成功发送出去：{nonebot.get_bots()} {notify}")
+            return False
+        bot = bot[0]
+        channel = await bot.create_DM(recipient_id=int(notify.target))
+        await bot.send_to(channel.id, f"代办通知：{notify.notify_msg}")
+    elif notify.platform == 'qq':
+        bot = [b for b in nonebot.get_bots().values() if isinstance(b, OnebotV11Bot)]
+        if len(bot) != 1:
+            logger.warning(f"提醒未成功发送出去：{nonebot.get_bots()} {notify}")
+            return False
+        bot = bot[0]
+        if notify.target_env is None:
+            await bot.send_private_msg(
+                user_id=int(notify.target),
+                message=f"代办通知：{notify.notify_msg}",
+            )
+        else:
+            await bot.send_group_msg(
+                group_id=int(notify.target_env),
+                message=cast(Any,
+                    await UniMessage().at(notify.target).text(f" 代办通知：{notify.notify_msg}").export()
+                ),
+            )
+    else:
+        logger.warning(f"提醒未成功发送出去：{notify}")
+        return False
+    return True
+
+
+async def create_notify_task(notify: Notify, fail2remove: bool = True):
+    async def mission():
+        begin_time = datetime.datetime.now()
+        if begin_time < notify.notify_time:
+            await asyncio.sleep((notify.notify_time - begin_time).total_seconds())
+        res = await notify_now(notify)
+        if fail2remove or res:
+            await DATA_FILE_LOCK.acquire()
+            cfg = load_notify_config()
+            cfg.notifies = [n for n in cfg.notifies if n.get_str() != notify.get_str()]
+            if not res:
+                cfg.unsent.append(notify)
+            save_notify_config(cfg)
+            DATA_FILE_LOCK.release()
+        else:
+            pass
+    return asyncio.create_task(mission())
+
+
+@evt.handle()
+async def _(msg: UniMsg, mEvt: Event):
+    if mEvt.get_user_id() in nonebot.get_bots():
+        return
+
+    text = msg.extract_plain_text()
+    if "提醒我" not in text:
+        return
+
+    segments = text.split("提醒我", maxsplit=1)
+    if len(segments) != 2:
+        return
+
+    notify_time, notify_text = segments
+    target_time = get_target_time(notify_time)
+    if target_time is None:
+        logger.info(f"无法从 {notify_time} 中解析出时间")
+        return
+    if not notify_text:
+        return
+
+    await DATA_FILE_LOCK.acquire()
+    cfg = load_notify_config()
+    
+    if isinstance(mEvt, ConsoleMessageEvent):
+        platform = "console"
+        target = mEvt.get_user_id()
+        target_env = None
+    elif isinstance(mEvt, OnebotV11MessageEvent):
+        platform = "qq"
+        target = mEvt.get_user_id()
+        if isinstance(mEvt, OnebotV11GroupMessageEvent):
+            target_env = str(mEvt.group_id)
+        else:
+            target_env = None
+    elif isinstance(mEvt, DiscordMessageEvent):
+        platform = "discord"
+        target = mEvt.get_user_id()
+        target_env = None
+    else:
+        logger.warning(f"Notify 遇到不支持的平台：{type(mEvt).__name__}")
+        return
+
+    notify = Notify(
+        platform=platform,
+        target=target,
+        target_env=target_env,
+        notify_time=target_time,
+        notify_msg=notify_text,
+    )
+    await create_notify_task(notify)
+
+    cfg.notifies.append(notify)
+    save_notify_config(cfg)
+    DATA_FILE_LOCK.release()
+
+    await evt.send(await UniMessage().at(mEvt.get_user_id()).text(
+        f" 了解啦！将会在 {notify.notify_time} 提醒你哦~").export())
+
+
+driver = nonebot.get_driver()
+
+NOTIFIED_FLAG = {
+    "task_added": False,
+}
+
+
+@driver.on_bot_connect
+async def _():
+    if NOTIFIED_FLAG["task_added"]:
+        return
+
+    NOTIFIED_FLAG["task_added"] = True
+
+    await DATA_FILE_LOCK.acquire()
+    tasks = []
+    cfg = load_notify_config()
+    for notify in cfg.notifies:
+        tasks.append(create_notify_task(notify, fail2remove=False))
+    DATA_FILE_LOCK.release()
+
+    await asyncio.gather(*tasks)

konabot/plugins/simple_notify/parse_time.py

@@ -0,0 +1,358 @@
+import datetime
+import re
+from typing import Optional, Dict, List, Callable, Tuple
+
+from loguru import logger
+
+# --- 常量与正则表达式定义 (Constants and Regex Definitions) ---
+
+# 数字模式，兼容中文和阿拉伯数字
+P_NUM = r"(\d+|[零一两二三四五六七八九十]+)"
+
+# 预编译的正则表达式
+PATTERNS = {
+    # 相对时间, e.g., "5分钟后"
+    "DELTA": re.compile(
+        r"^"
+        r"((?P<days>" + P_NUM + r") ?天)?"
+        r"((?P<hours>" + P_NUM + r") ?个?小?时)?"
+        r"((?P<minutes>" + P_NUM + r") ?分钟?)?"
+        r"((?P<seconds>" + P_NUM + r") ?秒钟?)?"
+        r" ?后 ?$"
+    ),
+    # 绝对时间
+    "YEAR": re.compile(r"(" + P_NUM + r") ?年"),
+    "MONTH": re.compile(r"(" + P_NUM + r") ?月"),
+    "DAY": re.compile(r"(" + P_NUM + r") ?[日号]"),
+    "HOUR": re.compile(r"(" + P_NUM + r") ?[点时](半)?钟?"),
+    "MINUTE": re.compile(r"(" + P_NUM + r") ?分(钟)?"),
+    "SECOND": re.compile(r"(" + P_NUM + r") ?秒(钟)?"),
+    "HMS_COLON": re.compile(r"(\d{1,2})[:：](\d{1,2})([:：](\d{1,2}))?"),
+    "PM": re.compile(r"(下午|PM|晚上)"),
+    # 相对日期
+    "TOMORROW": re.compile(r"明天"),
+    "DAY_AFTER_TOMORROW": re.compile(r"后天"),
+    "TODAY": re.compile(r"今天"),
+}
+
+# 中文数字到阿拉伯数字的映射
+CHINESE_TO_ARABIC_MAP: Dict[str, int] = {
+    '零': 0, '一': 1, '二': 2, '三': 3, '四': 4,
+    '五': 5, '六': 6, '七': 7, '八': 8, '九': 9, '十': 10
+}
+
+# --- 核心工具函数 (Core Utility Functions) ---
+
+def parse_number(s: str) -> int:
+    """
+    将包含中文或阿拉伯数字的字符串解析为整数。
+    例如: "五" -> 5, "十五" -> 15, "二十三" -> 23, "12" -> 12。
+    返回 -1 表示解析失败。
+    """
+    if not s:
+        return -1
+        
+    s = s.strip().replace("两", "二")
+
+    if s.isdigit():
+        return int(s)
+
+    if s in CHINESE_TO_ARABIC_MAP:
+        return CHINESE_TO_ARABIC_MAP[s]
+
+    # 处理 "十" 在不同位置的情况
+    if s.startswith('十'):
+        if len(s) == 1:
+            return 10
+        num = CHINESE_TO_ARABIC_MAP.get(s[1])
+        return 10 + num if num is not None else -1
+    
+    if s.endswith('十'):
+        if len(s) == 2:
+            num = CHINESE_TO_ARABIC_MAP.get(s[0])
+            return 10 * num if num is not None else -1
+
+    if '十' in s:
+        parts = s.split('十')
+        if len(parts) == 2:
+            left = CHINESE_TO_ARABIC_MAP.get(parts[0])
+            right = CHINESE_TO_ARABIC_MAP.get(parts[1])
+            if left is not None and right is not None:
+                return left * 10 + right
+    
+    return -1
+
+
+# --- 时间解析器类 (Time Parser Class) ---
+
+class TimeParser:
+    """
+    一个用于解析自然语言时间描述的类。
+    """
+    def __init__(self, content: str):
+        self.original_content: str = content
+        self.content_to_parse: str = self._preprocess(content)
+        self.now: datetime.datetime = datetime.datetime.now()
+        # 将 t 作为结果构建器，初始化为今天的午夜
+        self.t: datetime.datetime = self.now.replace(hour=0, minute=0, second=0, microsecond=0)
+        self.is_pm_specified: bool = False
+        self.is_date_specified: bool = False
+        self.is_time_specified: bool = False
+
+    def _preprocess(self, content: str) -> str:
+        """预处理字符串，移除不相关字符。"""
+        content = re.sub(r"\s+", "", content)
+        content = re.sub(r"[,，\.。:：、]", "", content)
+        return content
+
+    def _consume_match(self, match: re.Match) -> str:
+        """从待解析字符串中移除已匹配的部分。"""
+        self.content_to_parse = self.content_to_parse.replace(match.group(0), "", 1)
+        return match.group(0)
+
+    def parse(self) -> Optional[datetime.datetime]:
+        """
+        主解析方法。
+        首先尝试解析相对时间（如“5分钟后”），失败则尝试解析绝对时间。
+        """
+        logger.debug(f"🎉 开始解析: '{self.original_content}' -> 清洗后: '{self.content_to_parse}'")
+        if not self.content_to_parse:
+            logger.debug("❌ 内容为空，无法解析。")
+            return None
+
+        # 1. 尝试相对时间解析
+        if (target_time := self._parse_relative_time()) is not None:
+            return target_time
+
+        # 2. 尝试绝对时间解析
+        if (target_time := self._parse_absolute_time()) is not None:
+            return target_time
+
+        logger.debug(f"❌ 所有解析模式均未匹配成功。")
+        return None
+
+    def _parse_relative_time(self) -> Optional[datetime.datetime]:
+        """解析 'X天X小时X分钟后' 这种格式。"""
+        if match := PATTERNS["DELTA"].match(self.content_to_parse):
+            logger.debug("⏳ 匹配到相对时间模式 (DELTA)。")
+            try:
+                delta_parts = {
+                    "days": parse_number(match.group("days") or "0"),
+                    "hours": parse_number(match.group("hours") or "0"),
+                    "minutes": parse_number(match.group("minutes") or "0"),
+                    "seconds": parse_number(match.group("seconds") or "0"),
+                }
+                
+                # 检查是否有无效的数字解析
+                if any(v < 0 for v in delta_parts.values()):
+                    logger.debug(f"❌ 解析时间片段为数字时失败: {delta_parts}")
+                    return None
+                
+                delta = datetime.timedelta(**delta_parts)
+                if delta.total_seconds() == 0:
+                    logger.debug("❌ 解析出的时间增量为0。")
+                    return None
+
+                target_time = self.now + delta
+                logger.debug(f"✅ 相对时间解析成功 -> {target_time}")
+                return target_time
+            except (ValueError, TypeError) as e:
+                logger.debug(f"❌ 解析相对时间时出错: {e}", exc_info=True)
+                return None
+        return None
+
+    def _parse_absolute_time(self) -> Optional[datetime.datetime]:
+        """解析一个指定的日期和时间。"""
+        logger.debug(f"🎯 启动绝对时间解析，基准时间: {self.t}")
+        
+        # 定义解析步骤和顺序
+        # (pattern_key, handler_method)
+        parsing_steps: List[Tuple[str, Callable[[re.Match], bool]]] = [
+            ("TOMORROW", self._handle_tomorrow),
+            ("DAY_AFTER_TOMORROW", self._handle_day_after_tomorrow),
+            ("TODAY", self._handle_today),
+            ("YEAR", self._handle_year),
+            ("MONTH", self._handle_month),
+            ("DAY", self._handle_day),
+            ("HMS_COLON", self._handle_hms_colon),
+            ("PM", self._handle_pm),
+            ("HOUR", self._handle_hour),
+            ("MINUTE", self._handle_minute),
+            ("SECOND", self._handle_second),
+        ]
+
+        for key, handler in parsing_steps:
+            if match := PATTERNS[key].search(self.content_to_parse):
+                if not handler(match):
+                    # 如果任何一个处理器返回False，说明解析失败
+                    return None
+        
+        # 移除无意义的上午关键词
+        self.content_to_parse = self.content_to_parse.replace("上午", "").replace("AM", "").replace("凌晨", "")
+
+        # 如果解析后还有剩余字符，说明有无法识别的部分
+        if self.content_to_parse.strip():
+            logger.debug(f"❌ 匹配失败，存在未解析的残留内容: '{self.content_to_parse.strip()}'")
+            return None
+            
+        # 最终调整和检查
+        return self._finalize_datetime()
+
+    # --- Handler Methods for Absolute Time Parsing ---
+
+    def _handle_tomorrow(self, match: re.Match) -> bool:
+        self.t += datetime.timedelta(days=1)
+        self.is_date_specified = True
+        logger.debug(f"📅 匹配到 '明天' -> {self.t.date()}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_day_after_tomorrow(self, match: re.Match) -> bool:
+        self.t += datetime.timedelta(days=2)
+        self.is_date_specified = True
+        logger.debug(f"📅 匹配到 '后天' -> {self.t.date()}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_today(self, match: re.Match) -> bool:
+        self.is_date_specified = True
+        logger.debug(f"📅 匹配到 '今天', 日期基准不变, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_year(self, match: re.Match) -> bool:
+        year = parse_number(match.group(1))
+        if year < 0: return False
+        if year < 100: year += 2000 # 处理 "25年" -> 2025
+        if year < self.now.year:
+            logger.debug(f"❌ 指定的年份 {year} 已过去。")
+            return False
+        self.t = self.t.replace(year=year)
+        self.is_date_specified = True
+        logger.debug(f"Y| 年份更新 -> {self.t.year}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_month(self, match: re.Match) -> bool:
+        month = parse_number(match.group(1))
+        if not (1 <= month <= 12):
+            logger.debug(f"❌ 无效的月份: {month}")
+            return False
+        
+        # 如果设置的月份在当前月份之前，且没有指定年份，则年份加一
+        if month < self.t.month and not self.is_date_specified:
+            self.t = self.t.replace(year=self.t.year + 1)
+            logger.debug(f"💡 月份小于当前月份，年份自动进位 -> {self.t.year}")
+
+        self.t = self.t.replace(month=month)
+        self.is_date_specified = True
+        logger.debug(f"M| 月份更新 -> {self.t.month}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_day(self, match: re.Match) -> bool:
+        day = parse_number(match.group(1))
+        if not (1 <= day <= 31):
+            logger.debug(f"❌ 无效的日期: {day}")
+            return False
+        
+        try:
+            # 如果日期小于当前日期，且只指定了日，则月份加一
+            if day < self.t.day and not self.is_date_specified:
+                if self.t.month == 12:
+                    self.t = self.t.replace(year=self.t.year + 1, month=1)
+                else:
+                    self.t = self.t.replace(month=self.t.month + 1)
+                logger.debug(f"💡 日期小于当前日期，月份自动进位 -> {self.t.year}-{self.t.month}")
+            
+            self.t = self.t.replace(day=day)
+            self.is_date_specified = True
+            logger.debug(f"D| 日期更新 -> {self.t.day}, 消耗: '{self._consume_match(match)}'")
+            return True
+        except ValueError:
+            logger.debug(f"❌ 日期 {day} 对于月份 {self.t.month} 无效 (例如2月30号)。")
+            return False
+
+    def _handle_hms_colon(self, match: re.Match) -> bool:
+        h = int(match.group(1))
+        m = int(match.group(2))
+        s_str = match.group(4) # group(3) is with colon, group(4) is the number
+        s = int(s_str) if s_str else 0
+        if not (0 <= h <= 23 and 0 <= m <= 59 and 0 <= s <= 59):
+            logger.debug(f"❌ 无效的时间格式: H={h}, M={m}, S={s}")
+            return False
+        self.t = self.t.replace(hour=h, minute=m, second=s)
+        self.is_time_specified = True
+        logger.debug(f"T| 时分秒(冒号格式)更新 -> {self.t.time()}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_pm(self, match: re.Match) -> bool:
+        self.is_pm_specified = True
+        logger.debug(f"PM| 匹配到下午/晚上, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_hour(self, match: re.Match) -> bool:
+        hour = parse_number(match.group(1))
+        has_half = match.group(2) == '半'
+        if not (0 <= hour <= 23):
+            logger.debug(f"❌ 无效的小时: {hour}")
+            return False
+        minute = 30 if has_half else self.t.minute
+        self.t = self.t.replace(hour=hour, minute=minute)
+        self.is_time_specified = True
+        logger.debug(f"H| 小时更新 -> {self.t.hour}{':30' if has_half else ''}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_minute(self, match: re.Match) -> bool:
+        minute = parse_number(match.group(1))
+        if not (0 <= minute <= 59):
+            logger.debug(f"❌ 无效的分钟: {minute}")
+            return False
+        self.t = self.t.replace(minute=minute)
+        self.is_time_specified = True
+        logger.debug(f"M| 分钟更新 -> {self.t.minute}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _handle_second(self, match: re.Match) -> bool:
+        second = parse_number(match.group(1))
+        if not (0 <= second <= 59):
+            logger.debug(f"❌ 无效的秒: {second}")
+            return False
+        self.t = self.t.replace(second=second)
+        self.is_time_specified = True
+        logger.debug(f"S| 秒更新 -> {self.t.second}, 消耗: '{self._consume_match(match)}'")
+        return True
+
+    def _finalize_datetime(self) -> Optional[datetime.datetime]:
+        """对解析出的时间进行最后的调整和检查。"""
+        # 处理下午/晚上
+        if self.is_pm_specified and self.t.hour < 12:
+            self.t = self.t.replace(hour=self.t.hour + 12)
+            logger.debug(f"💡 根据 PM 标识，小时调整为 -> {self.t.hour}")
+
+        # 如果没有指定任何时间或日期部分，则认为解析无效
+        if not self.is_date_specified and not self.is_time_specified:
+            logger.debug("❌ 未能从输入中解析出任何有效的日期或时间部分。")
+            return None
+
+        # 如果最终计算出的时间点在当前时间之前，自动往后推
+        # 例如：现在是 15:00，说 "14点"，应该是指明天的14点
+        if self.t < self.now:
+            # 只有在明确指定了时间的情况下，才自动加一天
+            # 如果只指定了一个过去的日期（如“去年5月1号”），则不应该调整
+            if self.is_time_specified:
+                self.t += datetime.timedelta(days=1)
+                logger.debug(f"🔁 目标时间已过，自动调整为明天 -> {self.t}")
+        
+        logger.debug(f"✅ 解析成功，最终时间: {self.t}")
+        return self.t
+
+# --- 公共接口 (Public Interface) ---
+
+def get_target_time(content: str) -> Optional[datetime.datetime]:
+    """
+    高级接口，用于将自然语言时间描述转换为 datetime 对象。
+
+    Args:
+        content: 包含时间信息的字符串。
+
+    Returns:
+        一个 datetime 对象，如果解析失败则返回 None。
+    """
+    parser = TimeParser(content)
+    return parser.parse()

konabot/plugins/ytpgif/__init__.py

@@ -0,0 +1,268 @@
+import os
+import tempfile
+from typing import Optional
+
+from PIL import Image, ImageSequence
+from nonebot.adapters import Event as BaseEvent
+from nonebot.plugin import PluginMetadata
+from nonebot_plugin_alconna import (
+    Alconna,
+    Args,
+    Field,
+    UniMessage,
+    on_alconna,
+)
+
+__plugin_meta__ = PluginMetadata(
+    name="ytpgif",
+    description="生成来回镜像翻转的仿 YTPMV 动图。",
+    usage="ytpgif [倍速=1.0] （倍速范围：0.1～20.0）",
+    type="application",
+    config=None,
+    homepage=None,
+)
+
+# 参数定义
+BASE_SEGMENT_DURATION = 0.25
+BASE_INTERVAL = 0.25
+MAX_SIZE = 256
+MIN_SPEED = 0.1
+MAX_SPEED = 20.0
+MAX_FRAMES_PER_SEGMENT = 500
+
+# 提示语
+SPEED_TIPS = f"倍速必须是 {MIN_SPEED} 到 {MAX_SPEED} 之间的数字"
+
+
+# 定义命令 + 参数校验
+ytpgif_cmd = on_alconna(
+    Alconna(
+        "ytpgif",
+        Args[
+            "speed?",
+            float,
+            Field(
+                default=1.0,
+                unmatch_tips=lambda x: f"“{x}”不是有效数值。{SPEED_TIPS}",
+            ),
+        ],
+    ),
+    use_cmd_start=True,
+    use_cmd_sep=False,
+    skip_for_unmatch=False,
+)
+
+
+async def get_image_url(event: BaseEvent) -> Optional[str]:
+    """从事件中提取图片 URL，支持直接消息和回复"""
+    msg = event.get_message()
+    for seg in msg:
+        if seg.type == "image" and seg.data.get("url"):
+            return str(seg.data["url"])
+
+    if hasattr(event, "reply") and (reply := event.reply):
+        reply_msg = reply.message
+        for seg in reply_msg:
+            if seg.type == "image" and seg.data.get("url"):
+                return str(seg.data["url"])
+    return None
+
+
+async def download_image(url: str) -> bytes:
+    import httpx
+    async with httpx.AsyncClient() as client:
+        resp = await client.get(url, timeout=10)
+        resp.raise_for_status()
+        return resp.content
+
+
+def resize_frame(frame: Image.Image) -> Image.Image:
+    """缩放图像，保持宽高比，不超过 MAX_SIZE"""
+    w, h = frame.size
+    if w <= MAX_SIZE and h <= MAX_SIZE:
+        return frame
+
+    scale = MAX_SIZE / max(w, h)
+    new_w = int(w * scale)
+    new_h = int(h * scale)
+    return frame.resize((new_w, new_h), Image.Resampling.LANCZOS)
+
+
+@ytpgif_cmd.handle()
+async def handle_ytpgif(event: BaseEvent, speed: float = 1.0):
+    # === 校验 speed 范围 ===
+    if not (MIN_SPEED <= speed <= MAX_SPEED):
+        await ytpgif_cmd.send(
+            await UniMessage.text(f"❌ {SPEED_TIPS}").export()
+        )
+        return
+
+    img_url = await get_image_url(event)
+    if not img_url:
+        await ytpgif_cmd.send(
+            await UniMessage.text(
+                "请发送一张图片或回复一张图片来生成镜像动图。"
+            ).export()
+        )
+        return
+
+    try:
+        image_data = await download_image(img_url)
+    except Exception as e:
+        print(f"[YTPGIF] 下载失败: {e}")
+        await ytpgif_cmd.send(
+            await UniMessage.text("❌ 图片下载失败，请重试。").export()
+        )
+        return
+
+    input_path = output_path = None
+    try:
+        with tempfile.NamedTemporaryFile(delete=False, suffix=".gif") as tmp_in:
+            tmp_in.write(image_data)
+            input_path = tmp_in.name
+
+        with tempfile.NamedTemporaryFile(delete=False, suffix=".gif") as tmp_out:
+            output_path = tmp_out.name
+
+        with Image.open(input_path) as src_img:
+            # === 判断是否为动图 ===
+            try:
+                n_frames = getattr(src_img, "n_frames", 1)
+                is_animated = n_frames > 1
+            except Exception:
+                is_animated = False
+
+            output_frames = []
+            output_durations_ms = []
+
+            if is_animated:
+                # === 动图模式：截取正向 + 镜像两段 ===
+                frames_with_duration = []
+                palette = src_img.getpalette()
+
+                for idx in range(n_frames):
+                    src_img.seek(idx)
+                    frame = src_img.copy()
+                    # 检查是否需要透明通道
+                    has_alpha = (
+                        frame.mode in ("RGBA", "LA")
+                        or (frame.mode == "P" and "transparency" in frame.info)
+                    )
+                    if has_alpha:
+                        frame = frame.convert("RGBA")
+                    else:
+                        frame = frame.convert("RGB")
+                    resized_frame = resize_frame(frame)
+
+                    # 若原图有调色板，尝试保留（可选）
+                    if palette and resized_frame.mode == "P":
+                        try:
+                            resized_frame.putpalette(palette)
+                        except Exception:  # noqa
+                            pass
+
+                    ms = frame.info.get("duration", int(BASE_SEGMENT_DURATION * 1000))
+                    dur_sec = max(0.01, ms / 1000.0)
+                    frames_with_duration.append((resized_frame, dur_sec))
+
+                max_dur = BASE_SEGMENT_DURATION * speed
+                accumulated = 0.0
+                frame_count = 0
+
+                # 正向段
+                for img, dur in frames_with_duration:
+                    if accumulated + dur > max_dur or frame_count >= MAX_FRAMES_PER_SEGMENT:
+                        break
+                    output_frames.append(img)
+                    output_durations_ms.append(int(dur * 1000))
+                    accumulated += dur
+                    frame_count += 1
+
+                if frame_count == 0:
+                    await ytpgif_cmd.send(
+                        await UniMessage.text("动图帧太短，无法生成有效片段。").export()
+                    )
+                    return
+
+                # 镜像段（从头开始）
+                accumulated = 0.0
+                frame_count = 0
+                for img, dur in frames_with_duration:
+                    if accumulated + dur > max_dur or frame_count >= MAX_FRAMES_PER_SEGMENT:
+                        break
+                    flipped = img.transpose(Image.FLIP_LEFT_RIGHT)
+                    output_frames.append(flipped)
+                    output_durations_ms.append(int(dur * 1000))
+                    accumulated += dur
+                    frame_count += 1
+
+            else:
+                # === 静态图模式：制作翻转动画 ===
+                raw_frame = src_img.convert("RGBA")
+                resized_frame = resize_frame(raw_frame)
+
+                interval_sec = max(0.025, min(2.5, BASE_INTERVAL / speed))
+                duration_ms = int(interval_sec * 1000)
+
+                frame1 = resized_frame
+                frame2 = resized_frame.transpose(Image.FLIP_LEFT_RIGHT)
+
+                output_frames = [frame1, frame2]
+                output_durations_ms = [duration_ms, duration_ms]
+
+            if len(output_frames) < 1:
+                await ytpgif_cmd.send(
+                    await UniMessage.text("未能生成任何帧。").export()
+                )
+                return
+
+            # === 🔐 关键修复：防止无透明图的颜色被当成透明 ===
+            need_transparency = False
+            for frame in output_frames:
+                if frame.mode == "RGBA":
+                    alpha_channel = frame.getchannel("A")
+                    if any(pix < 255 for pix in alpha_channel.getdata()):
+                        need_transparency = True
+                        break
+                elif frame.mode == "P" and "transparency" in frame.info:
+                    need_transparency = True
+                    break
+
+            # 如果不需要透明，则统一转为 RGB 避免调色板污染
+            if not need_transparency:
+                output_frames = [f.convert("RGB") for f in output_frames]
+
+            # 构建保存参数
+            save_kwargs = {
+                "save_all": True,
+                "append_images": output_frames[1:],
+                "format": "GIF",
+                "loop": 0,           # 无限循环
+                "duration": output_durations_ms,
+                "disposal": 2,       # 清除到背景色，避免残留
+                "optimize": False,   # 关闭抖动（等效 -dither none）
+            }
+
+            # 只有真正需要透明时才启用 transparency
+            if need_transparency:
+                save_kwargs["transparency"] = 0
+
+            output_frames[0].save(output_path, **save_kwargs)
+
+        # 发送结果
+        with open(output_path, "rb") as f:
+            result_image = UniMessage.image(raw=f.read())
+        await ytpgif_cmd.send(await result_image.export())
+
+    except Exception as e:
+        print(f"[YTPGIF] 处理失败: {e}")
+        await ytpgif_cmd.send(
+            await UniMessage.text("❌ 处理失败，可能是图片格式不支持、文件损坏或过大。").export()
+        )
+    finally:
+        for path in filter(None, [input_path, output_path]):
+            if os.path.exists(path):
+                try:
+                    os.unlink(path)
+                except:  # noqa
+                    pass

poetry.lock

@@ -1727,6 +1727,91 @@ files = [
 [package.dependencies]
 textual = ">=3.7.0,<4.0.0"
 
+[[package]]
+name = "numpy"
+version = "2.2.6"
+description = "Fundamental package for array computing in Python"
+optional = false
+python-versions = ">=3.10"
+groups = ["main"]
+files = [
+    {file = "numpy-2.2.6-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:b412caa66f72040e6d268491a59f2c43bf03eb6c96dd8f0307829feb7fa2b6fb"},
+    {file = "numpy-2.2.6-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:8e41fd67c52b86603a91c1a505ebaef50b3314de0213461c7a6e99c9a3beff90"},
+    {file = "numpy-2.2.6-cp310-cp310-macosx_14_0_arm64.whl", hash = "sha256:37e990a01ae6ec7fe7fa1c26c55ecb672dd98b19c3d0e1d1f326fa13cb38d163"},
+    {file = "numpy-2.2.6-cp310-cp310-macosx_14_0_x86_64.whl", hash = "sha256:5a6429d4be8ca66d889b7cf70f536a397dc45ba6faeb5f8c5427935d9592e9cf"},
+    {file = "numpy-2.2.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:efd28d4e9cd7d7a8d39074a4d44c63eda73401580c5c76acda2ce969e0a38e83"},
+    {file = "numpy-2.2.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fc7b73d02efb0e18c000e9ad8b83480dfcd5dfd11065997ed4c6747470ae8915"},
+    {file = "numpy-2.2.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:74d4531beb257d2c3f4b261bfb0fc09e0f9ebb8842d82a7b4209415896adc680"},
+    {file = "numpy-2.2.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:8fc377d995680230e83241d8a96def29f204b5782f371c532579b4f20607a289"},
+    {file = "numpy-2.2.6-cp310-cp310-win32.whl", hash = "sha256:b093dd74e50a8cba3e873868d9e93a85b78e0daf2e98c6797566ad8044e8363d"},
+    {file = "numpy-2.2.6-cp310-cp310-win_amd64.whl", hash = "sha256:f0fd6321b839904e15c46e0d257fdd101dd7f530fe03fd6359c1ea63738703f3"},
+    {file = "numpy-2.2.6-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f9f1adb22318e121c5c69a09142811a201ef17ab257a1e66ca3025065b7f53ae"},
+    {file = "numpy-2.2.6-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c820a93b0255bc360f53eca31a0e676fd1101f673dda8da93454a12e23fc5f7a"},
+    {file = "numpy-2.2.6-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:3d70692235e759f260c3d837193090014aebdf026dfd167834bcba43e30c2a42"},
+    {file = "numpy-2.2.6-cp311-cp311-macosx_14_0_x86_64.whl", hash = "sha256:481b49095335f8eed42e39e8041327c05b0f6f4780488f61286ed3c01368d491"},
+    {file = "numpy-2.2.6-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:b64d8d4d17135e00c8e346e0a738deb17e754230d7e0810ac5012750bbd85a5a"},
+    {file = "numpy-2.2.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba10f8411898fc418a521833e014a77d3ca01c15b0c6cdcce6a0d2897e6dbbdf"},
+    {file = "numpy-2.2.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:bd48227a919f1bafbdda0583705e547892342c26fb127219d60a5c36882609d1"},
+    {file = "numpy-2.2.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9551a499bf125c1d4f9e250377c1ee2eddd02e01eac6644c080162c0c51778ab"},
+    {file = "numpy-2.2.6-cp311-cp311-win32.whl", hash = "sha256:0678000bb9ac1475cd454c6b8c799206af8107e310843532b04d49649c717a47"},
+    {file = "numpy-2.2.6-cp311-cp311-win_amd64.whl", hash = "sha256:e8213002e427c69c45a52bbd94163084025f533a55a59d6f9c5b820774ef3303"},
+    {file = "numpy-2.2.6-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:41c5a21f4a04fa86436124d388f6ed60a9343a6f767fced1a8a71c3fbca038ff"},
+    {file = "numpy-2.2.6-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:de749064336d37e340f640b05f24e9e3dd678c57318c7289d222a8a2f543e90c"},
+    {file = "numpy-2.2.6-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:894b3a42502226a1cac872f840030665f33326fc3dac8e57c607905773cdcde3"},
+    {file = "numpy-2.2.6-cp312-cp312-macosx_14_0_x86_64.whl", hash = "sha256:71594f7c51a18e728451bb50cc60a3ce4e6538822731b2933209a1f3614e9282"},
+    {file = "numpy-2.2.6-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f2618db89be1b4e05f7a1a847a9c1c0abd63e63a1607d892dd54668dd92faf87"},
+    {file = "numpy-2.2.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd83c01228a688733f1ded5201c678f0c53ecc1006ffbc404db9f7a899ac6249"},
+    {file = "numpy-2.2.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:37c0ca431f82cd5fa716eca9506aefcabc247fb27ba69c5062a6d3ade8cf8f49"},
+    {file = "numpy-2.2.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fe27749d33bb772c80dcd84ae7e8df2adc920ae8297400dabec45f0dedb3f6de"},
+    {file = "numpy-2.2.6-cp312-cp312-win32.whl", hash = "sha256:4eeaae00d789f66c7a25ac5f34b71a7035bb474e679f410e5e1a94deb24cf2d4"},
+    {file = "numpy-2.2.6-cp312-cp312-win_amd64.whl", hash = "sha256:c1f9540be57940698ed329904db803cf7a402f3fc200bfe599334c9bd84a40b2"},
+    {file = "numpy-2.2.6-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0811bb762109d9708cca4d0b13c4f67146e3c3b7cf8d34018c722adb2d957c84"},
+    {file = "numpy-2.2.6-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:287cc3162b6f01463ccd86be154f284d0893d2b3ed7292439ea97eafa8170e0b"},
+    {file = "numpy-2.2.6-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:f1372f041402e37e5e633e586f62aa53de2eac8d98cbfb822806ce4bbefcb74d"},
+    {file = "numpy-2.2.6-cp313-cp313-macosx_14_0_x86_64.whl", hash = "sha256:55a4d33fa519660d69614a9fad433be87e5252f4b03850642f88993f7b2ca566"},
+    {file = "numpy-2.2.6-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f92729c95468a2f4f15e9bb94c432a9229d0d50de67304399627a943201baa2f"},
+    {file = "numpy-2.2.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1bc23a79bfabc5d056d106f9befb8d50c31ced2fbc70eedb8155aec74a45798f"},
+    {file = "numpy-2.2.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:e3143e4451880bed956e706a3220b4e5cf6172ef05fcc397f6f36a550b1dd868"},
+    {file = "numpy-2.2.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:b4f13750ce79751586ae2eb824ba7e1e8dba64784086c98cdbbcc6a42112ce0d"},
+    {file = "numpy-2.2.6-cp313-cp313-win32.whl", hash = "sha256:5beb72339d9d4fa36522fc63802f469b13cdbe4fdab4a288f0c441b74272ebfd"},
+    {file = "numpy-2.2.6-cp313-cp313-win_amd64.whl", hash = "sha256:b0544343a702fa80c95ad5d3d608ea3599dd54d4632df855e4c8d24eb6ecfa1c"},
+    {file = "numpy-2.2.6-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:0bca768cd85ae743b2affdc762d617eddf3bcf8724435498a1e80132d04879e6"},
+    {file = "numpy-2.2.6-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:fc0c5673685c508a142ca65209b4e79ed6740a4ed6b2267dbba90f34b0b3cfda"},
+    {file = "numpy-2.2.6-cp313-cp313t-macosx_14_0_arm64.whl", hash = "sha256:5bd4fc3ac8926b3819797a7c0e2631eb889b4118a9898c84f585a54d475b7e40"},
+    {file = "numpy-2.2.6-cp313-cp313t-macosx_14_0_x86_64.whl", hash = "sha256:fee4236c876c4e8369388054d02d0e9bb84821feb1a64dd59e137e6511a551f8"},
+    {file = "numpy-2.2.6-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e1dda9c7e08dc141e0247a5b8f49cf05984955246a327d4c48bda16821947b2f"},
+    {file = "numpy-2.2.6-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f447e6acb680fd307f40d3da4852208af94afdfab89cf850986c3ca00562f4fa"},
+    {file = "numpy-2.2.6-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:389d771b1623ec92636b0786bc4ae56abafad4a4c513d36a55dce14bd9ce8571"},
+    {file = "numpy-2.2.6-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8e9ace4a37db23421249ed236fdcdd457d671e25146786dfc96835cd951aa7c1"},
+    {file = "numpy-2.2.6-cp313-cp313t-win32.whl", hash = "sha256:038613e9fb8c72b0a41f025a7e4c3f0b7a1b5d768ece4796b674c8f3fe13efff"},
+    {file = "numpy-2.2.6-cp313-cp313t-win_amd64.whl", hash = "sha256:6031dd6dfecc0cf9f668681a37648373bddd6421fff6c66ec1624eed0180ee06"},
+    {file = "numpy-2.2.6-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:0b605b275d7bd0c640cad4e5d30fa701a8d59302e127e5f79138ad62762c3e3d"},
+    {file = "numpy-2.2.6-pp310-pypy310_pp73-macosx_14_0_x86_64.whl", hash = "sha256:7befc596a7dc9da8a337f79802ee8adb30a552a94f792b9c9d18c840055907db"},
+    {file = "numpy-2.2.6-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ce47521a4754c8f4593837384bd3424880629f718d87c5d44f8ed763edd63543"},
+    {file = "numpy-2.2.6-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:d042d24c90c41b54fd506da306759e06e568864df8ec17ccc17e9e884634fd00"},
+    {file = "numpy-2.2.6.tar.gz", hash = "sha256:e29554e2bef54a90aa5cc07da6ce955accb83f21ab5de01a62c8478897b264fd"},
+]
+
+[[package]]
+name = "opencv-python-headless"
+version = "4.12.0.88"
+description = "Wrapper package for OpenCV python bindings."
+optional = false
+python-versions = ">=3.6"
+groups = ["main"]
+files = [
+    {file = "opencv-python-headless-4.12.0.88.tar.gz", hash = "sha256:cfdc017ddf2e59b6c2f53bc12d74b6b0be7ded4ec59083ea70763921af2b6c09"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-macosx_13_0_arm64.whl", hash = "sha256:1e58d664809b3350c1123484dd441e1667cd7bed3086db1b9ea1b6f6cb20b50e"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-macosx_13_0_x86_64.whl", hash = "sha256:365bb2e486b50feffc2d07a405b953a8f3e8eaa63865bc650034e5c71e7a5154"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:aeb4b13ecb8b4a0beb2668ea07928160ea7c2cd2d9b5ef571bbee6bafe9cc8d0"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:236c8df54a90f4d02076e6f9c1cc763d794542e886c576a6fee46ec8ff75a7a9"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-win32.whl", hash = "sha256:fde2cf5c51e4def5f2132d78e0c08f9c14783cd67356922182c6845b9af87dbd"},
+    {file = "opencv_python_headless-4.12.0.88-cp37-abi3-win_amd64.whl", hash = "sha256:86b413bdd6c6bf497832e346cd5371995de148e579b9774f8eba686dee3f5528"},
+]
+
+[package.dependencies]
+numpy = {version = ">=2,<2.3.0", markers = "python_version >= \"3.9\""}
+
 [[package]]
 name = "pillow"
 version = "11.3.0"
@@ -3077,4 +3162,4 @@ type = ["pytest-mypy"]
 [metadata]
 lock-version = "2.1"
 python-versions = ">=3.12,<4.0"
-content-hash = "ca1f92dc64b99018d4b1043c984b1e52d325af213e3af77370855a6b00bd77e0"
+content-hash = "673703a789248d0f7369999c364352eb12f8bb5830a8b4b6918f8bab6425a763"

pyproject.toml

@@ -20,6 +20,7 @@ dependencies = [
     "lxml (>=6.0.2,<7.0.0)",
     "pillow (>=11.3.0,<12.0.0)",
     "imagetext-py (>=2.2.0,<3.0.0)",
+    "opencv-python-headless (>=4.12.0.88,<5.0.0.0)",
 ]
 
 

scripts/test_plugin_load.py

@@ -0,0 +1,21 @@
+from pathlib import Path
+
+import nonebot
+from loguru import logger
+
+nonebot.init()
+nonebot.load_plugins("konabot/plugins")
+
+plugins = nonebot.get_loaded_plugins()
+len_requires = len(
+    [f for f in (
+        Path(__file__).parent.parent / "konabot" / "plugins"
+    ).iterdir() if f.is_dir() and (f / "__init__.py").exists()]
+)
+
+plugins = [p for p in plugins if p.module.__name__.startswith("konabot.plugins")]
+
+logger.info(f"已经加载的插件数量 {len(plugins)}")
+logger.info(f"期待加载的插件数量 {len_requires}")
+
+assert len(plugins) == len_requires