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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-parser
-Version: 2.1.3
+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,9 +211,9 @@ parser_bili_ck="SESSDATA=xxxxxxxxxx;ac_time_value=131231241231241"
 # 后两项在不同设备可能有兼容性问题，如需完全避免，可只填一项，如 '["avc"]'
 parser_bili_video_codes='["avc", "av01", "hev"]'
 
-# B 站视频分辨率
+# [可选] B 站视频清晰度
 # 360p(16), 480p(32), 720p(64), 1080p(80), 1080p+(112), 1080p_60(116), 4k(120)
-parser_bili_video_quality= 80
+parser_bili_video_quality=80
 
 # [可选] Youtube Cookie, Youtube 视频因人机检测下载失败，需填
 parser_ytb_ck=""
@@ -265,7 +277,7 @@ parser_need_forward_contents=True
 
 ## 🧩 扩展
 > [!IMPORTANT]
-> 插件自 `v2.1.1` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `patterns`, `parse` 即可
+> 插件自 `v2.2.0` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `handle` 即可
 <details>
 <summary>完整示例</summary>
 
@@ -278,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):
@@ -286,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.3 → 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,9 +165,9 @@ parser_bili_ck="SESSDATA=xxxxxxxxxx;ac_time_value=131231241231241"
 # 后两项在不同设备可能有兼容性问题，如需完全避免，可只填一项，如 '["avc"]'
 parser_bili_video_codes='["avc", "av01", "hev"]'
 
-# B 站视频分辨率
+# [可选] B 站视频清晰度
 # 360p(16), 480p(32), 720p(64), 1080p(80), 1080p+(112), 1080p_60(116), 4k(120)
-parser_bili_video_quality= 80
+parser_bili_video_quality=80
 
 # [可选] Youtube Cookie, Youtube 视频因人机检测下载失败，需填
 parser_ytb_ck=""
@@ -219,7 +231,7 @@ parser_need_forward_contents=True
 
 ## 🧩 扩展
 > [!IMPORTANT]
-> 插件自 `v2.1.1` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `patterns`, `parse` 即可
+> 插件自 `v2.2.0` 版本开始支持自定义解析器，通过继承 `BaseParser` 类并实现 `platform`, `handle` 即可
 <details>
 <summary>完整示例</summary>
 
@@ -232,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):
@@ -240,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.3 → nonebot_plugin_parser-2.2.0}/pyproject.toml

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

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

@@ -45,9 +45,9 @@ 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
@@ -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("获取视频信息失败")
@@ -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
 
@@ -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.3 → 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
@@ -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.3 → 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()
 

