feat(video): 添加硬件加速支持

- 定义硬件加速类型常量（none、qsv、cuda）
- 配置QSV和CUDA编码参数及预设
- 在WorkerConfig中添加硬件加速配置选项
- 实现基于硬件加速类型的编码参数动态获取
- 添加FFmpeg硬件加速解码和滤镜参数
- 检测并报告系统硬件加速支持信息
- 在API客户端中上报硬件加速配置和支持状态

handlers/base.py

@@ -19,6 +19,10 @@ from domain.task import Task
 from domain.result import TaskResult, ErrorCode
 from domain.config import WorkerConfig
 from services import storage
+from constant import (
+    HW_ACCEL_NONE, HW_ACCEL_QSV, HW_ACCEL_CUDA,
+    VIDEO_ENCODE_PARAMS, VIDEO_ENCODE_PARAMS_QSV, VIDEO_ENCODE_PARAMS_CUDA
+)
 
 if TYPE_CHECKING:
     from services.api_client import APIClientV2
@@ -26,15 +30,94 @@ if TYPE_CHECKING:
 logger = logging.getLogger(__name__)
 
 
-# v2 统一视频编码参数（来自集成文档）
-VIDEO_ENCODE_ARGS = [
-    '-c:v', 'libx264',
-    '-preset', 'medium',
-    '-profile:v', 'main',
-    '-level', '4.0',
-    '-crf', '23',
-    '-pix_fmt', 'yuv420p',
-]
+def get_video_encode_args(hw_accel: str = HW_ACCEL_NONE) -> List[str]:
+    """
+    根据硬件加速配置获取视频编码参数
+
+    Args:
+        hw_accel: 硬件加速类型 (none, qsv, cuda)
+
+    Returns:
+        FFmpeg 视频编码参数列表
+    """
+    if hw_accel == HW_ACCEL_QSV:
+        params = VIDEO_ENCODE_PARAMS_QSV
+        return [
+            '-c:v', params['codec'],
+            '-preset', params['preset'],
+            '-profile:v', params['profile'],
+            '-level', params['level'],
+            '-global_quality', params['global_quality'],
+            '-look_ahead', params['look_ahead'],
+        ]
+    elif hw_accel == HW_ACCEL_CUDA:
+        params = VIDEO_ENCODE_PARAMS_CUDA
+        return [
+            '-c:v', params['codec'],
+            '-preset', params['preset'],
+            '-profile:v', params['profile'],
+            '-level', params['level'],
+            '-rc', params['rc'],
+            '-cq', params['cq'],
+            '-b:v', '0',  # 配合 vbr 模式使用 cq
+        ]
+    else:
+        # 软件编码（默认）
+        params = VIDEO_ENCODE_PARAMS
+        return [
+            '-c:v', params['codec'],
+            '-preset', params['preset'],
+            '-profile:v', params['profile'],
+            '-level', params['level'],
+            '-crf', params['crf'],
+            '-pix_fmt', params['pix_fmt'],
+        ]
+
+
+def get_hwaccel_decode_args(hw_accel: str = HW_ACCEL_NONE) -> List[str]:
+    """
+    获取硬件加速解码参数（输入文件之前使用）
+
+    Args:
+        hw_accel: 硬件加速类型 (none, qsv, cuda)
+
+    Returns:
+        FFmpeg 硬件加速解码参数列表
+    """
+    if hw_accel == HW_ACCEL_CUDA:
+        # CUDA 硬件加速解码
+        # 注意：使用 cuda 作为 hwaccel，但输出到系统内存以便 CPU 滤镜处理
+        return ['-hwaccel', 'cuda', '-hwaccel_output_format', 'cuda']
+    elif hw_accel == HW_ACCEL_QSV:
+        # QSV 硬件加速解码
+        return ['-hwaccel', 'qsv', '-hwaccel_output_format', 'qsv']
+    else:
+        return []
+
+
+def get_hwaccel_filter_prefix(hw_accel: str = HW_ACCEL_NONE) -> str:
+    """
+    获取硬件加速滤镜前缀（用于 hwdownload 从 GPU 到 CPU）
+
+    注意：由于大多数复杂滤镜（如 lut3d, overlay, crop 等）不支持硬件表面，
+    我们需要在滤镜链开始时将硬件表面下载到系统内存。
+
+    Args:
+        hw_accel: 硬件加速类型
+
+    Returns:
+        需要添加到滤镜链开头的 hwdownload 滤镜字符串
+    """
+    if hw_accel == HW_ACCEL_CUDA:
+        return 'hwdownload,format=nv12,'
+    elif hw_accel == HW_ACCEL_QSV:
+        return 'hwdownload,format=nv12,'
+    else:
+        return ''
+
+
+# v2 统一视频编码参数（兼容旧代码，使用软件编码）
+VIDEO_ENCODE_ARGS = get_video_encode_args(HW_ACCEL_NONE)
 
 # v2 统一音频编码参数
 AUDIO_ENCODE_ARGS = [
@@ -178,6 +261,33 @@ class BaseHandler(TaskHandler, ABC):
         self.config = config
         self.api_client = api_client
 
+    def get_video_encode_args(self) -> List[str]:
+        """
+        获取当前配置的视频编码参数
+
+        Returns:
+            FFmpeg 视频编码参数列表
+        """
+        return get_video_encode_args(self.config.hw_accel)
+
+    def get_hwaccel_decode_args(self) -> List[str]:
+        """
+        获取硬件加速解码参数（在输入文件之前使用）
+
+        Returns:
+            FFmpeg 硬件加速解码参数列表
+        """
+        return get_hwaccel_decode_args(self.config.hw_accel)
+
+    def get_hwaccel_filter_prefix(self) -> str:
+        """
+        获取硬件加速滤镜前缀
+
+        Returns:
+            需要添加到滤镜链开头的 hwdownload 滤镜字符串
+        """
+        return get_hwaccel_filter_prefix(self.config.hw_accel)
+
     def before_handle(self, task: Task) -> None:
         """处理前钩子"""
         logger.debug(f"[task:{task.task_id}] Before handle: {task.task_type.value}")