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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-parser
-Version: 2.2.0
+Version: 2.2.2
 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
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Multimedia :: Video
@@ -22,7 +23,7 @@ Requires-Dist: beautifulsoup4>=4.12.0,<5.0.0
 Requires-Dist: bilibili-api-python>=17.4.0,<18.0.0
 Requires-Dist: curl-cffi>=0.13.0,<1.0.0
 Requires-Dist: httpx>=0.27.2,<1.0.0
-Requires-Dist: msgspec>=0.19.0,<1.0.0
+Requires-Dist: msgspec>=0.20.0,<1.0.0
 Requires-Dist: nonebot-plugin-alconna>=0.59.4
 Requires-Dist: nonebot-plugin-apscheduler>=0.5.0,<1.0.0
 Requires-Dist: nonebot-plugin-localstore>=0.7.4,<1.0.0
@@ -68,19 +69,19 @@ Description-Content-Type: text/markdown
 
 ## 📖 介绍
 
-| 平台    | 触发的消息形态                        | 视频 | 图集 | 音频 |
-| ------- | ------------------------------------- | ---- | ---- | ---- |
-| B站     | BV号/链接(包含短链,BV,av)/卡片/小程序 | ✅​   | ✅​   | ✅​   |
-| 抖音    | 链接(分享链接，兼容电脑端链接)        | ✅​   | ✅​   | ❌️    |
-| 微博    | 链接(博文，视频，show)                | ✅​   | ✅​   | ❌️    |
-| 小红书  | 链接(含短链)/卡片                     | ✅​   | ✅​   | ❌️    |
-| 快手    | 链接(包含标准链接和短链)              | ✅​   | ✅​   | ❌️    |
-| acfun   | 链接                                  | ✅​   | ❌️    | ❌️    |
-| youtube | 链接(含短链)                          | ✅​   | ❌️    | ✅​   |
-| tiktok  | 链接                                  | ✅​   | ❌️    | ❌️    |
-| twitter | 链接                                  | ✅​   | ✅​   | ❌️    |
+| 平台    | 触发的消息形态                  | 视频 | 图集 | 音频 |
+| ------- | ------------------------------- | ---- | ---- | ---- |
+| B站     | av号/BV号/链接/短链/卡片/小程序 | ✅​   | ✅​   | ✅​   |
+| 抖音    | 链接(分享链接，兼容电脑端链接)  | ✅​   | ✅​   | ❌️    |
+| 微博    | 链接(博文，视频，show, 文章)    | ✅​   | ✅​   | ❌️    |
+| 小红书  | 链接(含短链)/卡片               | ✅​   | ✅​   | ❌️    |
+| 快手    | 链接(包含标准链接和短链)        | ✅​   | ✅​   | ❌️    |
+| acfun   | 链接                            | ✅​   | ❌️    | ❌️    |
+| youtube | 链接(含短链)                    | ✅​   | ❌️    | ✅​   |
+| tiktok  | 链接                            | ✅​   | ❌️    | ❌️    |
+| twitter | 链接                            | ✅​   | ✅​   | ❌️    |
 
