nonebot-plugin-picmenu-next 0.1.0.dev1__py3-none-any.whl

nonebot_plugin_picmenu_next/__init__.py

@@ -0,0 +1,37 @@
+# ruff: noqa: E402
+
+from nonebot import get_driver
+from nonebot.plugin import PluginMetadata, inherit_supported_adapters, require
+
+require("nonebot_plugin_alconna")
+require("nonebot_plugin_waiter")
+require("nonebot_plugin_htmlrender")
+
+from . import __main__ as __main__
+from .config import ConfigModel
+from .data_source import refresh_infos
+from .templates import load_builtin_templates
+
+__version__ = "0.1.0.dev1"
+__plugin_meta__ = PluginMetadata(
+    name="PicMenu Next",
+    description="新一代的图片帮助插件",
+    usage="发送“帮助”查看所有所有插件功能",
+    type="application",
+    homepage="https://github.com/lgc-NB2Dev/nonebot-plugin-picmenu-next",
+    config=ConfigModel,
+    supported_adapters=inherit_supported_adapters(
+        "nonebot_plugin_alconna",
+        "nonebot_plugin_waiter",
+    ),
+    extra={"License": "MIT", "Author": "LgCookie"},
+)
+
+load_builtin_templates()
+
+driver = get_driver()
+
+
+@driver.on_startup
+async def _():
+    await refresh_infos()

nonebot_plugin_picmenu_next/__main__.py

@@ -0,0 +1,183 @@
+from collections.abc import Sequence
+from contextlib import suppress
+from typing import Optional, TypeVar
+
+from arclet.alconna import Alconna, Arg, Args, CommandMeta, Option, store_true
+from loguru import logger
+from nonebot_plugin_alconna import Query, on_alconna
+from nonebot_plugin_alconna.uniseg import UniMessage
+from thefuzz import process
+
+from .data_source import (
+    PMDataItem,
+    PMNPluginInfo,
+    get_resolved_infos,
+    transform_to_pinyin,
+)
+from .templates import detail_templates, func_detail_templates, index_templates
+
+alc = Alconna(
+    "help",
+    Args(
+        Arg("plugin?", str, notice="插件序号或名称"),
+        Arg("function?", str, notice="插件功能序号或名称"),
+    ),
+    Option(
+        "-H|--show-hidden",
+        action=store_true,
+        help_text="显示隐藏的插件",
+    ),
+    meta=CommandMeta(
+        description="新一代的图片帮助插件",
+        author="LgCookie",
+    ),
+)
+m_cls = on_alconna(
+    alc,
+    aliases={"帮助", "菜单"},
+    skip_for_unmatch=False,
+    auto_send_output=True,
+    use_cmd_start=True,
+)
+
+
+def get_name_similarities(
+    query: str,
+    query_pinyin: str,
+    choices: list[str],
+    choices_pinyin: list[str],
+    raw_weight: float = 0.6,
+    pinyin_weight: float = 0.4,
+) -> list[float]:
+    similarities: list[float] = []
+    raw_iter = process.extractWithoutOrder(query, choices)
+    pinyin_iter = process.extractWithoutOrder(query_pinyin, choices_pinyin)
+    with suppress(StopIteration):
+        while True:
+            raw_score = next(raw_iter)[1]
+            pinyin_score = next(pinyin_iter)[1]
+            similarities.append(raw_weight * raw_score + pinyin_weight * pinyin_score)
+    logger.opt(lazy=True).debug(
+        "Query: {}, similarities: {}",
+        lambda: query,
+        lambda: "; ".join(
+            f"{choices[i]}: {s}"
+            for i, s in sorted(
+                enumerate(similarities),
+                key=lambda x: x[1],
+                reverse=True,
+            )
+        ),
+    )
+    return similarities
+
+
+T = TypeVar("T")
+
+
+def handle_query_index(query: str, infos: Sequence[T]) -> Optional[tuple[int, T]]:
+    if query.isdigit() and query.strip("0"):
+        return (
+            ((i := qn - 1), infos[i])
+            if (1 <= (qn := int(query)) <= len(infos))
+            else None
+        )
+    return None
+
+
+async def query_plugin(
+    infos: list[PMNPluginInfo],
+    query: str,
+    score_cutoff: float = 60,
+) -> Optional[tuple[int, PMNPluginInfo]]:
+    if r := handle_query_index(query, infos):
+        return r
+
+    choices: list[str] = []
+    choices_pinyin: list[str] = []
+    for info in infos:
+        choices.append(info.name.casefold())
+        choices_pinyin.append(info.name_pinyin.casefold())
+
+    similarities = get_name_similarities(
+        query.casefold(),
+        transform_to_pinyin(query).casefold(),
+        choices,
+        choices_pinyin,
+    )
+    i, s = max(enumerate(similarities), key=lambda x: x[1])
+    if s >= score_cutoff:
+        return i, infos[i]
+    return None
+
+
+async def query_func_detail(
+    pm_data: list[PMDataItem],
+    query: str,
+    score_cutoff: float = 60,
+) -> Optional[tuple[int, PMDataItem]]:
+    if r := handle_query_index(query, pm_data):
+        return r
+
+    choices: list[str] = []
+    choices_pinyin: list[str] = []
+    for data in pm_data:
+        choices.append(data.func.casefold())
+        choices_pinyin.append(data.func_pinyin.casefold())
+
+    similarities = get_name_similarities(
+        query.casefold(),
+        transform_to_pinyin(query).casefold(),
+        choices,
+        choices_pinyin,
+    )
+    i, s = max(enumerate(similarities), key=lambda x: x[1])
+    if s >= score_cutoff:
+        return i, pm_data[i]
+    return None
+
+
+@m_cls.handle()
+async def _(
+    q_plugin: Query[Optional[str]] = Query("~plugin", None),
+    q_function: Query[Optional[str]] = Query("~function", None),
+    q_show_hidden: Query[bool] = Query("~show-hidden.value", default=False),
+):
+    infos = await get_resolved_infos()
+    if not q_show_hidden.result:
+        infos = [x for x in infos if not x.pmn_v.hidden]
+
+    if not q_plugin.result:
+        m = await index_templates.get()(infos)
+        await m.finish()
+
+    r = await query_plugin(infos, q_plugin.result)
+    if not r:
+        await UniMessage.text("好像没有找到对应插件呢……").finish(reply_to=True)
+    info_index, info = r
+    if not q_function.result:
+        m = await detail_templates.get(info.pmn.template)(info, info_index)
+        await m.finish()
+
+    if not info.pm_data:
+        await UniMessage.text(
+            f"插件 `{info.name}` 没有详细功能介绍哦",
+        ).finish(reply_to=True)
+
+    if (not (plugin := info.plugin)) or (
+        not (pm_data := await info.resolve_pm_data(plugin))
+    ):
+        await UniMessage.text("啊哦，遇到了意外情况……").finish(reply_to=True)
+
+    if not q_show_hidden.result:
+        pm_data = [x for x in pm_data if not x.hidden]
+    r = await query_func_detail(pm_data, q_function.result)
+    if not r:
+        await UniMessage.text(
+            f"好像没有找到插件 `{info.name}` 的对应功能呢……",
+        ).finish(reply_to=True)
+    func_index, func = r
+    m = await func_detail_templates.get(
+        func.template,
+    )(info, info_index, func, func_index)
+    await m.finish()

