p115client 0.0.5.10.9__py3-none-any.whl → 0.0.5.11.1__py3-none-any.whl

p115client/client.py

@@ -181,7 +181,7 @@ def complete_proapi(
 ) -> str:
     if path and not path.startswith("/"):
         path = "/" + path
-    if app in ("open", "aps", "web"):
+    if app in ("aps", "desktop", "open", "web"):
         app = "android"
     if app and not app.startswith("/"):
         app = "/" + app
@@ -266,7 +266,7 @@ def get_default_request():
     return _httpx_request
 
 
-def parse_upload_init_response(resp, content: bytes, /) -> dict:
+def parse_upload_init_response(_, content: bytes, /) -> dict:
     data = ecdh_aes_decode(content, decompress=True)
     if not isinstance(data, (bytes, bytearray, memoryview)):
         data = memoryview(data)
@@ -542,6 +542,36 @@ def check_response(resp: dict | Awaitable[dict], /) -> dict | Coroutine[Any, Any
                 # {"state": 0, "errno": 40140126, "error": "access_token 校验失败（防篡改）"}
                 case 40140126:
                     raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140127, "error": "response_type 错误"}
+                case 40140127:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140128, "error": "redirect_uri 缺少协议"}
+                case 40140128:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140129, "error": "redirect_uri 缺少域名"}
+                case 40140129:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140130, "error": "没有配置重定向域名"}
+                case 40140130:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140131, "error": "redirect_uri 非法域名"}
+                case 40140131:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140132, "error": "grant_type 错误"}
+                case 40140132:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140133, "error": "client_secret 验证失败"}
+                case 40140133:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140134, "error": "授权码 code 验证失败"}
+                case 40140134:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140135, "error": "client_id 验证失败"}
+                case 40140135:
+                    raise OperationalError(errno.EINVAL, resp)
+                # {"state": 0, "errno": 40140136, "error": "redirect_uri 验证失败（防MITM）"}
+                case 40140136:
+                    raise OperationalError(errno.EINVAL, resp)
         elif "msg_code" in resp:
             match resp["msg_code"]:
                 case 50028:
