nonebot-plugin-parser 2.6.0__tar.gz → 2.6.2__tar.gz

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nonebot-plugin-parser
-Version: 2.6.0
+Version: 2.6.2
 Summary: NoneBot2 链接分享解析 Alconna 版, 现支持B站|抖音|快手|微博|小红书|YouTube|TikTok|Twitter|AcFun|NGA
 Keywords: acfun,bilibili,douyin,kuaishou,nga,nonebot,nonebot2,tiktok,twitter,video,weibo,xiaohongshu,youtube
 Author: fllesser
@@ -19,20 +19,20 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Multimedia :: Video
-Requires-Dist: nonebot2>=2.4.3,<3.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: pillow>=11.0.0
 Requires-Dist: aiofiles>=25.1.0
 Requires-Dist: httpx>=0.27.2,<1.0.0
 Requires-Dist: msgspec>=0.20.0,<1.0.0
+Requires-Dist: nonebot2>=2.5.0,<3.0.0
 Requires-Dist: apilmoji[rich]>=0.3.1,<1.0.0
 Requires-Dist: beautifulsoup4>=4.12.0,<5.0.0
 Requires-Dist: curl-cffi>=0.13.0,!=0.14.0,<1.0.0
 Requires-Dist: bilibili-api-python>=17.4.1,<18.0.0
+Requires-Dist: nonebot-plugin-uninfo>=0.10.1,<1.0.0
 Requires-Dist: nonebot-plugin-alconna>=0.60.4,<1.0.0
-Requires-Dist: nonebot-plugin-apscheduler>=0.5.0,<1.0.0
 Requires-Dist: nonebot-plugin-localstore>=0.7.4,<1.0.0
-Requires-Dist: nonebot-plugin-uninfo>=0.10.1,<1.0.0
+Requires-Dist: nonebot-plugin-apscheduler>=0.5.0,<1.0.0
 Requires-Dist: nonebot-plugin-htmlkit>=0.1.0rc4 ; extra == 'all'
 Requires-Dist: nonebot-plugin-htmlrender>=0.6.7 ; extra == 'all'
 Requires-Dist: yt-dlp[default]>=2026.3.13 ; extra == 'all'
