docs(app): 更新 CLI 参数说明

Author: JoeanAmier

source/CLI/main.py

@@ -1,12 +1,13 @@
 from asyncio import run
 from contextlib import suppress
-from pathlib import Path as Root
+from pathlib import Path
 from textwrap import fill
+from typing import Callable
 
 from click import (
     Choice,
     Context,
-    Path,
+    Path as ClickPath,
     command,
     echo,
     option,
@@ -29,7 +30,7 @@
 __all__ = ["cli"]
 
 
-def check_value(function):
+def check_value(function: Callable) -> Callable:
     def inner(ctx: Context, param, value):
         return function(ctx, param, value) if value else None
 
@@ -55,22 +56,22 @@ async def __aenter__(self):
         await self.APP.__aenter__()
         return self
 
-    async def __aexit__(self, exc_type, exc_value, traceback):
+    async def __aexit__(self, exc_type, exc_value, traceback) -> None:
         await self.APP.__aexit__(exc_type, exc_value, traceback)
 
-    async def run(self):
+    async def run(self) -> None:
         if self.url:
             await self.APP.extract_cli(self.url, index=self.index)
         self.__update_settings()
 
-    def __update_settings(self):
+    def __update_settings(self) -> None:
         if self.update:
             self.settings.update(self.parameter)
 
     def __check_settings_path(self) -> Path:
         if not self.path:
             return VOLUME
-        return s.parent if (s := Root(self.path)).is_file() else VOLUME
+        return s.parent if (s := Path(self.path)).is_file() else VOLUME
 
     @staticmethod
     def __merge_cookie(data: dict) -> None:
@@ -80,10 +81,10 @@ def __merge_cookie(data: dict) -> None:
 
     def __clean_params(self, data: dict) -> dict:
         # self.__merge_cookie(data)
-        return {k: v for k, v in data.items() if v != None}
+        return {k: v for k, v in data.items() if v is not None}
 
     @staticmethod
-    def __format_index(index: str) -> list:
+    def __format_index(index: str) -> list[int]:
         if index:
             result = []
             values = index.split()
@@ -160,6 +161,12 @@ def help_(ctx: Context, param, value) -> None:
                 _("图文作品文件下载格式，支持：PNG、WEBP、JPEG、HEIC、AUTO"),
             ),
             ("--live_download", "-ld", "bool", _("动态图片下载开关")),
+            (
+                "--video_preference",
+                "-vp",
+                "choice",
+                _("视频下载偏好，支持：resolution、bitrate、size"),
+            ),
             ("--download_record", "-dr", "bool", _("作品下载记录开关")),
             (
                 "--folder_mode",
@@ -182,6 +189,12 @@ def help_(ctx: Context, param, value) -> None:
                     width=55,
                 ),
             ),
+            (
+                "--note_format",
+                "-nfmt",
+                "choice",
+                _("作品信息保存格式，支持：txt、md、all"),
+            ),
             ("--language", "-l", "choice", _("设置程序语言，目前支持：zh_CN、en_US")),
             ("--settings", "-s", "str", _("读取指定配置文件")),
             # (
@@ -233,7 +246,7 @@ def help_(ctx: Context, param, value) -> None:
 @option(
     "--work_path",
     "-wp",
-    type=Path(file_okay=False),
+    type=ClickPath(file_okay=False),
 )
 @option(
     "--folder_name",
@@ -325,7 +338,7 @@ def help_(ctx: Context, param, value) -> None:
 @option(
     "--settings",
     "-s",
-    type=Path(dir_okay=False),
+    type=ClickPath(dir_okay=False),
 )
 # @option(
 #     "--browser_cookie",