nonebot-plugin-parser 2.1.2__tar.gz → 2.2.0__tar.gz

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-parser
-Version: 2.1.2
+Version: 2.2.0
 Summary: NoneBot2 链接分享解析 Alconna 版, 通用媒体卡片渲染(PIL 实现), 支持 B站/抖音/快手/微博/小红书/youtube/tiktok/twitter/acfun/nga
 Keywords: acfun,bilibili,douyin,kuaishou,nga,nonebot,nonebot2,tiktok,twitter,video,weibo,xiaohongshu,youtube
 Author: fllesser
@@ -167,15 +167,27 @@ Description-Content-Type: text/markdown
 
 <details>
 <summary>安装必要组件</summary>
-部分解析依赖于 ffmpeg
 
-ubuntu/debian
+部分解析依赖 `ffmpeg`
+
+`ubuntu/debian`
 
     sudo apt-get install ffmpeg
 
-其他 linux 参考(原项目推荐): https://gitee.com/baihu433/ffmpeg
+其他 `Linux` 参考(原项目推荐): https://gitee.com/baihu433/ffmpeg
+
+`Windows` 参考(原项目推荐): https://www.jianshu.com/p/5015a477de3c
+
+`yt-dlp` 自 `2025.11.12` 起要求用户安装外部 `JavaScript Runtime`，参考 https://github.com/yt-dlp/yt-dlp/releases/tag/2025.11.12, 推荐安装 [Deno](https://deno.com)
+
+`macOS / Linux`
+
+    curl -fsSL https://deno.land/install.sh | sh
+
+`windows`
+
+    irm https://deno.land/install.ps1 | iex
 
-Windows 参考(原项目推荐): https://www.jianshu.com/p/5015a477de3c
 </details>
 
 ## ⚙️ 配置
@@ -199,6 +211,10 @@ parser_bili_ck="SESSDATA=xxxxxxxxxx;ac_time_value=131231241231241"
 # 后两项在不同设备可能有兼容性问题，如需完全避免，可只填一项，如 '["avc"]'
 parser_bili_video_codes='["avc", "av01", "hev"]'
 
+# [可选] B 站视频清晰度
+# 360p(16), 480p(32), 720p(64), 1080p(80), 1080p+(112), 1080p_60(116), 4k(120)
+parser_bili_video_quality=80
+
 # [可选] Youtube Cookie, Youtube 视频因人机检测下载失败，需填
 parser_ytb_ck=""
 
@@ -245,6 +261,7 @@ parser_need_forward_contents=True
 
 <details>
 <summary>推荐的字体</summary>