nonebot_plugin_picmenu_next/config.py

@@ -0,0 +1,13 @@
+from cookit.pyd import model_with_alias_generator
+from nonebot import get_plugin_config
+from pydantic import BaseModel
+
+
+@model_with_alias_generator(lambda x: f"pmn_{x}")
+class ConfigModel(BaseModel):
+    index_template: str = "default"
+    detail_template: str = "default"
+    func_detail_template: str = "default"
+
+
+config: ConfigModel = get_plugin_config(ConfigModel)

nonebot_plugin_picmenu_next/data_source.py

@@ -0,0 +1,341 @@
+import asyncio
+import importlib
+from asyncio import iscoroutinefunction
+from collections.abc import Awaitable, Iterable
+from importlib.metadata import Distribution, distribution
+from typing import Any, Optional, Union
+from typing_extensions import Self
+from weakref import ref
+
+import jieba
+from cookit.loguru import warning_suppress
+from cookit.pyd import model_validator, type_dump_python, type_validate_python
+from nonebot import logger
+from nonebot.plugin import Plugin, get_loaded_plugins
+from pydantic import BaseModel, Field, PrivateAttr
+from pypinyin import Style, pinyin
+
+
+async def call_entrypoint(plugin: Plugin, entrypoint: str) -> Any:
+    """`module_name:function_name` string.
+    You can Use `~` in module name to replace your plugin module name."""
+
+    module_path, func_name = entrypoint.split(":")
+    module_path = module_path.replace("~", plugin.module_name)
+    module = importlib.import_module(module_path)
+    func = getattr(module, func_name)
+    return (await func()) if iscoroutinefunction(func) else func()
+
+
+async def resolve_func_hidden(plugin: Plugin, entrypoint: str) -> bool:
+    """should only be called from event handler,
+    so hidden func can get current bot, event, etc."""
+
+    with warning_suppress(
+        f"Failed to resole hidden status `{entrypoint}` from plugin {plugin.id_}",
+    ):
+        return bool(await call_entrypoint(plugin, entrypoint))
+    return False
+
+
+class PMDataItemRaw(BaseModel):
+    func: str
+    func_pinyin: str
+    trigger_method: str
+    trigger_condition: str
+    brief_des: str
+    detail_des: str
+
+    # extension properties
+    hidden: Union[bool, str] = Field(default=False, alias="pmn_hidden")
+    template: Optional[str] = Field(default=None, alias="pmn_template")
+
+    @model_validator(mode="before")
+    def init_func_pinyin(cls, values: Any):  # noqa: N805
+        if isinstance(values, BaseModel):
+            values = type_dump_python(values, exclude_unset=True)
+        if isinstance((func := values.get("func")), str) and (
+            not values.get("func_pinyin")
+        ):
+            values["func_pinyin"] = transform_to_pinyin(func)
+        return values
+
+
+class PMDataItem(PMDataItemRaw):
+    pmn_hidden_v: bool = False
+
+    @classmethod
+    async def resolve(cls, plugin: Plugin, data: PMDataItemRaw) -> Self:
+        data_dict: dict = type_dump_python(data, exclude_unset=True)
+        if isinstance((hidden := data_dict.get("pmn_hidden")), str):
+            data_dict["pmn_hidden_v"] = await resolve_func_hidden(plugin, hidden)
+        return cls(**data_dict)
+
+
+class PMNDataRaw(BaseModel):
+    hidden: Union[bool, str] = False
+    markdown: bool = False
+    template: Optional[str] = None
+
+
+class PMNData(PMNDataRaw):
+    hidden_v: bool = False
+
+    @classmethod
+    async def resolve(cls, plugin: Plugin, data: PMNDataRaw) -> Self:
+        data_dict: dict = type_dump_python(data, exclude_unset=True)
+        if isinstance((hidden := data_dict.get("hidden")), str):
+            data_dict["hidden_v"] = await resolve_func_hidden(plugin, hidden)
+        return cls(**data_dict)
+
+
+class PMNPluginExtra(BaseModel):
+    author: Union[str, list[str], None] = None
+    version: Optional[str] = None
+    menu_data: Optional[list[PMDataItemRaw]] = None
+    pmn: Optional[PMNDataRaw] = None
+
+    @model_validator(mode="before")
+    def normalize_input(cls, values: dict[str, Any]):  # noqa: N805
+        should_normalize_keys = {x for x in values if x.lower() in {"author"}}
+        for key in should_normalize_keys:
+            value = values[key]
+            del values[key]
+            values[key.lower()] = value
+        return values
+
+
+class PMNPluginInfoRaw(BaseModel):
+    name: str
+    name_pinyin: str
+    author: Optional[str] = None
+    version: Optional[str] = None
+    description: Optional[str] = None
+    usage: Optional[str] = None
+    pm_data: Optional[list[PMDataItemRaw]] = None
+    pmn: PMNDataRaw = PMNDataRaw()
+
+    _resolved_pm_data: Optional[list[PMDataItem]] = PrivateAttr(None)
+
+    @model_validator(mode="before")
+    def init_name_pinyin(cls, values: dict[str, Any]):  # noqa: N805
+        if isinstance((name := values.get("name")), str) and (
+            not values.get("name_pinyin")
+        ):
+            values["name_pinyin"] = transform_to_pinyin(name)
+        return values
+
+    async def resolve_pm_data(self, plugin: Plugin):
+        if self._resolved_pm_data is not None:
+            return self._resolved_pm_data
+        if not self.pm_data:
+            return None
+
+        async def _ts(x: PMDataItemRaw):
+            with warning_suppress(
+                f"Failed to resolve plugin menu item `{x.func}` of {plugin.id_}",
+            ):
+                return await PMDataItem.resolve(plugin, x)
+
+        self._resolved_pm_data = [
+            x for x in await asyncio.gather(*(_ts(x) for x in self.pm_data)) if x
+        ]
+        return self._resolved_pm_data
+
+
+class PMNPluginInfo(PMNPluginInfoRaw):
+    pmn_v: PMNData = PMNData()
+
+    _plugin: Optional[ref[Plugin]] = PrivateAttr(None)
+
+    @property
+    def plugin(self) -> Optional[Plugin]:
+        if self._plugin:
+            return self._plugin()
+        return None
+
+    @plugin.setter
+    def plugin(self, plugin: Plugin):
+        self._plugin = ref(plugin)
+
+    @classmethod
+    async def resolve(cls, plugin: Plugin, data: PMNPluginInfoRaw) -> Self:
+        data_dict: dict = type_dump_python(data, exclude_unset=True)
+        tasks: list[Awaitable] = []
+
+        if pmn := data_dict.get("pmn"):
+
+            async def _t():
+                v = None
+                with warning_suppress(
+                    f"Failed to resolve PicMenu Next data of {plugin.id_}",
+                ):
+                    v = await PMNData.resolve(plugin, pmn)
+                data_dict["pmn_v"] = v
+
+            tasks.append(_t())
+
+        await asyncio.gather(*tasks)
+        ins = cls(**data_dict)
+        ins.plugin = plugin
+        return ins
+
+
+def normalize_plugin_name(name: str) -> str:
+    if pfx := next(
+        (x for x in ("nonebot_plugin_", "nonebot-plugin-") if name.startswith(x)),
+        None,
+    ):
+        name = name[len(pfx) :].replace("_", " ").title()
+    return name
+
+
+def normalize_metadata_user(info: str, allow_multi: bool = False) -> str:
+    infos = info.split(",")
+    if not allow_multi:
+        infos = infos[:1]
+    return " & ".join(x.split("<")[0].strip().strip("'\"") for x in infos)
+
+
+async def get_info_from_plugin(plugin: Plugin) -> PMNPluginInfoRaw:
+    meta = plugin.metadata
+    extra: Optional[PMNPluginExtra] = None
+    if meta:
+        with warning_suppress(f"Failed to parse plugin metadata of {plugin.id_}"):
+            extra = type_validate_python(PMNPluginExtra, meta.extra)
+
+    name = (
+        normalize_plugin_name(meta.name)
+        if meta
+        else normalize_plugin_name(
+            plugin.id_.replace(".", " ").replace(":", " "),
+        ).title()
+    )
+
+    _dist = ...
+
+    def get_dist() -> Optional[Distribution]:
+        nonlocal _dist
+        if _dist is ...:
+            _dist = None
+            with warning_suppress(
+                f"Failed to get info of package {plugin.module_name}",
+            ):
+                _dist = distribution(plugin.module_name)
+        return _dist
+
+    ver = extra.version if extra else None
+    if not ver:
+        ver = getattr(plugin, "__version__", None)
+    if not ver and (dist := get_dist()):
+        ver = dist.version
+
+    author = (
+        (" & ".join(extra.author) if isinstance(extra.author, list) else extra.author)
+        if extra
+        else None
+    )
+    if not author and (dist := get_dist()):
+        if author := dist.metadata.get("Author") or dist.metadata.get("Maintainer"):
+            author = normalize_metadata_user(author)
+        elif author := dist.metadata.get("Author-Email") or dist.metadata.get(
+            "Maintainer-Email",
+        ):
+            author = normalize_metadata_user(author, allow_multi=True)
+
+    description = (
+        meta.description
+        if meta
+        else (dist.metadata.get("Summary") if (dist := get_dist()) else None)
+    )
+
+    pmn = (extra.pmn if extra else None) or PMNDataRaw()
+    if ("hidden" not in pmn.model_fields_set) and meta and meta.type == "library":
+        pmn = PMNDataRaw(hidden=True)
+
+    logger.debug(f"Completed to get info of plugin {plugin.id_}")
+    return PMNPluginInfoRaw(
+        name=name,
+        name_pinyin="",  # avoid type error
+        author=author,
+        version=ver,
+        description=description,
+        usage=meta.usage if meta else None,
+        pm_data=extra.menu_data if extra else None,
+        pmn=pmn,
+    )
+
+
+class _NotCHNStr(str):  # noqa: SLOT000
+    pass
+
+
+def pinyin_sorter_k(text: str):
+    return tuple(
+        (
+            is_pinyin := not isinstance((x := v[0]), _NotCHNStr),
+            x[:-1] if is_pinyin else x,
+            int(x[-1]) if is_pinyin else 0,
+        )
+        for v in pinyin(
+            jieba.lcut(text),
+            style=Style.TONE3,
+            errors=lambda x: _NotCHNStr(x),
+            neutral_tone_with_five=True,
+        )
+    )
+
+
+async def collect_plugin_infos(plugins: Iterable[Plugin]):
+    async def _get(p: Plugin):
+        with warning_suppress(f"Failed to get plugin info of {p.id_}"):
+            return await get_info_from_plugin(p)
+
+    infos = await asyncio.gather(
+        *(_get(plugin) for plugin in plugins),
+    )
+    infos = [x for x in infos if x]
+    logger.success(f"Collected {len(infos)} plugin infos")
+    infos.sort(key=lambda x: x.name)
+    return infos
+
+
+def transform_to_pinyin(text: str) -> str:
+    return " ".join(
+        v[0]
+        for v in pinyin(
+            jieba.lcut(text),
+            style=Style.TONE3,
+            neutral_tone_with_five=True,
+        )
+    )
+
+
+_infos: list[PMNPluginInfoRaw] = []
+_plugin_refs: list[ref[Plugin]] = []
+
+
+def get_infos() -> list[PMNPluginInfoRaw]:
+    return _infos
+
+
+def get_plugin_refs() -> list[ref[Plugin]]:
+    return _plugin_refs
+
+
+async def refresh_infos() -> list[PMNPluginInfoRaw]:
+    global _plugin_refs, _infos
+    plugins = get_loaded_plugins()
+    _infos = await collect_plugin_infos(plugins)
+    _plugin_refs = [ref(plugin) for plugin in plugins]
+    return _infos
+
+
+async def get_resolved_infos() -> list[PMNPluginInfo]:
+    return await asyncio.gather(
+        *(
+            PMNPluginInfo.resolve(p, x)
+            for r, x in zip(_plugin_refs, _infos)
+            if (p := r())
+        ),
+    )