-支持的链接，可参考 [测试链接](https://github.com/fllesser/nonebot-plugin-parser/blob/master/test_url.md)
+支持的链接，可参考 [测试链接](https://github.com/fllesser/nonebot-plugin-parser/blob/master/tests/others/test_urls.md)
 
 ## 🎨 效果图
 插件默认启用 PIL 实现的通用媒体卡片渲染，效果图如下
@@ -289,9 +290,7 @@ from httpx import AsyncClient
 from nonebot import require
 
 require("nonebot_plugin_parser")
-from nonebot_plugin_parser.parsers import BaseParser, ParseResult
-from nonebot_plugin_parser.parsers.base import Platform, handle
-
+from nonebot_plugin_parser.parsers import BaseParser, Platform, handle
 
 class ExampleParser(BaseParser):
     """示例视频网站解析器"""
@@ -299,7 +298,7 @@ class ExampleParser(BaseParser):
     platform: ClassVar[Platform] = Platform(name="example", display_name="示例网站")
 
     @handle("ex.short", r"ex\.short/\w+)")
-    async def _parse_short_link(self, searched: re.Match[str]):
+    async def _parse_short_link(self, searched: Match[str]):
         """解析短链"""
         url = f"https://{searched.group(0)}"
         # 重定向再解析，请确保重定向链接的 handle 存在
@@ -308,7 +307,7 @@ class ExampleParser(BaseParser):
 
     @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:
+    async def _parse(self, searched: Match[str]):
         # 1. 提取视频 ID
         video_id = searched.group("video_id")
     

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

@@ -22,19 +22,19 @@
 
 ## 📖 介绍
 
-| 平台    | 触发的消息形态                        | 视频 | 图集 | 音频 |
-| ------- | ------------------------------------- | ---- | ---- | ---- |
-| B站     | BV号/链接(包含短链,BV,av)/卡片/小程序 | ✅​   | ✅​   | ✅​   |
-| 抖音    | 链接(分享链接，兼容电脑端链接)        | ✅​   | ✅​   | ❌️    |
-| 微博    | 链接(博文，视频，show)                | ✅​   | ✅​   | ❌️    |
-| 小红书  | 链接(含短链)/卡片                     | ✅​   | ✅​   | ❌️    |
-| 快手    | 链接(包含标准链接和短链)              | ✅​   | ✅​   | ❌️    |
-| acfun   | 链接                                  | ✅​   | ❌️    | ❌️    |
-| youtube | 链接(含短链)                          | ✅​   | ❌️    | ✅​   |
-| tiktok  | 链接                                  | ✅​   | ❌️    | ❌️    |
-| twitter | 链接                                  | ✅​   | ✅​   | ❌️    |
-
-支持的链接，可参考 [测试链接](https://github.com/fllesser/nonebot-plugin-parser/blob/master/test_url.md)
+| 平台    | 触发的消息形态                  | 视频 | 图集 | 音频 |
+| ------- | ------------------------------- | ---- | ---- | ---- |
+| B站     | av号/BV号/链接/短链/卡片/小程序 | ✅​   | ✅​   | ✅​   |
+| 抖音    | 链接(分享链接，兼容电脑端链接)  | ✅​   | ✅​   | ❌️    |
+| 微博    | 链接(博文，视频，show, 文章)    | ✅​   | ✅​   | ❌️    |
+| 小红书  | 链接(含短链)/卡片               | ✅​   | ✅​   | ❌️    |
+| 快手    | 链接(包含标准链接和短链)        | ✅​   | ✅​   | ❌️    |
+| acfun   | 链接                            | ✅​   | ❌️    | ❌️    |
+| youtube | 链接(含短链)                    | ✅​   | ❌️    | ✅​   |
+| tiktok  | 链接                            | ✅​   | ❌️    | ❌️    |
+| twitter | 链接                            | ✅​   | ✅​   | ❌️    |
+
+支持的链接，可参考 [测试链接](https://github.com/fllesser/nonebot-plugin-parser/blob/master/tests/others/test_urls.md)
 
 ## 🎨 效果图
 插件默认启用 PIL 实现的通用媒体卡片渲染，效果图如下
@@ -243,9 +243,7 @@ from httpx import AsyncClient
 from nonebot import require
 
 require("nonebot_plugin_parser")
-from nonebot_plugin_parser.parsers import BaseParser, ParseResult
-from nonebot_plugin_parser.parsers.base import Platform, handle
-
+from nonebot_plugin_parser.parsers import BaseParser, Platform, handle
 
 class ExampleParser(BaseParser):
     """示例视频网站解析器"""
@@ -253,7 +251,7 @@ class ExampleParser(BaseParser):
     platform: ClassVar[Platform] = Platform(name="example", display_name="示例网站")
 
     @handle("ex.short", r"ex\.short/\w+)")
-    async def _parse_short_link(self, searched: re.Match[str]):
+    async def _parse_short_link(self, searched: Match[str]):
         """解析短链"""
         url = f"https://{searched.group(0)}"
         # 重定向再解析，请确保重定向链接的 handle 存在
@@ -262,7 +260,7 @@ class ExampleParser(BaseParser):
 
     @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:
+    async def _parse(self, searched: Match[str]):
         # 1. 提取视频 ID
         video_id = searched.group("video_id")
     

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

@@ -1,6 +1,8 @@
+#:tombi schema.strict = false
+
 [project]
 name = "nonebot-plugin-parser"
-version = "2.2.0"
+version = "2.2.2"
 description = "NoneBot2 链接分享解析 Alconna 版, 通用媒体卡片渲染(PIL 实现), 支持 B站/抖音/快手/微博/小红书/youtube/tiktok/twitter/acfun/nga"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -30,6 +32,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Topic :: Communications :: Chat",
   "Topic :: Internet :: WWW/HTTP",
   "Topic :: Multimedia :: Video",
@@ -40,7 +43,7 @@ dependencies = [
   "bilibili-api-python>=17.4.0,<18.0.0",
   "curl_cffi>=0.13.0,<1.0.0",
   "httpx>=0.27.2,<1.0.0",
-  "msgspec>=0.19.0,<1.0.0",
+  "msgspec>=0.20.0,<1.0.0",
   "nonebot-plugin-alconna>=0.59.4",
   "nonebot-plugin-apscheduler>=0.5.0,<1.0.0",
   "nonebot-plugin-localstore>=0.7.4,<1.0.0",
@@ -86,7 +89,7 @@ requires = ["uv_build>=0.9.0,<0.10.0"]
 build-backend = "uv_build"
 
 [tool.bumpversion]
-current_version = "2.2.0"
+current_version = "2.2.2"
 commit = true
 message = "release: bump vesion from {current_version} to {new_version}"
 tag = true

{nonebot_plugin_parser-2.2.0 → nonebot_plugin_parser-2.2.2}/src/nonebot_plugin_parser/constants.py

@@ -4,18 +4,24 @@ from typing import Final
 from httpx import Timeout
 
 COMMON_HEADER: Final[dict[str, str]] = {
-    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) "
-    "Chrome/55.0.2883.87 UBrowser/6.2.4098.3 Safari/537.36"
+    "User-Agent": (
+        "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) "
+        "Chrome/55.0.2883.87 UBrowser/6.2.4098.3 Safari/537.36"
+    )
 }
 
 IOS_HEADER: Final[dict[str, str]] = {
-    "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) "
-    "Version/16.6 Mobile/15E148 Safari/604.1 Edg/132.0.0.0"
+    "User-Agent": (
+        "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) "
+        "Version/16.6 Mobile/15E148 Safari/604.1 Edg/132.0.0.0"
+    )
 }
 
 ANDROID_HEADER: Final[dict[str, str]] = {
-    "User-Agent": "Mozilla/5.0 (Linux; Android 15; SM-G998B) AppleWebKit/537.36 (KHTML, like Gecko) "
-    "Chrome/132.0.0.0 Mobile Safari/537.36 Edg/132.0.0.0"
+    "User-Agent": (
+        "Mozilla/5.0 (Linux; Android 15; SM-G998B) AppleWebKit/537.36 (KHTML, like Gecko) "
+        "Chrome/132.0.0.0 Mobile Safari/537.36 Edg/132.0.0.0"
+    )
 }
 
 COMMON_TIMEOUT: Final[Timeout] = Timeout(connect=15.0, read=20.0, write=10.0, pool=10.0)

{nonebot_plugin_parser-2.2.0 → nonebot_plugin_parser-2.2.2}/src/nonebot_plugin_parser/exception.py

@@ -2,39 +2,45 @@ class ParseException(Exception):
     """异常基类"""
 
     def __init__(self, message: str):
+        super().__init__(message)
         self.message = message
 
 
+class TipException(ParseException):
+    """提示异常"""
+
+    pass
+
+
 class DownloadException(ParseException):
     """下载异常"""
 
     def __init__(self, message: str | None = None):
-        self.message = message or "媒体下载失败"
+        super().__init__(message or "媒体下载失败")
 
 
 class DownloadLimitException(DownloadException):
     """下载超过限制异常"""
 
-    def __init__(self):
-        raise NotImplementedError
+    pass
 
 
 class SizeLimitException(DownloadLimitException):
     """下载大小超过限制异常"""
 
     def __init__(self):
-        self.message = "媒体大小超过配置限制，取消下载"
+        super().__init__("媒体大小超过配置限制，取消下载")
 
 
 class DurationLimitException(DownloadLimitException):
     """下载时长超过限制异常"""
 
     def __init__(self):
-        self.message = "媒体时长超过配置限制，取消下载"
+        super().__init__("媒体时长超过配置限制，取消下载")
 
 
 class ZeroSizeException(DownloadException):
     """下载大小为 0 异常"""
 
     def __init__(self):
-        self.message = "媒体大小为 0, 取消下载"
+        super().__init__("媒体大小为 0, 取消下载")

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

@@ -1,25 +1,38 @@
-from collections.abc import Sequence
+from collections.abc import Awaitable, Callable, Sequence
 from functools import wraps
 from pathlib import Path
-from typing import Literal
+from typing import Any, ClassVar, Literal
 
 from nonebot import logger
 from nonebot.adapters import Event
-from nonebot.internal.matcher import current_bot
-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 nonebot.matcher import current_bot, current_event
+from nonebot_plugin_alconna import SupportAdapter, uniseg
+from nonebot_plugin_alconna.uniseg import (
+    CustomNode,
+    File,
+    Image,
+    Reference,
+    Segment,
+    Text,
+    UniMessage,
+    Video,
+    Voice,
+)
 
 from .config import pconfig
 
+# from .exception import TipException
+
 ForwardNodeInner = str | Segment | UniMessage
 """转发消息节点内部允许的类型"""
 
 
 class UniHelper:
     @staticmethod
-    def construct_forward_message(segments: Sequence[ForwardNodeInner], user_id: str | None = None) -> Reference:
+    def construct_forward_message(
+        segments: Sequence[ForwardNodeInner],
+        user_id: str | None = None,
+    ) -> Reference:
         """构造转发消息
 
         Args:
@@ -45,7 +58,10 @@ class UniHelper:
         return Reference(nodes=nodes)
 
     @staticmethod
-    def img_seg(img_path: Path | None = None, raw: bytes | None = None) -> Image:
+    def img_seg(
+        img_path: Path | None = None,
+        raw: bytes | None = None,
+    ) -> Image:
         """获取图片 Seg
 
         Args:
@@ -102,7 +118,10 @@ class UniHelper:
                 return Video(path=video_path)
 
     @staticmethod
-    def file_seg(file: Path, display_name: str | None = None) -> File:
+    def file_seg(
+        file: Path,
+        display_name: str | None = None,
+    ) -> File:
         """获取文件 Seg
 
         Args:
@@ -121,43 +140,65 @@ class UniHelper:
         else:
             return File(path=file, name=display_name)
 
-    @staticmethod
+    EMOJI_MAP: ClassVar[dict[str, tuple[str, str]]] = {
+        "fail": ("10060", "❌"),
+        "resolving": ("424", "👀"),
+        "done": ("144", "🎉"),
+    }
+
+    @classmethod
     async def message_reaction(
+        cls,
         event: Event,
         status: Literal["fail", "resolving", "done"],
     ) -> None:
-        emoji_map = {
-            "fail": ("10060", "❌"),
-            "resolving": ("424", "👀"),
-            "done": ("144", "🎉"),
-        }
+        """发送消息回应
+
+        Args:
+            event (Event): 事件对象
+            status (Literal["fail", "resolving", "done"]): 状态
+        """
         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]
+            emoji = cls.EMOJI_MAP[status][0]
         else:
-            emoji = emoji_map[status][1]
+            emoji = cls.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):
+    @classmethod
+    def with_reaction(cls, func: Callable[..., Awaitable[Any]]):
+        """自动回应装饰器
+
+        自动处理消息响应状态，并捕获 TipException 发送提示消息
+
+        Args:
+            func: 被装饰的函数
+
+        Returns:
+            装饰后的函数
+        """
+
         @wraps(func)
         async def wrapper(*args, **kwargs):
             event = current_event.get()
-            await UniHelper.message_reaction(event, "resolving")
+            await cls.message_reaction(event, "resolving")
 
             try:
                 result = await func(*args, **kwargs)
+            # except TipException as e:
+            #     await UniMessage.text(e.message).send()
+            #     raise
             except Exception:
-                await UniHelper.message_reaction(event, "fail")
+                await cls.message_reaction(event, "fail")
                 raise
 
-            await UniHelper.message_reaction(event, "done")
+            await cls.message_reaction(event, "done")
             return result
 
         return wrapper

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

@@ -45,7 +45,7 @@ def clear_result_cache():
     _RESULT_CACHE.clear()
 
 
-@UniHelper.exception_handler
+@UniHelper.with_reaction
 async def parser_handler(
     sr: SearchResult = Searched(),
 ):
@@ -67,7 +67,7 @@ async def parser_handler(
     async for message in renderer.render_messages(result):
         await message.send()
 
-    # 4. 无 raise 再缓存解析结果
+    # 4. 缓存解析结果
     _RESULT_CACHE[cache_key] = result
 
 
@@ -84,7 +84,7 @@ from ..parsers import BilibiliParser
 
 
 @on_command("bm", priority=3, block=True).handle()
-@UniHelper.exception_handler
+@UniHelper.with_reaction
 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)
@@ -116,13 +116,13 @@ if YTDLP_DOWNLOADER is not None:
     from ..parsers import YouTubeParser
 
     @on_command("ym", priority=3, block=True).handle()
-    @UniHelper.exception_handler
+    @UniHelper.with_reaction
     async def _(message: Message = CommandArg()):
         text = message.extract_plain_text()
         ytb_parser = cast(YouTubeParser, KEYWORD_PARSER_MAP["youtu.be"])
         _, matched = ytb_parser.search_url(text)
         if not matched:
-            await UniMessage("请发送正确的 youtube 链接").finish()
+            await UniMessage("请发送正确的油管链接").finish()
 
         url = matched.group(0)
 

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

@@ -3,7 +3,6 @@ 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
 from .nga import NGAParser as NGAParser
@@ -15,6 +14,24 @@ if YTDLP_DOWNLOADER is not None:
     from .tiktok import TikTokParser as TikTokParser
     from .youtube import YouTubeParser as YouTubeParser
 
+from .base import handle as handle
+from .data import AudioContent as AudioContent
+from .data import Author
+from .data import DynamicContent as DynamicContent
+from .data import GraphicsContent as GraphicsContent
+from .data import ImageContent as ImageContent
+from .data import ParseResult as ParseResult
+from .data import Platform as Platform
+from .data import VideoContent as VideoContent
+
 __all__ = [
+    "AudioContent",
+    "Author",
+    "DynamicContent",
+    "GraphicsContent",
+    "ImageContent",
     "ParseResult",
+    "Platform",
+    "VideoContent",
+    "handle",
 ]

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

@@ -119,8 +119,8 @@ class AcfunParser(BaseParser):
                             break
         except HTTPError:
             await safe_unlink(video_file)
-            logger.exception("acfun 视频下载失败")
-            raise DownloadException("acfun 视频下载失败")
+            logger.exception("视频下载失败")
+            raise DownloadException("视频下载失败")
         return video_file
 
     async def _parse_m3u8(self, m3u8_url: str):

{nonebot_plugin_parser-2.2.0 → nonebot_plugin_parser-2.2.2}/src/nonebot_plugin_parser/parsers/base.py

@@ -5,7 +5,7 @@ from asyncio import Task
 from collections.abc import Callable, Coroutine
 from pathlib import Path
 from re import Match, Pattern, compile
-from typing import Any, ClassVar, TypeVar, cast
+from typing import TYPE_CHECKING, Any, ClassVar, TypeVar, cast
 from typing_extensions import Unpack
 
 from ..config import pconfig as pconfig
@@ -16,6 +16,7 @@ from ..exception import DownloadException as DownloadException
 from ..exception import DurationLimitException as DurationLimitException
 from ..exception import ParseException as ParseException
 from ..exception import SizeLimitException as SizeLimitException
+from ..exception import TipException as TipException
 from ..exception import ZeroSizeException as ZeroSizeException
 from .data import ParseResult, ParseResultKwargs, Platform
 
@@ -55,8 +56,9 @@ class BaseParser:
     platform: ClassVar[Platform]
     """ 平台信息（包含名称和显示名称） """
 
-    _key_patterns: ClassVar[KeyPatterns]
-    _handlers: ClassVar[dict[str, HandlerFunc]]
+    if TYPE_CHECKING:
+        _key_patterns: ClassVar[KeyPatterns]
+        _handlers: ClassVar[dict[str, HandlerFunc]]
 
     def __init__(self):
         self.headers = COMMON_HEADER.copy()
@@ -106,7 +108,11 @@ class BaseParser:
         """
         return await self._handlers[keyword](self, searched)
 
-    async def parse_with_redirect(self, url: str, headers: dict[str, str] | None = None) -> ParseResult:
+    async def parse_with_redirect(
+        self,
+        url: str,
+        headers: dict[str, str] | None = None,
+    ) -> ParseResult:
         """先重定向再解析"""
         redirect_url = await self.get_redirect_url(url, headers=headers or self.headers)
 
@@ -124,7 +130,7 @@ class BaseParser:
                 continue
             if searched := pattern.search(url):
                 return keyword, searched
-        raise ValueError(f"无法匹配 {url}")
+        raise ParseException(f"无法匹配 {url}")
 
     @classmethod
     def result(cls, **kwargs: Unpack[ParseResultKwargs]) -> ParseResult:
@@ -136,7 +142,7 @@ class BaseParser:
         url: str,
         headers: dict[str, str] | None = None,
     ) -> str:
-        """获取重定向后的URL"""
+        """获取重定向后的 URL, 单次重定向"""
         from httpx import AsyncClient
 
         headers = headers or COMMON_HEADER.copy()
@@ -151,6 +157,26 @@ class BaseParser:
                 response.raise_for_status()
             return response.headers.get("Location", url)
 
+    @staticmethod
+    async def get_final_url(
+        url: str,
+        headers: dict[str, str] | None = None,
+    ) -> str:
+        """获取重定向后的 URL, 允许多次重定向"""
+        from httpx import AsyncClient
+
+        headers = headers or COMMON_HEADER.copy()
+        async with AsyncClient(
+            headers=headers,
+            verify=False,
+            follow_redirects=True,
+            timeout=COMMON_TIMEOUT,
+        ) as client:
+            response = await client.get(url)
+            if response.status_code >= 400:
+                response.raise_for_status()
+            return str(response.url)
+
     def create_author(
         self,
         name: str,