{nonebot_plugin_parser-2.1.3 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/matchers/rule.py

@@ -21,7 +21,12 @@ class SearchResult:
 
     __slots__ = ("keyword", "searched", "text")
 
-    def __init__(self, text: str, keyword: str, searched: re.Match[str]):
+    def __init__(
+        self,
+        text: str,
+        keyword: str,
+        searched: re.Match[str],
+    ):
         self.text: str = text
         self.keyword: str = keyword
         self.searched: re.Match[str] = searched
@@ -110,6 +115,9 @@ class KeyPatternList(list[tuple[str, re.Pattern[str]]]):
             if isinstance(pattern, str):
                 pattern = re.compile(pattern)
             self.append((key, pattern))
+        # 按 key 长 -> 短
+        self.sort(key=lambda x: -len(x[0]))
+        logger.debug(f"KeyWords: {[k for k, _ in self]}")
 
 
 class KeywordRegexRule:

{nonebot_plugin_parser-2.1.3 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/parsers/__init__.py

@@ -1,6 +1,8 @@
 # 导出所有 Parser 类
-from .acfun import AcfunParser as AcfunParser  # noqa: I001
+from ..download import YTDLP_DOWNLOADER
+from .acfun import AcfunParser as AcfunParser
 from .base import BaseParser as BaseParser
+from .bilibili import BilibiliParser as BilibiliParser
 from .data import ParseResult as ParseResult
 from .douyin import DouyinParser as DouyinParser
 from .kuaishou import KuaiShouParser as KuaiShouParser
@@ -8,9 +10,6 @@ from .nga import NGAParser as NGAParser
 from .twitter import TwitterParser as TwitterParser
 from .weibo import WeiBoParser as WeiBoParser
 from .xiaohongshu import XiaoHongShuParser as XiaoHongShuParser
-from .bilibili import BilibiliParser as BilibiliParser
-
-from ..download import YTDLP_DOWNLOADER
 
 if YTDLP_DOWNLOADER is not None:
     from .tiktok import TikTokParser as TikTokParser

{nonebot_plugin_parser-2.1.3 → nonebot_plugin_parser-2.2.0}/src/nonebot_plugin_parser/parsers/acfun.py

@@ -4,7 +4,6 @@ from pathlib import Path
 import re
 import time
 from typing import ClassVar
-from typing_extensions import override
 
 import aiofiles
 from httpx import AsyncClient, HTTPError
@@ -13,22 +12,40 @@ from nonebot import logger
 from ..constants import COMMON_TIMEOUT, DOWNLOAD_TIMEOUT
 from ..exception import DownloadException, ParseException
 from ..utils import safe_unlink
-from .base import DOWNLOADER, BaseParser, Platform, PlatformEnum, pconfig
+from .base import DOWNLOADER, BaseParser, Platform, PlatformEnum, handle, pconfig
 
 
 class AcfunParser(BaseParser):
     # 平台信息
     platform: ClassVar[Platform] = Platform(name=PlatformEnum.ACFUN, display_name="猴山")
 
-    # URL 正则表达式模式（keyword, pattern）
-    patterns: ClassVar[list[tuple[str, str]]] = [
-        ("acfun.cn", r"(?:ac=|/ac)(\d+)"),
-    ]
-
     def __init__(self):
         super().__init__()
         self.headers["referer"] = "https://www.acfun.cn/"
 
+    @handle("acfun.cn", r"(?:ac=|/ac)(?P<acid>\d+)")
+    async def _parse(self, searched: re.Match[str]):
+        acid = int(searched.group("acid"))
+        url = f"https://www.acfun.cn/v/ac{acid}"
+
+        m3u8_url, title, description, author, upload_time = await self.parse_video_info(url)
+        author = self.create_author(author) if author else None
+
+        # 2024-12-1 -> timestamp
+        timestamp = int(time.mktime(time.strptime(upload_time, "%Y-%m-%d")))
+        text = f"简介: {description}"
+
+        # 下载视频
+        video_task = asyncio.create_task(self.download_video(m3u8_url, acid))
+
+        return self.result(
+            title=title,
+            text=text,
+            author=author,
+            timestamp=timestamp,
+            contents=[self.create_video_content(video_task)],
+        )
+
     async def parse_video_info(self, url: str) -> tuple[str, str, str, str, str]:
         """解析acfun链接获取详细信息
 
@@ -132,26 +149,3 @@ class AcfunParser(BaseParser):
         m3u8_full_urls = [f"{m3u8_prefix}/{d}" for d in m3u8_relative_links]
 
         return m3u8_full_urls
-
-    @override
-    async def parse(self, keyword: str, searched: re.Match[str]):
-        acid = int(searched.group(1))
-        url = f"https://www.acfun.cn/v/ac{acid}"
-
-        m3u8_url, title, description, author, upload_time = await self.parse_video_info(url)
-        author = self.create_author(author) if author else None
-
-        # 2024-12-1 -> timestamp
-        timestamp = int(time.mktime(time.strptime(upload_time, "%Y-%m-%d")))
-        text = f"简介: {description}"
-
-        # 下载视频
-        video_task = asyncio.create_task(self.download_video(m3u8_url, acid))
-
-        return self.result(
-            title=title,
-            text=text,
-            author=author,
-            timestamp=timestamp,
-            contents=[self.create_video_content(video_task)],
-        )