p115client 0.0.5.10.8__py3-none-any.whl → 0.0.5.11__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 == "open":
+    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:
@@ -616,9 +646,6 @@ def normalize_attr_web(
         if "te" in info:
             attr["mtime"] = int(info["te"])
     else:
-        attr["labels"] = info["fl"]
-        if "score" in info:
-            attr["score"] = int(info.get("score") or 0)
         attr["ico"] = info.get("ico", "folder" if is_directory else "")
         if "te" in info:
             attr["mtime"] = attr["user_utime"] = int(info["te"])
@@ -651,12 +678,14 @@ def normalize_attr_web(
             ("c", "violated"), 
             ("c", "is_collect"), 
             ("sh", "is_share"), 
+            ("score", "score"), 
             #("d", "has_desc"), 
             #("p", "has_pass"), 
         ):
             if key in info:
                 attr[name] = int(info[key] or 0)
         for key, name in (
+            ("fl", "labels"), 
             ("dp", "dir_path"), 
             ("style", "style"), 
             ("ns", "name_show"), 
@@ -744,10 +773,7 @@ def normalize_attr_app(
         if "upt" in info:
             attr["mtime"] = int(info["upt"])
     else:
-        attr["labels"] = info["fl"]
         attr["ico"] = info.get("ico", "folder" if attr["is_dir"] else "")
-        if "ftype" in info:
-            attr["file_type"] = int(info["ftype"] or 0)
         if "thumb" in info:
             thumb = info["thumb"]
             if thumb.startswith("?"):
@@ -763,6 +789,7 @@ def normalize_attr_app(
             ("aid", "area_id"), 
             ("fatr", "audio_play_long"), 
             ("fta", "status"), 
+            ("ftype", "file_type"), 
             ("ism", "star"), 
             ("ism", "is_mark"), 
             ("is_top", "is_top"), 
@@ -784,6 +811,7 @@ def normalize_attr_app(
             ("fco", "cover"), 
             ("fco", "folder_cover"), 
             ("fdesc", "desc"), 
+            ("fl", "labels"), 
             ("flabel", "fflabel"), 
             ("multitrack", "multitrack"), 
             ("play_long", "play_long"), 
@@ -838,18 +866,28 @@ def normalize_attr_app2(
         else:
             dict_cls = AttrDict
     attr: dict[str, Any] = dict_cls()
-    is_directory = attr["is_dir"] = "file_id" not in info
-    if not simple:
-        attr["is_directory"] = is_directory
-    if is_directory:
+    if "file_id" in info and "parent_id" in info:
+        if "file_category" in info:
+            is_directory = not int(info["file_category"])
+        else:
+            is_directory = bool(info.get("sha1") or info.get("file_sha1"))
         attr["id"] = int(info["file_id"])
-        attr["parent_id"] = int(info["category_id"])
+        attr["parent_id"] = int(info["parent_id"])
         attr["name"] = info["file_name"]
     else:
-        attr["id"] = int(info["category_id"])
-        attr["parent_id"] = int(info["parent_id"])
-        attr["name"] = info["category_name"]
-    attr["sha1"] = info.get("sha1") or ""
+        is_directory = "file_id" not in info
+        if is_directory:
+            attr["id"] = int(info["file_id"])
+            attr["parent_id"] = int(info["category_id"])
+            attr["name"] = info["file_name"]
+        else:
+            attr["id"] = int(info["category_id"])
+            attr["parent_id"] = int(info["parent_id"])
+            attr["name"] = info["category_name"]
+    attr["is_dir"] = is_directory
+    if not simple:
+        attr["is_directory"] = is_directory
+    attr["sha1"] = info.get("sha1") or info.get("file_sha1") or ""
     attr["size"] = int(info.get("file_size") or 0)
     if "pick_code" in info:
         attr["pickcode"] = info["pick_code"]
@@ -890,7 +928,8 @@ def normalize_attr_app2(
             if "utime" in info:
                 attr["utime"] = int(info["utime"])
         attr["ico"] = info.get("ico", "folder" if attr["is_dir"] else "")
-        attr["labels"] = info["fl"]
+        if "fl" in info:
+            attr["labels"] = info["fl"]
         for key, name in (
             ("area_id", "area_id"), 
             ("has_desc", "has_desc"), 
@@ -1158,13 +1197,17 @@ class ClientRequestMixin:
             "user-agent": "Mozilla/5.0 AppleWebKit/600 Safari/600 Chrome/124.0.0.0", 
         })
 
+    @locked_cacheproperty
+    def request_kwargs(self, /) -> dict:
+        return {}
+
     def close(self, /) -> None:
         """删除 session 和 async_session 属性，如果它们未被引用，则应该会被自动清理
         """
         self.__dict__.pop("session", None)
         self.__dict__.pop("async_session", None)
 
-    def request(
+    def _request(
         self, 
         /, 
         url: str, 
@@ -1282,120 +1325,252 @@ class ClientRequestMixin:
         request_kwargs.setdefault("parse", default_parse)
         return request(url=url, method=method, **request_kwargs)
 
+    def request(
+        self, 
+        /, 
+        url: str, 
+        method: str = "GET", 
+        params = None, 
+        data = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ):
+        """帮助函数：可执行同步和异步的网络请求
+
+        :param url: HTTP 的请求链接
+        :param method: HTTP 的请求方法
+        :param params: 查询参数
+        :param ecdh_encrypt: 使用 ecdh 算法进行加密（返回值也要解密）
+        :param async_: 说明 `request` 是同步调用还是异步调用
+        :param request: HTTP 请求调用，如果为 None，则默认用 httpx 执行请求
+            如果传入调用，则必须至少能接受以下几个关键词参数：
+
+            - url:     HTTP 的请求链接
+            - method:  HTTP 的请求方法
+            - headers: HTTP 的请求头
+            - data:    HTTP 的请求体
+            - parse:   解析 HTTP 响应的方法，默认会构建一个 Callable，会把响应的字节数据视为 JSON 进行反序列化解析
+
+                - 如果为 None，则直接把响应对象返回
+                - 如果为 ...(Ellipsis)，则把响应对象关闭后将其返回
+                - 如果为 True，则根据响应头来确定把响应得到的字节数据解析成何种格式（反序列化），请求也会被自动关闭
+                - 如果为 False，则直接返回响应得到的字节数据，请求也会被自动关闭
+                - 如果为 Callable，则使用此调用来解析数据，接受 1-2 个位置参数，并把解析结果返回给 `request` 的调用者，请求也会被自动关闭
+                    - 如果只接受 1 个位置参数，则把响应对象传给它
+                    - 如果能接受 2 个位置参数，则把响应对象和响应得到的字节数据（响应体）传给它
+
+        :param request_kwargs: 其余的请求参数，会被传给 `request`
+
+        :return: 直接返回 `request` 执行请求后的返回值
+
+        .. note:: 
+            `request` 可以由不同的请求库来提供，下面是封装了一些模块
+
+            1. `httpx_request <https://pypi.org/project/httpx_request/>`_，由 `httpx <https://pypi.org/project/httpx/>`_ 封装，支持同步和异步调用，本模块默认用的就是这个封装
+
+                .. code:: python
+
+                    from httpx_request import request
+
+            2. `python-urlopen <https://pypi.org/project/python-urlopen/>`_，由 `urllib.request.urlopen <https://docs.python.org/3/library/urllib.request.html#urllib.request.urlopen>`_ 封装，支持同步调用，性能相对最差
+
+                .. code:: python
+
+                    from urlopen import request
+
+            3. `urllib3_request <https://pypi.org/project/urllib3_request/>`_，由 `urllib3 <https://pypi.org/project/urllib3/>`_ 封装，支持同步调用，性能相对较好，推荐使用
+
+                .. code:: python
+
+                    from urllib3_request import request
+
+            4. `requests_request <https://pypi.org/project/requests_request/>`_，由 `requests <https://pypi.org/project/requests/>`_ 封装，支持同步调用
+
+                .. code:: python
+
+                    from requests_request import request
+
+            5. `aiohttp_client_request <https://pypi.org/project/aiohttp_client_request/>`_，由 `aiohttp <https://pypi.org/project/aiohttp/>`_ 封装，支持异步调用，异步并发能力最强，推荐使用
+
+                .. code:: python
+
+                    from aiohttp_client_request import request
+
+            6. `blacksheep_client_request <https://pypi.org/project/blacksheep_client_request/>`_，由 `blacksheep <https://pypi.org/project/blacksheep/>`_ 封装，支持异步调用
+
+                .. code:: python
+
+                    from blacksheep_client_request import request
+        """
+        kwargs = {**self.request_kwargs, **request_kwargs}
+        return self._request(url, method, params, data, async_=async_, **kwargs)
+
     ########## Qrcode API ##########
 
+    @overload
+    def login_authorize_open(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def login_authorize_open(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def login_authorize_open(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """授权码方式请求开放接口应用授权
+
+        GET https://qrcodeapi.115.com/open/authorize
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/okr2cq0wywelscpe#EiOrD
+
+        :payload:
+            - client_id: int | str 💡 AppID
+            - redirect_uri: str 💡 授权成功后重定向到指定的地址并附上授权码 code，需要先到 https://open.115.com/ 应用管理应用域名设置
+            - response_type: str = "code" 💡 授权模式，固定为 code，表示授权码模式
+            - state: int | str = <default> 💡 随机值，会通过 redirect_uri 原样返回，可用于验证以防 MITM 和 CSRF
+        """
+        api = complete_api("/open/authorize", base_url=base_url)
+        payload = {"response_type": "code", **payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
     @overload
     @staticmethod
-    def login_qrcode(
-        payload: str | dict, 
+    def login_authorize_access_token_open(
+        payload: dict, 
         /, 
         request: None | Callable = None, 
-        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
-    ) -> bytes:
+    ) -> dict:
         ...
     @overload
     @staticmethod
-    def login_qrcode(
-        payload: str | dict, 
+    def login_authorize_access_token_open(
+        payload: dict, 
         /, 
         request: None | Callable = None, 
-        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
-    ) -> Coroutine[Any, Any, bytes]:
+    ) -> Coroutine[Any, Any, dict]:
         ...
     @staticmethod
-    def login_qrcode(
-        payload: str | dict, 
+    def login_authorize_access_token_open(
+        payload: dict, 
         /, 
         request: None | Callable = None, 
-        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
-    ) -> bytes | Coroutine[Any, Any, bytes]:
-        """下载登录二维码图片
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """用授权码获取开放接口应用的 access_token
 
-        GET https://qrcodeapi.115.com/api/1.0/web/1.0/qrcode
+        POST https://qrcodeapi.115.com/open/authCodeToToken
 
-        :params uid: 二维码的 uid
+        .. admonition:: Reference
 
-        :return: 图片的二进制数据（PNG 图片）
+            https://www.yuque.com/115yun/open/okr2cq0wywelscpe#JnDgl
+
+        :payload:
+            - client_id: int | str 💡 AppID
+            - client_secret: str 💡 AppSecret
+            - code: str 💡 授权码，/open/authCodeToToken 重定向地址里面
+            - redirect_uri: str 💡 与 /open/authCodeToToken 传的 redirect_uri 一致，可用于验证以防 MITM 和 CSRF
+            - grant_type: str = "authorization_code" 💡 授权类型，固定为 authorization_code，表示授权码类型
         """
-        api = complete_api(f"/api/1.0/{app}/1.0/qrcode", base_url=base_url)
-        if isinstance(payload, str):
-            payload = {"uid": payload}
-        request_kwargs.setdefault("parse", False)
+        api = complete_api("/open/authCodeToToken", base_url=base_url)
+        payload = {"grant_type": "authorization_code", **payload}
+        request_kwargs.setdefault("parse", default_parse)
         if request is None:
-            return get_default_request()(url=api, params=payload, async_=async_, **request_kwargs)
+            return get_default_request()(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
         else:
-            return request(url=api, params=payload, **request_kwargs)
+            return request(url=api, method="POST", data=payload, **request_kwargs)
 
     @overload
     @staticmethod
-    def login_qrcode_access_token_open(
+    def login_qrcode(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
-    ) -> dict:
+    ) -> bytes:
         ...
     @overload
     @staticmethod
-    def login_qrcode_access_token_open(
+    def login_qrcode(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
-    ) -> Coroutine[Any, Any, dict]:
+    ) -> Coroutine[Any, Any, bytes]:
         ...
     @staticmethod
-    def login_qrcode_access_token_open(
+    def login_qrcode(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        app: str = "web", 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """绑定扫码并获取开放平台应用的 access_token 和 refresh_token
-
-        POST https://qrcodeapi.115.com/open/deviceCodeToToken
+    ) -> bytes | Coroutine[Any, Any, bytes]:
+        """下载登录二维码图片
 
-        .. admonition:: Reference
+        GET https://qrcodeapi.115.com/api/1.0/web/1.0/qrcode
 
-            https://www.yuque.com/115yun/open/shtpzfhewv5nag11#QCCVQ
+        :params uid: 二维码的 uid
 
-        :payload:
-            - uid: str
-            - code_verifier: str = <default> 💡 默认字符串是 64 个 "0"
+        :return: 图片的二进制数据（PNG 图片）
         """
-        api = complete_api("/open/deviceCodeToToken", base_url=base_url)
+        api = complete_api(f"/api/1.0/{app}/1.0/qrcode", base_url=base_url)
         if isinstance(payload, str):
-            payload = {"uid": payload, "code_verifier": _default_code_verifier}
-        request_kwargs.setdefault("parse", default_parse)
+            payload = {"uid": payload}
+        request_kwargs.setdefault("parse", False)
         if request is None:
-            return get_default_request()(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+            return get_default_request()(url=api, params=payload, async_=async_, **request_kwargs)
         else:
-            return request(url=api, method="POST", data=payload, **request_kwargs)
+            return request(url=api, params=payload, **request_kwargs)
 
     @overload
     @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_access_token_open(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
@@ -1407,7 +1582,7 @@ class ClientRequestMixin:
         ...
     @overload
     @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_access_token_open(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
@@ -1418,7 +1593,7 @@ class ClientRequestMixin:
     ) -> Coroutine[Any, Any, dict]:
         ...
     @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_access_token_open(
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
@@ -1427,20 +1602,21 @@ class ClientRequestMixin:
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """用一个 refresh_token 去获取新的 access_token 和 refresh_token，然后原来的 refresh_token 作废
+        """绑定扫码并获取开放平台应用的 access_token 和 refresh_token
 
-        POST https://qrcodeapi.115.com/open/refreshToken
+        POST https://qrcodeapi.115.com/open/deviceCodeToToken
 
         .. admonition:: Reference
 
-            https://www.yuque.com/115yun/open/shtpzfhewv5nag11#ve54x
+            https://www.yuque.com/115yun/open/shtpzfhewv5nag11#QCCVQ
 
         :payload:
-            - refresh_token: str
+            - uid: str
+            - code_verifier: str = <default> 💡 默认字符串是 64 个 "0"
         """
-        api = complete_api("/open/refreshToken", base_url=base_url)
+        api = complete_api("/open/deviceCodeToToken", base_url=base_url)
         if isinstance(payload, str):
-            payload = {"refresh_token": payload}
+            payload = {"uid": payload, "code_verifier": _default_code_verifier}
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
             return get_default_request()(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
@@ -1766,7 +1942,7 @@ class ClientRequestMixin:
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取开放平台的登录二维码，扫码可用
+        """获取开放平台的登录二维码，扫码可用，采用 PKCE (Proof Key for Code Exchange)
 
         POST https://qrcodeapi.115.com/open/authDeviceCode
 
@@ -1807,12 +1983,11 @@ class ClientRequestMixin:
             return request(url=api, method="POST", data=payload, **request_kwargs)
 
     @overload
-    @classmethod
-    def login_with_qrcode(
-        cls, 
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
         /, 
-        app: None | str = "", 
-        console_qrcode: bool = True, 
+        request: None | Callable = None, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
@@ -1820,24 +1995,81 @@ class ClientRequestMixin:
     ) -> dict:
         ...
     @overload
-    @classmethod
-    def login_with_qrcode(
-        cls, 
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
         /, 
-        app: None | str = "", 
-        console_qrcode: bool = True, 
+        request: None | Callable = None, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @classmethod
-    def login_with_qrcode(
-        cls, 
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
         /, 
-        app: None | str = "", 
-        console_qrcode: bool = True, 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """用一个 refresh_token 去获取新的 access_token 和 refresh_token，然后原来的 refresh_token 作废
+
+        POST https://qrcodeapi.115.com/open/refreshToken
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/shtpzfhewv5nag11#ve54x
+
+            https://www.yuque.com/115yun/open/opnx8yezo4at2be6
+
+        :payload:
+            - refresh_token: str
+        """
+        api = complete_api("/open/refreshToken", base_url=base_url)
+        if isinstance(payload, str):
+            payload = {"refresh_token": payload}
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            return get_default_request()(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
+        else:
+            return request(url=api, method="POST", data=payload, **request_kwargs)
+
+    @overload
+    @classmethod
+    def login_with_qrcode(
+        cls, 
+        /, 
+        app: None | str = "", 
+        console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @classmethod
+    def login_with_qrcode(
+        cls, 
+        /, 
+        app: None | str = "", 
+        console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @classmethod
+    def login_with_qrcode(
+        cls, 
+        /, 
+        app: None | str = "", 
+        console_qrcode: bool = True, 
         base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
@@ -1955,7 +2187,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:
@@ -1992,7 +2224,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
@@ -2059,7 +2291,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:
@@ -2092,7 +2324,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 ##########
 
@@ -2475,7 +2707,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(
@@ -2590,7 +2822,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):
@@ -2668,7 +2900,7 @@ class P115OpenClient(ClientRequestMixin):
                 app_id_or_refresh_token.startswith("0") or 
                 app_id_or_refresh_token.strip(digits)
             ):
-                resp = yield self.login_qrcode_refresh_token_open(
+                resp = yield self.login_refresh_token_open(
                     app_id_or_refresh_token, 
                     async_=async_, 
                     **request_kwargs, 
@@ -2686,7 +2918,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:
@@ -2743,7 +2975,7 @@ class P115OpenClient(ClientRequestMixin):
         """更新 access_token 和 refresh_token （⚠️ 目前是 7200 秒内就要求刷新一次）
         """
         def gen_step():
-            resp = yield self.login_qrcode_refresh_token_open(
+            resp = yield self.login_refresh_token_open(
                 self.refresh_token, 
                 async_=async_, 
                 **request_kwargs, 
@@ -2753,7 +2985,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(
@@ -3136,9 +3368,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, 
         *, 
@@ -3147,9 +4045,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, 
         *, 
@@ -3157,40 +4055,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, 
@@ -3198,52 +4095,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, 
@@ -3251,56 +4149,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, 
         *, 
@@ -3309,9 +4195,8 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_search(
+    def offline_quota_info(
         self, 
-        payload: str | dict = ".", 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3319,88 +4204,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, 
@@ -3408,53 +4235,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, 
         /, 
@@ -3465,7 +4283,7 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3475,7 +4293,7 @@ class P115OpenClient(ClientRequestMixin):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3484,27 +4302,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
@@ -3542,7 +4352,8 @@ class P115OpenClient(ClientRequestMixin):
 
         POST https://proapi.115.com/open/rb/del
 
-        .. note:
+        .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/gwtof85nmboulrce
 
         :payload:
@@ -3900,7 +4711,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(
@@ -4244,7 +5055,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(
@@ -4295,7 +5106,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
@@ -4489,10 +5312,6 @@ class P115Client(P115OpenClient):
         """
         self.cookies = None
 
-    @locked_cacheproperty
-    def request_kwargs(self, /) -> dict:
-        return {}
-
     @locked_cacheproperty
     def user_id(self, /) -> int:
         cookie_uid = self.cookies.get("UID")
@@ -4617,7 +5436,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:
@@ -4789,7 +5608,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(
@@ -4921,7 +5740,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(
@@ -4979,7 +5798,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(
@@ -5031,7 +5850,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(
@@ -5175,7 +5994,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(
@@ -5269,7 +6088,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
@@ -5388,7 +6207,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(
@@ -5540,7 +6359,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:
@@ -5594,8 +6413,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, 
@@ -5608,10 +6426,10 @@ 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:
@@ -5660,11 +6478,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, 
@@ -6516,15 +7334,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 ##########
 
@@ -15099,7 +15916,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(
@@ -15623,7 +16440,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(
@@ -16716,7 +17533,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, 
@@ -16758,8 +17575,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):
@@ -16810,7 +17627,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, 
@@ -16853,7 +17670,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:
@@ -16863,7 +17680,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_clear(
         self, 
-        payload: int | dict, 
+        payload: int | dict = 0, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -16874,7 +17691,7 @@ class P115Client(P115OpenClient):
     @overload
     def offline_clear(
         self, 
-        payload: int | dict, 
+        payload: int | dict = 0, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -16884,7 +17701,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, 
         *, 
@@ -16907,11 +17724,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)
 
@@ -16985,7 +17797,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, 
@@ -17021,7 +17833,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):
@@ -17136,7 +17948,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, 
         *, 
@@ -17147,7 +17959,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, 
         *, 
@@ -17157,7 +17969,7 @@ class P115Client(P115OpenClient):
         ...
     def offline_remove(
         self, 
-        payload: str | dict, 
+        payload: str | Iterable[str] | dict, 
         /, 
         base_url: None | bool | str | Callable[[], str] = None, 
         *, 
@@ -19522,7 +20334,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(
@@ -19889,7 +20701,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(
@@ -20025,7 +20837,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(
@@ -20384,7 +21196,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 ##########