+
 - [LXGW ZhenKai / 霞鹜臻楷](https://github.com/lxgw/LxgwZhenKai) 效果图使用字体
 - [LXGW Neo XiHei / 霞鹜新晰黑](https://github.com/lxgw/LxgwNeoXiHei)
 - [LXGW Neo ZhiSong / 霞鹜新致宋 / 霞鶩新緻宋](https://github.com/lxgw/LxgwNeoZhiSong)
@@ -255,12 +272,12 @@ parser_need_forward_contents=True
 | :------: | :-------------------: | :---: | :---: | :---------------: |
 | 开启解析 | SUPERUSER/OWNER/ADMIN |  是   | 群聊  |     开启解析      |
 | 关闭解析 | SUPERUSER/OWNER/ADMIN |  是   | 群聊  |     关闭解析      |
-|    bm    |          ALL          |  否   | 群聊  |   下载 B 站音频   |
-|    ym    |          ALL          |  否   | 群聊  | 下载 youtube 音频 |
+|    bm    |           -           |  否   | 群聊  |   下载 B 站音频   |
+|    ym    |           -           |  否   | 群聊  | 下载 youtube 音频 |
 
 ## 🧩 扩展
 > [!IMPORTANT]
-> 插件自 `v2.1.1` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `patterns`, `parse` 即可
+> 插件自 `v2.2.0` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `handle` 即可
 <details>
 <summary>完整示例</summary>
 
@@ -273,7 +290,7 @@ from nonebot import require
 
 require("nonebot_plugin_parser")
 from nonebot_plugin_parser.parsers import BaseParser, ParseResult
-from nonebot_plugin_parser.parsers.base import Platform
+from nonebot_plugin_parser.parsers.base import Platform, handle
 
 
 class ExampleParser(BaseParser):
@@ -281,21 +298,20 @@ class ExampleParser(BaseParser):
 
     platform: ClassVar[Platform] = Platform(name="example", display_name="示例网站")
 
-    patterns: ClassVar[list[tuple[str, str]]] = [
-        ("example.com", r"example\.com/video/(?P<video_id>\w+)"),
-        ("ex.short", r"ex\.short/(?P<short_id>\w+)"),
-    ]
-
-    async def parse(self, keyword: str, searched: Match[str]) -> ParseResult:
+    @handle("ex.short", r"ex\.short/\w+)")
+    async def _parse_short_link(self, searched: re.Match[str]):
+        """解析短链"""
+        url = f"https://{searched.group(0)}"
+        # 重定向再解析，请确保重定向链接的 handle 存在
+        # 比如 url 重定向到 example.com/... 就会调用 _parse 解析
+        return await self.parse_with_redirect(url)
+
+    @handle("example.com", r"example\.com/video/(?P<video_id>\w+)")
+    @handle("exam.ple", r"exam\.ple/(?P<video_id>\w+)")
+    async def _parse(self, searched: Match[str]) -> ParseResult:
         # 1. 提取视频 ID
-        if keyword == "ex.short":
-            # 处理短链接
-            short_id = searched.group("short_id")
-            full_url = await self.get_redirect_url(f"https://ex.short/{short_id}")
-            video_id = full_url.split("/")[-1]
-        else:
-            video_id = searched.group("video_id")
-
+        video_id = searched.group("video_id")
+    
         # 2. 请求 API 获取视频信息
         async with AsyncClient(headers=self.headers, timeout=self.timeout) as client:
             resp = await client.get(f"https://api.example.com/video/{video_id}")

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/README.md

@@ -121,15 +121,27 @@
 
 <details>
 <summary>安装必要组件</summary>
-部分解析依赖于 ffmpeg
 
-ubuntu/debian
+部分解析依赖 `ffmpeg`
+
+`ubuntu/debian`
 
     sudo apt-get install ffmpeg
 
-其他 linux 参考(原项目推荐): https://gitee.com/baihu433/ffmpeg
+其他 `Linux` 参考(原项目推荐): https://gitee.com/baihu433/ffmpeg
+
+`Windows` 参考(原项目推荐): https://www.jianshu.com/p/5015a477de3c
+
+`yt-dlp` 自 `2025.11.12` 起要求用户安装外部 `JavaScript Runtime`，参考 https://github.com/yt-dlp/yt-dlp/releases/tag/2025.11.12, 推荐安装 [Deno](https://deno.com)
+
+`macOS / Linux`
+
+    curl -fsSL https://deno.land/install.sh | sh
+
+`windows`
+
+    irm https://deno.land/install.ps1 | iex
 
-Windows 参考(原项目推荐): https://www.jianshu.com/p/5015a477de3c
 </details>
 
 ## ⚙️ 配置
@@ -153,6 +165,10 @@ parser_bili_ck="SESSDATA=xxxxxxxxxx;ac_time_value=131231241231241"
 # 后两项在不同设备可能有兼容性问题，如需完全避免，可只填一项，如 '["avc"]'
 parser_bili_video_codes='["avc", "av01", "hev"]'
 
+# [可选] B 站视频清晰度
+# 360p(16), 480p(32), 720p(64), 1080p(80), 1080p+(112), 1080p_60(116), 4k(120)
+parser_bili_video_quality=80
+
 # [可选] Youtube Cookie, Youtube 视频因人机检测下载失败，需填
 parser_ytb_ck=""
 
@@ -199,6 +215,7 @@ parser_need_forward_contents=True
 
 <details>
 <summary>推荐的字体</summary>
+
 - [LXGW ZhenKai / 霞鹜臻楷](https://github.com/lxgw/LxgwZhenKai) 效果图使用字体
 - [LXGW Neo XiHei / 霞鹜新晰黑](https://github.com/lxgw/LxgwNeoXiHei)
 - [LXGW Neo ZhiSong / 霞鹜新致宋 / 霞鶩新緻宋](https://github.com/lxgw/LxgwNeoZhiSong)
@@ -209,12 +226,12 @@ parser_need_forward_contents=True
 | :------: | :-------------------: | :---: | :---: | :---------------: |
 | 开启解析 | SUPERUSER/OWNER/ADMIN |  是   | 群聊  |     开启解析      |
 | 关闭解析 | SUPERUSER/OWNER/ADMIN |  是   | 群聊  |     关闭解析      |
-|    bm    |          ALL          |  否   | 群聊  |   下载 B 站音频   |
-|    ym    |          ALL          |  否   | 群聊  | 下载 youtube 音频 |
+|    bm    |           -           |  否   | 群聊  |   下载 B 站音频   |
+|    ym    |           -           |  否   | 群聊  | 下载 youtube 音频 |
 
 ## 🧩 扩展
 > [!IMPORTANT]
-> 插件自 `v2.1.1` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `patterns`, `parse` 即可
+> 插件自 `v2.2.0` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `handle` 即可
 <details>
 <summary>完整示例</summary>
 
@@ -227,7 +244,7 @@ from nonebot import require
 
 require("nonebot_plugin_parser")
 from nonebot_plugin_parser.parsers import BaseParser, ParseResult
-from nonebot_plugin_parser.parsers.base import Platform
+from nonebot_plugin_parser.parsers.base import Platform, handle
 
 
 class ExampleParser(BaseParser):
@@ -235,21 +252,20 @@ class ExampleParser(BaseParser):
 
     platform: ClassVar[Platform] = Platform(name="example", display_name="示例网站")
 
-    patterns: ClassVar[list[tuple[str, str]]] = [
-        ("example.com", r"example\.com/video/(?P<video_id>\w+)"),
-        ("ex.short", r"ex\.short/(?P<short_id>\w+)"),
-    ]
-
-    async def parse(self, keyword: str, searched: Match[str]) -> ParseResult:
+    @handle("ex.short", r"ex\.short/\w+)")
+    async def _parse_short_link(self, searched: re.Match[str]):
+        """解析短链"""
+        url = f"https://{searched.group(0)}"
+        # 重定向再解析，请确保重定向链接的 handle 存在
+        # 比如 url 重定向到 example.com/... 就会调用 _parse 解析
+        return await self.parse_with_redirect(url)
+
+    @handle("example.com", r"example\.com/video/(?P<video_id>\w+)")
+    @handle("exam.ple", r"exam\.ple/(?P<video_id>\w+)")
+    async def _parse(self, searched: Match[str]) -> ParseResult:
         # 1. 提取视频 ID
-        if keyword == "ex.short":
-            # 处理短链接
-            short_id = searched.group("short_id")
-            full_url = await self.get_redirect_url(f"https://ex.short/{short_id}")
-            video_id = full_url.split("/")[-1]
-        else:
-            video_id = searched.group("video_id")
-
+        video_id = searched.group("video_id")
+    
         # 2. 请求 API 获取视频信息
         async with AsyncClient(headers=self.headers, timeout=self.timeout) as client:
             resp = await client.get(f"https://api.example.com/video/{video_id}")

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parser"
-version = "2.1.2"
+version = "2.2.0"
 description = "NoneBot2 链接分享解析 Alconna 版, 通用媒体卡片渲染(PIL 实现), 支持 B站/抖音/快手/微博/小红书/youtube/tiktok/twitter/acfun/nga"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -86,9 +86,9 @@ requires = ["uv_build>=0.9.0,<0.10.0"]
 build-backend = "uv_build"
 
 [tool.bumpversion]
-current_version = "2.1.2"
+current_version = "2.2.0"
 commit = true
-message = "🔖 release: bump vesion from {current_version} to {new_version}"
+message = "release: bump vesion from {current_version} to {new_version}"
 tag = true
 
 [[tool.bumpversion.files]]

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/config.py

@@ -1,7 +1,7 @@
 from enum import Enum
 from pathlib import Path
 
-from bilibili_api.video import VideoCodecs
+from bilibili_api.video import VideoCodecs, VideoQuality
 from nonebot import get_driver, get_plugin_config, require
 from pydantic import BaseModel
 
@@ -43,8 +43,14 @@ class Config(BaseModel):
     """是否在解析结果中附加原始URL"""
     parser_disabled_platforms: list[PlatformEnum] = []
     """禁止的解析器"""
-    parser_bili_video_codes: list[VideoCodecs] = [VideoCodecs.AVC, VideoCodecs.AV1, VideoCodecs.HEV]
+    parser_bili_video_codes: list[VideoCodecs] = [
+        VideoCodecs.AVC,
+        VideoCodecs.AV1,
+        VideoCodecs.HEV,
+    ]
     """B站视频编码"""
+    parser_bili_video_quality: VideoQuality = VideoQuality._1080P
+    """B站视频分辨率"""
     parser_render_type: RenderType = RenderType.common
     """Renderer 类型"""
     parser_custom_font: str | None = None
@@ -92,6 +98,11 @@ class Config(BaseModel):
         """B站视频编码"""
         return self.parser_bili_video_codes
 
+    @property
+    def bili_video_quality(self) -> VideoQuality:
+        """B站视频分辨率"""
+        return self.parser_bili_video_quality
+
     @property
     def render_type(self) -> RenderType:
         """Renderer 类型"""

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/download/__init__.py

@@ -33,8 +33,8 @@ class StreamDownloader:
 
         Args:
             url (str): url address
-            file_name (str | None, optional): file name. Defaults to get name by parse_url_resource_name.
-            ext_headers (dict[str, str] | None, optional): ext headers. Defaults to None.
+            file_name (str | None): file name. Defaults to generate_file_name.
+            ext_headers (dict[str, str] | None): ext headers. Defaults to None.
 
         Returns:
             Path: file path
@@ -84,7 +84,7 @@ class StreamDownloader:
 
         Args:
             desc (str): 描述
-            total (int | None, optional): 总大小. Defaults to None.
+            total (int | None): 总大小. Defaults to None.
 
         Returns:
             tqdm: 进度条
@@ -111,8 +111,8 @@ class StreamDownloader:
 
         Args:
             url (str): url address
-            video_name (str | None, optional): video name. Defaults to get name by parse url.
-            ext_headers (dict[str, str] | None, optional): ext headers. Defaults to None.
+            video_name (str | None): video name. Defaults to get name by parse url.
+            ext_headers (dict[str, str] | None): ext headers. Defaults to None.
 
         Returns:
             Path: video file path
@@ -136,8 +136,8 @@ class StreamDownloader:
 
         Args:
             url (str): url address
-            audio_name (str | None, optional): audio name. Defaults to get name by parse_url_resource_name.
-            ext_headers (dict[str, str] | None, optional): ext headers. Defaults to None.
+            audio_name (str | None ): audio name. Defaults to get name by parse_url_resource_name.
+            ext_headers (dict[str, str] | None): ext headers. Defaults to None.
 
         Returns:
             Path: audio file path
@@ -161,8 +161,8 @@ class StreamDownloader:
 
         Args:
             url (str): url
-            img_name (str, optional): image name. Defaults to None.
-            ext_headers (dict[str, str], optional): ext headers. Defaults to None.
+            img_name (str | None): image name. Defaults to None.
+            ext_headers (dict[str, str] | None): ext headers. Defaults to None.
 
         Returns:
             Path: image file path
@@ -184,13 +184,14 @@ class StreamDownloader:
 
         Args:
             urls (list[str]): urls
-            ext_headers (dict[str, str] | None, optional): ext headers. Defaults to None.
+            ext_headers (dict[str, str] | None): ext headers. Defaults to None.
 
         Returns:
             list[Path]: image file paths
         """
         paths_or_errs = await asyncio.gather(
-            *[self.download_img(url, ext_headers=ext_headers) for url in urls], return_exceptions=True
+            *[self.download_img(url, ext_headers=ext_headers) for url in urls],
+            return_exceptions=True,
         )
         return [p for p in paths_or_errs if isinstance(p, Path)]
 

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/download/ytdlp.py

@@ -45,16 +45,16 @@ class YtdlpDownloader:
             "force_generic_extractor": True,
         }
         self._ydl_download_base_opts: dict[str, Any] = {}
-        if pconfig.proxy is not None:
-            self._ydl_download_base_opts["proxy"] = pconfig.proxy
-            self._ydl_extract_base_opts["proxy"] = pconfig.proxy
+        if proxy := pconfig.proxy:
+            self._ydl_download_base_opts["proxy"] = proxy
+            self._ydl_extract_base_opts["proxy"] = proxy
 
     async def extract_video_info(self, url: str, cookiefile: Path | None = None) -> VideoInfo:
         """get video info by url
 
         Args:
             url (str): url address
-            cookiefile (Path | None, optional): cookie file path. Defaults to None.
+            cookiefile (Path | None ): cookie file path. Defaults to None.
 
         Returns:
             dict[str, str]: video info
@@ -62,12 +62,12 @@ class YtdlpDownloader:
         video_info = self._video_info_mapping.get(url, None)
         if video_info:
             return video_info
-        ydl_opts = {} | self._ydl_extract_base_opts
+        ydl_opts = self._ydl_extract_base_opts.copy()
 
         if cookiefile:
             ydl_opts["cookiefile"] = str(cookiefile)
 
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:  # pyright: ignore[reportArgumentType]
             info_dict = await asyncio.to_thread(ydl.extract_info, url, download=False)
             if not info_dict:
                 raise ParseException("获取视频信息失败")
@@ -82,7 +82,7 @@ class YtdlpDownloader:
 
         Args:
             url (str): url address
-            cookiefile (Path | None, optional): cookie file path. Defaults to None.
+            cookiefile (Path | None): cookie file path. Defaults to None.
 
         Returns:
             Path: video file path
@@ -105,7 +105,7 @@ class YtdlpDownloader:
         if cookiefile:
             ydl_opts["cookiefile"] = str(cookiefile)
 
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:  # pyright: ignore[reportArgumentType]
             await asyncio.to_thread(ydl.download, [url])
         return video_path
 
@@ -115,7 +115,7 @@ class YtdlpDownloader:
 
         Args:
             url (str): url address
-            cookiefile (Path | None, optional): cookie file path. Defaults to None.
+            cookiefile (Path | None): cookie file path. Defaults to None.
 
         Returns:
             Path: audio file path
@@ -139,6 +139,6 @@ class YtdlpDownloader:
 
         if cookiefile:
             ydl_opts["cookiefile"] = str(cookiefile)
-        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:  # pyright: ignore[reportArgumentType]
             await asyncio.to_thread(ydl.download, [url])
         return audio_path

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/helper.py

@@ -1,9 +1,14 @@
 from collections.abc import Sequence
+from functools import wraps
 from pathlib import Path
+from typing import Literal
 
+from nonebot import logger
+from nonebot.adapters import Event
 from nonebot.internal.matcher import current_bot
-from nonebot_plugin_alconna import File, Image, Text, Video
-from nonebot_plugin_alconna.uniseg import Segment, UniMessage, Voice
+from nonebot.matcher import current_event
+from nonebot_plugin_alconna import File, Image, Text, Video, uniseg
+from nonebot_plugin_alconna.uniseg import Segment, SupportAdapter, UniMessage, Voice
 from nonebot_plugin_alconna.uniseg.segment import CustomNode, Reference
 
 from .config import pconfig
@@ -97,12 +102,12 @@ class UniHelper:
                 return Video(path=video_path)
 
     @staticmethod
-    def file_seg(file: Path, display_name: str = "") -> File:
+    def file_seg(file: Path, display_name: str | None = None) -> File:
         """获取文件 Seg
 
         Args:
             file (Path): 文件路径
-            display_name (str, optional): 显示名称. Defaults to file.name.
+            display_name (str): 显示名称. Defaults to file.name.
 
         Returns:
             File: 文件 Seg
@@ -115,3 +120,44 @@ class UniHelper:
             return File(raw=file.read_bytes(), name=display_name)
         else:
             return File(path=file, name=display_name)
+
+    @staticmethod
+    async def message_reaction(
+        event: Event,
+        status: Literal["fail", "resolving", "done"],
+    ) -> None:
+        emoji_map = {
+            "fail": ("10060", "❌"),
+            "resolving": ("424", "👀"),
+            "done": ("144", "🎉"),
+        }
+        message_id = uniseg.get_message_id(event)
+        target = uniseg.get_target(event)
+
+        if target.adapter in (SupportAdapter.onebot11, SupportAdapter.qq):
+            emoji = emoji_map[status][0]
+        else:
+            emoji = emoji_map[status][1]
+
+        try:
+            await uniseg.message_reaction(emoji, message_id=message_id)
+        except Exception:
+            logger.warning(f"reaction {emoji} to {message_id} failed, maybe not support")
+
+    @staticmethod
+    def exception_handler(func):
+        @wraps(func)
+        async def wrapper(*args, **kwargs):
+            event = current_event.get()
+            await UniHelper.message_reaction(event, "resolving")
+
+            try:
+                result = await func(*args, **kwargs)
+            except Exception:
+                await UniHelper.message_reaction(event, "fail")
+                raise
+
+            await UniHelper.message_reaction(event, "done")
+            return result
+
+        return wrapper

{nonebot_plugin_parser-2.1.2 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/matchers/__init__.py

@@ -1,12 +1,9 @@
 """统一的解析器 matcher"""
 
-from typing import Literal
-
 from nonebot import get_driver, logger
-from nonebot.adapters import Event
-from nonebot_plugin_alconna import SupportAdapter
 
 from ..config import pconfig
+from ..helper import UniHelper
 from ..parsers import BaseParser, ParseResult
 from ..renders import get_renderer
 from ..utils import LimitedSizeDict
@@ -25,17 +22,17 @@ KEYWORD_PARSER_MAP: dict[str, BaseParser] = {}
 
 @get_driver().on_startup
 def register_parser_matcher():
-    enabled_parser_classes = _get_enabled_parser_classes()
+    enabled_classes = _get_enabled_parser_classes()
 
-    enabled_platform_names = []
-    for _cls in enabled_parser_classes:
+    enabled_platforms = []
+    for _cls in enabled_classes:
         parser = _cls()
-        enabled_platform_names.append(parser.platform.display_name)
-        for keyword, _ in _cls.patterns:
+        enabled_platforms.append(parser.platform.display_name)
+        for keyword, _ in _cls._key_patterns:
             KEYWORD_PARSER_MAP[keyword] = parser
-    logger.info(f"启用平台: {', '.join(sorted(enabled_platform_names))}")
+    logger.info(f"启用平台: {', '.join(sorted(enabled_platforms))}")
 
-    patterns = [p for _cls in enabled_parser_classes for p in _cls.patterns]
+    patterns = [p for _cls in enabled_classes for p in _cls._key_patterns]
     matcher = on_keyword_regex(*patterns)
     matcher.append_handler(parser_handler)
 
@@ -48,14 +45,11 @@ def clear_result_cache():
     _RESULT_CACHE.clear()
 
 
+@UniHelper.exception_handler
 async def parser_handler(
-    event: Event,
     sr: SearchResult = Searched(),
 ):
     """统一的解析处理器"""
-    # 响应用户处理中
-    await _message_reaction(event, "resolving")
-
     # 1. 获取缓存结果
     cache_key = sr.searched.group(0)
     result = _RESULT_CACHE.get(cache_key)
@@ -63,58 +57,19 @@ async def parser_handler(
     if result is None:
         # 2. 获取对应平台 parser
         parser = KEYWORD_PARSER_MAP[sr.keyword]
-
-        try:
-            result = await parser.parse(sr.keyword, sr.searched)
-        except Exception:
-            # await UniMessage(str(e)).send()
-            await _message_reaction(event, "fail")
-            raise
+        result = await parser.parse(sr.keyword, sr.searched)
         logger.debug(f"解析结果: {result}")
     else:
         logger.debug(f"命中缓存: {cache_key}, 结果: {result}")
 
     # 3. 渲染内容消息并发送
-    try:
-        renderer = get_renderer(result.platform.name)
-        async for message in renderer.render_messages(result):
-            await message.send()
-    except Exception:
-        await _message_reaction(event, "fail")
-        raise
+    renderer = get_renderer(result.platform.name)
+    async for message in renderer.render_messages(result):
+        await message.send()
 
     # 4. 无 raise 再缓存解析结果
     _RESULT_CACHE[cache_key] = result
 
-    # 5. 添加成功的消息响应
-    await _message_reaction(event, "done")
-
-
-from nonebot_plugin_alconna import uniseg
-
-
-async def _message_reaction(
-    event: Event,
-    status: Literal["fail", "resolving", "done"],
-) -> None:
-    emoji_map = {
-        "fail": ("10060", "❌"),
-        "resolving": ("424", "👀"),
-        "done": ("144", "🎉"),
-    }
-    message_id = uniseg.get_message_id(event)
-    target = uniseg.get_target(event)
-
-    if target.adapter in (SupportAdapter.onebot11, SupportAdapter.qq):
-        emoji = emoji_map[status][0]
-    else:
-        emoji = emoji_map[status][1]
-
-    try:
-        await uniseg.message_reaction(emoji, message_id=message_id)
-    except Exception:
-        logger.warning(f"reaction {emoji} to {message_id} failed, maybe not support")
-
 
 import re
 from typing import cast
@@ -125,11 +80,11 @@ from nonebot.params import CommandArg
 from nonebot_plugin_alconna import UniMessage
 
 from ..download import DOWNLOADER
-from ..helper import UniHelper
 from ..parsers import BilibiliParser
 
 
 @on_command("bm", priority=3, block=True).handle()
+@UniHelper.exception_handler
 async def _(message: Message = CommandArg()):
     text = message.extract_plain_text()
     matched = re.search(r"(BV[A-Za-z0-9]{10})(\s\d{1,3})?", text)
@@ -139,14 +94,15 @@ async def _(message: Message = CommandArg()):
     bvid, page_num = matched.group(1), matched.group(2)
     page_idx = int(page_num) if page_num else 0
 
-    bili_parser = KEYWORD_PARSER_MAP["BV"]
-    bili_parser = cast(BilibiliParser, bili_parser)
-    _, audio_url = await bili_parser.get_download_urls(bvid=bvid, page_index=page_idx)
+    parser = KEYWORD_PARSER_MAP["BV"]
+    parser = cast(BilibiliParser, parser)
+
+    _, audio_url = await parser.extract_download_urls(bvid=bvid, page_index=page_idx)
     if not audio_url:
         await UniMessage("未找到可下载的音频").finish()
 
     audio_path = await DOWNLOADER.download_audio(
-        audio_url, audio_name=f"{bvid}-{page_idx}.mp3", ext_headers=bili_parser.headers
+        audio_url, audio_name=f"{bvid}-{page_idx}.mp3", ext_headers=parser.headers
     )
     await UniMessage(UniHelper.record_seg(audio_path)).send()
 
@@ -160,6 +116,7 @@ if YTDLP_DOWNLOADER is not None:
     from ..parsers import YouTubeParser
 
     @on_command("ym", priority=3, block=True).handle()
+    @UniHelper.exception_handler
     async def _(message: Message = CommandArg()):
         text = message.extract_plain_text()
         ytb_parser = cast(YouTubeParser, KEYWORD_PARSER_MAP["youtu.be"])
@@ -168,6 +125,7 @@ if YTDLP_DOWNLOADER is not None:
             await UniMessage("请发送正确的 youtube 链接").finish()
 
         url = matched.group(0)
+
         audio_path = await YTDLP_DOWNLOADER.download_audio(url)
         await UniMessage(UniHelper.record_seg(audio_path)).send()