nonebot_plugin_picmenu_next/templates/__init__.py

@@ -0,0 +1,77 @@
+from pathlib import Path
+from typing import Callable, Optional, Protocol, TypeVar
+
+from cookit import HasNameProtocol, NameDecoCollector, auto_import
+from nonebot import logger
+from nonebot_plugin_alconna.uniseg import UniMessage
+
+from ..config import config
+from ..data_source import PMDataItem, PMNPluginInfo
+
+TN = TypeVar("TN", bound=HasNameProtocol)
+
+
+class IndexTemplateHandler(HasNameProtocol, Protocol):
+    async def __call__(self, infos: list[PMNPluginInfo]) -> UniMessage: ...
+
+
+class DetailTemplateHandler(HasNameProtocol, Protocol):
+    async def __call__(self, info: PMNPluginInfo, info_index: int) -> UniMessage: ...
+
+
+class FuncDetailTemplateHandler(HasNameProtocol, Protocol):
+    async def __call__(
+        self,
+        info: PMNPluginInfo,
+        info_index: int,
+        func: PMDataItem,
+        func_index: int,
+    ) -> UniMessage: ...
+
+
+class TemplateDecoCollector(NameDecoCollector[TN]):
+    def __init__(
+        self,
+        template_type: str,
+        template_name_getter: Callable[[], str],
+        data: Optional[dict[str, TN]] = None,
+        allow_overwrite: bool = False,
+    ) -> None:
+        super().__init__(data, allow_overwrite)
+        self.template_type = template_type
+        self.name_getter = template_name_getter
+
+    def get(self, name: Optional[str] = None) -> TN:
+        if name and name not in self.data:
+            logger.warning(
+                f"Plugin configured {self.template_type} template '{name}' not found"
+                ", falling back to user configured default",
+            )
+            name = None
+        if not name:
+            name = self.name_getter()
+        if name not in self.data:
+            logger.warning(
+                f"User configured {self.template_type} template '{name}' not found"
+                ", falling back to plugin default",
+            )
+            name = "default"
+        return self.data[name]
+
+
+index_templates = TemplateDecoCollector[IndexTemplateHandler](
+    "index",
+    lambda: config.index_template,
+)
+detail_templates = TemplateDecoCollector[DetailTemplateHandler](
+    "detail",
+    lambda: config.detail_template,
+)
+func_detail_templates = TemplateDecoCollector[FuncDetailTemplateHandler](
+    "func detail",
+    lambda: config.func_detail_template,
+)
+
+
+def load_builtin_templates():
+    auto_import(Path(__file__).parent, __package__)

