refactor(download): 重命名下载函数参数以提高可读性

- 将 download_av_and_merge 函数中的参数 v_url 重命名为 video_url
- 将参数 a_url 重命名为 audio_url
- 将参数 merga_name 重命名为 merge_name
- 更新相应的文档字符串和调用处的参数名
- 在返回值说明中明确标注为 mp4 格式

Author: molanp

src/nonebot_plugin_parser_lite/download/__init__.py

@@ -834,9 +834,9 @@ async def download_img(
 
     async def download_av_and_merge(
         self,
-        v_url: str,
-        a_url: str,
-        merga_name: str,
+        video_url: str,
+        audio_url: str,
+        merge_name: str,
         video_name: str | None = None,
         audio_name: str | None = None,
         ext_headers: dict[str, str] | None = None,
@@ -845,35 +845,35 @@ async def download_av_and_merge(
         """
         下载音频和视频文件并合并
 
-        :param v_url: 视频流下载地址
-        :param a_url: 音频流下载地址
-        :param merga_name: 合并后输出文件名(不含扩展名)
+        :param video_url: 视频流下载地址
+        :param audio_url: 音频流下载地址
+        :param merge_name: 合并后输出文件名(不含扩展名)
         :param video_name: 保存到本地的视频文件名，为空时根据 url 自动生成 mp4 文件名
         :param audio_name: 保存到本地的音频文件名，为空时根据 url 自动生成 mp3 文件名
         :param ext_headers: 额外的请求头，会与默认请求头合并
         :param use_curl_cffi: 是否使用 curl_cffi 下载
-        :return: 合并后的视频文件本地路径
+        :return: 合并后的视频文件本地路径(mp4)
         :raise DownloadException: 下载或合并过程中发生错误时抛出
         """
         cache_dir = await CacheManager.ensure_dir(CacheManager.MEDIA)
-        output_path = cache_dir / f"{merga_name}.mp4"
+        output_path = cache_dir / f"{merge_name}.mp4"
         if await output_path.exists():
             return output_path
         v_path, a_path = await asyncio.gather(
             self.download_video(
-                url=v_url,
+                url=video_url,
                 video_name=video_name,
                 ext_headers=ext_headers,
                 use_curl_cffi=use_curl_cffi,
             ),
             self.download_audio(
-                url=a_url,
+                url=audio_url,
                 audio_name=audio_name,
                 ext_headers=ext_headers,
                 use_curl_cffi=use_curl_cffi,
             ),
         )
-        return await FFmpeg.merge_av(v_path=v_path, a_path=a_path, file_name=merga_name)
+        return await FFmpeg.merge_av(v_path=v_path, a_path=a_path, file_name=merge_name)
 
     @staticmethod
     @contextlib.contextmanager

src/nonebot_plugin_parser_lite/parsers/bilibili/__init__.py

@@ -332,9 +332,9 @@ async def __call__(self) -> Path:
                 # 有单独音频流时，走 av 合并
                 if self._audio_url:
                     return await DOWNLOADER.download_av_and_merge(
-                        self.video_url,
-                        self._audio_url,
-                        merga_name=file_base,
+                        video_url=self.video_url,
+                        audio_url=self._audio_url,
+                        merge_name=file_base,
                         video_name=f"{file_base}.mp4",
                         audio_name=f"{file_base}.m4a",
                         ext_headers=self.ext_headers,