@@ -65,7 +65,7 @@ Description-Content-Type: text/markdown
 [![uv](https://img.shields.io/badge/package%20manager-uv-black?style=flat-square&logo=uv)](https://github.com/astral-sh/uv)
 [![ruff](https://img.shields.io/badge/code%20style-ruff-black?style=flat-square&logo=ruff)](https://github.com/astral-sh/ruff)
 <br/>
-[![pre-commit](https://results.pre-commit.ci/badge/github/fllesser/nonebot-plugin-parser/master.svg)](https://results.pre-commit.ci/latest/github/fllesser/nonebot-plugin-parser/master)
+[![prek](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json)](https://github.com/j178/prek)
 [![codecov](https://codecov.io/gh/fllesser/nonebot-plugin-parser/graph/badge.svg?token=VCS8IHSO7U)](https://codecov.io/gh/fllesser/nonebot-plugin-parser)
 [![qqgroup](https://img.shields.io/badge/QQ%E7%BE%A4-820082006-orange?style=flat-square)](https://qm.qq.com/q/y4T4CjHimc)
 
@@ -416,7 +416,7 @@ class ExampleParser(BaseParser):
 <details>
 <summary>辅助函数</summary>
 
-> 构建作者信息
+> 构建作者
 
 ```python
 author = self.create_author(
@@ -473,5 +473,5 @@ real_url = await self.get_redirect_url(
 
 ## 🎉 致谢
 
-- [nonebot-plugin-resolver](https://github.com/zhiyu1998/nonebot-plugin-resolver) | 初代解析插件
-- [parse-video-py](https://github.com/wujunwei928/parse-video-py) | 借鉴了抖音解析
+- [nonebot-plugin-resolver](https://github.com/zhiyu1998/nonebot-plugin-resolver) - 本项目最初基于此插件进行开发，在此表示感谢。尽管当前版本代码已完全重构，但仍感谢原项目提供的初始思路和参考。 
+- [parse-video-py](https://github.com/wujunwei928/parse-video-py) - 在抖音解析功能实现方面提供了技术参考和借鉴。

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/README.md

@@ -11,7 +11,7 @@
 [![uv](https://img.shields.io/badge/package%20manager-uv-black?style=flat-square&logo=uv)](https://github.com/astral-sh/uv)
 [![ruff](https://img.shields.io/badge/code%20style-ruff-black?style=flat-square&logo=ruff)](https://github.com/astral-sh/ruff)
 <br/>
-[![pre-commit](https://results.pre-commit.ci/badge/github/fllesser/nonebot-plugin-parser/master.svg)](https://results.pre-commit.ci/latest/github/fllesser/nonebot-plugin-parser/master)
+[![prek](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/j178/prek/master/docs/assets/badge-v0.json)](https://github.com/j178/prek)
 [![codecov](https://codecov.io/gh/fllesser/nonebot-plugin-parser/graph/badge.svg?token=VCS8IHSO7U)](https://codecov.io/gh/fllesser/nonebot-plugin-parser)
 [![qqgroup](https://img.shields.io/badge/QQ%E7%BE%A4-820082006-orange?style=flat-square)](https://qm.qq.com/q/y4T4CjHimc)
 
@@ -362,7 +362,7 @@ class ExampleParser(BaseParser):
 <details>
 <summary>辅助函数</summary>
 
-> 构建作者信息
+> 构建作者
 
 ```python
 author = self.create_author(
@@ -419,5 +419,5 @@ real_url = await self.get_redirect_url(
 
 ## 🎉 致谢
 
-- [nonebot-plugin-resolver](https://github.com/zhiyu1998/nonebot-plugin-resolver) | 初代解析插件
-- [parse-video-py](https://github.com/wujunwei928/parse-video-py) | 借鉴了抖音解析
+- [nonebot-plugin-resolver](https://github.com/zhiyu1998/nonebot-plugin-resolver) - 本项目最初基于此插件进行开发，在此表示感谢。尽管当前版本代码已完全重构，但仍感谢原项目提供的初始思路和参考。 
+- [parse-video-py](https://github.com/wujunwei928/parse-video-py) - 在抖音解析功能实现方面提供了技术参考和借鉴。

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-parser"
-version = "2.6.0"
+version = "2.6.2"
 description = "NoneBot2 链接分享解析 Alconna 版, 现支持B站|抖音|快手|微博|小红书|YouTube|TikTok|Twitter|AcFun|NGA"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -39,20 +39,20 @@ classifiers = [
 ]
 
 dependencies = [
-  "nonebot2>=2.4.3,<3.0.0",
   "rich>=13.0.0",
   "pillow>=11.0.0",
   "aiofiles>=25.1.0",
   "httpx>=0.27.2,<1.0.0",
   "msgspec>=0.20.0,<1.0.0",
+  "nonebot2>=2.5.0,<3.0.0",
   "apilmoji[rich]>=0.3.1,<1.0.0",
   "beautifulsoup4>=4.12.0,<5.0.0",
   "curl_cffi>=0.13.0,<1.0.0,!=0.14.0",
   "bilibili-api-python>=17.4.1,<18.0.0",
+  "nonebot-plugin-uninfo>=0.10.1,<1.0.0",
   "nonebot-plugin-alconna>=0.60.4,<1.0.0",
-  "nonebot-plugin-apscheduler>=0.5.0,<1.0.0",
   "nonebot-plugin-localstore>=0.7.4,<1.0.0",
-  "nonebot-plugin-uninfo>=0.10.1,<1.0.0",
+  "nonebot-plugin-apscheduler>=0.5.0,<1.0.0",
 ]
 
 [project.urls]
@@ -74,7 +74,7 @@ all = [
 
 [dependency-groups]
 dev = [
-  "nonebot2[fastapi]>=2.4.3,<3.0.0",
+  "nonebot2[fastapi]>=2.5.0,<3.0.0",
   "nonebot-adapter-onebot>=2.4.6",
   "ruff>=0.15.6,<1.0.0",
   { include-group = "extras" },
@@ -88,8 +88,8 @@ extras = [
   "types-yt-dlp>=2026.3.13.20260314",
 ]
 test = [
-  "nonebug>=0.4.3,<1.0.0",
-  "poethepoet>=0.42.1",
+  "nonebug>=0.4.4,<1.0.0",
+  "poethepoet>=0.42.1,<1.0.0",
   "pytest-asyncio>=1.3.0,<1.4.0",
   "pytest-cov>=7.0.0",
   "pytest-xdist>=3.8.0,<4.0.0",
@@ -112,13 +112,11 @@ conflicts = [
   ],
 ]
 
-[tool.uv.sources]
-nonebug = { git = "https://github.com/nonebot/nonebug", rev = "master" }
 
 [tool.bumpversion]
 tag = true
 commit = true
-current_version = "2.6.0"
+current_version = "2.6.2"
 message = "release: bump vesion from {current_version} to {new_version}"
 
 [[tool.bumpversion.files]]
@@ -150,7 +148,7 @@ test-render = "pytest tests/renders --cov=src --cov-report=xml --junitxml=junit.
 bump = "bump-my-version bump"
 show-bump = "bump-my-version show-bump"
 
-[tool.pyright]
+[tool.basedpyright]
 pythonVersion = "3.10"
 pythonPlatform = "All"
 defineConstant = { PYDANTIC_V2 = true }

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/download/__init__.py

@@ -4,9 +4,10 @@ from functools import partial
 from contextlib import contextmanager
 from urllib.parse import urljoin
 
+import httpx
 import aiofiles
-from httpx import HTTPError, AsyncClient
-from nonebot import logger
+import curl_cffi
+from nonebot import logger, get_driver
 from rich.progress import (
     Progress,
     BarColumn,
@@ -15,22 +16,27 @@ from rich.progress import (
 )
 
 from .task import auto_task
-from ..utils import merge_av, safe_unlink, generate_file_name
+from ..utils import merge_av, safe_unlink, generate_file_name, is_module_available
 from ..config import pconfig
 from ..constants import COMMON_HEADER, DOWNLOAD_TIMEOUT
 from ..exception import IgnoreException, DownloadException
 
 
 class StreamDownloader:
-    """Downloader class for downloading files with stream"""
-
     def __init__(self):
         self.headers: dict[str, str] = COMMON_HEADER.copy()
         self.cache_dir: Path = pconfig.cache_dir
-        self.client: AsyncClient = AsyncClient(timeout=DOWNLOAD_TIMEOUT, verify=False)
+        self.client: httpx.AsyncClient = httpx.AsyncClient(timeout=DOWNLOAD_TIMEOUT, verify=False)
+
+    async def aclose(self):
+        await self.client.aclose()
 
+    @staticmethod
     @contextmanager
-    def rich_progress(self, desc: str, total: int | None = None):
+    def rich_progress(
+        desc: str,
+        total: int | None = None,
+    ):
         with Progress(
             TextColumn("[bold blue]{task.description}", justify="right"),
             BarColumn(bar_width=None),
@@ -41,53 +47,83 @@ class StreamDownloader:
             task_id = progress.add_task(description=desc, total=total)
             yield partial(progress.update, task_id)
 
-    async def _download_file(
+    @staticmethod
+    def _validate_content_length(
+        response: httpx.Response | curl_cffi.Response,
+    ) -> int:
+        """获取文件长度"""
+        content_length = response.headers.get("Content-Length")
+        content_length = int(content_length) if content_length else 0
+
+        if content_length == 0:
+            logger.warning(f"媒体 url: {response.url}, 大小为 0, 取消下载")
+            raise IgnoreException
+
+        if (file_size := content_length / 1024 / 1024) > pconfig.max_size:
+            logger.warning(f"媒体 url: {response.url} 大小 {file_size:.2f} MB, 超过 {pconfig.max_size} MB, 取消下载")
+            raise IgnoreException
+
+        return content_length
+
+    async def _download_file_with_httpx(
         self,
         url: str,
         *,
-        file_name: str | None = None,
-        ext_headers: dict[str, str] | None = None,
+        file_path: Path,
+        headers: dict[str, str],
         chunk_size: int = 64 * 1024,
     ) -> Path:
         """download file by url with stream"""
-        if not file_name:
-            file_name = generate_file_name(url)
-        file_path = self.cache_dir / file_name
-        # 如果文件存在，则直接返回
-        if file_path.exists():
-            return file_path
 
-        headers = {**self.headers, **(ext_headers or {})}
+        async with self.client.stream(
+            "GET",
+            url,
+            headers=headers,
+            follow_redirects=True,
+        ) as response:
+            response.raise_for_status()
+            content_length = self._validate_content_length(response)
+
+            with self.rich_progress(
+                f"httpx | {file_path.name}",
+                content_length,
+            ) as update_progress:
+                async with aiofiles.open(file_path, "wb") as file:
+                    async for chunk in response.aiter_bytes(chunk_size):
+                        await file.write(chunk)
+                        update_progress(advance=len(chunk))
 
-        try:
-            async with self.client.stream("GET", url, headers=headers, follow_redirects=True) as response:
-                response.raise_for_status()
-                content_length = response.headers.get("Content-Length")
-                content_length = int(content_length) if content_length else 0
-
-                if content_length == 0:
-                    logger.warning(f"媒体 url: {url}, 大小为 0, 取消下载")
-                    raise IgnoreException
-
-                if (file_size := content_length / 1024 / 1024) > pconfig.max_size:
-                    logger.warning(f"媒体 url: {url} 大小 {file_size:.2f} MB, 超过 {pconfig.max_size} MB, 取消下载")
-                    raise IgnoreException
-
-                with self.rich_progress(file_name, content_length) as update_progress:
-                    async with aiofiles.open(file_path, "wb") as file:
-                        async for chunk in response.aiter_bytes(chunk_size):
-                            await file.write(chunk)
-                            update_progress(advance=len(chunk))
-
-        except HTTPError:
-            await safe_unlink(file_path)
-            logger.exception(f"下载失败 | url: {url}, file_path: {file_path}")
-            raise DownloadException("媒体下载失败")
+        return file_path
+
+    async def _download_file_with_curl_cffi(
+        self,
+        url: str,
+        *,
+        file_path: Path,
+        headers: dict[str, str],
+    ) -> Path:
+        async with curl_cffi.AsyncSession(allow_redirects=True) as session:
+            response: curl_cffi.Response = await session.get(
+                url,
+                headers=headers,
+                timeout=DOWNLOAD_TIMEOUT,
+                stream=True,
+            )
+            response.raise_for_status()
+            content_length = self._validate_content_length(response)
+
+            with self.rich_progress(
+                f"curl_cffi | {file_path.name}",
+                content_length,
+            ) as update_progress:
+                async with aiofiles.open(file_path, "wb") as file:
+                    async for chunk in response.aiter_content(chunk_size=8192):
+                        await file.write(chunk)
+                        update_progress(advance=len(chunk))
 
         return file_path
 
-    @auto_task
-    async def download_file(
+    async def _download_file(
         self,
         url: str,
         *,
@@ -95,13 +131,28 @@ class StreamDownloader:
         ext_headers: dict[str, str] | None = None,
         chunk_size: int = 64 * 1024,
     ) -> Path:
-        """download file by url with stream"""
-        return await self._download_file(
-            url,
-            file_name=file_name,
-            ext_headers=ext_headers,
-            chunk_size=chunk_size,
-        )
+        """download file by url with fallback"""
+        if not file_name:
+            file_name = generate_file_name(url)
+        file_path = self.cache_dir / file_name
+        if file_path.exists():
+            return file_path
+
+        headers = {**self.headers, **(ext_headers or {})}
+
+        try:
+            path = await self._download_file_with_httpx(
+                url, file_path=file_path, headers=headers, chunk_size=chunk_size
+            )
+        except httpx.HTTPError:
+            logger.opt(exception=True).warning(f"下载失败(httpx) | url: {url}")
+            try:
+                path = await self._download_file_with_curl_cffi(url, file_path=file_path, headers=headers)
+            except curl_cffi.CurlError:
+                logger.opt(exception=True).warning(f"下载失败(curl_cffi) | url: {url}")
+                raise DownloadException("媒体下载失败")
+
+        return path
 
     @auto_task
     async def download_video(
@@ -199,7 +250,7 @@ class StreamDownloader:
                                 await f.write(chunk)
                                 total_size += len(chunk)
                                 update_progress(advance=len(chunk), total=total_size)
-        except HTTPError:
+        except httpx.HTTPError:
             await safe_unlink(video_path)
             logger.exception("m3u8 视频下载失败")
             raise DownloadException("m3u8 视频下载失败")
@@ -224,13 +275,18 @@ class StreamDownloader:
         return slices
 
 
-DOWNLOADER: StreamDownloader = StreamDownloader()
-
-try:
-    import yt_dlp as yt_dlp
+downloader: StreamDownloader = StreamDownloader()
+"""全局下载器实例，提供下载功能"""
+yt_dlp_downloader = None
+"""yt-dlp 下载器实例，提供下载视频功能，若 yt-dlp 未安装则为 None"""
 
+if is_module_available("yt_dlp"):
     from .ytdlp import YtdlpDownloader
 
-    YTDLP_DOWNLOADER = YtdlpDownloader()
-except ImportError:
-    YTDLP_DOWNLOADER = None
+    yt_dlp_downloader = YtdlpDownloader()
+
+
+@get_driver().on_shutdown
+async def close_download_client():
+    logger.debug("正在关闭下载器...")
+    await downloader.aclose()

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/helper.py

@@ -31,6 +31,14 @@ EMOJI_MAP = {
     "resolving": ("424", "👀"),
     "done": ("144", "🎉"),
 }
+"""emoji 映射"""
+
+ID_ADAPTERS = {
+    SupportAdapter.onebot11,
+    SupportAdapter.qq,
+    SupportAdapter.milky,
+}
+"""支持的传入 emoji id 发送 reaction 的适配器"""
 
 
 class UniHelper:
@@ -127,15 +135,12 @@ class UniHelper:
         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]
+        emoji = EMOJI_MAP[status][0 if target.adapter in ID_ADAPTERS else 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")
+            logger.opt(exception=True).warning(f"reaction {emoji} to {message_id} failed, maybe not support")
 
     @classmethod
     def with_reaction(cls, func: Callable[..., Awaitable[Any]]):

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/matchers/__init__.py

@@ -112,9 +112,9 @@ async def _(message: Message = CommandArg()):
         await UniMessage(UniHelper.file_seg(audio_path)).send()
 
 
-from ..download import YTDLP_DOWNLOADER
+from ..download import yt_dlp_downloader
 
-if YTDLP_DOWNLOADER is not None:
+if yt_dlp_downloader is not None:
     from ..parsers import YouTubeParser
 
     @on_command("ym", priority=3, block=True).handle()
@@ -128,7 +128,7 @@ if YTDLP_DOWNLOADER is not None:
 
         url = matched.group(0)
 
-        audio_path = await YTDLP_DOWNLOADER.download_audio(url)
+        audio_path = await yt_dlp_downloader.download_audio(url)
         await UniMessage(UniHelper.record_seg(audio_path)).send()
 
         if pconfig.need_upload:

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/parsers/__init__.py

@@ -7,10 +7,10 @@ from .douyin import DouyinParser as DouyinParser
 from .twitter import TwitterParser as TwitterParser
 from .bilibili import BilibiliParser as BilibiliParser
 from .kuaishou import KuaiShouParser as KuaiShouParser
-from ..download import YTDLP_DOWNLOADER
+from ..download import yt_dlp_downloader as yt_dlp_downloader
 from .xiaohongshu import XiaoHongShuParser as XiaoHongShuParser
 
-if YTDLP_DOWNLOADER is not None:
+if yt_dlp_downloader is not None:
     from .tiktok import TikTokParser as TikTokParser
     from .youtube import YouTubeParser as YouTubeParser
 

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/parsers/acfun/__init__.py

@@ -50,7 +50,7 @@ class AcfunParser(BaseParser):
             text=video_info.text,
             author=author,
             timestamp=video_info.timestamp,
-            video=video_content,
+            contents=[video_content],
         )
 
     async def parse_video_info(self, url: str):

{nonebot_plugin_parser-2.6.0 → nonebot_plugin_parser-2.6.2}/src/nonebot_plugin_parser/parsers/base.py

@@ -1,15 +1,15 @@
 from re import Match, Pattern, compile
 from abc import ABC
-from typing import TYPE_CHECKING, Any, TypeVar, ClassVar, cast
+from typing import TYPE_CHECKING, Any, TypeVar, ClassVar, cast, final
 from asyncio import Task
 from pathlib import Path
 from collections.abc import Callable, Coroutine
-from typing_extensions import Unpack, final
+from typing_extensions import Unpack
 
 from .data import Platform, ParseResult, ImageContent, ParseResultKwargs
 from .task import PathTask
 from ..config import pconfig as pconfig
-from ..download import DOWNLOADER
+from ..download import downloader
 from ..constants import IOS_HEADER, COMMON_HEADER, ANDROID_HEADER, COMMON_TIMEOUT
 from ..constants import DOWNLOAD_TIMEOUT as DOWNLOAD_TIMEOUT
 from ..constants import PlatformEnum as PlatformEnum
@@ -170,7 +170,7 @@ class BaseParser:
         author = Author(name=name, description=description)
 
         if avatar_url:
-            author.avatar = PathTask(DOWNLOADER.download_img(avatar_url, ext_headers=self.headers))
+            author.avatar = PathTask(downloader.download_img(avatar_url, ext_headers=self.headers))
 
         return author
 
@@ -179,31 +179,48 @@ class BaseParser:
         url_or_task: str | Task[Path],
         cover_url: str | None = None,
         duration: float | None = None,
+        is_gif: bool = False,
     ):
-        """创建视频内容"""
+        """创建视频内容, 未指定封面时会尝试从视频中提取封面"""
         from .data import VideoContent
-        from ..utils import extract_video_cover
+        from ..utils import convert_video_to_gif, extract_video_first_frame
 
         if isinstance(url_or_task, str):
-            path_task = DOWNLOADER.download_video(url_or_task, ext_headers=self.headers)
+            path_task = downloader.download_video(url_or_task, ext_headers=self.headers)
         elif isinstance(url_or_task, Task):
             path_task = url_or_task
 
+        video_content = VideoContent(PathTask(path_task), duration=duration, is_gif=is_gif)
+
         if cover_url:
-            cover_task = DOWNLOADER.download_img(cover_url, ext_headers=self.headers)
+            cover_task = downloader.download_img(cover_url, ext_headers=self.headers)
         else:
             # 如果没有封面 URL，尝试从视频中提取封面
             async def extract_cover():
                 video_path = await path_task
-                return await extract_video_cover(video_path)
+                return await extract_video_first_frame(video_path)
 
             cover_task = extract_cover()
 
-        return VideoContent(
-            PathTask(path_task),
-            cover=PathTask(cover_task),
-            duration=duration,
-        )
+        video_content.cover = PathTask(cover_task)
+
+        if is_gif:
+            # 需要转换为 GIF
+            async def convert_to_gif():
+                video_path = await path_task
+                return await convert_video_to_gif(video_path)
+
+            video_content.gif_path = PathTask(convert_to_gif())
+
+        return video_content
+
+    def create_gif(
+        self,
+        url_or_task: str | Task[Path],
+        cover_url: str | None = None,
+    ):
+        """创建 GIF 内容"""
+        return self.create_video(url_or_task, cover_url=cover_url, is_gif=True)
 
     def create_images(
         self,
@@ -212,7 +229,7 @@ class BaseParser:
         """创建图片内容列表"""
         contents: list[ImageContent] = []
         for url in image_urls:
-            task = DOWNLOADER.download_img(url, ext_headers=self.headers)
+            task = downloader.download_img(url, ext_headers=self.headers)
             contents.append(ImageContent(PathTask(task)))
         return contents
 
@@ -223,7 +240,7 @@ class BaseParser:
     ):
         """创建单个图片内容"""
         if isinstance(url_or_task, str):
-            path_task = DOWNLOADER.download_img(url_or_task, ext_headers=self.headers)
+            path_task = downloader.download_img(url_or_task, ext_headers=self.headers)
         elif isinstance(url_or_task, Task):
             path_task = url_or_task
 
@@ -238,7 +255,7 @@ class BaseParser:
         from .data import AudioContent
 
         if isinstance(url_or_task, str):
-            path_task = DOWNLOADER.download_audio(url_or_task, ext_headers=self.headers)
+            path_task = downloader.download_audio(url_or_task, ext_headers=self.headers)
         elif isinstance(url_or_task, Task):
             path_task = url_or_task
 
@@ -246,4 +263,4 @@ class BaseParser:
 
     @property
     def downloader(self):
-        return DOWNLOADER
+        return downloader