p115client 0.0.5.10.4__py3-none-any.whl → 0.0.5.11__py3-none-any.whl

p115client/client.py

@@ -65,8 +65,8 @@ from yarl import URL
 
 from .const import CLASS_TO_TYPE, CLIENT_API_MAP, SSOENT_TO_APP, SUFFIX_TO_TYPE, errno
 from .exception import (
-    AuthenticationError, BusyOSError, DataError, LoginError, NotSupportedError, 
-    P115OSError, OperationalError, P115Warning, P115FileExistsError, 
+    AuthenticationError, BusyOSError, DataError, LoginError, OpenAppAuthLimitExceeded, 
+    NotSupportedError, P115OSError, OperationalError, P115Warning, P115FileExistsError, 
     P115FileNotFoundError, P115IsADirectoryError, 
 )
 from .type import RequestKeywords, MultipartResumeData, P115Cookies, P115URL
@@ -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)
@@ -339,6 +339,10 @@ def get_first(m: Mapping, /, *keys, default=None):
     return default
 
 
+def contains_any(m: Mapping, /, *keys):
+    return any(k in m for k in keys)
+
+
 @overload
 def check_response(resp: dict, /) -> dict:
     ...
@@ -525,7 +529,7 @@ def check_response(resp: dict | Awaitable[dict], /) -> dict | Coroutine[Any, Any
                     raise OperationalError(errno.EINVAL, resp)
                 # {"state": 0, "errno": 40140122, "error": "超出授权应用个数上限"}
                 case 40140122:
-                    raise OperationalError(errno.EINVAL, resp)
+                    raise OpenAppAuthLimitExceeded(errno.EDQUOT, resp)
                 # {"state": 0, "errno": 40140123, "error": "access_token 格式错误（防篡改）"}
                 case 40140123:
                     raise OperationalError(errno.EINVAL, resp)
@@ -538,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:
@@ -612,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"])
@@ -647,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"), 
@@ -740,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("?"):
@@ -759,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"), 
@@ -780,6 +811,7 @@ def normalize_attr_app(
             ("fco", "cover"), 
             ("fco", "folder_cover"), 
             ("fdesc", "desc"), 
+            ("fl", "labels"), 
             ("flabel", "fflabel"), 
             ("multitrack", "multitrack"), 
             ("play_long", "play_long"), 
@@ -834,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"]
@@ -886,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"), 
@@ -1154,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, 
@@ -1278,14 +1325,203 @@ 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_authorize_access_token_open(
+        payload: dict, 
+        /, 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def login_authorize_access_token_open(
+        payload: dict, 
+        /, 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def login_authorize_access_token_open(
+        payload: dict, 
+        /, 
+        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]:
+        """用授权码获取开放接口应用的 access_token
+
+        POST https://qrcodeapi.115.com/open/authCodeToToken
+
+        .. admonition:: Reference
+
+            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("/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, method="POST", data=payload, async_=async_, **request_kwargs)
+        else:
+            return request(url=api, method="POST", data=payload, **request_kwargs)
+
     @overload
     @staticmethod
     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, 
@@ -1297,6 +1533,8 @@ class ClientRequestMixin:
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1307,6 +1545,8 @@ class ClientRequestMixin:
         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, 
@@ -1319,7 +1559,7 @@ class ClientRequestMixin:
 
         :return: 图片的二进制数据（PNG 图片）
         """
-        api = "https://qrcodeapi.115.com/api/1.0/web/1.0/qrcode"
+        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)
@@ -1334,6 +1574,7 @@ class ClientRequestMixin:
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1345,6 +1586,7 @@ class ClientRequestMixin:
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1355,6 +1597,7 @@ class ClientRequestMixin:
         payload: str | dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -1364,13 +1607,14 @@ class ClientRequestMixin:
         POST https://qrcodeapi.115.com/open/deviceCodeToToken
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/shtpzfhewv5nag11#QCCVQ
 
         :payload:
             - uid: str
             - code_verifier: str = <default> 💡 默认字符串是 64 个 "0"
         """
-        api = "https://qrcodeapi.115.com/open/deviceCodeToToken"
+        api = complete_api("/open/deviceCodeToToken", base_url=base_url)
         if isinstance(payload, str):
             payload = {"uid": payload, "code_verifier": _default_code_verifier}
         request_kwargs.setdefault("parse", default_parse)
@@ -1380,138 +1624,175 @@ class ClientRequestMixin:
             return request(url=api, method="POST", data=payload, **request_kwargs)
 
     @overload
-    @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_scan(
+        self, 
         payload: str | dict, 
         /, 
-        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_scan(
+        self, 
         payload: str | dict, 
         /, 
-        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def login_qrcode_refresh_token_open(
+    def login_qrcode_scan(
+        self, 
         payload: str | dict, 
         /, 
-        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
+        """扫描二维码，payload 数据取自 `login_qrcode_token` 接口响应
 
-        .. admonition:: Reference
-            https://www.yuque.com/115yun/open/shtpzfhewv5nag11#ve54x
+        GET https://qrcodeapi.115.com/api/2.0/prompt.php
 
         :payload:
-            - refresh_token: str
+            - uid: str
         """
-        api = "https://qrcodeapi.115.com/open/refreshToken"
+        api = complete_api("/api/2.0/prompt.php", 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)
+            payload = {"uid": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
 
     @overload
-    @staticmethod
     def login_qrcode_scan_cancel(
+        self, 
         payload: str | dict, 
         /, 
-        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
     def login_qrcode_scan_cancel(
+        self, 
         payload: str | dict, 
         /, 
-        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
     def login_qrcode_scan_cancel(
+        self, 
         payload: str | dict, 
         /, 
-        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]:
         """取消扫描二维码，payload 数据取自 `login_qrcode_scan` 接口响应
 
-        GET https://hnqrcodeapi.115.com/api/2.0/cancel.php
+        GET https://qrcodeapi.115.com/api/2.0/cancel.php
 
         :payload:
             - key: str
             - uid: str
             - client: int = 0
         """
-        api = "https://hnqrcodeapi.115.com/api/2.0/cancel.php"
+        api = complete_api("/api/2.0/cancel.php", base_url=base_url)
         if isinstance(payload, str):
             payload = {"key": payload, "uid": payload, "client": 0}
-        request_kwargs.setdefault("parse", default_parse)
-        if request is None:
-            return get_default_request()(url=api, params=payload, async_=async_, **request_kwargs)
-        else:
-            return request(url=api, params=payload, **request_kwargs)
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
 
     @overload
-    @staticmethod
-    def login_qrcode_scan_result(
-        uid: str, 
-        app: str = "alipaymini", 
-        request: None | Callable = None, 
+    def login_qrcode_scan_confirm(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def login_qrcode_scan_result(
-        uid: str, 
-        app: str = "alipaymini", 
-        request: None | Callable = None, 
+    def login_qrcode_scan_confirm(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def login_qrcode_scan_result(
-        uid: str, 
-        app: str = "alipaymini", 
-        request: None | Callable = None, 
-        *, 
-        async_: Literal[False, True] = False, 
-        **request_kwargs, 
+    def login_qrcode_scan_confirm(
+        self, 
+        payload: str | dict, 
+        /, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """确认扫描二维码，payload 数据取自 `login_qrcode_scan` 接口响应
+
+        GET https://qrcodeapi.115.com/api/2.0/slogin.php
+
+        :payload:
+            - key: str
+            - uid: str
+            - client: int = 0
+        """
+        api = complete_api("/api/2.0/slogin.php", base_url=base_url)
+        if isinstance(payload, str):
+            payload = {"key": payload, "uid": payload, "client": 0}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    @staticmethod
+    def login_qrcode_scan_result(
+        uid: str, 
+        app: str = "alipaymini", 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def login_qrcode_scan_result(
+        uid: str, 
+        app: str = "alipaymini", 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def login_qrcode_scan_result(
+        uid: str, 
+        app: str = "alipaymini", 
+        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]:
         """获取扫码登录的结果，包含 cookie
 
-        POST https://passportapi.115.com/app/1.0/{app}/1.0/login/qrcode/
+        POST https://qrcodeapi.115.com/app/1.0/{app}/1.0/login/qrcode/
 
         :param uid: 扫码的 uid
         :param app: 绑定的 app
@@ -1523,7 +1804,7 @@ class ClientRequestMixin:
         """
         if app == "desktop":
             app = "web"
-        api = f"http://passportapi.115.com/app/1.0/{app}/1.0/login/qrcode/"
+        api = complete_api(f"/app/1.0/{app}/1.0/login/qrcode/", base_url=base_url)
         payload = {"account": uid}
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
@@ -1537,6 +1818,7 @@ class ClientRequestMixin:
         payload: dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1548,6 +1830,7 @@ class ClientRequestMixin:
         payload: dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1558,6 +1841,7 @@ class ClientRequestMixin:
         payload: dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -1567,6 +1851,7 @@ class ClientRequestMixin:
         GET https://qrcodeapi.115.com/get/status/
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/shtpzfhewv5nag11#lAsp2
 
         :payload:
@@ -1574,7 +1859,7 @@ class ClientRequestMixin:
             - time: int
             - sign: str
         """
-        api = "https://qrcodeapi.115.com/get/status/"
+        api = complete_api("/get/status/", base_url=base_url)
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
             return get_default_request()(url=api, params=payload, async_=async_, **request_kwargs)
@@ -1585,6 +1870,8 @@ class ClientRequestMixin:
     @staticmethod
     def login_qrcode_token(
         request: None | Callable = None, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1594,6 +1881,8 @@ class ClientRequestMixin:
     @staticmethod
     def login_qrcode_token(
         request: None | Callable = None, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1602,6 +1891,8 @@ class ClientRequestMixin:
     @staticmethod
     def login_qrcode_token(
         request: None | Callable = None, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -1610,7 +1901,7 @@ class ClientRequestMixin:
 
         GET https://qrcodeapi.115.com/api/1.0/web/1.0/token/
         """
-        api = "https://qrcodeapi.115.com/api/1.0/web/1.0/token/"
+        api = complete_api(f"/api/1.0/{app}/1.0/token/", base_url=base_url)
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
             return get_default_request()(url=api, async_=async_, **request_kwargs)
@@ -1623,6 +1914,7 @@ class ClientRequestMixin:
         payload: int | str | dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1634,6 +1926,7 @@ class ClientRequestMixin:
         payload: int | str | dict, 
         /, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1644,15 +1937,17 @@ class ClientRequestMixin:
         payload: int | str | dict, 
         /, 
         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]:
-        """获取开放平台的登录二维码，扫码可用
+        """获取开放平台的登录二维码，扫码可用，采用 PKCE (Proof Key for Code Exchange)
 
         POST https://qrcodeapi.115.com/open/authDeviceCode
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/shtpzfhewv5nag11#WzRhM
 
         .. note::
@@ -1674,7 +1969,7 @@ class ClientRequestMixin:
 
             - code_challenge_method: str = <default> 💡 计算 `code_challenge` 的 hash 算法，支持 "md5", "sha1", "sha256"
         """
-        api = "https://qrcodeapi.115.com/open/authDeviceCode"
+        api = complete_api("/open/authDeviceCode", base_url=base_url)
         if isinstance(payload, (int, str)):
             payload = {
                 "client_id": payload, 
@@ -1687,6 +1982,62 @@ class ClientRequestMixin:
         else:
             return request(url=api, method="POST", data=payload, **request_kwargs)
 
+    @overload
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
+        /, 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
+        /, 
+        request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def login_refresh_token_open(
+        payload: str | dict, 
+        /, 
+        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(
@@ -1694,6 +2045,7 @@ class ClientRequestMixin:
         /, 
         app: None | str = "", 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1706,6 +2058,7 @@ class ClientRequestMixin:
         /, 
         app: None | str = "", 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1717,6 +2070,7 @@ class ClientRequestMixin:
         /, 
         app: None | str = "", 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -1817,6 +2171,7 @@ class ClientRequestMixin:
         def gen_step():
             resp = yield cls.login_qrcode_token(
                 async_=async_, 
+                base_url=base_url, 
                 **request_kwargs, 
             )
             qrcode_token = resp["data"]
@@ -1830,15 +2185,16 @@ class ClientRequestMixin:
                 qr.add_data(qrcode)
                 qr.print_ascii(tty=isatty(1))
             else:
-                url = "https://qrcodeapi.115.com/api/1.0/web/1.0/qrcode?uid=" + login_uid
+                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:
                 try:
                     resp = yield cls.login_qrcode_scan_status(
                         qrcode_token, 
+                        base_url=base_url, 
                         async_=async_, 
                         **request_kwargs, 
                     )
@@ -1862,12 +2218,13 @@ class ClientRequestMixin:
                 return cls.login_qrcode_scan_result(
                     login_uid, 
                     app, 
+                    base_url=base_url, 
                     async_=async_, 
                     **request_kwargs, 
                 )
             else:
                 return qrcode_token
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     @classmethod
@@ -1876,6 +2233,7 @@ class ClientRequestMixin:
         /, 
         app_id: int | str = 100195993, 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -1888,6 +2246,7 @@ class ClientRequestMixin:
         /, 
         app_id: int | str = 100195993, 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -1899,6 +2258,7 @@ class ClientRequestMixin:
         /, 
         app_id: int | str = 100195993, 
         console_qrcode: bool = True, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
@@ -1914,6 +2274,7 @@ class ClientRequestMixin:
         def gen_step():
             resp = yield cls.login_qrcode_token_open(
                 app_id, 
+                base_url=base_url, 
                 async_=async_, 
                 **request_kwargs, 
             )
@@ -1928,15 +2289,16 @@ class ClientRequestMixin:
                 qr.add_data(qrcode)
                 qr.print_ascii(tty=isatty(1))
             else:
-                url = "https://qrcodeapi.115.com/api/1.0/web/1.0/qrcode?uid=" + login_uid
+                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:
                 try:
                     resp = yield cls.login_qrcode_scan_status(
                         qrcode_token, 
+                        base_url=base_url, 
                         async_=async_, 
                         **request_kwargs, 
                     )
@@ -1958,10 +2320,13 @@ class ClientRequestMixin:
                         raise LoginError(errno.EAUTH, f"qrcode: aborted with {resp!r}")
             return cls.login_qrcode_access_token_open(
                 login_uid, 
+                base_url=base_url, 
                 async_=async_, 
                 **request_kwargs, 
             )
-        return run_gen_step(gen_step, async_=async_)
+        return run_gen_step(gen_step, simple=True, async_=async_)
+
+    ########## Upload API ##########
 
     upload_endpoint = "http://oss-cn-shenzhen.aliyuncs.com"
 
@@ -2342,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(
@@ -2457,13 +2822,14 @@ 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):
     """115 的客户端对象
 
     .. admonition:: Reference
+
         https://www.yuque.com/115yun/open
 
     :param app_id_or_refresh_token: 申请到的 AppID 或 refresh_token
@@ -2534,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, 
@@ -2552,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:
@@ -2609,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, 
@@ -2619,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(
@@ -2747,6 +3113,7 @@ class P115OpenClient(ClientRequestMixin):
             相当于 `P115Client.download_url_app(app="chrome")`
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/um8whr91bxb5997o
 
         :payload:
@@ -2810,6 +3177,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/ufile/copy
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/lvas49ar94n47bbk
 
         :payload:
@@ -2866,6 +3234,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/ufile/delete
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/kt04fu8vcchd2fnb
 
         :payload:
@@ -2909,7 +3278,7 @@ class P115OpenClient(ClientRequestMixin):
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """更新文件或目录
+        """获取目录中的文件列表和基本信息
 
         GET https://proapi.115.com/open/ufile/files
 
@@ -2917,6 +3286,7 @@ class P115OpenClient(ClientRequestMixin):
             相当于 `P115Client.fs_files_app`
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/kz9ft9a7s57ep868
 
         :payload:
@@ -3036,6 +3406,7 @@ class P115OpenClient(ClientRequestMixin):
             相当于 `P115Client.fs_category_get_app`
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/rl8zrhe2nag21dfw
 
         :payload:
@@ -3085,6 +3456,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/folder/add
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/qur839kyx9cgxpxi
 
         :payload:
@@ -3137,6 +3509,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/ufile/move
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/vc6fhi2mrkenmav2
 
         :payload:
@@ -3157,9 +3530,663 @@ class P115OpenClient(ClientRequestMixin):
         return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
-    def fs_search(
+    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: str | Iterable[str] | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def offline_add_urls(
+        self, 
+        payload: str | Iterable[str] | dict, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def offline_add_urls(
+        self, 
+        payload: str | Iterable[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/offline/add_task_urls
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/zkyfq2499gdn3mty
+
+        :payload:
+            - urls: str 💡 链接，用 "\\n" 分隔，支持HTTP、HTTPS、FTP、磁力链和电驴链接
+            - wp_path_id: int | str = <default> 💡 保存到目录的 id
+        """
+        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 offline_clear(
+        self, 
+        payload: int | dict = 0, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def offline_clear(
+        self, 
+        payload: int | dict = 0, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def offline_clear(
+        self, 
+        payload: int | dict = 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/offline/clear_task
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/uu5i4urb5ylqwfy4
+
+        :payload:
+            - flag: int = 0 💡 标识，用于对应某种情况
+
+              - 0: 已完成
+              - 1: 全部
+              - 2: 已失败
+              - 3: 进行中
+              - 4: 已完成+删除源文件
+              - 5: 全部+删除源文件
+        """
+        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 offline_list(
+        self, 
+        payload: int | dict = 1, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def offline_list(
+        self, 
+        payload: int | dict = 1, 
+        /, 
+        base_url: bool | str | Callable[[], str] = False, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def offline_list(
+        self, 
+        payload: int | dict = 1, 
+        /, 
+        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/offline/get_task_list
+
+        .. admonition:: Reference
+
+            https://www.yuque.com/115yun/open/av2mluz7uwigz74k
+
+        :payload:
+            - page: int | str = 1
+        """
+        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 offline_quota_info(
         self, 
-        payload: str | dict = ".", 
         /, 
         base_url: bool | str | Callable[[], str] = False, 
         *, 
@@ -3168,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, 
         *, 
@@ -3178,87 +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, 
@@ -3266,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, 
         /, 
@@ -3323,7 +4283,7 @@ class P115OpenClient(ClientRequestMixin):
     ) -> dict:
         ...
     @overload
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3333,7 +4293,7 @@ class P115OpenClient(ClientRequestMixin):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_update(
+    def offline_torrent_info(
         self, 
         payload: dict, 
         /, 
@@ -3342,26 +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
@@ -3399,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:
@@ -3448,6 +4402,7 @@ class P115OpenClient(ClientRequestMixin):
         GET https://proapi.115.com/open/rb/list
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/bg7l4328t98fwgex
 
         :payload:
@@ -3497,6 +4452,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/rb/revert
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/gq293z80a3kmxbaq
 
         :payload:
@@ -3542,6 +4498,7 @@ class P115OpenClient(ClientRequestMixin):
         GET https://proapi.115.com/open/upload/get_token
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/kzacvzl0g7aiyyn4
         """
         api = complete_proapi("/open/upload/get_token", base_url)
@@ -3583,6 +4540,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/upload/init
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/ul4mrauo5i2uza0q
 
         :payload:
@@ -3641,6 +4599,7 @@ class P115OpenClient(ClientRequestMixin):
         POST https://proapi.115.com/open/upload/resume
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/tzvi9sbcg59msddz
 
         :payload:
@@ -3752,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(
@@ -4096,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(
@@ -4131,6 +5090,7 @@ class P115OpenClient(ClientRequestMixin):
         GET https://proapi.115.com/open/user/info
 
         .. admonition:: Reference
+
             https://www.yuque.com/115yun/open/ot1litggzxa1czww
         """
         api = complete_proapi("/open/user/info", base_url)
@@ -4146,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
@@ -4464,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:
@@ -4601,118 +5573,42 @@ class P115Client(P115OpenClient):
         | 20    | P2       | mac        | 115生活(macOS端)        |
         +-------+----------+------------+-------------------------+
         | 21    | P3       | linux      | 115生活(Linux端)        |
-        +-------+----------+------------+-------------------------+
-        | 22    | R1       | wechatmini | 115生活(微信小程序)     |
-        +-------+----------+------------+-------------------------+
-        | 23    | R2       | alipaymini | 115生活(支付宝小程序)   |
-        +-------+----------+------------+-------------------------+
-        | 24    | S1       | harmony    | 115(Harmony端)          |
-        +-------+----------+------------+-------------------------+
-        """
-        def gen_step():
-            nonlocal app
-            status = yield self.login_status(async_=async_, **request_kwargs)
-            if status:
-                return self
-            if not app:
-                app = yield self.login_app(async_=async_, **request_kwargs)
-            if not app:
-                app = "alipaymini"
-            resp = yield self.login_with_qrcode(
-                app, 
-                console_qrcode=console_qrcode, 
-                async_=async_, 
-                **request_kwargs, 
-            )
-            try:
-                check_response(resp)
-            except AuthenticationError:
-                resp = yield self.login_with_qrcode(
-                    app, 
-                    console_qrcode=console_qrcode, 
-                    async_=async_, 
-                    **request_kwargs, 
-                )
-                check_response(resp)
-            setattr(self, "cookies", resp["data"]["cookie"])
-            return self
-        return run_gen_step(gen_step, async_=async_)
-
-    @overload
-    def login_qrcode_scan(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[False] = False, 
-        **request_kwargs, 
-    ) -> dict:
-        ...
-    @overload
-    def login_qrcode_scan(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[True], 
-        **request_kwargs, 
-    ) -> Coroutine[Any, Any, dict]:
-        ...
-    def login_qrcode_scan(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[False, True] = False, 
-        **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """扫描二维码，payload 数据取自 `login_qrcode_token` 接口响应
-
-        GET https://qrcodeapi.115.com/api/2.0/prompt.php
-
-        :payload:
-            - uid: str
-        """
-        api = "https://qrcodeapi.115.com/api/2.0/prompt.php"
-        if isinstance(payload, str):
-            payload = {"uid": payload}
-        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
-
-    @overload
-    def login_qrcode_scan_confirm(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[False] = False, 
-        **request_kwargs, 
-    ) -> dict:
-        ...
-    @overload
-    def login_qrcode_scan_confirm(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[True], 
-        **request_kwargs, 
-    ) -> Coroutine[Any, Any, dict]:
-        ...
-    def login_qrcode_scan_confirm(
-        self, 
-        payload: str | dict, 
-        /, 
-        async_: Literal[False, True] = False, 
-        **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """确认扫描二维码，payload 数据取自 `login_qrcode_scan` 接口响应
-
-        GET https://hnqrcodeapi.115.com/api/2.0/slogin.php
-
-        :payload:
-            - key: str
-            - uid: str
-            - client: int = 0
+        +-------+----------+------------+-------------------------+
+        | 22    | R1       | wechatmini | 115生活(微信小程序)     |
+        +-------+----------+------------+-------------------------+
+        | 23    | R2       | alipaymini | 115生活(支付宝小程序)   |
+        +-------+----------+------------+-------------------------+
+        | 24    | S1       | harmony    | 115(Harmony端)          |
+        +-------+----------+------------+-------------------------+
         """
-        api = "https://hnqrcodeapi.115.com/api/2.0/slogin.php"
-        if isinstance(payload, str):
-            payload = {"key": payload, "uid": payload, "client": 0}
-        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+        def gen_step():
+            nonlocal app
+            status = yield self.login_status(async_=async_, **request_kwargs)
+            if status:
+                return self
+            if not app:
+                app = yield self.login_app(async_=async_, **request_kwargs)
+            if not app:
+                app = "alipaymini"
+            resp = yield self.login_with_qrcode(
+                app, 
+                console_qrcode=console_qrcode, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            try:
+                check_response(resp)
+            except AuthenticationError:
+                resp = yield self.login_with_qrcode(
+                    app, 
+                    console_qrcode=console_qrcode, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                check_response(resp)
+            setattr(self, "cookies", resp["data"]["cookie"])
+            return self
+        return run_gen_step(gen_step, simple=True, async_=async_)
 
     @overload
     def login_with_app(
@@ -4844,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(
@@ -4902,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(
@@ -4954,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(
@@ -5098,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(
@@ -5192,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
@@ -5311,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(
@@ -5347,7 +6243,7 @@ class P115Client(P115OpenClient):
                 return None
         return self.logout_by_ssoent(ssoent, async_=async_, **request_kwargs)
 
-    def request(
+    def _request(
         self, 
         /, 
         url: str, 
@@ -5463,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:
@@ -5517,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, 
@@ -5531,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:
@@ -5583,11 +6478,95 @@ 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, 
+        /, 
+        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 check: 是否用 `check_response` 函数检查返回值
+        :param ecdh_encrypt: 使用 ecdh 算法进行加密（返回值也要解密）
+        :param fetch_cert_headers: 调用以获取认证信息头
+        :param revert_cert_headers: 调用以退还认证信息头
+        :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)
 
     ########## Activity API ##########
 
@@ -6355,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 ##########
 
@@ -9057,9 +10035,9 @@ class P115Client(P115OpenClient):
             4. show_dir=0 且 cur=0（或不指定 cur）
 
         .. hint::
-            如果仅指定 natsort=1&show_dir=1，以及一个可选的 cid，则当文件数不大于 1150 时可仅统计某个目录内的文件或目录总数，而不返回具体的文件信息，超过那个数值时，则会返回完整的文件列表
+            如果不指定或者指定的 cid 不存在，则会视为 cid=0 进行处理
 
-            但如果不指定或者指定的 cid 不存在，则会视为 cid=0 进行处理
+            当指定 natsort=1 时，如果里面的数量较少时，可仅统计某个目录内的文件或目录总数，而不返回具体的文件信息
 
         .. hint::
             当一个 cookies 被另一个更新的登录所失效，并不意味着这个 cookies 就直接不可用了。
@@ -14938,12 +15916,145 @@ 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(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def login_open_auth_detail(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def login_open_auth_detail(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        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/app/1.0/web/1.0/user/getAppAuthDetail
+
+        :payload:
+            - auth_id: int | str 💡 授权 id
+        """
+        api = complete_api(f"/app/1.0/{app}/1.0/user/getAppAuthDetail", base_url=base_url)
+        if isinstance(payload, (int, str)):
+            payload = {"auth_id": payload}
+        return self.request(url=api, params=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def login_open_auth_list(
+        self, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def login_open_auth_list(
+        self, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def login_open_auth_list(
+        self, 
+        /, 
+        app: str = "web", 
+        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/app/1.0/web/1.0/user/getAppAuthList
+        """
+        api = complete_api(f"/app/1.0/{app}/1.0/user/getAppAuthList", base_url=base_url)
+        return self.request(url=api, async_=async_, **request_kwargs)
+
+    @overload
+    def login_open_deauth(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def login_open_deauth(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def login_open_deauth(
+        self, 
+        payload: int | str | dict, 
+        /, 
+        app: str = "web", 
+        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/app/1.0/web/1.0/user/deauthApp
+
+        :payload:
+            - auth_id: int | str 💡 授权 id
+        """
+        api = complete_api(f"/app/1.0/{app}/1.0/user/deauthApp", base_url=base_url)
+        if isinstance(payload, (int, str)):
+            payload = {"auth_id": payload}
+        return self.request(url=api, method="POST", data=payload, async_=async_, **request_kwargs)
 
     @overload
     def login_check_sso(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
@@ -14952,6 +16063,9 @@ class P115Client(P115OpenClient):
     def login_check_sso(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
@@ -14959,14 +16073,17 @@ class P115Client(P115OpenClient):
     def login_check_sso(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
         """检查当前 cookies 的登录状态信息，并且自最近一次登录的 60 秒后，使当前设备下除最近一次登录外的所有 cookies 失效
 
-        GET https://passportapi.115.com/app/1.0/web/1.0/check/sso
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/check/sso
         """
-        api = "https://passportapi.115.com/app/1.0/web/1.0/check/sso"
+        api = complete_api(f"/app/1.0/{app}/1.0/check/sso", base_url=base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
     @overload
@@ -15005,6 +16122,9 @@ class P115Client(P115OpenClient):
     def login_devices(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
@@ -15013,6 +16133,9 @@ class P115Client(P115OpenClient):
     def login_devices(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
@@ -15020,14 +16143,17 @@ class P115Client(P115OpenClient):
     def login_devices(
         self, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
+        *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
         """获取所有的已登录设备的信息，不过当前的 cookies 必须是登录状态（未退出或未失效）
 
-        GET https://passportapi.115.com/app/1.0/web/1.0/login_log/login_devices
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/login_log/login_devices
         """
-        api = "https://passportapi.115.com/app/1.0/web/1.0/login_log/login_devices"
+        api = complete_api(f"/app/1.0/{app}/1.0/login_log/login_devices", base_url=base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
     @overload
@@ -15073,6 +16199,8 @@ class P115Client(P115OpenClient):
         self, 
         payload: dict = {}, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -15083,6 +16211,8 @@ class P115Client(P115OpenClient):
         self, 
         payload: dict = {}, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -15092,19 +16222,21 @@ class P115Client(P115OpenClient):
         self, 
         payload: dict = {}, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
         """获取登录信息日志列表
 
-        GET https://passportapi.115.com/app/1.0/web/1.0/login_log/log
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/login_log/log
 
         :payload:
             - start: int = 0
             - limit: int = 100
         """
-        api = "https://passportapi.115.com/app/1.0/web/1.0/login_log/log"
+        api = complete_api(f"/app/1.0/{app}/1.0/login_log/log", base_url=base_url)
         payload = {"start": 0, "limit": 100, **payload}
         return self.request(url=api, params=payload, async_=async_, **request_kwargs)
 
@@ -15113,6 +16245,7 @@ class P115Client(P115OpenClient):
         self, 
         /, 
         app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -15123,6 +16256,7 @@ class P115Client(P115OpenClient):
         self, 
         /, 
         app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -15132,15 +16266,16 @@ class P115Client(P115OpenClient):
         self, 
         /, 
         app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
         """当前登录的设备总数和最近登录的设备
 
-        GET https://passportapi.115.com/app/1.0/web/1.0/login_log/login_online
+        GET https://qrcodeapi.115.com/app/1.0/web/1.0/login_log/login_online
         """
-        api = f"http://passportapi.115.com/app/1.0/{app}/1.0/login_log/login_online"
+        api = complete_api(f"/app/1.0/{app}/1.0/login_log/login_online", base_url=base_url)
         return self.request(url=api, async_=async_, **request_kwargs)
 
     @overload
@@ -15202,6 +16337,7 @@ class P115Client(P115OpenClient):
         /, 
         app: None | str = None, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -15213,6 +16349,7 @@ class P115Client(P115OpenClient):
         /, 
         app: None | str = None, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -15223,13 +16360,14 @@ class P115Client(P115OpenClient):
         /, 
         app: None | str = None, 
         request: None | Callable = None, 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> None | Coroutine[Any, Any, None]:
         """退出登录状态（可以把某个客户端下线，所有已登录设备可从 `login_devices` 获取）
 
-        GET https://passportapi.115.com/app/1.0/{app}/1.0/logout/logout
+        GET https://qrcodeapi.115.com/app/1.0/{app}/1.0/logout/logout
 
         :param app: 退出登录的 app
 
@@ -15295,20 +16433,22 @@ class P115Client(P115OpenClient):
                 app = yield self.login_app(async_=async_)
             if app == "desktop":
                 app = "web"
-            api = f"http://passportapi.115.com/app/1.0/{app}/1.0/logout/logout"
+            api = complete_api(f"/app/1.0/{app}/1.0/logout/logout", base_url=base_url)
             request_kwargs["headers"] = {**(request_kwargs.get("headers") or {}), "Cookie": self.cookies_str}
             request_kwargs.setdefault("parse", ...)
             if request is None:
                 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(
         self, 
         payload: None | str | dict = None, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
@@ -15319,6 +16459,8 @@ class P115Client(P115OpenClient):
         self, 
         payload: None | str | dict = None, 
         /, 
+        app: str = "web", 
+        base_url: str | Callable[[], str] = "https://qrcodeapi.115.com", 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
@@ -15328,13 +16470,15 @@ class P115Client(P115OpenClient):
         self, 
         payload: None | str | dict = 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]:
         """退出登录状态（可以把某个客户端下线，所有已登录设备可从 `login_devices` 获取）
 
-        POST https://passportapi.115.com/app/1.0/web/1.0/logout/mange
+        POST https://qrcodeapi.115.com/app/1.0/web/1.0/logout/mange
 
         :payload:
             - ssoent: str
@@ -15395,7 +16539,7 @@ class P115Client(P115OpenClient):
         | 24    | S1       | harmony    | 115(Harmony端)          |
         +-------+----------+------------+-------------------------+
         """
-        api = "https://passportapi.115.com/app/1.0/web/1.0/logout/mange"
+        api = complete_api(f"/app/1.0/{app}/1.0/logout/mange", base_url=base_url)
         if payload is None:
             payload = {"ssoent": self.login_ssoent or ""}
         elif isinstance(payload, str):
@@ -16389,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, 
@@ -16431,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):
@@ -16483,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, 
@@ -16526,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:
@@ -16536,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, 
         *, 
@@ -16547,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, 
         *, 
@@ -16557,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, 
         *, 
@@ -16580,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)
 
@@ -16658,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, 
@@ -16694,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):
@@ -16809,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, 
         *, 
@@ -16820,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, 
         *, 
@@ -16830,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, 
         *, 
@@ -19195,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(
@@ -19562,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(
@@ -19698,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(
@@ -20057,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 ##########