@@ -566,13 +596,34 @@ def check_response(resp: dict | Awaitable[dict], /) -> dict | Coroutine[Any, Any
     raise P115OSError(errno.EIO, resp)
 
 
+@overload
 def normalize_attr_web(
     info: Mapping, 
     /, 
     simple: bool = False, 
     keep_raw: bool = False, 
-    dict_cls: None | type[dict] = None, 
+    *, 
+    dict_cls: None = None, 
 ) -> dict[str, Any]:
+    ...
+@overload
+def normalize_attr_web[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: type[D], 
+) -> D:
+    ...
+def normalize_attr_web[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: None | type[D] = None, 
+) -> dict[str, Any] | D:
     """翻译 `P115Client.fs_files`、`P115Client.fs_search`、`P115Client.share_snap` 等接口响应的文件信息数据，使之便于阅读
 
     :param info: 原始数据
@@ -583,10 +634,7 @@ def normalize_attr_web(
     :return: 翻译后的 dict 类型数据
     """
     if dict_cls is None:
-        if simple:
-            dict_cls = dict
-        else:
-            dict_cls = AttrDict
+        dict_cls = cast(type[D], dict)
     attr: dict[str, Any] = dict_cls()
     is_directory = attr["is_dir"] = "fid" not in info
     if not simple:
@@ -690,10 +738,10 @@ def normalize_attr_web(
         attr["type"] = 0
     elif info.get("iv") or "vdi" in info:
         attr["type"] = 4
-    elif type := CLASS_TO_TYPE.get(attr.get("class", "")):
-        attr["type"] = type
-    elif type := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
-        attr["type"] = type
+    elif type_ := CLASS_TO_TYPE.get(attr.get("class", "")):
+        attr["type"] = type_
+    elif type_ := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
+        attr["type"] = type_
     else:
         attr["type"] = 99
     if keep_raw:
@@ -701,13 +749,33 @@ def normalize_attr_web(
     return attr
 
 
+@overload
 def normalize_attr_app(
     info: Mapping, 
     /, 
     simple: bool = False, 
     keep_raw: bool = False, 
-    dict_cls: None | type[dict] = None, 
+    *, 
+    dict_cls: None = None, 
 ) -> dict[str, Any]:
+    ...
+@overload
+def normalize_attr_app[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: None | type[D] = None, 
+) -> D:
+    ...
+def normalize_attr_app[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    dict_cls: None | type[D] = None, 
+) -> dict[str, Any] | D:
     """翻译 `P115Client.fs_files_app` 接口响应的文件信息数据，使之便于阅读
 
     :param info: 原始数据
@@ -718,10 +786,7 @@ def normalize_attr_app(
     :return: 翻译后的 dict 类型数据
     """
     if dict_cls is None:
-        if simple:
-            dict_cls = dict
-        else:
-            dict_cls = AttrDict
+        dict_cls = cast(type[D], dict)
     attr: dict[str, Any] = dict_cls()
     is_directory = attr["is_dir"] = info["fc"] == "0" # fc => file_category
     if not simple:
@@ -805,8 +870,8 @@ def normalize_attr_app(
         attr["type"] = 3
     elif info.get("isv") or "def" in info or "def2" in info or "v_img" in info:
         attr["type"] = 4
-    elif type := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
-        attr["type"] = type
+    elif type_ := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
+        attr["type"] = type_
     else:
         attr["type"] = 99
     if keep_raw:
@@ -814,13 +879,33 @@ def normalize_attr_app(
     return attr
 
 
+@overload
 def normalize_attr_app2(
     info: Mapping, 
     /, 
     simple: bool = False, 
     keep_raw: bool = False, 
-    dict_cls: None | type[dict] = None, 
+    *, 
+    dict_cls: None = None, 
 ) -> dict[str, Any]:
+    ...
+@overload
+def normalize_attr_app2[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: None | type[D] = None, 
+) -> D:
+    ...
+def normalize_attr_app2[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    dict_cls: None | type[D] = None, 
+) -> dict[str, Any] | D:
     """翻译 `P115Client.fs_files_app2` 接口响应的文件信息数据，使之便于阅读
 
     :param info: 原始数据
@@ -831,10 +916,7 @@ def normalize_attr_app2(
     :return: 翻译后的 dict 类型数据
     """
     if dict_cls is None:
-        if simple:
-            dict_cls = dict
-        else:
-            dict_cls = AttrDict
+        dict_cls = cast(type[D], dict)
     attr: dict[str, Any] = dict_cls()
     if "file_id" in info and "parent_id" in info:
         if "file_category" in info:
@@ -940,8 +1022,8 @@ def normalize_attr_app2(
         attr["type"] = 3
     elif info.get("is_video") or "definition" in info or "definition2" in info or "video_img_url" in info:
         attr["type"] = 4
-    elif type := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
-        attr["type"] = type
+    elif type_ := SUFFIX_TO_TYPE.get(splitext(attr["name"])[1].lower()):
+        attr["type"] = type_
     else:
         attr["type"] = 99
     if keep_raw:
@@ -949,13 +1031,34 @@ def normalize_attr_app2(
     return attr
 
 
+@overload
 def normalize_attr(
     info: Mapping, 
     /, 
     simple: bool = False, 
     keep_raw: bool = False, 
-    dict_cls: None | type[dict] = None, 
+    *, 
+    dict_cls: None, 
 ) -> dict[str, Any]:
+    ...
+@overload
+def normalize_attr[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: type[D] = AttrDict, # type: ignore
+) -> D:
+    ...
+def normalize_attr[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    simple: bool = False, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: None | type[D] = AttrDict, # type: ignore
+) -> dict[str, Any] | D:
     """翻译获取自罗列目录、搜索、获取文件信息等接口的数据，使之便于阅读
 
     :param info: 原始数据
@@ -973,12 +1076,32 @@ def normalize_attr(
         return normalize_attr_web(info, simple=simple, keep_raw=keep_raw, dict_cls=dict_cls)
 
 
+@overload
 def normalize_attr_simple(
     info: Mapping, 
     /, 
     keep_raw: bool = False, 
+    *, 
+    dict_cls: None = None, 
 ) -> dict[str, Any]:
-    return normalize_attr(info, simple=True, keep_raw=keep_raw)
+    ...
+@overload
+def normalize_attr_simple[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: type[D], 
+) -> D:
+    ...
+def normalize_attr_simple[D: dict[str, Any]](
+    info: Mapping, 
+    /, 
+    keep_raw: bool = False, 
+    *, 
+    dict_cls: None | type[D] = None, 
+) -> dict[str, Any] | D:
+    return normalize_attr(info, simple=True, keep_raw=keep_raw, dict_cls=dict_cls)
 
 
 class IgnoreCaseDict[V](dict[str, V]):
@@ -2157,7 +2280,7 @@ class ClientRequestMixin:
             else:
                 url = complete_api(f"/api/1.0/web/1.0/qrcode?uid={login_uid}", base_url=base_url)
                 if async_:
-                    yield partial(startfile_async, url)
+                    yield startfile_async(url)
                 else:
                     startfile(url)
             while True:
@@ -2194,7 +2317,7 @@ class ClientRequestMixin:
                 )
             else:
                 return qrcode_token
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     @classmethod
@@ -2261,7 +2384,7 @@ class ClientRequestMixin:
             else:
                 url = complete_api(f"/api/1.0/web/1.0/qrcode?uid={login_uid}", base_url=base_url)
                 if async_:
-                    yield partial(startfile_async, url)
+                    yield startfile_async(url)
                 else:
                     startfile(url)
             while True:
@@ -2294,7 +2417,7 @@ class ClientRequestMixin:
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     ########## Upload API ##########
 
@@ -2677,7 +2800,7 @@ class ClientRequestMixin:
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def read_bytes_range(
@@ -2792,7 +2915,7 @@ class ClientRequestMixin:
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
 
 class P115OpenClient(ClientRequestMixin):
@@ -2888,7 +3011,7 @@ class P115OpenClient(ClientRequestMixin):
             self.refresh_token = data["refresh_token"]
             self.access_token = data["access_token"]
             return self
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @classmethod
     def from_token(cls, /, access_token: str, refresh_token: str) -> P115OpenClient:
@@ -2955,7 +3078,7 @@ class P115OpenClient(ClientRequestMixin):
             self.refresh_token = data["refresh_token"]
             access_token = self.access_token = data["access_token"]
             return access_token
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def download_url(
@@ -3338,9 +3461,675 @@ class P115OpenClient(ClientRequestMixin):
         return self.request(url=api, params=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_info(
+    def fs_info(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_info(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_info(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取文件或目录详情
+
+        GET https://proapi.115.com/open/folder/get_info
+
+        .. hint::
+            相当于 `P115Client.fs_category_get_app`
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/rl8zrhe2nag21dfw
+
+        :payload:
+            - file_id: int | str 💡 文件或目录的 id
+        """
+        api = complete_proapi("/open/folder/get_info", base_url)
+        if isinstance(payload, (int, str)):
+            payload = {"file_id": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_mkdir(
+        self, 
+        payload: str | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_mkdir(
+        self, 
+        payload: str | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_mkdir(
+        self, 
+        payload: str | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """新建目录
+
+        POST https://proapi.115.com/open/folder/add
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/qur839kyx9cgxpxi
+
+        :payload:
+            - file_name: str 💡 新建目录名称，限制255个字符
+            - pid: int | str = 0 💡 新建目录所在的父目录ID (根目录的ID为0)
+        """
+        api = complete_proapi("/open/folder/add", base_url)
+        if isinstance(payload, str):
+            payload = {"pid": pid, "file_name": payload}
+        else:
+            payload = {"pid": pid, **payload}
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_move(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_move(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_move(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        pid: int = 0, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """文件移动
+
+        POST https://proapi.115.com/open/ufile/move
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/vc6fhi2mrkenmav2
+
+        :payload:
+            - file_ids: int | str 💡 文件或目录的 id，多个用逗号 "," 隔开
+            - to_cid: int | str = 0 💡 父目录 id
+        """
+        api = complete_proapi("/open/ufile/move", base_url)
+        if isinstance(payload, (int, str)):
+            payload = {"file_ids": payload}
+        elif isinstance(payload, dict):
+            payload = dict(payload)
+        else:
+            payload = {"file_ids": ",".join(map(str, payload))}
+        if not payload.get("file_ids"):
+            return {"state": False, "message": "no op"}
+        payload = cast(dict, payload)
+        payload.setdefault("to_cid", pid)
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_search(
+        self, 
+        payload: str | dict = ".", 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_search(
+        self, 
+        payload: str | dict = ".", 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_search(
+        self, 
+        payload: str | dict = ".", 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """搜索文件或目录
+
+        GET https://proapi.115.com/open/ufile/search
+
+        .. hint::
+            相当于 `P115Client.fs_search_app2`
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/ft2yelxzopusus38
+
+        :payload:
+            - aid: int | str = 1 💡 area_id。1:正常文件 7:回收站文件 12:瞬间文件 120:彻底删除文件、简历附件
+            - asc: 0 | 1 = <default> 💡 是否升序排列
+            - cid: int | str = 0 💡 目录 id。cid=-1 时，表示不返回列表任何内容
+            - count_folders: 0 | 1 = <default>
+            - date: str = <default> 💡 筛选日期
+            - fc: 0 | 1 = <default> 💡 只显示文件或目录。1:只显示目录 2:只显示文件
+            - fc_mix: 0 | 1 = <default> 💡 是否目录和文件混合，如果为 0 则目录在前（目录置顶）
+            - file_label: int | str = <default> 💡 标签 id
+            - format: str = "json" 💡 输出格式（不用管）
+            - gte_day: str 💡 搜索结果匹配的开始时间；格式：YYYY-MM-DD
+            - limit: int = 32 💡 一页大小，意思就是 page_size
+            - lte_day: str 💡 搜索结果匹配的结束时间；格式：YYYY-MM-DD
+            - o: str = <default> 💡 用某字段排序
+
+              - "file_name": 文件名
+              - "file_size": 文件大小
+              - "file_type": 文件种类
+              - "user_utime": 修改时间
+              - "user_ptime": 创建时间
+              - "user_otime": 上一次打开时间
+
+            - offset: int = 0  💡 索引偏移，索引从 0 开始计算
+            - pick_code: str = <default> 💡 是否查询提取码，如果该值为 1 则查询提取码为 `search_value` 的文件
+            - search_value: str = "." 💡 搜索文本，可以是 sha1
+            - show_dir: 0 | 1 = 1
+            - source: str = <default>
+            - star: 0 | 1 = <default>
+            - suffix: str = <default>
+            - type: int = <default> 💡 文件类型
+
+              - 0: 全部（仅当前目录）
+              - 1: 文档
+              - 2: 图片
+              - 3: 音频
+              - 4: 视频
+              - 5: 压缩包
+              - 6: 软件/应用
+              - 7: 书籍
+              - 99: 仅文件
+
+            - version: str = <default> 💡 版本号，比如 3.1
+        """
+        api = complete_proapi("/open/ufile/search", base_url)
+        if isinstance(payload, str):
+            payload = {
+                "aid": 1, "cid": 0, "format": "json", "limit": 32, "offset": 0, 
+                "show_dir": 1, "search_value": payload, 
+            }
+        else:
+            payload = {
+                "aid": 1, "cid": 0, "format": "json", "limit": 32, "offset": 0, 
+                "show_dir": 1, "search_value": ".", **payload, 
+            }
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_star_set(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        star: bool = True, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_star_set(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        star: bool = True, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_star_set(
+        self, 
+        payload: int | str | Iterable[int | str] | dict, 
+        /, 
+        star: bool = True, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """为文件或目录设置或取消星标，此接口是对 `fs_update_open` 的封装
+
+        .. note::
+            即使其中任何一个 id 目前已经被删除，也可以操作成功
+
+        :payload:
+            - file_id: int | str    💡 只能传入 1 个
+            - file_id[0]: int | str 💡 如果有多个，则按顺序给出
+            - file_id[1]: int | str
+            - ...
+            - star: 0 | 1 = 1
+        """
+        api = complete_webapi("/files/star", base_url=base_url)
+        if isinstance(payload, (int, str)):
+            payload = {"file_id": payload, "star": int(star)}
+        elif not isinstance(payload, dict):
+            payload = {f"file_id[{i}]": id for i, id in enumerate(payload)}
+            if not payload:
+                return {"state": False, "message": "no op"}
+            payload["star"] = int(star)
+        else:
+            payload = {"star": int(star), **payload}
+        return self.fs_update(payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_video_history(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_video_history(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_video_history(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取视频播放进度
+
+        GET https://proapi.115.com/open/video/history
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/gssqdrsq6vfqigag
+
+        :payload:
+            - pick_code: str 💡 文件提取码
+        """
+        api = complete_proapi("/open/video/history", base_url)
+        if isinstance(payload, str):
+            payload = {"pick_code": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_video_history_set(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_video_history_set(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_video_history_set(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """记忆视频播放进度
+
+        POST https://proapi.115.com/open/video/history
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/bshagbxv1gzqglg4
+
+        :payload:
+            - pick_code: str 💡 文件提取码
+            - time: int = <default> 💡 视频播放进度时长 (单位秒)
+            - watch_end: int = <default> 💡 视频是否播放播放完毕 0:未完毕 1:完毕
+        """
+        api = complete_proapi("/open/video/history", base_url)
+        if isinstance(payload, str):
+            payload = {"pick_code": payload}
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_video_play(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_video_play(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_video_play(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取视频在线播放地址（和视频文件相关数据）
+
+        GET https://proapi.115.com/open/video/play
+        
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/hqglxv3cedi3p9dz
+
+        .. hint::
+            需切换音轨时，在请求返回的播放地址中增加请求参数 `&audio_track=${index}`，值就是接口响应中 `multitrack_list` 中某个成员的索引，从 0 开始计数
+
+        :payload:
+            - pick_code: str 💡 文件提取码
+            - share_id: int | str = <default> 💡 共享 id，获取共享文件播放地址所需
+        """
+        api = complete_proapi("/open/video/play", base_url)
+        if isinstance(payload, str):
+            payload = {"pick_code": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_video_push(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_video_push(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_video_push(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """提交视频转码
+
+        POST https://proapi.115.com/open/video/video_push
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/nxt8r1qcktmg3oan
+
+        :payload:
+            - pick_code: str 💡 文件提取码
+            - op: str = "vip_push" 💡 提交视频加速转码方式：vip_push:根据；vip 等级加速 pay_push:枫叶加速
+        """
+        api = complete_proapi("/open/video/video_push", base_url)
+        if isinstance(payload, str):
+            payload = {"pick_code": payload, "op": "vip_push"}
+        else:
+            payload.setdefault("op", "vip_push")
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_video_subtitle(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_video_subtitle(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_video_subtitle(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """视频字幕列表
+
+        GET https://proapi.115.com/open/video/subtitle
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/nx076h3glapoyh7u
+
+        :payload:
+            - pick_code: str 💡 文件提取码
+        """
+        api = complete_proapi("/open/video/subtitle", base_url)
+        if isinstance(payload, str):
+            payload = {"pick_code": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def fs_update(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_update(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_update(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """设置文件或目录（备注、标签等）
+
+        POST https://proapi.115.com/open/ufile/update
+
+        .. hint::
+            即使文件已经被删除，也可以操作成功
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/gyrpw5a0zc4sengm
+
+        :payload:
+            - file_id: int | str    💡 只能传入 1 个
+            - file_id[0]: int | str 💡 如果有多个，则按顺序给出
+            - file_id[1]: int | str
+            - ...
+            - file_name: str = <default> 💡 文件名
+            - star: 0 | 1 = <default> 💡 是否星标：0:取消星标 1:设置星标
+            - ...
+        """
+        api = complete_proapi("/open/ufile/update", base_url)
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def offline_add_torrent(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def offline_add_torrent(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def offline_add_torrent(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """添加云下载 BT 任务
+
+        POST https://proapi.115.com/open/offline/add_task_bt 
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/svfe4unlhayvluly
+
+        :payload:
+            - info_hash: str 💡 种子文件的 info_hash
+            - pick_code: str 💡 种子文件的提取码
+            - save_path: str 💡 保存到 `wp_path_id` 对应目录下的相对路径
+            - torrent_sha1: str 💡 种子文件的 sha1
+            - wanted: str 💡 选择文件进行下载（是数字索引，从 0 开始计数，用 "," 分隔）
+            - wp_path_id: int | str = <default> 💡 保存目标文件夹 id
+        """
+        api = complete_proapi("/open/offline/add_task_bt ", base_url)
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def offline_add_urls(
         self, 
-        payload: int | str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3349,9 +4138,9 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_info(
+    def offline_add_urls(
         self, 
-        payload: int | str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3359,40 +4148,39 @@ class P115OpenClient(ClientRequestMixin):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_info(
+    def offline_add_urls(
         self, 
-        payload: int | str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取文件或目录详情
+        """添加云下载链接任务
 
-        GET https://proapi.115.com/open/folder/get_info
-
-        .. hint::
-            相当于 `P115Client.fs_category_get_app`
+        POST https://proapi.115.com/open/offline/add_task_urls
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/rl8zrhe2nag21dfw
+            https://www.yuque.com/115yun/open/zkyfq2499gdn3mty
 
         :payload:
-            - file_id: int | str 💡 文件或目录的 id
+            - urls: str 💡 链接，用 "\\n" 分隔，支持HTTP、HTTPS、FTP、磁力链和电驴链接
+            - wp_path_id: int | str = <default> 💡 保存到目录的 id
         """
-        api = complete_proapi("/open/folder/get_info", base_url)
-        if isinstance(payload, (int, str)):
-            payload = {"file_id": payload}
-        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+        api = complete_proapi("/open/offline/add_task_urls", base_url)
+        if isinstance(payload, str):
+            payload = {"urls": payload.strip("\n")}
+        elif not isinstance(payload, dict):
+            payload = {"urls": ",".join(payload)}
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_mkdir(
+    def offline_clear(
         self, 
-        payload: str | dict, 
+        payload: int | dict = 0, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False] = False, 
@@ -3400,52 +4188,53 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_mkdir(
+    def offline_clear(
         self, 
-        payload: str | dict, 
+        payload: int | dict = 0, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_mkdir(
+    def offline_clear(
         self, 
-        payload: str | dict, 
+        payload: int | dict = 0, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """新建目录
+        """清空云下载任务
 
-        POST https://proapi.115.com/open/folder/add
+        POST https://proapi.115.com/open/offline/clear_task
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/qur839kyx9cgxpxi
+            https://www.yuque.com/115yun/open/uu5i4urb5ylqwfy4
 
         :payload:
-            - file_name: str 💡 新建目录名称，限制255个字符
-            - pid: int | str = 0 💡 新建目录所在的父目录ID (根目录的ID为0)
+            - flag: int = 0 💡 标识，用于对应某种情况
+
+              - 0: 已完成
+              - 1: 全部
+              - 2: 已失败
+              - 3: 进行中
+              - 4: 已完成+删除源文件
+              - 5: 全部+删除源文件
         """
-        api = complete_proapi("/open/folder/add", base_url)
-        if isinstance(payload, str):
-            payload = {"pid": pid, "file_name": payload}
-        else:
-            payload = {"pid": pid, **payload}
+        api = complete_proapi("/open/offline/clear_task", base_url)
+        if isinstance(payload, int):
+            payload = {"flag": payload}
         return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_move(
+    def offline_list(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: int | dict = 1, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False] = False, 
@@ -3453,56 +4242,44 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_move(
+    def offline_list(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: int | dict = 1, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_move(
+    def offline_list(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: int | dict = 1, 
         /, 
-        pid: int = 0, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """文件移动
+        """获取用户云下载任务列表
 
-        POST https://proapi.115.com/open/ufile/move
+        GET https://proapi.115.com/open/offline/get_task_list
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/vc6fhi2mrkenmav2
+            https://www.yuque.com/115yun/open/av2mluz7uwigz74k
 
         :payload:
-            - file_ids: int | str 💡 文件或目录的 id，多个用逗号 "," 隔开
-            - to_cid: int | str = 0 💡 父目录 id
+            - page: int | str = 1
         """
-        api = complete_proapi("/open/ufile/move", base_url)
-        if isinstance(payload, (int, str)):
-            payload = {"file_ids": payload}
-        elif isinstance(payload, dict):
-            payload = dict(payload)
-        else:
-            payload = {"file_ids": ",".join(map(str, payload))}
-        if not payload.get("file_ids"):
-            return {"state": False, "message": "no op"}
-        payload = cast(dict, payload)
-        payload.setdefault("to_cid", pid)
-        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+        api = complete_proapi("/open/offline/get_task_list", base_url)
+        if isinstance(payload, int):
+            payload = {"page": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_search(
+    def offline_quota_info(
         self, 
-        payload: str | dict = ".", 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3511,9 +4288,8 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_search(
+    def offline_quota_info(
         self, 
-        payload: str | dict = ".", 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3521,88 +4297,30 @@ class P115OpenClient(ClientRequestMixin):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_search(
+    def offline_quota_info(
         self, 
-        payload: str | dict = ".", 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """搜索文件或目录
-
-        GET https://proapi.115.com/open/ufile/search
+        """获取云下载配额信息
 
-        .. hint::
-            相当于 `P115Client.fs_search_app2`
+        GET https://proapi.115.com/open/offline/get_quota_info
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/ft2yelxzopusus38
-
-        :payload:
-            - aid: int | str = 1 💡 area_id。1:正常文件 7:回收站文件 12:瞬间文件 120:彻底删除文件、简历附件
-            - asc: 0 | 1 = <default> 💡 是否升序排列
-            - cid: int | str = 0 💡 目录 id。cid=-1 时，表示不返回列表任何内容
-            - count_folders: 0 | 1 = <default>
-            - date: str = <default> 💡 筛选日期
-            - fc: 0 | 1 = <default> 💡 只显示文件或目录。1:只显示目录 2:只显示文件
-            - fc_mix: 0 | 1 = <default> 💡 是否目录和文件混合，如果为 0 则目录在前（目录置顶）
-            - file_label: int | str = <default> 💡 标签 id
-            - format: str = "json" 💡 输出格式（不用管）
-            - gte_day: str 💡 搜索结果匹配的开始时间；格式：YYYY-MM-DD
-            - limit: int = 32 💡 一页大小，意思就是 page_size
-            - lte_day: str 💡 搜索结果匹配的结束时间；格式：YYYY-MM-DD
-            - o: str = <default> 💡 用某字段排序
-
-              - "file_name": 文件名
-              - "file_size": 文件大小
-              - "file_type": 文件种类
-              - "user_utime": 修改时间
-              - "user_ptime": 创建时间
-              - "user_otime": 上一次打开时间
-
-            - offset: int = 0  💡 索引偏移，索引从 0 开始计算
-            - pick_code: str = <default> 💡 是否查询提取码，如果该值为 1 则查询提取码为 `search_value` 的文件
-            - search_value: str = "." 💡 搜索文本，可以是 sha1
-            - show_dir: 0 | 1 = 1
-            - source: str = <default>
-            - star: 0 | 1 = <default>
-            - suffix: str = <default>
-            - type: int = <default> 💡 文件类型
-
-              - 0: 全部（仅当前目录）
-              - 1: 文档
-              - 2: 图片
-              - 3: 音频
-              - 4: 视频
-              - 5: 压缩包
-              - 6: 软件/应用
-              - 7: 书籍
-              - 99: 仅文件
-
-            - version: str = <default> 💡 版本号，比如 3.1
+            https://www.yuque.com/115yun/open/gif2n3smh54kyg0p
         """
-        api = complete_proapi("/open/ufile/search", base_url)
-        if isinstance(payload, str):
-            payload = {
-                "aid": 1, "cid": 0, "format": "json", "limit": 32, "offset": 0, 
-                "show_dir": 1, "search_value": payload, 
-            }
-        else:
-            payload = {
-                "aid": 1, "cid": 0, "format": "json", "limit": 32, "offset": 0, 
-                "show_dir": 1, "search_value": ".", **payload, 
-            }
-        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+        api = complete_proapi("/open/offline/get_quota_info", base_url)
+        return self.request(url=api, async_=async_, **request_kwargs)
 
     @overload
-    def fs_star_set(
+    def offline_remove(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: str | dict, 
         /, 
-        star: bool = True, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False] = False, 
@@ -3610,53 +4328,44 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_star_set(
+    def offline_remove(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: str | dict, 
         /, 
-        star: bool = True, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_star_set(
+    def offline_remove(
         self, 
-        payload: int | str | Iterable[int | str] | dict, 
+        payload: str | dict, 
         /, 
-        star: bool = True, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """为文件或目录设置或取消星标，此接口是对 `fs_update_open` 的封装
+        """删除用户云下载任务
 
-        .. note::
-            即使其中任何一个 id 目前已经被删除，也可以操作成功
+        POST https://proapi.115.com/open/offline/del_task
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/pmgwc86lpcy238nw
 
         :payload:
-            - file_id: int | str    💡 只能传入 1 个
-            - file_id[0]: int | str 💡 如果有多个，则按顺序给出
-            - file_id[1]: int | str
-            - ...
-            - star: 0 | 1 = 1
+            - info_hash: str 💡 待删除任务的 info_hash
+            - del_source_file: 0 | 1 = <default> 💡 是否删除源文件 1:删除 0:不删除
         """
-        api = complete_webapi("/files/star", base_url=base_url)
-        if isinstance(payload, (int, str)):
-            payload = {"file_id": payload, "star": int(star)}
-        elif not isinstance(payload, dict):
-            payload = {f"file_id[{i}]": id for i, id in enumerate(payload)}
-            if not payload:
-                return {"state": False, "message": "no op"}
-            payload["star"] = int(star)
-        else:
-            payload = {"star": int(star), **payload}
-        return self.fs_update(payload, async_=async_, **request_kwargs)
+        api = complete_proapi("/open/offline/del_task", base_url)
+        if isinstance(payload, str):
+            payload = {"info_hash": payload}
+        return self.request(api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3667,7 +4376,7 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3677,7 +4386,7 @@ class P115OpenClient(ClientRequestMixin):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3686,27 +4395,19 @@ class P115OpenClient(ClientRequestMixin):
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """设置文件或目录（备注、标签等）
-
-        POST https://proapi.115.com/open/ufile/update
+        """解析 BT 种子
 
-        .. hint::
-            即使文件已经被删除，也可以操作成功
+        POST https://proapi.115.com/open/offline/torrent
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/gyrpw5a0zc4sengm
+            https://www.yuque.com/115yun/open/evez3u50cemoict1
 
         :payload:
-            - file_id: int | str    💡 只能传入 1 个
-            - file_id[0]: int | str 💡 如果有多个，则按顺序给出
-            - file_id[1]: int | str
-            - ...
-            - file_name: str = <default> 💡 文件名
-            - star: 0 | 1 = <default> 💡 是否星标：0:取消星标 1:设置星标
-            - ...
+            - torrent_sha1: str 💡 种子文件的 sha1
+            - pick_code: str    💡 种子文件的提取码
         """
-        api = complete_proapi("/open/ufile/update", base_url)
+        api = complete_proapi("/open/offline/torrent", base_url)
         return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
@@ -3744,7 +4445,8 @@ class P115OpenClient(ClientRequestMixin):
 
         POST https://proapi.115.com/open/rb/del
 
-        .. note:
+        .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/gwtof85nmboulrce
 
         :payload:
@@ -4102,7 +4804,7 @@ class P115OpenClient(ClientRequestMixin):
                 check_response(resp)
             resp["data"] = {**payload, **resp["data"], "sha1": filesha1, "cid": pid}
             return resp
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def upload_file(
@@ -4446,7 +5148,7 @@ class P115OpenClient(ClientRequestMixin):
                     async_=async_, # type: ignore
                     **request_kwargs, 
                 )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def user_info(
@@ -4497,7 +5199,19 @@ class P115OpenClient(ClientRequestMixin):
     fs_move_open = fs_move
     fs_search_open = fs_search
     fs_star_set_open = fs_star_set
+    fs_video_history_open = fs_video_history
+    fs_video_history_set_open = fs_video_history_set
+    fs_video_play_open = fs_video_play
+    fs_video_push_open = fs_video_push
+    fs_video_subtitle_open = fs_video_subtitle
     fs_update_open = fs_update
+    offline_add_torrent_open = offline_add_torrent
+    offline_add_urls_open = offline_add_urls
+    offline_clear_open = offline_clear
+    offline_list_open = offline_list
+    offline_quota_info_open = offline_quota_info
+    offline_remove_open = offline_remove
+    offline_torrent_info_open = offline_torrent_info
     recyclebin_clean_open = recyclebin_clean
     recyclebin_list_open = recyclebin_list
     recyclebin_revert_open = recyclebin_revert
@@ -4815,7 +5529,7 @@ class P115Client(P115OpenClient):
                     )
             setattr(self, "check_for_relogin", check_for_relogin)
             return self
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @locked_cacheproperty
     def request_lock(self, /) -> Lock:
@@ -4987,7 +5701,7 @@ class P115Client(P115OpenClient):
                 check_response(resp)
             setattr(self, "cookies", resp["data"]["cookie"])
             return self
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_with_app(
@@ -5119,7 +5833,7 @@ class P115Client(P115OpenClient):
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_without_app(
@@ -5177,7 +5891,7 @@ class P115Client(P115OpenClient):
             )
             check_response(resp)
             return uid
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_with_open(
@@ -5229,7 +5943,7 @@ class P115Client(P115OpenClient):
             resp = yield self.login_qrcode_scan_confirm(login_uid, async_=async_, **request_kwargs)
             check_response(resp)
             return self.login_qrcode_access_token_open(login_uid, async_=async_, **request_kwargs)
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_another_app(
@@ -5373,7 +6087,7 @@ class P115Client(P115OpenClient):
             if self is not inst and ssoent == inst.login_ssoent:
                 warn(f"login with the same ssoent {ssoent!r}, {self!r} will expire within 60 seconds", category=P115Warning)
             return inst
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_another_open(
@@ -5467,7 +6181,7 @@ class P115Client(P115OpenClient):
                 inst.access_token = data["access_token"]
             inst.app_id = app_id
             return inst
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     @classmethod
@@ -5586,7 +6300,7 @@ class P115Client(P115OpenClient):
             resp = yield cls.login_qrcode_scan_result(uid, app, async_=async_, **request_kwargs)
             cookies = check_response(resp)["data"]["cookie"]
             return cls(cookies, check_for_relogin=check_for_relogin)
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def logout(
@@ -5738,7 +6452,7 @@ class P115Client(P115OpenClient):
             if async_:
                 fetch_cert_headers = ensure_async(fetch_cert_headers)
             if fetch_cert_headers_argcount:
-                fetch_cert_headers = partial(fetch_cert_headers, async_)
+                fetch_cert_headers = cast(Callable, fetch_cert_headers)(async_)
             if revert_cert_headers is not None and async_:
                 revert_cert_headers = ensure_async(revert_cert_headers)
             if is_open_api:
@@ -5768,7 +6482,7 @@ class P115Client(P115OpenClient):
         def gen_step():
             cert_headers: None | Mapping = None
             if need_fetch_cert_first:
-                cert_headers = yield fetch_cert_headers
+                cert_headers = yield cast(Callable, fetch_cert_headers)()
                 headers.update(cert_headers)
             if async_:
                 lock: Lock | AsyncLock = self.request_alock
@@ -5792,8 +6506,7 @@ class P115Client(P115OpenClient):
                             cert: str = headers["authorization"]
                         else:
                             cert = headers["cookie"]
-                    resp = yield partial(
-                        cast(Callable, request), 
+                    resp = yield cast(Callable, request)(
                         url=url, 
                         method=method, 
                         **request_kwargs, 
@@ -5806,14 +6519,14 @@ class P115Client(P115OpenClient):
                         not is_auth_error and
                         get_status_code(e) != 405
                     ):
-                        yield partial(revert_cert_headers, cert_headers)
+                        yield revert_cert_headers(cert_headers)
                     if not need_to_check:
                         raise
-                    res = yield partial(cast(Callable, check_for_relogin), e)
+                    res = yield cast(Callable, check_for_relogin)(e)
                     if not res if isinstance(res, bool) else res != 405:
                         raise
                     if fetch_cert_headers is not None:
-                        cert_headers = yield fetch_cert_headers
+                        cert_headers = yield fetch_cert_headers()
                         headers.update(cert_headers)
                     elif is_open_api:
                         yield lock.acquire
@@ -5858,11 +6571,11 @@ class P115Client(P115OpenClient):
                             lock.release()
                 else:
                     if cert_headers is not None and revert_cert_headers is not None:
-                        yield partial(revert_cert_headers, cert_headers)
+                        yield revert_cert_headers(cert_headers)
                     if check and isinstance(resp, dict):
                         check_response(resp)
                     return resp
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     def request(
         self, 
@@ -6714,15 +7427,14 @@ class P115Client(P115OpenClient):
             if "sign" not in payload:
                 resp = yield self.captcha_sign(async_=async_)
                 payload["sign"] = resp["sign"]
-            return partial(
-                self.request, 
+            return self.request(
                 url=api, 
                 method="POST", 
                 data=payload, 
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     ########## Download API ##########
 
@@ -15297,7 +16009,7 @@ class P115Client(P115OpenClient):
             if device is None:
                 return None
             return device["icon"]
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_open_auth_detail(
@@ -15821,7 +16533,7 @@ class P115Client(P115OpenClient):
                 return get_default_request()(url=api, async_=async_, **request_kwargs)
             else:
                 return request(url=api, **request_kwargs)
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def logout_by_ssoent(
@@ -16914,7 +17626,7 @@ class P115Client(P115OpenClient):
             method = self._offline_lixianssp_post
         return method(payload, ac, async_=async_, ecdh_encrypt=ecdh_encrypt, **request_kwargs)
 
-    @overload
+    @overload # type: ignore
     def offline_add_torrent(
         self, 
         payload: str | dict, 
@@ -16956,8 +17668,8 @@ class P115Client(P115OpenClient):
 
         :payload:
             - info_hash: str 💡 种子文件的 info_hash
-            - wanted: str = <default> 💡 选择文件进行下载（是数字用 "," 分隔）
-            - savepath: str = <default> 💡 保存到目录下的相对路径
+            - wanted: str = <default> 💡 选择文件进行下载（是数字索引，从 0 开始计数，用 "," 分隔）
+            - savepath: str = <default> 💡 保存到 `wp_path_id` 对应目录下的相对路径
             - wp_path_id: int | str = <default> 💡 保存到目录的 id
         """
         if isinstance(payload, str):
@@ -17008,7 +17720,7 @@ class P115Client(P115OpenClient):
             payload = {"url": payload}
         return self._offline_post(payload, "add_task_url", use_web_api=use_web_api, async_=async_, **request_kwargs)
 
-    @overload
+    @overload # type: ignore
     def offline_add_urls(
         self, 
         payload: str | Iterable[str] | dict, 
@@ -17051,7 +17763,7 @@ class P115Client(P115OpenClient):
             - wp_path_id: int | str = <default> 💡 保存到目录的 id
         """
         if isinstance(payload, str):
-            payload = payload.strip().split("\n")
+            payload = payload.strip("\n").split("\n")
         if not isinstance(payload, dict):
             payload = {f"url[{i}]": url for i, url in enumerate(payload)}
             if not payload:
@@ -17061,7 +17773,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_clear(
         self, 
-        payload: int | dict, 
+        payload: int | dict = 0, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -17072,7 +17784,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_clear(
         self, 
-        payload: int | dict, 
+        payload: int | dict = 0, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -17082,7 +17794,7 @@ class P115Client(P115OpenClient):
         ...
     def offline_clear(
         self, 
-        payload: int | dict = {"flag": 0}, 
+        payload: int | dict = 0, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -17105,11 +17817,6 @@ class P115Client(P115OpenClient):
         """
         api = complete_lixian_api("?ct=lixian&ac=task_clear", base_url=base_url)
         if isinstance(payload, int):
-            flag = payload
-            if flag < 0:
-                flag = 0
-            elif flag > 5:
-                flag = 5
             payload = {"flag": payload}
         return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
@@ -17183,7 +17890,7 @@ class P115Client(P115OpenClient):
         api = complete_api("/?ct=offline&ac=space", base_url=base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
-    @overload
+    @overload # type: ignore
     def offline_list(
         self, 
         payload: int | dict = 1, 
@@ -17219,7 +17926,7 @@ class P115Client(P115OpenClient):
         POST https://lixian.115.com/lixian/?ct=lixian&ac=task_lists
 
         :payload:
-            - page: int | str
+            - page: int | str = 1
         """
         api = complete_lixian_api("?ct=lixian&ac=task_lists", base_url=base_url)
         if isinstance(payload, int):
@@ -17334,7 +18041,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_remove(
         self, 
-        payload: str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -17345,7 +18052,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_remove(
         self, 
-        payload: str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -17355,7 +18062,7 @@ class P115Client(P115OpenClient):
         ...
     def offline_remove(
         self, 
-        payload: str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -19720,7 +20427,7 @@ class P115Client(P115OpenClient):
             if resp["state"]:
                 self.user_key = resp["data"]["userkey"]
             return resp
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def upload_resume(
@@ -20087,7 +20794,7 @@ class P115Client(P115OpenClient):
                 "pickcode": resp["pickcode"], 
             }
             return resp
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def upload_file_sample(
@@ -20223,7 +20930,7 @@ class P115Client(P115OpenClient):
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload # type: ignore
     def upload_file(
@@ -20582,7 +21289,7 @@ class P115Client(P115OpenClient):
                     async_=async_, # type: ignore
                     **request_kwargs, 
                 )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     ########## User API ##########