nonebot_plugin_picmenu_next/templates/default/__init__.py

@@ -0,0 +1,147 @@
+import re
+from functools import cached_property
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import jinja2 as jj
+from cookit import DebugFileWriter
+from cookit.jinja import register_all_filters
+from cookit.pw import RouterGroup, make_real_path_router, screenshot_html
+from cookit.pw.loguru import log_router_err
+from cookit.pyd import model_with_alias_generator
+from nonebot import get_plugin_config
+from nonebot_plugin_alconna.uniseg import UniMessage
+from nonebot_plugin_htmlrender import get_new_page
+from pydantic import BaseModel, Field
+
+from ...data_source import PMDataItem, PMNPluginInfo
+from .. import detail_templates, func_detail_templates, index_templates
+
+if TYPE_CHECKING:
+    from playwright.async_api import Route
+    from yarl import URL
+
+
+@model_with_alias_generator(lambda x: f"pmn_default_{x}")
+class TemplateConfigModel(BaseModel):
+    command_start: set[str] = Field(alias="command_start")
+
+    dark: bool = False
+    additional_css: list[str] = []
+    additional_js: list[str] = []
+
+    @cached_property
+    def pfx(self) -> str:
+        return next(iter(self.command_start), "")
+
+
+template_config = get_plugin_config(TemplateConfigModel)
+
+
+RES_DIR = Path(__file__).parent / "res"
+ROUTE_BASE_URL = "https://picmenu-next.nonebot"
+debug = DebugFileWriter(Path.cwd() / "debug", "picmenu-next", "default")
+
+jj_env = jj.Environment(
+    loader=jj.FileSystemLoader(Path(__file__).parent / "res"),
+    autoescape=True,
+    enable_async=True,
+)
+register_all_filters(jj_env)
+
+base_routers = RouterGroup()
+
+
+@base_routers.router(f"{ROUTE_BASE_URL}/")
+@log_router_err()
+async def _(route: "Route", **_):
+    await route.fulfill(content_type="text/html", body="<h1>Hello World!</h1>")
+
+
+@base_routers.router(re.compile(rf"^{ROUTE_BASE_URL}/local-file\?path=[^/]+"))
+@make_real_path_router
+@log_router_err()
+async def _(url: "URL", **_):
+    return Path(url.query["path"]).resolve()
+
+
+@base_routers.router(f"{ROUTE_BASE_URL}/**/*", 99)
+@make_real_path_router
+@log_router_err()
+async def _(url: "URL", **_):
+    return RES_DIR.joinpath(*url.parts[1:])
+
+
+def version():
+    from ... import __version__
+
+    return __version__
+
+
+async def render(template: str, routers: RouterGroup, **kwargs):
+    template_obj = jj_env.get_template(template)
+    html = await template_obj.render_async(
+        **kwargs,
+        cfg=template_config,
+        version=version(),
+    )
+    if debug.enabled:
+        debug.write(html, f"{template.replace('.html.jinja', '')}_{{time}}.html")
+
+    async with get_new_page() as page:
+        await routers.apply(page)
+        await page.goto(f"{ROUTE_BASE_URL}/")
+        pic = await screenshot_html(page, html, selector="main")
+    return UniMessage.image(raw=pic)
+
+
+@index_templates("default")
+async def render_index(infos: list[PMNPluginInfo]) -> UniMessage:
+    routers = base_routers.copy()
+    return await render(
+        "index.html.jinja",
+        routers,
+        infos=infos,
+    )
+
+
+def get_plugin_desc(info: PMNPluginInfo):
+    return " | ".join(
+        x
+        for x in (
+            f"By {info.author}" if info.author else None,
+            f"v{info.version}" if info.version else None,
+        )
+        if x
+    )
+
+
+@detail_templates("default")
+async def render_detail(info: PMNPluginInfo, info_index: int) -> UniMessage:
+    routers = base_routers.copy()
+    return await render(
+        "detail.html.jinja",
+        routers,
+        info=info,
+        info_index=info_index,
+        desc=get_plugin_desc(info),
+    )
+
+
+@func_detail_templates("default")
+async def render_func_detail(
+    info: PMNPluginInfo,
+    info_index: int,
+    func: PMDataItem,
+    func_index: int,
+) -> UniMessage:
+    routers = base_routers.copy()
+    return await render(
+        "detail.html.jinja",
+        routers,
+        info=info,
+        info_index=info_index,
+        desc=get_plugin_desc(info),
+        func=func,
+        func_index=func_index,
+    )

