优化管理员帮助，超级用户帮助图片,重新移植gamedraw，修复pil帮助私聊时无法生成

2026-09-30 09:10:01 +08:00 · 2022-12-24 00:16:17 +08:00
parent 0dc11b7edb
commit b25b9ca928
33 changed files with 869 additions and 695 deletions
@@ -3,7 +3,7 @@ from nonebot.typing import T_State
 from nonebot.adapters import Bot
 from nonebot.adapters.onebot.v11 import GroupMessageEvent
 from utils.message_builder import image
-from .data_source import create_help_image, admin_help_image
+from .data_source import create_help_image, ADMIN_HELP_IMAGE


 __zx_plugin_name__ = '管理帮助 [Admin]'
@@ -16,12 +16,12 @@ __plugin_settings__ = {

 admin_help = on_command("管理员帮助", aliases={"管理帮助"}, priority=5, block=True)

-if admin_help_image.exists():
-    admin_help_image.unlink()
+if ADMIN_HELP_IMAGE.exists():
+    ADMIN_HELP_IMAGE.unlink()


@admin_help.handle()
 async def _(bot: Bot, event: GroupMessageEvent, state: T_State):
-    if not admin_help_image.exists():
+    if not ADMIN_HELP_IMAGE.exists():
        await create_help_image()
-    await admin_help.send(image('admin_help_img.png'))
+    await admin_help.send(image(ADMIN_HELP_IMAGE))
@@ -1,25 +1,25 @@
-from utils.image_utils import BuildImage
-from configs.path_config import IMAGE_PATH
-from services.log import logger
-from utils.utils import get_matchers
-from utils.manager import group_manager
-from nonebot.adapters.onebot.v11 import Bot
-from nonebot import Driver
 import nonebot
-
+from configs.path_config import IMAGE_PATH
+from nonebot import Driver
+from services.log import logger
+from utils.image_template import help_template
+from utils.image_utils import (BuildImage, build_sort_image, group_image,
+                               text2image)
+from utils.manager import group_manager, plugin_data_manager
+from utils.manager.models import PluginType

 driver: Driver = nonebot.get_driver()

 background = IMAGE_PATH / "background" / "0.png"

-admin_help_image = IMAGE_PATH / 'admin_help_img.png'
+ADMIN_HELP_IMAGE = IMAGE_PATH / "admin_help_img.png"


@driver.on_bot_connect
 async def init_task():
    if not group_manager.get_task_data():
        group_manager.load_task()
-        logger.info(f'已成功加载 {len(group_manager.get_task_data())} 个被动技能.')
+        logger.info(f"已成功加载 {len(group_manager.get_task_data())} 个被动技能.")


 async def create_help_image():
@@ -33,58 +33,55 @@ async def _create_help_image():
    """
    创建管理员帮助图片
    """
-    _matchers = get_matchers()
-    _plugin_name_list = []
-    width = 0
-    _plugin_level = {}
-    for matcher in _matchers:
-        _plugin = nonebot.plugin.get_plugin(matcher.plugin_name)
-        _module = _plugin.module
+    if ADMIN_HELP_IMAGE.exists():
+        return
+    plugin_data_ = plugin_data_manager.get_data()
+    image_list = []
+    task_list = []
+    for plugin_data in [plugin_data_[x] for x in plugin_data_]:
        try:
-            plugin_name = _module.__getattribute__("__zx_plugin_name__")
-        except AttributeError:
-            continue
-        try:
-            if (
-                "[admin]" in plugin_name.lower()
-                and plugin_name not in _plugin_name_list
-                and plugin_name != "管理帮助 [Admin]"
-            ):
-                _plugin_name_list.append(plugin_name)
-                plugin_settings = _module.__getattribute__("__plugin_settings__")
-                plugin_des = _module.__getattribute__("__plugin_des__")
-                plugin_cmd = _module.__getattribute__("__plugin_cmd__")
-                plugin_cmd = [x for x in plugin_cmd if "[_superuser]" not in x]
-                admin_level = int(plugin_settings["admin_level"])
-                if _plugin_level.get(admin_level):
-                    _plugin_level[admin_level].append(
-                        f"[{admin_level}] {plugin_des} -> " + " / ".join(plugin_cmd)
-                    )
-                else:
-                    _plugin_level[admin_level] = [
-                        f"[{admin_level}] {plugin_des} -> " + " / ".join(plugin_cmd)
-                    ]
-                x = len(f"[{admin_level}] {plugin_des} -> " + " / ".join(plugin_cmd)) * 23
-                width = width if width > x else x
-        except AttributeError:
-            logger.warning(f"获取管理插件 {matcher.plugin_name}: {plugin_name} 设置失败...")
-    help_str = "*  注: ‘*’ 代表可有多个相同参数 ‘?’ 代表可省略该参数  *\n\n" \
-               "[权限等级] 管理员帮助：\n\n"
-    x = list(_plugin_level.keys())
-    x.sort()
-    for level in x:
-        for help_ in _plugin_level[level]:
-            help_str += f"\t{help_}\n\n"
-    help_str += '-----[被动技能开关]-----\n\n'
-    task_data = group_manager.get_task_data()
-    for i, x in enumerate(task_data.keys()):
-        help_str += f'{i+1}.开启/关闭{task_data[x]}\n\n'
-    height = len(help_str.split("\n")) * 33
-    A = BuildImage(width, height, font_size=24)
-    _background = BuildImage(width, height, background=background)
-    await A.apaste(_background, alpha=True)
-    await A.atext((150, 110), help_str)
-    await A.asave(admin_help_image)
-    logger.info(f'已成功加载 {len(_plugin_name_list)} 条管理员命令')
-
-
+            usage = None
+            if plugin_data.plugin_type == PluginType.ADMIN and plugin_data.usage:
+                usage = await text2image(
+                    plugin_data.usage, padding=5, color=(204, 196, 151)
+                )
+            if usage:
+                await usage.acircle_corner()
+                level = 5
+                if plugin_data.plugin_setting:
+                    level = plugin_data.plugin_setting.level or level
+                image = await help_template(plugin_data.name + f"[{level}]", usage)
+                image_list.append(image)
+            if plugin_data.task:
+                for x in plugin_data.task.keys():
+                    task_list.append(plugin_data.task[x])
+        except Exception as e:
+            logger.warning(
+                f"获取群管理员插件 {plugin_data.model}: {plugin_data.name} 设置失败... {type(e)}：{e}"
+            )
+    task_str = "\n".join(task_list)
+    task_str = "通过 开启/关闭 来控制群被动\n----------\n" + task_str
+    task_image = await text2image(task_str, padding=5, color=(204, 196, 151))
+    task_image = await help_template("被动任务", task_image)
+    image_list.append(task_image)
+    image_group, _ = group_image(image_list)
+    A = await build_sort_image(image_group, color="#f9f6f2", padding_top=180)
+    await A.apaste(
+        BuildImage(0, 0, font="CJGaoDeGuo.otf", plain_text="群管理员帮助", font_size=50),
+        (50, 30),
+        True,
+    )
+    await A.apaste(
+        BuildImage(
+            0,
+            0,
+            font="CJGaoDeGuo.otf",
+            plain_text="注: ‘*’ 代表可有多个相同参数 ‘?’ 代表可省略该参数",
+            font_size=30,
+            font_color="red",
+        ),
+        (50, 90),
+        True,
+    )
+    await A.asave(ADMIN_HELP_IMAGE)
+    logger.info(f"已成功加载 {len(image_list)} 条管理员命令")
@@ -17,17 +17,21 @@ background = IMAGE_PATH / "background" / "0.png"

 async def create_help_img(group_id: Optional[int]):
    """
-    生成帮助图片
-    :param group_id: 群号
+    说明:
+        生成帮助图片
+    参数:
+        :param group_id: 群号
    """
    await HelpImageBuild().build_image(group_id)


 def get_plugin_help(msg: str, is_super: bool = False) -> Optional[str]:
    """
-    获取功能的帮助信息
-    :param msg: 功能cmd
-    :param is_super: 是否为超级用户
+    说明:
+        获取功能的帮助信息
+    参数:
+        :param msg: 功能cmd
+        :param is_super: 是否为超级用户
    """
    module = plugins2settings_manager.get_plugin_module(
        msg
@@ -1,17 +1,15 @@
-from typing import List, Tuple, Dict, Optional
-from nonebot_plugin_htmlrender import template_to_pic
-
-from ._config import Item
-from configs.path_config import IMAGE_PATH, TEMPLATE_PATH, DATA_PATH
-from utils.decorator import Singleton
-from utils.image_utils import BuildImage
-from configs.config import Config
 import os
 import random
+from typing import Dict, List, Optional

-from utils.manager import plugin_data_manager, group_manager
+from configs.config import Config
+from configs.path_config import DATA_PATH, IMAGE_PATH, TEMPLATE_PATH
+from utils.decorator import Singleton
+from utils.image_utils import BuildImage, build_sort_image, group_image
+from utils.manager import group_manager, plugin_data_manager
 from utils.manager.models import PluginData, PluginType

+from ._config import Item

 GROUP_HELP_PATH = DATA_PATH / "group_help"
 GROUP_HELP_PATH.mkdir(exist_ok=True, parents=True)
@@ -21,126 +19,27 @@ for x in os.listdir(GROUP_HELP_PATH):

 BACKGROUND_PATH = IMAGE_PATH / "background" / "help" / "simple_help"

-LOGO_PATH = TEMPLATE_PATH / 'menu' / 'res' / 'logo'
-
-
-async def build_help_image(image_group: List[List[BuildImage]], h: int):
-    bk = None
-    random_bk = os.listdir(BACKGROUND_PATH)
-    if random_bk:
-        bk = random.choice(random_bk)
-    A = BuildImage(
-        h,
-        h,
-        font_size=24,
-        color="#FFEFD5",
-        background=(BACKGROUND_PATH / bk) if bk else None,
-    )
-    A.filter("GaussianBlur", 5)
-    curr_w = 50
-    for ig in image_group:
-        curr_h = 180
-        for img in ig:
-            await A.apaste(img, (curr_w, curr_h), True)
-            curr_h += img.h + 10
-        curr_w += max([x.w for x in ig]) + 30
-    return A
-
-
-def group_image(image_list: List[BuildImage]) -> Tuple[List[List[BuildImage]], int]:
-    """
-    说明:
-        根据图片大小进行分组
-    参数:
-        :param image_list: 排序图片列表
-    """
-    image_list.sort(key=lambda x: x.h, reverse=True)
-    max_image = max(image_list, key=lambda x: x.h)
-
-    image_list.remove(max_image)
-    max_h = max_image.h
-    total_w = 0
-
-    # 图片分组
-    image_group = [[max_image]]
-    is_use = []
-    surplus_list = image_list[:]
-
-    for image in image_list:
-        if image.uid not in is_use:
-            group = [image]
-            is_use.append(image.uid)
-            curr_h = image.h
-            while True:
-                surplus_list = [x for x in surplus_list if x.uid not in is_use]
-                for tmp in surplus_list:
-                    temp_h = curr_h + tmp.h + 10
-                    if temp_h < max_h or abs(max_h - temp_h) < 100:
-                        curr_h += tmp.h + 15
-                        is_use.append(tmp.uid)
-                        group.append(tmp)
-                        break
-                else:
-                    break
-            total_w += max([x.w for x in group]) + 15
-            image_group.append(group)
-    while surplus_list:
-        surplus_list = [x for x in surplus_list if x.uid not in is_use]
-        if not surplus_list:
-            break
-        surplus_list.sort(key=lambda x: x.h, reverse=True)
-        for img in surplus_list:
-            if img.uid not in is_use:
-                _w = 0
-                index = -1
-                for i, ig in enumerate(image_group):
-                    if s := sum([x.h for x in ig]) > _w:
-                        _w = s
-                        index = i
-                if index != -1:
-                    image_group[index].append(img)
-                    is_use.append(img.uid)
-    max_h = 0
-    max_w = 0
-    for i, ig in enumerate(image_group):
-        if (_h := sum([x.h + 15 for x in ig])) > max_h:
-            max_h = _h
-        max_w += max([x.w for x in ig]) + 30
-    is_use.clear()
-    while abs(max_h - max_w) > 200 and len(image_group) - 1 >= len(image_group[-1]):
-        for img in image_group[-1]:
-            _min_h = 0
-            _min_index = -1
-            for i, ig in enumerate(image_group):
-                if i not in is_use and (_h := sum([x.h for x in ig]) + img.h) > _min_h:
-                    _min_h = _h
-                    _min_index = i
-            is_use.append(_min_index)
-            image_group[_min_index].append(img)
-        max_w -= max([x.w for x in image_group[-1]])
-        image_group.pop(-1)
-    return image_group, max(max_h + 250, max_w + 70)
+LOGO_PATH = TEMPLATE_PATH / "menu" / "res" / "logo"


@Singleton
 class HelpImageBuild:
-
    def __init__(self):
        self._data: Dict[str, PluginData] = plugin_data_manager.get_data()
        self._sort_data: Dict[str, List[PluginData]] = {}
        self._image_list = []
        self.icon2str = {
-            'normal': 'fa fa-cog',
-            '原神相关': 'fa fa-circle-o',
-            '常规插件': 'fa fa-cubes',
-            '联系管理员': 'fa fa-envelope-o',
-            '抽卡相关': 'fa fa-credit-card-alt',
-            '来点好康的': 'fa fa-picture-o',
-            '数据统计': 'fa fa-bar-chart',
-            '一些工具': 'fa fa-shopping-cart',
-            '商店': 'fa fa-shopping-cart',
-            '其它': 'fa fa-tags',
-            '群内小游戏': 'fa fa-gamepad',
+            "normal": "fa fa-cog",
+            "原神相关": "fa fa-circle-o",
+            "常规插件": "fa fa-cubes",
+            "联系管理员": "fa fa-envelope-o",
+            "抽卡相关": "fa fa-credit-card-alt",
+            "来点好康的": "fa fa-picture-o",
+            "数据统计": "fa fa-bar-chart",
+            "一些工具": "fa fa-shopping-cart",
+            "商店": "fa fa-shopping-cart",
+            "其它": "fa fa-tags",
+            "群内小游戏": "fa fa-gamepad",
        }

    def sort_type(self):
@@ -162,28 +61,36 @@ class HelpImageBuild:
        else:
            help_image = IMAGE_PATH / f"simple_help.png"
        build_type = Config.get_config("help", "TYPE")
-        if build_type == 'HTML':
+        if build_type == "HTML":
            byt = await self.build_html_image(group_id)
-            with open(help_image, 'wb') as f:
+            with open(help_image, "wb") as f:
                f.write(byt)
        else:
            img = await self.build_pil_image(group_id)
            img.save(help_image)

    async def build_html_image(self, group_id: Optional[int]) -> bytes:
+        from nonebot_plugin_htmlrender import template_to_pic
        self.sort_type()
        classify = {}
        for menu in self._sort_data:
            for plugin in self._sort_data[menu]:
                sta = 0
                if not plugin.plugin_status.status:
-                    if group_id and plugin.plugin_status.block_type in ['all', 'group']:
+                    if group_id and plugin.plugin_status.block_type in ["all", "group"]:
                        sta = 2
-                    if not group_id and plugin.plugin_status.block_type in ['all', 'private']:
+                    if not group_id and plugin.plugin_status.block_type in [
+                        "all",
+                        "private",
+                    ]:
                        sta = 2
-                if group_id and not group_manager.get_plugin_super_status(plugin.model, group_id):
+                if group_id and not group_manager.get_plugin_super_status(
+                    plugin.model, group_id
+                ):
                    sta = 2
-                if group_id and not group_manager.get_plugin_status(plugin.model, group_id):
+                if group_id and not group_manager.get_plugin_status(
+                    plugin.model, group_id
+                ):
                    sta = 1
                if classify.get(menu):
                    classify[menu].append(Item(plugin_name=plugin.name, sta=sta))
@@ -197,11 +104,14 @@ class HelpImageBuild:
            if plu in self.icon2str.keys():
                icon = self.icon2str[plu]
            else:
-                icon = 'fa fa-pencil-square-o'
+                icon = "fa fa-pencil-square-o"
            logo = LOGO_PATH / random.choice(os.listdir(LOGO_PATH))
-            # print(str(logo.absolute()))
-            data = {'name': plu if plu != 'normal' else '功能', 'items': classify[plu], 'icon': icon,
-                    'logo': str(logo.absolute())}
+            data = {
+                "name": plu if plu != "normal" else "功能",
+                "items": classify[plu],
+                "icon": icon,
+                "logo": str(logo.absolute()),
+            }
            if len(classify[plu]) > max_len:
                max_len = len(classify[plu])
                flag_index = index
@@ -210,8 +120,8 @@ class HelpImageBuild:
        del plugin_list[flag_index]
        plugin_list.insert(0, max_data)
        pic = await template_to_pic(
-            template_path=str((TEMPLATE_PATH / 'menu').absolute()),
-            template_name='zhenxun_menu.html',
+            template_path=str((TEMPLATE_PATH / "menu").absolute()),
+            template_name="zhenxun_menu.html",
            templates={"plugin_list": plugin_list},
            pages={
                "viewport": {"width": 1903, "height": 975},
@@ -270,7 +180,9 @@ class HelpImageBuild:
                if (
                    not plugin_data.plugin_status.status
                    and plugin_data.plugin_status.block_type in ["group", "all"]
-                ) or not group_manager.get_plugin_super_status(plugin_data.model, group_id):
+                ) or (group_id and not group_manager.get_plugin_super_status(
+                    plugin_data.model, group_id
+                )):
                    w = curr_h + int(B.getsize(plugin_data.name)[1] / 2) + 2
                    pos = (
                        7,
@@ -305,7 +217,12 @@ class HelpImageBuild:
            # await bk.acircle_corner(point_list=['lt', 'rt'])
            self._image_list.append(bk)
        image_group, h = group_image(self._image_list)
-        B = await build_help_image(image_group, h)
+        B = await build_sort_image(
+            image_group,
+            h,
+            background_path=BACKGROUND_PATH,
+            background_handle=lambda image: image.filter("GaussianBlur", 5),
+        )
        w = 10
        h = 10
        for msg in [
@@ -2,23 +2,13 @@ import random
 from types import ModuleType
 from typing import Any

-from services import logger
-from utils.manager import (
-    plugin_data_manager,
-    plugins2settings_manager,
-    plugins2cd_manager,
-    plugins2block_manager,
-    plugins2count_manager, plugins_manager,
-)
 from configs.config import Config
-from utils.manager.models import (
-    PluginType,
-    PluginSetting,
-    PluginCd,
-    PluginData,
-    PluginBlock,
-    PluginCount, Plugin,
-)
+from services import logger
+from utils.manager import (plugin_data_manager, plugins2block_manager,
+                           plugins2cd_manager, plugins2count_manager,
+                           plugins2settings_manager, plugins_manager)
+from utils.manager.models import (Plugin, PluginBlock, PluginCd, PluginCount,
+                                  PluginData, PluginSetting, PluginType)
 from utils.utils import get_matchers


@@ -31,9 +21,7 @@ def get_attr(module: ModuleType, name: str, default: Any = None) -> Any:
        :param name: name
        :param default: default
    """
-    if hasattr(module, name):
-        return getattr(module, name)
-    return default
+    return getattr(module, name) if hasattr(module, name) else default


 def init_plugin_info():
@@ -42,6 +30,7 @@ def init_plugin_info():
        try:
            plugin = matcher.plugin
            metadata = plugin.metadata
+            extra = metadata.extra if metadata else {}
            if hasattr(plugin, "module"):
                module = plugin.module
                plugin_model = matcher.plugin_name
@@ -52,13 +41,13 @@ def init_plugin_info():
                )
                if "[Admin]" in plugin_name:
                    plugin_type = PluginType.ADMIN
-                    plugin_name = plugin_name.replace("[Admin]", "")
+                    plugin_name = plugin_name.replace("[Admin]", "").strip()
                elif "[Hidden]" in plugin_name:
                    plugin_type = PluginType.HIDDEN
-                    plugin_name = plugin_name.replace("[Hidden]", "")
+                    plugin_name = plugin_name.replace("[Hidden]", "").strip()
                elif "[Superuser]" in plugin_name:
                    plugin_type = PluginType.SUPERUSER
-                    plugin_name = plugin_name.replace("[Superuser]", "")
+                    plugin_name = plugin_name.replace("[Superuser]", "").strip()
                else:
                    plugin_type = PluginType.NORMAL
                plugin_usage = (
@@ -76,9 +65,14 @@ def init_plugin_info():
                if plugin_setting:
                    plugin_setting = PluginSetting(**plugin_setting)
                    plugin_setting.plugin_type = menu_type
+                plugin_superuser_usage = get_attr(module, "__plugin_super_usage__")
                plugin_task = get_attr(module, "__plugin_task__")
-                plugin_version = get_attr(module, "__plugin_version__")
-                plugin_author = get_attr(module, "__plugin_author__")
+                plugin_version = extra.get("__plugin_version__") or get_attr(
+                    module, "__plugin_version__"
+                )
+                plugin_author = extra.get("__plugin_author__") or get_attr(
+                    module, "__plugin_author__"
+                )
                plugin_cd = get_attr(module, "__plugin_cd_limit__")
                if plugin_cd:
                    plugin_cd = PluginCd(**plugin_cd)
@@ -102,9 +96,7 @@ def init_plugin_info():
                    plugin_configs = plugin_cfg
                plugin_status = plugins_manager.get(plugin_model)
                if not plugin_status:
-                    plugin_status = Plugin(
-                        plugin_name=plugin_model
-                    )
+                    plugin_status = Plugin(plugin_name=plugin_model)
                plugin_status.author = plugin_author
                plugin_status.version = plugin_version
                plugin_data = PluginData(
@@ -112,6 +104,7 @@ def init_plugin_info():
                    name=plugin_name.strip(),
                    plugin_type=plugin_type,
                    usage=plugin_usage,
+                    superuser_usage=plugin_superuser_usage,
                    des=plugin_des,
                    task=plugin_task,
                    menu_type=menu_type,
@@ -121,7 +114,7 @@ def init_plugin_info():
                    plugin_count=plugin_count,
                    plugin_resources=plugin_resources,
                    plugin_configs=plugin_configs,
-                    plugin_status=plugin_status
+                    plugin_status=plugin_status,
                )
                plugin_data_manager.add_plugin_info(plugin_data)
        except Exception as e:
@@ -1,18 +1,15 @@
 from nonebot import on_command
 from nonebot.permission import SUPERUSER
 from nonebot.rule import to_me
-from configs.path_config import IMAGE_PATH
 from utils.message_builder import image
-from .data_source import create_help_image
+from .data_source import create_help_image, SUPERUSER_HELP_IMAGE


 __zx_plugin_name__ = '超级用户帮助 [Superuser]'


-superuser_help_image = IMAGE_PATH / 'superuser_help.png'
-
-if superuser_help_image.exists():
-    superuser_help_image.unlink()
+if SUPERUSER_HELP_IMAGE.exists():
+    SUPERUSER_HELP_IMAGE.unlink()

 super_help = on_command(
    "超级用户帮助", rule=to_me(), priority=1, permission=SUPERUSER, block=True
@@ -21,7 +18,7 @@ super_help = on_command(

@super_help.handle()
 async def _():
-    if not superuser_help_image.exists():
+    if not SUPERUSER_HELP_IMAGE.exists():
        await create_help_image()
-    x = image(superuser_help_image)
+    x = image(SUPERUSER_HELP_IMAGE)
    await super_help.finish(x)
@@ -1,79 +1,84 @@
-from utils.image_utils import BuildImage
-from configs.path_config import IMAGE_PATH
-from services.log import logger
-from utils.utils import get_matchers
-from nonebot.adapters.onebot.v11 import Bot
-from nonebot import Driver
-import asyncio
-import nonebot

+import nonebot
+from configs.path_config import IMAGE_PATH
+from nonebot import Driver
+from services.log import logger
+from utils.image_template import help_template
+from utils.image_utils import (BuildImage, build_sort_image, group_image,
+                               text2image)
+from utils.manager import plugin_data_manager
+from utils.manager.models import PluginType

 driver: Driver = nonebot.get_driver()

-background = IMAGE_PATH / "background" / "0.png"
-
-superuser_help_image = IMAGE_PATH / "superuser_help.png"
+SUPERUSER_HELP_IMAGE = IMAGE_PATH / "superuser_help.png"


@driver.on_bot_connect
-async def create_help_image(bot: Bot = None):
+async def create_help_image():
    """
    创建超级用户帮助图片
    """
-    await asyncio.get_event_loop().run_in_executor(None, _create_help_image)
-
-
-def _create_help_image():
-    """
-    创建管理员帮助图片
-    """
-    _matchers = get_matchers()
-    _plugin_name_list = []
-    width = 0
-    help_str = "超级用户帮助\n\n*  注: ‘*’ 代表可有多个相同参数 ‘?’ 代表可省略该参数  *\n\n"
-    tmp_img = BuildImage(0, 0, plain_text='1', font_size=24)
-    for matcher in _matchers:
-        plugin_name = ""
+    if SUPERUSER_HELP_IMAGE.exists():
+        return
+    plugin_data_ = plugin_data_manager.get_data()
+    image_list = []
+    task_list = []
+    for plugin_data in [
+        plugin_data_[x]
+        for x in plugin_data_
+        if plugin_data_[x].name != "超级用户帮助 [Superuser]"
+    ]:
        try:
-            _plugin = nonebot.plugin.get_plugin(matcher.plugin_name)
-            _module = _plugin.module
-            try:
-                plugin_name = _module.__getattribute__("__zx_plugin_name__")
-            except AttributeError:
-                continue
-            is_superuser_usage = False
-            try:
-                _ = _module.__getattribute__("__plugin_superuser_usage__")
-                is_superuser_usage = True
-            except AttributeError:
-                pass
-            if (
-                ("[superuser]" in plugin_name.lower() or is_superuser_usage)
-                and plugin_name != "超级用户帮助 [Superuser]"
-                and plugin_name not in _plugin_name_list
-                and "[hidden]" not in plugin_name.lower()
-            ):
-                _plugin_name_list.append(plugin_name)
-                try:
-                    plugin_des = _module.__getattribute__("__plugin_des__")
-                except AttributeError:
-                    plugin_des = '_'
-                plugin_cmd = _module.__getattribute__("__plugin_cmd__")
-                if is_superuser_usage:
-                    plugin_cmd = [x for x in plugin_cmd if "[_superuser]" in x]
-                plugin_cmd = " / ".join(plugin_cmd).replace('[_superuser]', '').strip()
-                help_str += f"{plugin_des} -> {plugin_cmd}\n\n"
-                x = tmp_img.getsize(f"{plugin_des} -> {plugin_cmd}")[0]
-                width = width if width > x else x
+            if plugin_data.plugin_type in [PluginType.SUPERUSER, PluginType.ADMIN]:
+                usage = None
+                if (
+                    plugin_data.plugin_type == PluginType.SUPERUSER
+                    and plugin_data.usage
+                ):
+                    usage = await text2image(
+                        plugin_data.usage, padding=5, color=(204, 196, 151)
+                    )
+                if plugin_data.superuser_usage:
+                    usage = await text2image(
+                        plugin_data.superuser_usage, padding=5, color=(204, 196, 151)
+                    )
+                if usage:
+                    await usage.acircle_corner()
+                    image = await help_template(plugin_data.name, usage)
+                    image_list.append(image)
+            if plugin_data.task:
+                for x in plugin_data.task.keys():
+                    task_list.append(plugin_data.task[x])
        except Exception as e:
            logger.warning(
-                f"获取超级用户插件 {matcher.plugin_name}: {plugin_name} 设置失败... {type(e)}：{e}"
+                f"获取超级用户插件 {plugin_data.model}: {plugin_data.name} 设置失败... {type(e)}：{e}"
            )
-    height = len(help_str.split("\n")) * 33
-    width += 500
-    A = BuildImage(width, height, font_size=24)
-    _background = BuildImage(width, height, background=background)
-    A.text((300, 140), help_str)
-    A.paste(_background, alpha=True)
-    A.save(superuser_help_image)
-    logger.info(f"已成功加载 {len(_plugin_name_list)} 条超级用户命令")
+    task_str = "\n".join(task_list)
+    task_str = "通过 开启/关闭 来控制全局被动\n----------\n" + task_str
+    task_image = await text2image(
+        task_str, padding=5, color=(204, 196, 151)
+    )
+    task_image = await help_template("被动任务", task_image)
+    image_list.append(task_image)
+    image_group, _ = group_image(image_list)
+    A = await build_sort_image(image_group, color="#f9f6f2", padding_top=180)
+    await A.apaste(
+        BuildImage(0, 0, font="CJGaoDeGuo.otf", plain_text="超级用户帮助", font_size=50),
+        (50, 30),
+        True,
+    )
+    await A.apaste(
+        BuildImage(
+            0,
+            0,
+            font="CJGaoDeGuo.otf",
+            plain_text="注: ‘*’ 代表可有多个相同参数 ‘?’ 代表可省略该参数",
+            font_size=30,
+            font_color="red",
+        ),
+        (50, 90),
+        True,
+    )
+    await A.asave(SUPERUSER_HELP_IMAGE)
+    logger.info(f"已成功加载 {len(image_list)} 条超级用户命令")