nonebot-plugin-picmenu-next 0.1.0__tar.gz

nonebot_plugin_picmenu_next-0.1.0/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.

nonebot_plugin_picmenu_next-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.1
+Name: nonebot-plugin-picmenu-next
+Version: 0.1.0
+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.6
+Requires-Dist: pypinyin>=0.54.0
+Requires-Dist: jieba>=0.42.1
+Requires-Dist: thefuzz>=0.22.1
+Requires-Dist: markdown-it-py[plugins]>=3.0.0
+Requires-Dist: pygments>=2.19.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
+
+_✨ 新一代的图片帮助插件 ✨_
+
+<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>
+
+## 📖 介绍
+
+- ✨ **美观的图片界面**：直观友好的图片界面
+- 🛠️ **PicMenu 兼容**：本插件使用 PicMenu 插件格式的三级菜单（功能详情），兼容 PicMenu 的 `<ft>` 富文本标签（但不太推荐使用）
+- 🔍 **支持模糊搜索**：支持通过序号或名称查找插件及功能，并提供插件名称的模糊匹配
+- 🔤 **拼音支持**：插件排序与模糊搜索时考虑拼音，提高中文环境下的使用体验
+- 📜 **Markdown 支持**：支持 Markdown 格式的帮助信息展示（需要插件开发者主动适配）
+- 🔒 **隐藏控制**：默认状态下类型为 `library` 的插件会对普通用户隐藏
+- 🎨 **自定义模板**：提供模板开发者注册模板的接口，提供插件开发者自定义某插件使用的详细信息模板的方式，提供配置供用户自定义想要使用的模板
+- 🔌 **插件扩展机制**：提供强大的 mixin 支持，允许插件通过中间件方式自定义帮助菜单展示和行为
+
+### 展示图
+
+<details>
+<summary>主页面</summary>
+
+![亮色主页](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_main.jpg)  
+![暗色主页](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_main.jpg)
+
+</details>
+
+<details>
+<summary>插件详情</summary>
+
+![亮色插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_detail.jpg)  
+![暗色插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_detail.jpg)
+
+</details>
+
+<details>
+<summary>插件详情（带功能详情三级菜单）</summary>
+
+![亮色带三级菜单插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_with_func.jpg)  
+![暗色带三级菜单插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_with_func.jpg)
+
+</details>
+
+<details>
+<summary>功能详情</summary>
+
+![亮色功能详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_func_detail.jpg)  
+![暗色功能详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_func_detail.jpg)
+
+</details>
+
+<details>
+<summary>Markdown 测试</summary>
+
+![亮色 Markdown 测试](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_markdown.jpg)  
+![暗色 Markdown 测试](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_markdown.jpg)
+
+</details>
+
+## 💿 安装
+
+以下提到的方法 任选**其一** 即可
+
+<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` 文件中添加下表中的配置
+
+|             配置项              | 必填 |  默认值   |              说明              |
+| :-----------------------------: | :--: | :-------: | :----------------------------: |
+|      `PMN_INDEX_TEMPLATE`       |  否  | `default` |       首页展示模板的名称       |
+|      `PMN_DETAIL_TEMPLATE`      |  否  | `default` |       插件详情模板的名称       |
+|   `PMN_FUNC_DETAIL_TEMPLATE`    |  否  | `default` |     插件功能详情模板的名称     |
+| `PMN_ONLY_SUPERUSER_SEE_HIDDEN` |  否  |  `False`  | 是否仅超级用户可以查看隐藏内容 |
+
+## 🎉 使用
+
+发送 `帮助` 指令试试吧！
+
+## 🔧 开发
+
+文档待补充
+
+## 📞 联系
+
+QQ：3076823485  
+Telegram：[@lgc2333](https://t.me/lgc2333)  
+吹水群：[1105946125](https://jq.qq.com/?_wv=1027&k=Z3n1MpEp)  
+邮箱：<lgc2333@126.com>
+
+## 💡 鸣谢
+
+### [hamo-reid/nonebot_plugin_PicMenu](https://github.com/hamo-reid/nonebot_plugin_PicMenu)
+
+- 灵感来源（？）
+
+## 💰 赞助
+
+**[赞助我](https://blog.lgc2333.top/donate)**
+
+感谢大家的赞助！你们的赞助将是我继续创作的动力！
+
+## 📝 更新日志
+
+芝士刚刚发布的插件，还没有更新日志的说 qwq~

nonebot_plugin_picmenu_next-0.1.0/README.md

@@ -0,0 +1,207 @@
+<!-- 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
+
+_✨ 新一代的图片帮助插件 ✨_
+
+<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>
+
+## 📖 介绍
+
+- ✨ **美观的图片界面**：直观友好的图片界面
+- 🛠️ **PicMenu 兼容**：本插件使用 PicMenu 插件格式的三级菜单（功能详情），兼容 PicMenu 的 `<ft>` 富文本标签（但不太推荐使用）
+- 🔍 **支持模糊搜索**：支持通过序号或名称查找插件及功能，并提供插件名称的模糊匹配
+- 🔤 **拼音支持**：插件排序与模糊搜索时考虑拼音，提高中文环境下的使用体验
+- 📜 **Markdown 支持**：支持 Markdown 格式的帮助信息展示（需要插件开发者主动适配）
+- 🔒 **隐藏控制**：默认状态下类型为 `library` 的插件会对普通用户隐藏
+- 🎨 **自定义模板**：提供模板开发者注册模板的接口，提供插件开发者自定义某插件使用的详细信息模板的方式，提供配置供用户自定义想要使用的模板
+- 🔌 **插件扩展机制**：提供强大的 mixin 支持，允许插件通过中间件方式自定义帮助菜单展示和行为
+
+### 展示图
+
+<details>
+<summary>主页面</summary>
+
+![亮色主页](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_main.jpg)  
+![暗色主页](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_main.jpg)
+
+</details>
+
+<details>
+<summary>插件详情</summary>
+
+![亮色插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_detail.jpg)  
+![暗色插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_detail.jpg)
+
+</details>
+
+<details>
+<summary>插件详情（带功能详情三级菜单）</summary>
+
+![亮色带三级菜单插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_with_func.jpg)  
+![暗色带三级菜单插件详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_with_func.jpg)
+
+</details>
+
+<details>
+<summary>功能详情</summary>
+
+![亮色功能详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_func_detail.jpg)  
+![暗色功能详情](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_func_detail.jpg)
+
+</details>
+
+<details>
+<summary>Markdown 测试</summary>
+
+![亮色 Markdown 测试](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/light_markdown.jpg)  
+![暗色 Markdown 测试](https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/picmenu-next/dark_markdown.jpg)
+
+</details>
+
+## 💿 安装
+
+以下提到的方法 任选**其一** 即可
+
+<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` 文件中添加下表中的配置
+
+|             配置项              | 必填 |  默认值   |              说明              |
+| :-----------------------------: | :--: | :-------: | :----------------------------: |
+|      `PMN_INDEX_TEMPLATE`       |  否  | `default` |       首页展示模板的名称       |
+|      `PMN_DETAIL_TEMPLATE`      |  否  | `default` |       插件详情模板的名称       |
+|   `PMN_FUNC_DETAIL_TEMPLATE`    |  否  | `default` |     插件功能详情模板的名称     |
+| `PMN_ONLY_SUPERUSER_SEE_HIDDEN` |  否  |  `False`  | 是否仅超级用户可以查看隐藏内容 |
+
+## 🎉 使用
+
+发送 `帮助` 指令试试吧！
+
+## 🔧 开发
+
+文档待补充
+
+## 📞 联系
+
+QQ：3076823485  
+Telegram：[@lgc2333](https://t.me/lgc2333)  
+吹水群：[1105946125](https://jq.qq.com/?_wv=1027&k=Z3n1MpEp)  
+邮箱：<lgc2333@126.com>
+
+## 💡 鸣谢
+
+### [hamo-reid/nonebot_plugin_PicMenu](https://github.com/hamo-reid/nonebot_plugin_PicMenu)
+
+- 灵感来源（？）
+
+## 💰 赞助
+
+**[赞助我](https://blog.lgc2333.top/donate)**
+
+感谢大家的赞助！你们的赞助将是我继续创作的动力！
+
+## 📝 更新日志
+
+芝士刚刚发布的插件，还没有更新日志的说 qwq~

nonebot_plugin_picmenu_next-0.1.0/nonebot_plugin_picmenu_next/__init__.py

@@ -0,0 +1,33 @@
+# ruff: noqa: E402
+
+from nonebot import get_driver
+from nonebot.plugin import PluginMetadata, inherit_supported_adapters, require
+
+require("nonebot_plugin_alconna")
+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"
+__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"),
+    extra={"License": "MIT", "Author": "LgCookie"},
+)
+
+load_builtin_templates()
+
+driver = get_driver()
+
+
+@driver.on_startup
+async def _():
+    await refresh_infos()

nonebot_plugin_picmenu_next-0.1.0/nonebot_plugin_picmenu_next/__main__.py

@@ -0,0 +1,203 @@
+from collections.abc import Sequence
+from pathlib import Path
+from typing import Optional, TypeVar
+
+from arclet.alconna import Alconna, Arg, Args, CommandMeta, Option, store_true
+from loguru import logger
+from nonebot.adapters import Bot as BaseBot, Event as BaseEvent
+from nonebot.permission import SUPERUSER
+from nonebot_plugin_alconna import Query, on_alconna
+from nonebot_plugin_alconna.uniseg import UniMessage
+from thefuzz import process
+
+from .config import config
+from .data_source import get_infos
+from .data_source.mixin import resolve_detail_mixin, resolve_main_mixin
+from .data_source.models import PinyinChunkSequence, PMDataItem, PMNPluginInfo
+from .templates import detail_templates, func_detail_templates, index_templates
+
+RES_DIR = Path(__file__).parent / "res"
+TIP_IMG_PATH = RES_DIR / "gan_shen_me.jpg"
+
+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]:
+    raw_scores = [x[1] for x in process.extractWithoutOrder(query, choices)]
+    pinyin_scores = [
+        x[1] for x in process.extractWithoutOrder(query_pinyin, choices_pinyin)
+    ]
+    similarities = [
+        raw_weight * raw + pinyin_weight * pinyin
+        for raw, pinyin in zip(raw_scores, pinyin_scores)
+    ]
+    logger.opt(lazy=True).debug(
+        "Query: {}, similarities:\n{}",
+        lambda: f"{query} ({query_pinyin})",
+        lambda: ";\n".join(
+            (
+                f"{choices[i]} ({choices_pinyin[i]})"
+                f": ({raw} * {raw_weight}) + ({pin} * {pinyin_weight}) = {sim}"
+            )
+            for i, (raw, pin, sim) in sorted(
+                enumerate(zip(raw_scores, pinyin_scores, 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.casefold_name)
+        choices_pinyin.append(info.name_pinyin.casefold_str)
+
+    similarities = get_name_similarities(
+        query.casefold(),
+        PinyinChunkSequence.from_raw(query).casefold_str,
+        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.casefold_func)
+        choices_pinyin.append(data.func_pinyin.casefold_str)
+
+    similarities = get_name_similarities(
+        query.casefold(),
+        PinyinChunkSequence.from_raw(query).casefold_str,
+        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 _(
+    bot: BaseBot,
+    ev: BaseEvent,
+    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),
+):
+    show_hidden = q_show_hidden.result
+    if (
+        show_hidden
+        and config.only_superuser_see_hidden
+        and (not await SUPERUSER(bot, ev))
+    ):
+        await (
+            UniMessage.image(raw=TIP_IMG_PATH.read_bytes())
+            .text("别想看咱藏起来的东西！")
+            .finish(reply_to=True)
+        )
+
+    infos = await resolve_main_mixin(get_infos())
+    if not show_hidden:
+        infos = [x for x in infos if not x.pmn.hidden]
+
+    if not q_plugin.result:
+        m = await index_templates.get()(infos, show_hidden)
+        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, show_hidden)
+        await m.finish()
+
+    info = await resolve_detail_mixin(info)
+    pm_data = info.pm_data
+    if pm_data and (not show_hidden):
+        pm_data = [x for x in pm_data if not x.hidden]
+
+    if not pm_data:
+        await UniMessage.text(
+            f"插件 `{info.name}` 没有详细功能介绍哦",
+        ).finish(reply_to=True)
+
+    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, show_hidden)
+    await m.finish()