nonebot_plugin_picmenu_next/templates/default/res/base.html.jinja

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="stylesheet" href="./css/base.css" />
+    {% if cfg.dark %}<link rel="stylesheet" href="./css/dark.css" />{% endif -%}
+    {% block head %}{% endblock %}
+    {% for f in cfg.additional_css -%}
+    <link rel="stylesheet" href="./local-file/?path={{ f | url_encode | safe }}" />
+    {% endfor -%}
+  </head>
+  <body>
+    <main>
+      <div class="main-wrapper">
+        {% block main %}{% endblock %}
+        <div class="main-footer">
+          Generated by PicMenu-Next v{{ version }} | Made with ❤️ by LgCookie
+        </div>
+      </div>
+    </main>
+  </body>
+  {% for f in cfg.additional_js -%}
+  <script src="./local-file/?path={{ f | url_encode | safe }}"></script>
+  {% endfor -%}
+  {% block script %}{% endblock %}
+</html>

nonebot_plugin_picmenu_next/templates/default/res/css/base.css

@@ -0,0 +1,137 @@
+:root {
+  --background-color: unset;
+  --background-image: linear-gradient(120deg, #e0c3fc 0%, #8ec5fc 100%);
+
+  --background-color-wrapper: #fff3;
+  --background-image-wrapper: unset;
+
+  --card-background-color: unset;
+  --card-background-image: linear-gradient(120deg, #fdfbfb99 0%, #ebedee99 100%);
+  --card-background-border: #00000014 1px solid;
+  --card-shadow: rgba(0, 0, 0, 0.05) 0px 6px 24px 0px;
+
+  --text-shadow: 0 0 4px #3332;
+
+  --font-color-main: #000d;
+  --font-color-sub: #666d;
+
+  --font-color-card-index: #3336;
+  --text-shadow-card-index: 0 0 4px #3331;
+
+  --title-deco-color: #8174a0;
+
+  --font-family-main: 'HarmonyOS Sans SC';
+}
+
+* {
+  box-sizing: border-box;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+p {
+  margin: 0;
+  padding: 0;
+}
+
+h1.deco::before,
+h2.deco::before,
+h3.deco::before,
+h4.deco::before,
+h5.deco::before,
+h6.deco::before {
+  content: '';
+  display: inline-block;
+  vertical-align: -10%;
+  width: 4px;
+  height: 1em;
+  margin-left: 2px;
+  margin-right: 6px;
+  border-radius: 9999px;
+  background-color: var(--title-deco-color);
+  box-shadow: var(--text-shadow);
+}
+
+.sub {
+  color: var(--font-color-sub);
+}
+
+main {
+  background-color: var(--background-color);
+  background-image: var(--background-image);
+  background-size: cover;
+  background-position: center;
+  background-repeat: no-repeat;
+
+  color: var(--font-color-main);
+  font-family: var(--font-family-main), sans-serif;
+  text-shadow: var(--text-shadow);
+}
+
+main > .main-wrapper {
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+
+  background-color: var(--background-color-wrapper);
+  background-image: var(--background-image-wrapper);
+  background-size: cover;
+  background-position: center;
+  background-repeat: no-repeat;
+}
+
+.main-footer {
+  text-align: end;
+  color: var(--font-color-sub);
+}
+
+.card-grid {
+  display: grid;
+  gap: 8px;
+  grid-template-columns: repeat(var(--grid-columns), 1fr);
+}
+
+.card {
+  border-radius: 8px;
+  padding: 8px;
+
+  background-color: var(--card-background-color);
+  background-image: var(--card-background-image);
+  background-size: cover;
+  background-position: center;
+  background-repeat: no-repeat;
+  border: var(--card-background-border);
+  box-shadow: var(--card-shadow);
+
+  text-shadow: none;
+}
+
+.card.flex {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.card.relative {
+  position: relative;
+}
+
+.card .index {
+  position: absolute;
+  bottom: 0;
+  right: 10px;
+  font-size: 36px;
+  font-style: italic;
+  color: var(--font-color-card-index);
+  text-shadow: var(--text-shadow-card-index);
+  z-index: 2;
+}
+
+.card .index > .no {
+  font-size: 24px;
+}

nonebot_plugin_picmenu_next/templates/default/res/css/dark.css

@@ -0,0 +1,10 @@
+:root {
+  --background-image: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  --background-color-wrapper: #3336;
+  --card-background-color: unset;
+  --card-background-image: linear-gradient(60deg, #29323c99 0%, #373c4299 100%);
+  --font-color-main: #fffd;
+  --font-color-sub: #cccd;
+  --font-color-card-index: #ccc6;
+  --title-deco-color: #ab7dc5;
+}

nonebot_plugin_picmenu_next/templates/default/res/css/detail.css

@@ -0,0 +1,16 @@
+main {
+  /* width: fit-content; */
+  /* max-width: 810px; */
+  width: 810px;
+}
+
+.inner-flex {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  width: 100%;
+}
+
+.card-grid.functions {
+  --grid-columns: 2;
+}

nonebot_plugin_picmenu_next/templates/default/res/css/index.css

@@ -0,0 +1,9 @@
+main {
+  width: 810px;
+  overflow: hidden;
+}
+
+.card-grid {
+  --grid-columns: 3;
+  width: 100%;
+}

nonebot_plugin_picmenu_next/templates/default/res/detail.html.jinja

@@ -0,0 +1,68 @@
+{%- extends "base.html.jinja" -%}
+
+{%- block head -%}
+<link rel="stylesheet" href="./css/detail.css" />
+{%- endblock -%}
+
+{%- block main -%}
+{% if func -%}
+<div class="main-header">
+  <h1>{{ info.name }} <span class="sub">&gt;</span> {{ func.func }}</h1>
+  <p>{{ desc }}</p>
+</div>
+<div class="inner-flex">
+  <h2 class="deco">触发条件</h2>
+  <div class="card">{{ func.trigger_method }}</div>
+</div>
+<div class="inner-flex">
+  <h2 class="deco">触发方式</h2>
+  <div class="card">{{ func.trigger_condition }}</div>
+</div>
+<div class="inner-flex">
+  <h2 class="deco">简要介绍</h2>
+  <div class="card">{{ func.brief_des | br }}</div>
+</div>
+<div class="inner-flex">
+  <h2 class="deco">详细用法</h2>
+  <div class="card">{{ func.detail_des | br }}</div>
+</div>
+{% else -%}
+<div class="main-header">
+  <h1>{{ info.name }}</h1>
+  <p>{{ desc }}</p>
+</div>
+{% if info.description -%}
+<div class="inner-flex">
+  <h2 class="deco">简介</h2>
+  <div class="card">{{ info.description }}</div>
+</div>
+{% endif -%}
+{% if info.usage -%}
+<div class="inner-flex">
+  <h2 class="deco">用法</h2>
+  <div class="card">{{ info.usage | br }}</div>
+</div>
+{% endif -%}
+{% if info.pm_data -%}
+<div class="inner-flex">
+  <div>
+    <h2 class="deco">功能</h2>
+    <p>发送 <b>菜单 {{ info_index + 1 }} 功能名称或序号</b> 获取某功能详细信息</p>
+  </div>
+  <div class="card-grid functions">
+    {% for x in info.pm_data -%}
+    <div class="card flex relative">
+      <div class="index"><span class="no">No.</span>{{ loop.index }}</div>
+      <h3>{{ x.func }}</h3>
+      <p>
+        触发条件：{{ x.trigger_method }}<br />
+        触发方式：{{ x.trigger_condition }}<br />
+        {{ x.brief_des | br }}
+      </p>
+    </div>
+    {% endfor -%}
+  </div>
+</div>
+{% endif -%}
+{% endif -%}
+{%- endblock -%}

nonebot_plugin_picmenu_next/templates/default/res/index.html.jinja

@@ -0,0 +1,21 @@
+{%- extends "base.html.jinja" -%}
+
+{%- block head -%}
+<link rel="stylesheet" href="./css/index.css" />
+{%- endblock -%}
+
+{%- block main -%}
+<div class="main-header">
+  <h1>机器人帮助菜单</h1>
+  <p>发送 <b>{{ cfg.pfx }}帮助 插件名或序号</b> 获取关于某插件的更多信息</p>
+</div>
+<div class="card-grid">
+  {% for it in infos -%}
+  <div class="card flex relative">
+    <div class="index"><span class="no">No.</span>{{ loop.index }}</div>
+    <h3>{{ it.name }}</h3>
+    <p>{{ it.description | br }}</p>
+  </div>
+  {% endfor -%}
+</div>
+{%- endblock -%}

nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/METADATA

@@ -0,0 +1,175 @@
+Metadata-Version: 2.1
+Name: nonebot-plugin-picmenu-next
+Version: 0.1.0.dev1
+Summary: Template plugin project
+Author-Email: LgCookie <lgc2333@126.com>
+License: MIT
+Project-URL: homepage, https://github.com/lgc-NB2Dev/nonebot-plugin-picmenu-next
+Requires-Python: <4.0,>=3.9
+Requires-Dist: nonebot2>=2.4.1
+Requires-Dist: nonebot-plugin-alconna>=0.54.2
+Requires-Dist: cookit[jinja,loguru,nonebot-alconna,nonebot-localstore,pw,pyd]>=0.11.2
+Requires-Dist: pypinyin>=0.54.0
+Requires-Dist: jieba>=0.42.1
+Requires-Dist: thefuzz>=0.22.1
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD031 MD033 MD036 MD041 -->
+
+<div align="center">
+
+<a href="https://v2.nonebot.dev/store">
+  <img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo">
+</a>
+
+<p>
+  <img src="https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/plugin.svg" alt="NoneBotPluginText">
+</p>
+
+# NoneBot-Plugin-PicMenu-Next
+
+_✨ NoneBot 插件简单描述 ✨_
+
+<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
+<a href="https://pdm.fming.dev">
+  <img src="https://img.shields.io/badge/pdm-managed-blueviolet" alt="pdm-managed">
+</a>
+<a href="https://wakatime.com/badge/user/b61b0f9a-f40b-4c82-bc51-0a75c67bfccf/project/f4778875-45a4-4688-8e1b-b8c844440abb">
+  <img src="https://wakatime.com/badge/user/b61b0f9a-f40b-4c82-bc51-0a75c67bfccf/project/f4778875-45a4-4688-8e1b-b8c844440abb.svg" alt="wakatime">
+</a>
+
+<br />
+
+<a href="https://pydantic.dev">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/pyd-v1-or-v2.json" alt="Pydantic Version 1 Or 2" >
+</a>
+<a href="./LICENSE">
+  <img src="https://img.shields.io/github/license/lgc-NB2Dev/nonebot-plugin-picmenu-next.svg" alt="license">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot-plugin-picmenu-next">
+  <img src="https://img.shields.io/pypi/v/nonebot-plugin-picmenu-next.svg" alt="pypi">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot-plugin-picmenu-next">
+  <img src="https://img.shields.io/pypi/dm/nonebot-plugin-picmenu-next" alt="pypi download">
+</a>
+
+<br />
+
+<a href="https://registry.nonebot.dev/plugin/nonebot-plugin-picmenu-next:nonebot_plugin_picmenu_next">
+  <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin%2Fnonebot-plugin-picmenu-next" alt="NoneBot Registry">
+</a>
+<a href="https://registry.nonebot.dev/plugin/nonebot-plugin-picmenu-next:nonebot_plugin_picmenu_next">
+  <img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin-adapters%2Fnonebot-plugin-picmenu-next" alt="Supported Adapters">
+</a>
+
+</div>
+
+## 📖 介绍
+
+这里是插件的详细介绍部分
+
+## 💿 安装
+
+以下提到的方法 任选**其一** 即可
+
+<details open>
+<summary>[推荐] 使用 nb-cli 安装</summary>
+在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
+
+```bash
+nb plugin install nonebot-plugin-picmenu-next
+```
+
+</details>
+
+<details>
+<summary>使用包管理器安装</summary>
+在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
+
+<details>
+<summary>pip</summary>
+
+```bash
+pip install nonebot-plugin-picmenu-next
+```
+
+</details>
+<details>
+<summary>pdm</summary>
+
+```bash
+pdm add nonebot-plugin-picmenu-next
+```
+
+</details>
+<details>
+<summary>poetry</summary>
+
+```bash
+poetry add nonebot-plugin-picmenu-next
+```
+
+</details>
+<details>
+<summary>conda</summary>
+
+```bash
+conda install nonebot-plugin-picmenu-next
+```
+
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分的 `plugins` 项里追加写入
+
+```toml
+[tool.nonebot]
+plugins = [
+    # ...
+    "nonebot_plugin_picmenu_next"
+]
+```
+
+</details>
+
+## ⚙️ 配置
+
+在 nonebot2 项目的 `.env` 文件中添加下表中的必填配置
+
+|  配置项  | 必填 | 默认值 |   说明   |
+| :------: | :--: | :----: | :------: |
+| 配置项 1 |  是  |   无   | 配置说明 |
+| 配置项 2 |  否  |   无   | 配置说明 |
+
+## 🎉 使用
+
+### 指令表
+
+|  指令  | 权限 | 需要@ | 范围 |   说明   |
+| :----: | :--: | :---: | :--: | :------: |
+| 指令 1 | 主人 |  否   | 私聊 | 指令说明 |
+| 指令 2 | 群员 |  是   | 群聊 | 指令说明 |
+
+### 效果图
+
+如果有效果图的话
+
+## 📞 联系
+
+QQ：3076823485  
+Telegram：[@lgc2333](https://t.me/lgc2333)  
+吹水群：[1105946125](https://jq.qq.com/?_wv=1027&k=Z3n1MpEp)  
+邮箱：<lgc2333@126.com>
+
+## 💡 鸣谢
+
+如果有要鸣谢的人的话
+
+## 💰 赞助
+
+**[赞助我](https://blog.lgc2333.top/donate)**
+
+感谢大家的赞助！你们的赞助将是我继续创作的动力！
+
+## 📝 更新日志
+
+芝士刚刚发布的插件，还没有更新日志的说 qwq~

nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/RECORD

@@ -0,0 +1,18 @@
+nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/METADATA,sha256=NIIQQWbDfD-kFu_onX1KW0Ja4Hp0B7yf0dGloEa5gQ8,4847
+nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/WHEEL,sha256=tSfRZzRHthuv7vxpI4aehrdN9scLjk-dCJkPLzkHxGg,90
+nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/licenses/LICENSE,sha256=gPUiJ9TSIxT1ttYJOGCkZBk1ikEIeCLbUvTf1PU_pAE,1065
+nonebot_plugin_picmenu_next/__init__.py,sha256=48NhCwYfb28FxFcOkfibjlWQr_BrpzJWwYhMnRYmvV8,999
+nonebot_plugin_picmenu_next/__main__.py,sha256=iXur11G0oBce9FXOFBorNRMVIFvlGe_RhPRRfmpaVCw,5336
+nonebot_plugin_picmenu_next/config.py,sha256=qrjkdcMA8MwYWkCTlI7xkFIxlQHkifCRMndCnK2wB3o,371
+nonebot_plugin_picmenu_next/data_source.py,sha256=U8syGzqToSFery-W28dG-1rc-j0bW4GEn4vgqe0YCIc,10425
+nonebot_plugin_picmenu_next/templates/__init__.py,sha256=g7d_2djgV_5ZC34GslliqvZPabtL4CdcEY7xoiGXNas,2356
+nonebot_plugin_picmenu_next/templates/default/__init__.py,sha256=IFNZ95MN0whCVjGpf9B3jC3N16qOk_WsPmZl5rZsvT0,3906
+nonebot_plugin_picmenu_next/templates/default/res/base.html.jinja,sha256=a9V0Gi1rLYN7jmMsH-1sLWu3k8M9mRKbK-HcmThH-k0,953
+nonebot_plugin_picmenu_next/templates/default/res/css/base.css,sha256=xO-Y8-1H_mH3M5bCgxz0rJOJxOKHUzpnSoIcJN2sbVM,2606
+nonebot_plugin_picmenu_next/templates/default/res/css/dark.css,sha256=SguUeVccY-Qcx8-9HgBmXbUqamXatqSYrZHuMmaUH7Q,355
+nonebot_plugin_picmenu_next/templates/default/res/css/detail.css,sha256=_CZP6u-satvZxRCZbOeWKrqeuv5Cn9hHmvwkUr7tYtQ,213
+nonebot_plugin_picmenu_next/templates/default/res/css/index.css,sha256=lJgPQhdodPZp5hJXPHmalRv0ppYwcW85WFDTz5s2P3o,97
+nonebot_plugin_picmenu_next/templates/default/res/detail.html.jinja,sha256=qScKDS9_mvHv9tThmQhETeHNO_qtER2UP7t9yvePVPI,1816
+nonebot_plugin_picmenu_next/templates/default/res/index.html.jinja,sha256=GJz7heyAszbjS7lbZKpdYswak6LP34SMXygS5pY73SM,575
+nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/RECORD,,

nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: pdm-backend (2.4.4)
+Root-Is-Purelib: true
+Tag: py3-none-any

nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+
+[gui_scripts]
+

nonebot_plugin_picmenu_next-0.1.0.dev1.dist-info/licenses/LICENSE

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