p123client 0.0.6.9__py3-none-any.whl → 0.0.6.9.4__py3-none-any.whl

p123client/client.py

@@ -5,21 +5,25 @@ from __future__ import annotations
 
 __all__ = ["check_response", "P123OpenClient", "P123Client"]
 
+from base64 import b64decode
 from collections.abc import (
     AsyncIterable, Awaitable, Buffer, Callable, Coroutine, 
     ItemsView, Iterable, Iterator, Mapping, MutableMapping, 
 )
-from errno import EIO, EISDIR, ENOENT
+from contextlib import contextmanager
+from errno import EAUTH, EIO, EISDIR, ENOENT
 from functools import partial
 from hashlib import md5
 from http.cookiejar import CookieJar
 from inspect import isawaitable
 from itertools import chain
-from os import fsdecode, fstat, PathLike
+from os import fsdecode, fstat, isatty, PathLike
 from os.path import basename
-from re import compile as re_compile
+from pathlib import Path, PurePath
+from re import compile as re_compile, MULTILINE
+from sys import _getframe
 from tempfile import TemporaryFile
-from typing import cast, overload, Any, Literal
+from typing import cast, overload, Any, Final, Literal, Self
 from uuid import uuid4
 from warnings import warn
 
@@ -31,21 +35,24 @@ from filewrap import (
     copyfileobj, copyfileobj_async, SupportsRead, 
 )
 from hashtools import file_digest, file_digest_async
-from http_request import encode_multipart_data, encode_multipart_data_async, SupportsGeturl
+from http_request import (
+    encode_multipart_data, encode_multipart_data_async, SupportsGeturl, 
+)
 from iterutils import run_gen_step
 from property import locked_cacheproperty
 from yarl import URL
 
-from .exception import P123OSError, P123BrokenUpload
+from .const import CLIENT_API_METHODS_MAP, CLIENT_METHOD_API_MAP
+from .exception import P123OSError, P123BrokenUpload, P123LoginError, P123AuthenticationError
 
 
 # 默认使用的域名
 # "https://www.123pan.com"
 # "https://www.123pan.com/a"
 # "https://www.123pan.com/b"
-DEFAULT_BASE_URL = "https://www.123pan.com/b"
-DEFAULT_LOGIN_BASE_URL = "https://login.123pan.com"
-DEFAULT_OPEN_BASE_URL = "https://open-api.123pan.com"
+DEFAULT_BASE_URL: Final = "https://www.123pan.com/b"
+DEFAULT_LOGIN_BASE_URL: Final = "https://login.123pan.com"
+DEFAULT_OPEN_BASE_URL: Final = "https://open-api.123pan.com"
 # 默认的请求函数
 _httpx_request = None
 
@@ -147,6 +154,20 @@ def items[K, V](
     return m
 
 
+@contextmanager
+def temp_globals(f_globals: None | dict = None, /, **ns):
+    if f_globals is None:
+        f_globals = _getframe(2).f_globals
+    old_globals = f_globals.copy()
+    if ns:
+        f_globals.update(ns)
+    try:
+        yield f_globals
+    finally:
+        f_globals.clear()
+        f_globals.update(old_globals)
+
+
 @overload
 def check_response(resp: dict, /) -> dict:
     ...
@@ -157,9 +178,16 @@ def check_response(resp: dict | Awaitable[dict], /) -> dict | Coroutine[Any, Any
     """检测 123 的某个接口的响应，如果成功则直接返回，否则根据具体情况抛出一个异常，基本上是 OSError 的实例
     """
     def check(resp, /) -> dict:
-        if not isinstance(resp, dict) or resp.get("code", 0) not in (0, 200):
+        if not isinstance(resp, dict):
             raise P123OSError(EIO, resp)
-        return resp
+        code = resp.get("code", 0)
+        if code in (0, 200):
+            return resp
+        match code:
+            case 401:
+                raise P123AuthenticationError(EAUTH, resp)
+            case _:
+                raise P123OSError(EIO, resp)
     if isawaitable(resp):
         async def check_await() -> dict:
             return check(await resp)
@@ -176,17 +204,32 @@ class P123OpenClient:
         https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced
     """
 
+    token_path: None | PurePath = None
+
     def __init__(
         self, /, 
-        client_id: str = "", 
+        client_id: str | PathLike = "", 
         client_secret: str = "", 
-        token: str = "", 
+        token: None | str | PathLike = None, 
     ):
-        self.client_id = client_id
-        self.client_secret = client_secret
-        self.token = token
-        if client_id and client_secret:
-            self.login_open()
+        if isinstance(client_id, PathLike):
+            token = client_id
+        else:
+            self.client_id = client_id
+            self.client_secret = client_secret
+        if token is None:
+            if client_id and client_secret:
+                self.login_open()
+        elif isinstance(token, str):
+            self.token = token.removeprefix("Bearer ")
+        else:
+            if isinstance(token, PurePath) and hasattr(token, "open"):
+                self.token_path = token
+            else:
+                self.token_path = Path(fsdecode(token))
+            self._read_token()
+            if not self.token and client_id and client_secret:
+                self.login_open()
 
     def __del__(self, /):
         self.close()
@@ -258,20 +301,62 @@ class P123OpenClient:
 
     @property
     def token(self, /) -> str:
-        return self._token
+        return self.__dict__.get("token", "")
 
     @token.setter
-    def token(self, value: str, /):
-        self._token = value
-        if value:
-            self.headers["authorization"] = f"Bearer {self._token}"
-        else:
-            self.headers.pop("authorization", None)
+    def token(self, token: str, /):
+        if token != self.token:
+            self._write_token(token)
+            ns = self.__dict__
+            ns["token"] = token
+            if token:
+                self.headers["authorization"] = f"Bearer {token}"
+            else:
+                self.headers.pop("authorization", None)
+                ns.pop("token_user_info", None)
+                ns.pop("user_id", None)
 
     @token.deleter
     def token(self, /):
         self.token = ""
 
+    @locked_cacheproperty
+    def token_user_info(self, /) -> dict:
+        from orjson import loads
+        return loads(b64decode(self.token.split(".", 2)[1] + "=="))
+
+    @locked_cacheproperty
+    def user_id(self, /) -> dict:
+        return self.token_user_info["id"]
+
+    def _read_token(
+        self, 
+        /, 
+        encoding: str = "latin-1", 
+    ) -> None | str:
+        if token_path := self.token_path:
+            try:
+                with token_path.open("rb") as f: # type: ignore
+                    token = str(f.read().strip(), encoding)
+                self.token = token.removeprefix("Bearer ")
+                return token
+            except OSError:
+                pass
+        return self.token
+
+    def _write_token(
+        self, 
+        token: None | str = None, 
+        /, 
+        encoding: str = "latin-1", 
+    ):
+        if token_path := self.token_path:
+            if token is None:
+                token = self.token
+            token_bytes = bytes(token, encoding)
+            with token_path.open("wb") as f: # type: ignore
+                f.write(token_bytes)
+
     def close(self, /) -> None:
         """删除 session 和 async_session 属性，如果它们未被引用，则应该会被自动清理
         """
@@ -433,13 +518,16 @@ class P123OpenClient:
             - clientID: str     💡 应用标识，创建应用时分配的 appId
             - clientSecret: str 💡 应用密钥，创建应用时分配的 secretId
         """
-        request_kwargs["url"] = complete_url("/api/v1/access_token", base_url)
-        request_kwargs.setdefault("method", "POST")
         request_kwargs.setdefault("parse", default_parse)
         if request is None:
             request = get_default_request()
             request_kwargs["async_"] = async_
-        return request(json=payload, **request_kwargs)
+        return request(
+            url=complete_url("/api/v1/access_token", base_url), 
+            method="POST", 
+            json=payload, 
+            **request_kwargs, 
+        )
 
     @overload
     @staticmethod
@@ -490,13 +578,16 @@ class P123OpenClient:
             - scope: str = "user:base,file:all:read,file:all:write" 💡 权限
             - state: str = ""   💡 自定义参数，任意取值
         """
-        request_kwargs["url"] = complete_url("/auth", base_url)
         request_kwargs.setdefault("parse", default_parse)
         payload = dict_to_lower_merge(payload, scope="user:base,file:all:read,file:all:write")
         if request is None:
             request = get_default_request()
             request_kwargs["async_"] = async_
-        return request(params=payload, **request_kwargs)
+        return request(
+            url=complete_url("/auth", base_url), 
+            params=payload, 
+            **request_kwargs, 
+        )
 
     @overload
     @staticmethod
@@ -556,8 +647,6 @@ class P123OpenClient:
             - redirect_uri: str = <default>  💡 应用注册的回调地址，`grant_type` 为 "authorization_code" 时必携带
             - refresh_token: str = <default> 💡 刷新 token，单次请求有效
         """
-        request_kwargs["url"] = complete_url("/api/v1/oauth2/access_token", base_url)
-        request_kwargs.setdefault("method", "POST")
         request_kwargs.setdefault("parse", default_parse)
         payload = dict_to_lower(payload)
         if not payload.get("grant_type"):
@@ -568,7 +657,163 @@ class P123OpenClient:
         if request is None:
             request = get_default_request()
             request_kwargs["async_"] = async_
-        return request(params=payload, **request_kwargs)
+        return request(
+            url=complete_url("/api/v1/oauth2/access_token", base_url), 
+            method="POST", 
+            params=payload, 
+            **request_kwargs, 
+        )
+
+    ########## Developer API ##########
+
+    @overload
+    def developer_config_forbide_ip_list(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def developer_config_forbide_ip_list(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def developer_config_forbide_ip_list(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """ip黑名单列表
+
+        GET https://open-api.123pan.com/api/v1/developer/config/forbide-ip/list
+
+        .. admonition:: Reference
+            /API列表/直链/IP黑名单配置/ip黑名单列表
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/mxldrm9d5gpw5h2d
+
+        .. caution::
+            获取用户配置的黑名单     
+        """
+        api = complete_url("/api/v1/developer/config/forbide-ip/list", base_url)
+        return self.request(api, async_=async_, **request_kwargs)
+
+    @overload
+    def developer_config_forbide_ip_switch(
+        self, 
+        payload: dict | Literal[1, 2] = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def developer_config_forbide_ip_switch(
+        self, 
+        payload: dict | Literal[1, 2] = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def developer_config_forbide_ip_switch(
+        self, 
+        payload: dict | Literal[1, 2] = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """开启关闭ip黑名单
+
+        POST https://open-api.123pan.com/api/v1/developer/config/forbide-ip/switch
+
+        .. admonition:: Reference
+            /API列表/直链/IP黑名单配置/开启关闭ip黑名单
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xwx77dbzrkxquuxm
+
+        .. caution::
+            此接口需要开通开发者权益
+
+        :payload:
+            - Status: 1 | 2 = 1 💡 状态：1:启用 2:禁用 
+        """
+        api = complete_url("/api/v1/developer/config/forbide-ip/switch", base_url)
+        if not isinstance(payload, dict):
+            payload = {"Status": payload}
+        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+
+    @overload
+    def developer_config_forbide_ip_update(
+        self, 
+        payload: dict | Iterable[str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def developer_config_forbide_ip_update(
+        self, 
+        payload: dict | Iterable[str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def developer_config_forbide_ip_update(
+        self, 
+        payload: dict | Iterable[str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """更新ip黑名单列表
+
+        POST https://open-api.123pan.com/api/v1/developer/config/forbide-ip/update
+
+        .. admonition:: Reference
+            /API列表/直链/IP黑名单配置/更新ip黑名单列表
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/tt3s54slh87q8wuh
+
+        .. caution::
+            此接口需要开通开发者权益
+
+        :payload:
+            - IpList: list[str] 💡 IP 地址列表，最多 500 个 IPv4 地址
+        """
+        api = complete_url("/api/v1/developer/config/forbide-ip/update", base_url)
+        if not isinstance(payload, dict):
+            if not isinstance(payload, (list, tuple)):
+                payload = list(payload)
+            payload = {"IpList": payload}
+        return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
+
+    ########## Direct Link API ##########
 
     @overload
     def dlink_disable(
@@ -706,6 +951,9 @@ class P123OpenClient:
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/agmqpmu0dm0iogc9
 
+        .. caution::
+            此接口需要开通开发者权益，并且仅限查询近 3 天的日志数据
+
         :payload:
             - pageNum: int                           💡 第几页
             - pageSize: int  = 100                   💡 分页大小
@@ -781,6 +1029,65 @@ class P123OpenClient:
             payload = {"fileID": payload}
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    @overload
+    def dlink_offline_log(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def dlink_offline_log(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def dlink_offline_log(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_OPEN_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取直链离线日志
+
+        GET https://open-api.123pan.com/api/v1/direct-link/offline/logs
+
+        .. admonition:: Reference
+            /API列表/直链/获取直链离线日志
+
+            https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/yz4bdynw9yx5erqb
+
+        .. caution::
+            此接口需要开通开发者权益，并且仅限查询近30天的日志数据
+
+        :payload:
+            - pageNum: int                  💡 第几页
+            - pageSize: int  = 100          💡 分页大小
+            - startHour: str = "0001010100" 💡 开始时间，格式：YYYYMMDDhh
+            - endHour: str.  = "9999123123" 💡 结束时间，格式：YYYYMMDDhh
+        """
+        api = complete_url("/api/v1/direct-link/offline/logs", base_url)
+        if not isinstance(payload, dict):
+            payload = {"pageNum": payload}
+        payload = dict_to_lower_merge(payload, {
+            "pageSize": 100, 
+            "startTime": "0001010100", 
+            "endTime": "9999123123", 
+        })
+        return self.request(api, params=payload, async_=async_, **request_kwargs)
+
     @overload
     def dlink_transcode(
         self, 
@@ -934,6 +1241,8 @@ class P123OpenClient:
             payload = {"fileID": payload}
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    ########## Download API ##########
+
     @overload
     def download_info(
         self, 
@@ -983,6 +1292,8 @@ class P123OpenClient:
             payload = {"fileId": payload}
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    ########## File System API ##########
+
     @overload
     def fs_delete(
         self, 
@@ -1078,6 +1389,9 @@ class P123OpenClient:
 
             https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/owapsz373dzwiqbp
 
+        .. note::
+            支持查询单文件夹包含文件大小            
+
         :payload:
             - fileID: int 💡 文件 id
         """
@@ -1188,11 +1502,14 @@ class P123OpenClient:
 
         .. note::
             如果返回信息中，"lastFileId" 字段的值为 "-1"，代表最后一页（无需再翻页查询）。
-            其它则代表下一页开始的文件 id，携带到请求参数中，可查询下一页
+            其它则代表下一页开始的文件 id，携带到请求参数中，可查询下一页。
+
+        .. caution::
+            此接口查询结果包含回收站的文件，需自行根据字段 `trashed` 判断处理
 
         :payload:
             - businessType: int = <default> 💡 业务类型：2:转码空间
-            - category: int = <default>     💡 分类代码：0:未知 1:音频 2:视频 3:图片
+            - category: int = <default>     💡 分类代码：0:未知 1:音频 2:视频 3:图片 4:音频 5:其它
             - lastFileId: int = <default>   💡 上一页的最后一条记录的 FileID，翻页查询时需要填写
             - limit: int = 100              💡 分页大小，最多 100
             - parentFileId: int | str = 0   💡 父目录 id，根目录是 0
@@ -1262,7 +1579,7 @@ class P123OpenClient:
 
         :payload:
             - limit: int = 100         💡 分页大小，最多 100
-            - orderBy: str = "file_id" 💡 排序依据
+            - orderBy: str = "file_name" 💡 排序依据
 
                 - "file_id": 文件 id
                 - "file_name": 文件名
@@ -1287,7 +1604,7 @@ class P123OpenClient:
             payload = {"parentFileId": payload}
         payload = dict_to_lower_merge(payload, {
             "limit": 100, 
-            "orderBy": "file_id", 
+            "orderBy": "file_name", 
             "orderDirection": "asc", 
             "page": 1, 
             "parentFileId": 0, 
@@ -1617,6 +1934,8 @@ class P123OpenClient:
             payload = {"fileIDs": payload}
         return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
 
+    ########## Offline Download API ##########
+
     @overload
     def offline_download(
         self, 
@@ -1726,6 +2045,8 @@ class P123OpenClient:
             payload = {"taskID": payload}
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    ########## Oss API ##########
+
     @overload
     def oss_copy(
         self, 
@@ -2864,6 +3185,8 @@ class P123OpenClient:
                 }) from e
         return run_gen_step(gen_step, async_)
 
+    ########## Share API ##########
+
     @overload
     def share_create(
         self, 
@@ -3072,6 +3395,8 @@ class P123OpenClient:
             payload = {"limit": payload}
         return self.request(api, params=payload, async_=async_, **request_kwargs)
 
+    ########## Transcode API ##########
+
     @overload
     def transcode_delete(
         self, 
@@ -3618,6 +3943,8 @@ class P123OpenClient:
         api = complete_url("/api/v1/transcode/video", base_url)
         return self.request(api, "POST", json=payload, async_=async_, **request_kwargs)
 
+    ########## Upload API ##########
+
     @overload
     def upload_create(
         self, 
@@ -4220,6 +4547,8 @@ class P123OpenClient:
                 }) from e
         return run_gen_step(gen_step, async_)
 
+    ########## User API ##########
+
     @overload
     def user_info(
         self, 
@@ -4274,6 +4603,8 @@ class P123OpenClient:
         api = complete_url("/api/v1/user/info", base_url)
         return self.request(api, async_=async_, **request_kwargs)
 
+    ########## API Aliases ##########
+
     login_open = login
     login_access_token_open = login_access_token
     login_auth_open = login_auth
@@ -4341,19 +4672,36 @@ class P123OpenClient:
 
 
 class P123Client(P123OpenClient):
+    """123 的客户端对象
 
+    :param passport: 手机号或邮箱
+    :param password: 密码
+    :param token: 123 的访问令牌
+    """
     def __init__(
         self, 
         /, 
-        passport: int | str = "", 
+        passport: int | str | PathLike = "", 
         password: str = "", 
-        token: str = "", 
+        token: None | str | PathLike = None, 
     ):
-        self.passport = passport
-        self.password = password
-        self.token = token
-        if passport and password:
+        if isinstance(passport, PathLike):
+            token = passport
+        else:
+            self.passport = passport
+            self.password = password
+        if token is None:
             self.login()
+        elif isinstance(token, str):
+            self.token = token.removeprefix("Bearer ")
+        else:
+            if isinstance(token, PurePath) and hasattr(token, "open"):
+                self.token_path = token
+            else:
+                self.token_path = Path(fsdecode(token))
+            self._read_token()
+            if not self.token:
+                self.login()
 
     @overload # type: ignore
     def login(
@@ -4412,193 +4760,236 @@ class P123Client(P123OpenClient):
         else:
             password = self.password
         def gen_step():
-            resp = yield self.user_login(
-                {"passport": passport, "password": password, "remember": remember}, 
-                base_url=base_url, 
-                async_=async_, 
-                **request_kwargs, 
-            )
-            check_response(resp)
-            self.token = resp["data"]["token"]
-            return resp
+            if passport and password:
+                resp = yield self.login_passport(
+                    {"passport": passport, "password": password, "remember": remember}, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                check_response(resp)
+                self.token = resp["data"]["token"]
+                return resp
+            else:
+                resp = yield self.login_with_qrcode(
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                self.token = resp["data"]["token"]
+                return resp
         return run_gen_step(gen_step, async_)
 
     @overload
-    @staticmethod
-    def app_dydomain(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_another(
+        self, 
+        /, 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
-    ) -> dict:
+    ) -> Self:
         ...
     @overload
-    @staticmethod
-    def app_dydomain(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_another(
+        self, 
+        /, 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
-    ) -> Coroutine[Any, Any, dict]:
+    ) -> Coroutine[Any, Any, Self]:
         ...
-    @staticmethod
-    def app_dydomain(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_another(
+        self, 
+        /, 
+        replace: bool | Self = False, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """获取 123 网盘的各种域名
+    ) -> Self | Coroutine[Any, Any, Self]:
+        """再执行一次登录
 
-        GET https://www.123pan.com/api/dydomain
+        :param replace: 替换某个 client 对象的 token
+
+            - 如果为 P123Client, 则更新到此对象
+            - 如果为 True，则更新到 `self`
+            - 如果为 False，否则返回新的 `P123Client` 对象
+
+        :param base_url: 接口的基地址
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
+
+        :return: 客户端实例
         """
-        request_kwargs["url"] = complete_url("/api/dydomain", base_url)
-        request_kwargs.setdefault("parse", default_parse)
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(**request_kwargs)
+        def gen_step():
+            resp = yield self.login_qrcode_auto(
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            check_response(resp)
+            if resp["code"] != 200:
+                raise P123LoginError(EAUTH, resp)
+            token = resp["data"]["token"]
+            if replace is False:
+                return type(self)(passport=self.passport, password=self.password, token=token)
+            elif replace is True:
+                inst = self
+            else:
+                inst = replace
+            inst.token = token
+            return inst
+        return run_gen_step(gen_step, async_)
 
     @overload
-    @staticmethod
-    def app_server_time(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_qrcode_auto(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def app_server_time(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_qrcode_auto(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def app_server_time(
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
-        request: None | Callable = None, 
+    def login_qrcode_auto(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取 123 网盘的服务器时间戳
+        """执行一次自动扫码，但并不因此更新 `self.token`
 
-        GET https://www.123pan.com/api/get/server/time
+        :param base_url: 接口的基地址
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
+
+        :return: 接口响应
         """
-        request_kwargs["url"] = complete_url("/api/get/server/time", base_url)
-        request_kwargs.setdefault("parse", default_parse)
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(**request_kwargs)
+        def gen_step():
+            resp = yield self.login_qrcode_generate(
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            check_response(resp)
+            uniID = resp["data"]["uniID"]
+            resp = yield self.login_qrcode_confirm(
+                uniID, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            check_response(resp)
+            resp = yield self.login_qrcode_result(
+                uniID, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            return resp
+        return run_gen_step(gen_step, async_)
 
     @overload
-    def download_info(
-        self, 
-        payload: dict | int | str, 
+    @classmethod
+    def login_with_qrcode(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def download_info(
-        self, 
-        payload: dict | int | str, 
+    @classmethod
+    def login_with_qrcode(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def download_info(
-        self, 
-        payload: dict | int | str, 
+    @classmethod
+    def login_with_qrcode(
+        cls, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取下载信息
-
-        POST https://www.123pan.com/api/file/download_info
+        """二维码扫码登录
 
-        .. hint::
-            即使文件已经被删除，只要还有 S3KeyFlag 和 Etag （即 MD5） 就依然可以下载
-
-            你完全可以构造这样的查询参数
-
-            .. code:: python
-
-                payload = {
-                    "Etag": "...", # 必填，文件的 MD5
-                    "FileID": 0, # 可以随便填
-                    "FileName": "a", # 随便填一个名字
-                    "S3KeyFlag": str # 必填，格式为 f"{UID}-0"，UID 就是上传此文件的用户的 UID，如果此文件是由你上传的，则可从 `P123Client.user_info` 的响应中获取
-                    "Size": 0, # 可以随便填，填了可能搜索更准确
-                }
-
-        .. note::
-            获取的直链有效期是 24 小时
+        :param base_url: 接口的基地址
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
 
-        :payload:
-            - Etag: str 💡 文件的 MD5 散列值
-            - S3KeyFlag: str
-            - FileName: str = <default> 💡 默认用 Etag（即 MD5）作为文件名
-            - FileID: int | str = 0
-            - Size: int = <default>
-            - Type: int = 0
-            - driveId: int | str = 0
-            - ...
+        :return: 接口响应
         """
         def gen_step():
-            nonlocal payload
-            update_headers_in_kwargs(request_kwargs, platform="android")
-            if not isinstance(payload, dict):
-                resp = yield self.fs_info(
-                    payload, 
+            resp = yield cls.login_qrcode_generate(
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+            check_response(resp)
+            uniID = resp["data"]["uniID"]
+            qrcode_url = f"{resp['data']['url']}?env=production&uniID={uniID}&source=123pan&type=login"
+            from qrcode import QRCode # type: ignore
+            qr = QRCode(border=1)
+            qr.add_data(qrcode_url)
+            qr.print_ascii(tty=isatty(1))
+            while True:
+                resp = yield cls.login_qrcode_result(
+                    uniID, 
                     base_url=base_url, 
                     async_=async_, 
                     **request_kwargs, 
                 )
-                resp["payload"] = payload
                 check_response(resp)
-                if not (info_list := resp["data"]["infoList"]):
-                    raise FileNotFoundError(ENOENT, resp)
-                payload = cast(dict, info_list[0])
-                if payload["Type"]:
-                    raise IsADirectoryError(EISDIR, resp)
-            payload = dict_to_lower_merge(
-                payload, {"driveId": 0, "Type": 0, "FileID": 0})
-            if "filename" not in payload:
-                payload["filename"] = payload["etag"]
-            return self.request(
-                "file/download_info", 
-                "POST", 
-                json=payload, 
-                base_url=base_url, 
-                async_=async_, 
-                **request_kwargs, 
-            )
+                if resp["code"] == 200:
+                    return resp
+                match resp["data"]["loginStatus"]:
+                    case 0:
+                        print("\r\033[1K[loginStatus=0] qrcode: waiting", end="")
+                    case 1:
+                        print("\r\033[1K[loginStatus=1] qrcode: scanned", end="")
+                    case 2:
+                        print("\r\033[1K[loginStatus=2] qrcode: cancelled", end="")
+                        raise P123LoginError(EAUTH, f"qrcode: cancelled with {resp!r}")
+                    case 3:
+                        print("\r\033[1K[loginStatus=3] qrcode: login", end="")
+                    case 4:
+                        print("\r\033[1K[loginStatus=4] qrcode: expired", end="")
+                        raise P123LoginError(EAUTH, f"qrcode: expired with {resp!r}")
+                    case _:
+                        raise P123LoginError(EAUTH, f"qrcode: aborted with {resp!r}")
         return run_gen_step(gen_step, async_)
 
+    ########## App API ##########
+
     @overload
-    def download_info_batch(
+    def app_config(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str = "OfflineDownload", 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4607,9 +4998,9 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def download_info_batch(
+    def app_config(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str = "OfflineDownload", 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4617,37 +5008,26 @@ class P123Client(P123OpenClient):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def download_info_batch(
+    def app_config(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str = "OfflineDownload", 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取批量下载信息
-
-        POST https://www.123pan.com/api/file/batch_download_info
+        """获取配置信息
 
-        .. warning::
-            会把一些文件或目录以 zip 包的形式下载，但非会员有流量限制，所以还是推荐用 `P123Client.download_info` 逐个获取下载链接并下载
+        POST https://www.123pan.com/api/config/get
 
         :payload:
-            - fileIdList: list[FileID]
-
-                .. code:: python
-
-                    FileID = {
-                        "FileId": int | str
-                    }
+            - business_key: str 💡 配置键名（字段）
         """
-        if isinstance(payload, (int, str)):
-            payload = {"fileIdList": [{"FileId": payload}]}
-        elif not isinstance(payload, dict):
-            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
+        if not isinstance(payload, dict):
+            payload = {"business_key": payload}
         return self.request(
-            "file/batch_download_info", 
+            "config/get", 
             "POST", 
             json=payload, 
             base_url=base_url, 
@@ -4656,65 +5036,533 @@ class P123Client(P123OpenClient):
         )
 
     @overload
-    def download_url(
-        self, 
-        payload: dict | int | str, 
-        /, 
+    @staticmethod
+    def app_dydomain(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
-    ) -> str:
+    ) -> dict:
         ...
     @overload
-    def download_url(
-        self, 
-        payload: dict | int | str, 
-        /, 
+    @staticmethod
+    def app_dydomain(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
-    ) -> Coroutine[Any, Any, str]:
+    ) -> Coroutine[Any, Any, dict]:
         ...
-    def download_url(
-        self, 
-        payload: dict | int | str, 
-        /, 
+    @staticmethod
+    def app_dydomain(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
-    ) -> str | Coroutine[Any, Any, str]:
-        """获取下载链接
-
-        .. note::
-            `payload` 支持多种格式的输入，按下面的规则按顺序进行判断：
-
-            1. 如果是 `int` 或 `str`，则视为文件 id，必须在你的网盘中存在此文件
-            2. 如果是 `dict`（不区分大小写），有 "S3KeyFlag", "Etag" 和 "Size" 的值，则直接获取链接，文件不必在你网盘中
-            3. 如果是 `dict`（不区分大小写），有 "Etag" 和 "Size" 的值，则会先秒传（临时文件路径为 /.tempfile）再获取链接，文件不必在你网盘中
-            4. 如果是 `dict`（不区分大小写），有 "FileID"，则会先获取信息，再获取链接，必须在你的网盘中存在此文件
-            5. 否则会报错 ValueError
-
-        :params payload: 文件 id 或者文件信息，文件信息必须包含的信息如下：
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取 123 网盘的各种域名
 
-            - FileID: int | str 💡 下载链接
-            - S3KeyFlag: str    💡 s3 存储名
-            - Etag: str         💡 文件的 MD5 散列值
-            - Size: int         💡 文件大小
-            - FileName: str     💡 默认用 Etag（即 MD5）作为文件名，可以省略
+        GET https://www.123pan.com/api/dydomain
+        """
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/dydomain", base_url), 
+            **request_kwargs, 
+        )
 
-        :params async_: 是否异步
-        :params request_kwargs: 其它请求参数
+    @overload
+    @staticmethod
+    def app_id_get(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def app_id_get(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def app_id_get(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取 app-id
 
-        :return: 下载链接
+        GET https://www.123pan.com/api/v3/3rd/app-id
         """
-        def gen_step():
-            nonlocal payload
-            if isinstance(payload, dict):
-                payload = dict_to_lower(payload)
-                if not ("size" in payload and "etag" in payload):
-                    if fileid := payload.get("fileid"):
-                        resp = yield self.fs_info(fileid, async_=async_, **request_kwargs)
-                        check_response(resp)
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/v3/3rd/app-id", base_url), 
+            **request_kwargs, 
+        )
+
+    @overload
+    @staticmethod
+    def app_server_time(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def app_server_time(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def app_server_time(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取 123 网盘的服务器时间戳
+
+        GET https://www.123pan.com/api/get/server/time
+        """
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/get/server/time", base_url), 
+            **request_kwargs, 
+        )
+
+    @overload
+    @staticmethod
+    def app_transfer_metrics(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    @staticmethod
+    def app_transfer_metrics(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    @staticmethod
+    def app_transfer_metrics(
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取和传输有关的配置信息
+
+        GET https://www.123pan.com/api/transfer/metrics/whether/report
+        """
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/transfer/metrics/whether/report", base_url), 
+            **request_kwargs, 
+        )
+
+    ########## Download API ##########
+
+    @overload
+    def dlink_disable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def dlink_disable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def dlink_disable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """禁用直链空间
+
+        POST https://www.123pan.com/api/cdn-link/disable
+
+        :payload:
+            - fileID: int | str 💡 目录 id
+        """
+        if not isinstance(payload, dict):
+            payload = {"fileID": payload}
+        return self.request(
+            "cdn-link/disable", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def dlink_enable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def dlink_enable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def dlink_enable(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """启用直链空间
+
+        POST https://www.123pan.com/api/cdn-link/enable
+
+        :payload:
+            - fileID: int | str 💡 目录 id
+        """
+        if not isinstance(payload, dict):
+            payload = {"fileID": payload}
+        return self.request(
+            "cdn-link/enable", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def dlink_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def dlink_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def dlink_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取直链链接
+
+        GET https://www.123pan.com/api/cdn-link/url
+
+        :payload:
+            - fileID: int | str 💡 文件 id
+        """
+        if not isinstance(payload, dict):
+            payload = {"fileID": payload}
+        return self.request(
+            "cdn-link/url", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    ########## Download API ##########
+
+    @overload
+    def download_info(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def download_info(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def download_info(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取下载信息
+
+        POST https://www.123pan.com/api/file/download_info
+
+        .. hint::
+            即使文件已经被删除，只要还有 S3KeyFlag 和 Etag （即 MD5） 就依然可以下载
+
+            你完全可以构造这样的查询参数
+
+            .. code:: python
+
+                payload = {
+                    "Etag": "...", # 必填，文件的 MD5
+                    "FileID": 0, # 可以随便填
+                    "FileName": "a", # 随便填一个名字
+                    "S3KeyFlag": str # 必填，格式为 f"{UID}-0"，UID 就是上传此文件的用户的 UID，如果此文件是由你上传的，则可从 `P123Client.user_info` 的响应中获取
+                    "Size": 0, # 可以随便填，填了可能搜索更准确
+                }
+
+        .. note::
+            获取的直链有效期是 24 小时
+
+        :payload:
+            - Etag: str 💡 文件的 MD5 散列值
+            - S3KeyFlag: str
+            - FileName: str = <default> 💡 默认用 Etag（即 MD5）作为文件名
+            - FileID: int | str = 0
+            - Size: int = <default>
+            - Type: int = 0
+            - driveId: int | str = 0
+            - ...
+        """
+        def gen_step():
+            nonlocal payload
+            update_headers_in_kwargs(request_kwargs, platform="android")
+            if not isinstance(payload, dict):
+                resp = yield self.fs_info(
+                    payload, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                resp["payload"] = payload
+                check_response(resp)
+                if not (info_list := resp["data"]["infoList"]):
+                    raise FileNotFoundError(ENOENT, resp)
+                payload = cast(dict, info_list[0])
+                if payload["Type"]:
+                    raise IsADirectoryError(EISDIR, resp)
+            payload = dict_to_lower_merge(
+                payload, {"driveId": 0, "Type": 0, "FileID": 0})
+            if "filename" not in payload:
+                payload["filename"] = payload["etag"]
+            return self.request(
+                "file/download_info", 
+                "POST", 
+                json=payload, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
+        return run_gen_step(gen_step, async_)
+
+    @overload
+    def download_info_batch(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def download_info_batch(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def download_info_batch(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取批量下载信息
+
+        POST https://www.123pan.com/api/file/batch_download_info
+
+        .. warning::
+            会把一些文件或目录以 zip 包的形式下载，但非会员有流量限制，所以还是推荐用 `P123Client.download_info` 逐个获取下载链接并下载
+
+        :payload:
+            - fileIdList: list[FileID]
+
+                .. code:: python
+
+                    FileID = {
+                        "FileId": int | str
+                    }
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileIdList": [{"FileId": payload}]}
+        elif not isinstance(payload, dict):
+            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
+        return self.request(
+            "file/batch_download_info", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def download_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> str:
+        ...
+    @overload
+    def download_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, str]:
+        ...
+    def download_url(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> str | Coroutine[Any, Any, str]:
+        """获取下载链接
+
+        .. note::
+            `payload` 支持多种格式的输入，按下面的规则按顺序进行判断：
+
+            1. 如果是 `int` 或 `str`，则视为文件 id，必须在你的网盘中存在此文件
+            2. 如果是 `dict`（不区分大小写），有 "S3KeyFlag", "Etag" 和 "Size" 的值，则直接获取链接，文件不必在你网盘中
+            3. 如果是 `dict`（不区分大小写），有 "Etag" 和 "Size" 的值，则会先秒传（临时文件路径为 /.tempfile）再获取链接，文件不必在你网盘中
+            4. 如果是 `dict`（不区分大小写），有 "FileID"，则会先获取信息，再获取链接，必须在你的网盘中存在此文件
+            5. 否则会报错 ValueError
+
+        :params payload: 文件 id 或者文件信息，文件信息必须包含的信息如下：
+
+            - FileID: int | str 💡 下载链接
+            - S3KeyFlag: str    💡 s3 存储名
+            - Etag: str         💡 文件的 MD5 散列值
+            - Size: int         💡 文件大小
+            - FileName: str     💡 默认用 Etag（即 MD5）作为文件名，可以省略
+
+        :params async_: 是否异步
+        :params request_kwargs: 其它请求参数
+
+        :return: 下载链接
+        """
+        def gen_step():
+            nonlocal payload
+            if isinstance(payload, dict):
+                payload = dict_to_lower(payload)
+                if not ("size" in payload and "etag" in payload):
+                    if fileid := payload.get("fileid"):
+                        resp = yield self.fs_info(fileid, async_=async_, **request_kwargs)
+                        check_response(resp)
                         if not (info_list := resp["data"]["infoList"]):
                             raise P123OSError(ENOENT, resp)
                         info = info_list[0]
@@ -4753,15 +5601,948 @@ class P123Client(P123OpenClient):
                     **request_kwargs, 
                 )
                 check_response(resp)
-                return resp["data"]["downloadUrl"]
+                return resp["data"]["downloadUrl"]
+        return run_gen_step(gen_step, async_)
+
+    ########## File System API ##########
+
+    @overload
+    def fs_abnormal_count(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_abnormal_count(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_abnormal_count(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取异常文件数
+
+        GET https://www.123pan.com/b/api/file/abnormal/count
+        """
+        return self.request(
+            "file/abnormal/count", 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_copy(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_copy(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_copy(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """复制
+
+        POST https://www.123pan.com/api/restful/goapi/v1/file/copy/async
+
+        :payload:
+            - fileList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
+
+                .. code:: python
+
+                    File = { 
+                        "FileId": int | str, 
+                        ...
+                    }
+
+            - targetFileId: int | str = 0
+        """
+        def gen_step():
+            nonlocal payload
+            if not isinstance(payload, dict):
+                resp = yield self.fs_info(
+                    payload, 
+                    base_url=base_url, 
+                    async_=async_, 
+                    **request_kwargs, 
+                )
+                resp["payload"] = payload
+                check_response(resp)
+                info_list = resp["data"]["infoList"]
+                if not info_list:
+                    raise FileNotFoundError(ENOENT, resp)
+                payload = {"fileList": info_list}
+            payload = dict_to_lower_merge(payload, targetFileId=parent_id)
+            return self.request(
+                "restful/goapi/v1/file/copy/async", 
+                "POST", 
+                json=payload, 
+                base_url=base_url, 
+                async_=async_, 
+                **request_kwargs, 
+            )
         return run_gen_step(gen_step, async_)
 
     @overload
-    def fs_copy(
+    def fs_detail(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_detail(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_detail(
+        self, 
+        payload: dict | int | str, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取文件或目录详情（文件数、目录数、总大小）
+
+        GET https://www.123pan.com/api/file/detail
+
+        :payload:
+            - fileID: int | str
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileID": payload}
+        return self.request(
+            "file/detail", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_delete(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_delete(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_delete(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """彻底删除
+
+        POST https://www.123pan.com/api/file/delete
+
+        .. hint::
+            彻底删除文件前,文件必须要在回收站中,否则无法删除
+
+        :payload:
+            - fileIdList: list[FileID]
+
+                .. code:: python
+
+                    FileID = {
+                        "FileId": int | str
+                    }
+
+            - event: str = "recycleDelete"
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileIdList": [{"FileId": payload}]}
+        elif not isinstance(payload, dict):
+            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
+        payload = cast(dict, payload)
+        payload.setdefault("event", "recycleDelete")
+        return self.request(
+            "file/delete", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_get_path(
+        self, 
+        payload: dict | int, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_get_path(
+        self, 
+        payload: dict | int, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_get_path(
+        self, 
+        payload: dict | int, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取某个 id 对应的祖先节点列表
+
+        POST https://www.123pan.com/api/file/get_path
+
+        :payload:
+            - fileId: int 💡 文件 id
+        """
+        if isinstance(payload, int):
+            payload = {"fileId": payload}
+        return self.request(
+            "file/get_path", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_info(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_info(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_info(
+        self, 
+        payload: dict | int | str | Iterable[int | str] = 0, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取文件信息
+
+        POST https://www.123pan.com/api/file/info
+
+        :payload:
+            - fileIdList: list[FileID]
+
+                .. code:: python
+
+                    FileID = {
+                        "FileId": int | str
+                    }
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileIdList": [{"FileId": payload}]}
+        elif not isinstance(payload, dict):
+            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
+        return self.request(
+            "file/info", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload # type: ignore
+    def fs_list(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_list(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_list(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取文件列表（可搜索）
+
+        GET https://www.123pan.com/api/file/list
+
+        .. note::
+            如果返回信息中，"Next" 字段的值为 "-1"，代表最后一页（无需再翻页查询）
+
+        :payload:
+            - driveId: int | str = 0
+            - limit: int = 100 💡 分页大小，最多 100 个
+            - next: int = 0    💡 下一批拉取开始的 id
+            - orderBy: str = "file_name" 💡 排序依据
+
+                - "file_id": 文件 id，也可以写作 "fileId"
+                - "file_name": 文件名
+                - "size":  文件大小
+                - "create_at": 创建时间
+                - "update_at": 更新时间
+                - "share_id": 分享 id
+                - ...
+
+            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
+            - Page: int = <default> 💡 第几页，从 1 开始，可以是 0
+            - parentFileId: int | str = 0 💡 父目录 id
+            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
+            - inDirectSpace: "false" | "true" = "false"
+            - event: str = "homeListFile" 💡 事件名称
+
+                - "homeListFile": 全部文件
+                - "recycleListFile": 回收站
+                - "syncFileList": 同步空间
+
+            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
+            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - OnlyLookAbnormalFile: int = <default>
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"parentFileId": payload}
+        payload = dict_to_lower_merge(payload, {
+            "driveId": 0, 
+            "limit": 100, 
+            "next": 0, 
+            "orderBy": "file_name", 
+            "orderDirection": "asc", 
+            "parentFileId": 0, 
+            "inDirectSpace": "false", 
+            "event": event, 
+        })
+        if not payload.get("trashed"):
+            match payload["event"]:
+                case "recycleListFile":
+                    payload["trashed"] = "true"
+                case _:
+                    payload["trashed"] = "false"
+        return self.request(
+            "file/list", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_list_by_type(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_list_by_type(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_list_by_type(
+        self, 
+        payload: dict | int = 1, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """按类型获取文件列表
+
+        GET https://www.123pan.com/api/restful/goapi/v1/file/category/list-by-type
+
+        :payload:
+            - driveId: int | str = 0
+            - limit: int = 100  💡 分页大小，最多 100 个
+            - next: int = 0     💡 下一批拉取开始的 id
+            - category: int = 1 💡 分类代码
+
+                - 1: 音频
+                - 2: 视频
+                - 3: 图片
+                - 4: 音频
+                - 5: 其它
+
+            - dateGranularity: int = <default> 💡 按时间分组展示
+
+                - 1: 日
+                - 2: 月
+                - 3: 年
+    
+            - orderBy: str = "file_name" 💡 排序依据
+
+                - "file_id": 文件 id，也可以写作 "fileId"
+                - "file_name":   文件名
+                - "size":        文件大小
+                - "create_at":   创建时间
+                - "update_at":   更新时间
+                - "trashed_at":  删除时间
+                - "share_id":    分享 id
+                - "remain_days": 剩余保留天数
+                - ...
+
+            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
+            - Page: int = 1 💡 第几页，从 1 开始
+            - parentFileId: int | str = 0 💡 父目录 id
+            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
+            - inDirectSpace: "false" | "true" = "false"
+            - event: str = "homeListFile" 💡 事件名称
+
+                - "homeListFile": 全部文件
+                - "recycleListFile": 回收站
+                - "syncFileList": 同步空间
+
+            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
+
+                .. note::
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+
+            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
+        """
+        if not isinstance(payload, dict):
+            payload = {"Page": payload}
+        payload = dict_to_lower_merge(payload, {
+            "driveId": 0, 
+            "limit": 100, 
+            "next": 0, 
+            "category": 1, 
+            "orderBy": "file_name", 
+            "orderDirection": "asc", 
+            "parentFileId": 0, 
+            "inDirectSpace": "false", 
+            "event": event, 
+            "OnlyLookAbnormalFile": 0, 
+            "Page": 1, 
+        })
+        if not payload.get("trashed"):
+            match payload["event"]:
+                case "recycleListFile":
+                    payload["trashed"] = "true"
+                case _:
+                    payload["trashed"] = "false"
+        return self.request(
+            "restful/goapi/v1/file/category/list-by-type", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_list_new(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_list_new(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_list_new(
+        self, 
+        payload: dict | int | str = 0, 
+        /, 
+        event: str = "homeListFile", 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取文件列表（可搜索）
+
+        GET https://www.123pan.com/api/file/list/new
+
+        .. note::
+            如果返回信息中，"Next" 字段的值为 "-1"，代表最后一页（无需再翻页查询）
+
+        :payload:
+            - driveId: int | str = 0
+            - limit: int = 100 💡 分页大小，最多 100 个
+            - next: int = 0    💡 下一批拉取开始的 id
+            - orderBy: str = "file_name" 💡 排序依据
+
+                - "file_id": 文件 id，也可以写作 "fileId"
+                - "file_name":   文件名
+                - "size":        文件大小
+                - "create_at":   创建时间
+                - "update_at":   更新时间
+                - "trashed_at":  删除时间
+                - "share_id":    分享 id
+                - "remain_days": 剩余保留天数
+                - ...
+
+            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
+            - Page: int = 1 💡 第几页，从 1 开始
+            - parentFileId: int | str = 0 💡 父目录 id
+            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
+            - inDirectSpace: "false" | "true" = "false"
+            - event: str = "homeListFile" 💡 事件名称
+
+                - "homeListFile": 全部文件
+                - "recycleListFile": 回收站
+                - "syncFileList": 同步空间
+
+            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
+
+                .. note::
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+
+            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
+            - RequestSource: int = <default> 💡 浏览器中，在同步空间中为 1
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"parentFileId": payload}
+        payload = dict_to_lower_merge(payload, {
+            "driveId": 0, 
+            "limit": 100, 
+            "next": 0, 
+            "orderBy": "file_name", 
+            "orderDirection": "asc", 
+            "parentFileId": 0, 
+            "inDirectSpace": "false", 
+            "event": event, 
+            "OnlyLookAbnormalFile": 0, 
+            "Page": 1, 
+        })
+        if not payload.get("trashed"):
+            match payload["event"]:
+                case "recycleListFile":
+                    payload["trashed"] = "true"
+                case _:
+                    payload["trashed"] = "false"
+        return self.request(
+            "file/list/new", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload # type: ignore
+    def fs_mkdir(
+        self, 
+        name: str, 
+        /, 
+        parent_id: int | str = 0, 
+        duplicate: Literal[0, 1, 2] = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_mkdir(
+        self, 
+        name: str, 
+        /, 
+        parent_id: int | str = 0, 
+        duplicate: Literal[0, 1, 2] = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_mkdir(
+        self, 
+        name: str, 
+        /, 
+        parent_id: int | str = 0, 
+        duplicate: Literal[0, 1, 2] = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """创建目录
+
+        :param name: 目录名
+        :param parent_id: 父目录 id
+        :param duplicate: 处理同名：0: 复用 1: 保留两者 2: 替换
+        :param async_: 是否异步
+        :param request_kwargs: 其它请求参数
+
+        :return: 接口响应
+        """
+        payload = {"filename": name, "parentFileId": parent_id}
+        if duplicate:
+            payload["NotReuse"] = True
+            payload["duplicate"] = duplicate
+        return self.upload_request(
+            payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_move(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_move(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_move(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        parent_id: int | str = 0, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """移动
+
+        POST https://www.123pan.com/api/file/mod_pid
+
+        :payload:
+            - fileIdList: list[FileID]
+
+                .. code:: python
+
+                    FileID = {
+                        "FileId": int | str
+                    }
+
+            - parentFileId: int | str = 0
+            - event: str = "fileMove"
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileIdList": [{"FileId": payload}]}
+        elif not isinstance(payload, dict):
+            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
+        payload = dict_to_lower_merge(payload, {"parentFileId": parent_id, "event": "fileMove"})
+        return self.request(
+            "file/mod_pid", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_refresh(
+        self, 
+        payload: dict = {}, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_refresh(
+        self, 
+        payload: dict = {}, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_refresh(
+        self, 
+        payload: dict = {}, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """刷新列表和直链缓存
+
+        POST https://www.123pan.com/api/restful/goapi/v1/cdnLink/cache/refresh
+        """
+        return self.request(
+            "restful/goapi/v1/cdnLink/cache/refresh", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload # type: ignore
+    def fs_rename(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_rename(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_rename(
+        self, 
+        payload: dict, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """（单个）改名
+
+        POST https://www.123pan.com/api/file/rename
+
+        :payload:
+            - FileId: int | str
+            - fileName: str
+            - driveId: int | str = 0
+            - duplicate: 0 | 1 | 2 = 0 💡 处理同名：0: 提示/忽略 1: 保留两者 2: 替换
+            - event: str = "fileRename"
+        """
+        payload = dict_to_lower_merge(payload, {
+            "driveId": 0, 
+            "duplicate": 0, 
+            "event": "fileRename", 
+        })
+        return self.request(
+            "file/rename", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_star(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        star: bool = True, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def fs_star(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        star: bool = True, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def fs_star(
+        self, 
+        payload: dict | int | str | Iterable[int | str], 
+        /, 
+        star: bool = True, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """给文件或目录，设置或取消星标
+
+        POST https://www.123pan.com/api/restful/goapi/v1/file/starred
+
+        :payload:
+            - fileIdList: list[int | str] 💡 id 列表
+            - starredStatus: int = 255    💡 是否设置星标：1:取消 255:设置
+        """
+        if isinstance(payload, (int, str)):
+            payload = {"fileIdList": [payload], "starredStatus": 255}
+        elif not isinstance(payload, dict):
+            if not isinstance(payload, (tuple, list)):
+                payload = list(payload)
+            payload = {"fileIdList": payload, "starredStatus": 255}
+        else:
+            payload.setdefault("starredStatus", 255 if star else 1)
+        return self.request(
+            "restful/goapi/v1/file/starred", 
+            "POST", 
+            json=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
+
+    @overload
+    def fs_star_list(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | int = 1, 
         /, 
-        parent_id: int | str = 0, 
+        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -4769,73 +6550,98 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_copy(
+    def fs_star_list(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | int = 1, 
         /, 
-        parent_id: int | str = 0, 
+        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_copy(
+    def fs_star_list(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | int = 1, 
         /, 
-        parent_id: int | str = 0, 
+        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """复制
+        """罗列已星标的文件或目录
 
-        POST https://www.123pan.com/api/restful/goapi/v1/file/copy/async
+        GET https://www.123pan.com/api/restful/goapi/v1/file/starred/list
 
         :payload:
-            - fileList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
+            - driveId: int | str = 0
+            - next: int = 0    💡 下一批拉取开始的 id
+            - orderBy: str = "file_name" 💡 排序依据
 
-                .. code:: python
+                - "file_id": 文件 id，也可以写作 "fileId"
+                - "file_name":   文件名
+                - "size":        文件大小
+                - "create_at":   创建时间
+                - "update_at":   更新时间
+                - "trashed_at":  删除时间
+                - "share_id":    分享 id
+                - "remain_days": 剩余保留天数
+                - ...
 
-                    File = { 
-                        "FileId": int | str, 
-                        ...
-                    }
+            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
+            - Page: int = 1 💡 第几页，从 1 开始
+            - pageSize: int = 100 💡 分页大小，最多 100 个
+            - parentFileId: int | str = 0 💡 父目录 id
+            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
+            - inDirectSpace: "false" | "true" = "false"
+            - event: str = "homeListFile" 💡 事件名称
 
-            - targetFileId: int | str = 0
+                - "homeListFile": 全部文件
+                - "recycleListFile": 回收站
+                - "syncFileList": 同步空间
+
+            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
+
+                .. note::
+                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
+
+            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
+            - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
         """
-        def gen_step():
-            nonlocal payload
-            if not isinstance(payload, dict):
-                resp = yield self.fs_info(
-                    payload, 
-                    base_url=base_url, 
-                    async_=async_, 
-                    **request_kwargs, 
-                )
-                resp["payload"] = payload
-                check_response(resp)
-                info_list = resp["data"]["infoList"]
-                if not info_list:
-                    raise FileNotFoundError(ENOENT, resp)
-                payload = {"fileList": info_list}
-            payload = dict_to_lower_merge(payload, targetFileId=parent_id)
-            return self.request(
-                "restful/goapi/v1/file/copy/async", 
-                "POST", 
-                json=payload, 
-                base_url=base_url, 
-                async_=async_, 
-                **request_kwargs, 
-            )
-        return run_gen_step(gen_step, async_)
+        if not isinstance(payload, dict):
+            payload = {"Page": payload}
+        payload = dict_to_lower_merge(payload, {
+            "driveId": 0, 
+            "next": 0, 
+            "orderBy": "file_name", 
+            "orderDirection": "asc", 
+            "Page": 1, 
+            "pageSize": 100, 
+            "parentFileId": 0, 
+            "inDirectSpace": "false", 
+            "event": event, 
+            "OnlyLookAbnormalFile": 0, 
+        })
+        if not payload.get("trashed"):
+            match payload["event"]:
+                case "recycleListFile":
+                    payload["trashed"] = "true"
+                case _:
+                    payload["trashed"] = "false"
+        return self.request(
+            "restful/goapi/v1/file/starred/list", 
+            params=payload, 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
 
     @overload
-    def fs_detail(
+    def fs_sync_log(
         self, 
-        payload: dict | int | str, 
+        payload: dict | int = 1, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4844,9 +6650,9 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_detail(
+    def fs_sync_log(
         self, 
-        payload: dict | int | str, 
+        payload: dict | int = 1, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4854,37 +6660,40 @@ class P123Client(P123OpenClient):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_detail(
+    def fs_sync_log(
         self, 
-        payload: dict | int | str, 
+        payload: dict | int = 1, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取文件或目录详情（文件数、目录数、总大小）
+        """获取同步空间的操作记录
 
-        GET https://www.123pan.com/api/file/detail
+        GET https://www.123pan.com/api/restful/goapi/v1/sync-disk/file/log
 
         :payload:
-            - fileID: int | str
+            - page: int = 1               💡 第几页
+            - pageSize: int = 100         💡 每页大小
+            - searchData: str = <default> 💡 搜索关键字
         """
-        if isinstance(payload, (int, str)):
-            payload = {"fileID": payload}
+        if not isinstance(payload, dict):
+            payload = {"page": payload, "pageSize": 100}
         return self.request(
-            "file/detail", 
+            "restful/goapi/v1/sync-disk/file/log", 
             params=payload, 
             base_url=base_url, 
             async_=async_, 
             **request_kwargs, 
         )
 
-    @overload
-    def fs_delete(
+    @overload # type: ignore
+    def fs_trash(
         self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
+        payload: dict | int | str | Iterable[int | str], 
         /, 
+        event: str = "intoRecycle", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -4892,51 +6701,64 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_delete(
+    def fs_trash(
         self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
+        payload: dict | int | str | Iterable[int | str], 
         /, 
+        event: str = "intoRecycle", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_delete(
+    def fs_trash(
         self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
+        payload: dict | int | str | Iterable[int | str], 
         /, 
+        event: str = "intoRecycle", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """彻底删除
-
-        POST https://www.123pan.com/api/file/delete
+        """操作回收站
 
-        .. hint::
-            彻底删除文件前,文件必须要在回收站中,否则无法删除
+        POST https://www.123pan.com/api/file/trash
 
         :payload:
-            - fileIdList: list[FileID]
+            - fileTrashInfoList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
 
                 .. code:: python
 
-                    FileID = {
-                        "FileId": int | str
+                    File = { 
+                        "FileId": int | str, 
+                        ...
                     }
 
-            - event: str = "recycleDelete"
+            - driveId: int = 0
+            - event: str = "intoRecycle" 💡 事件类型
+
+                - "intoRecycle": 移入回收站
+                - "recycleRestore": 移出回收站
+
+            - operation: bool = <default>
+            - operatePlace: int = <default>
+            - RequestSource: int = <default> 💡 浏览器中，在同步空间中为 1
         """
         if isinstance(payload, (int, str)):
-            payload = {"fileIdList": [{"FileId": payload}]}
+            payload = {"fileTrashInfoList": [{"FileId": payload}]}
         elif not isinstance(payload, dict):
-            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
-        payload = cast(dict, payload)
-        payload.setdefault("event", "recycleDelete")
+            payload = {"fileTrashInfoList": [{"FileId": fid} for fid in payload]}
+        payload = dict_to_lower_merge(payload, {"driveId": 0, "event": event})
+        if payload.get("operation") is None:
+            match payload["event"]:
+                case "recycleRestore":
+                    payload["operation"] = False
+                case _:
+                    payload["operation"] = True
         return self.request(
-            "file/delete", 
+            "file/trash", 
             "POST", 
             json=payload, 
             base_url=base_url, 
@@ -4945,9 +6767,9 @@ class P123Client(P123OpenClient):
         )
 
     @overload
-    def fs_get_path(
+    def fs_trash_clear(
         self, 
-        payload: dict | int, 
+        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4956,9 +6778,9 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_get_path(
+    def fs_trash_clear(
         self, 
-        payload: dict | int, 
+        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -4966,26 +6788,25 @@ class P123Client(P123OpenClient):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_get_path(
+    def fs_trash_clear(
         self, 
-        payload: dict | int, 
+        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取某个 id 对应的祖先节点列表
+        """清空回收站
 
-        POST https://www.123pan.com/api/file/get_path
+        POST https://www.123pan.com/api/file/trash_delete_all
 
         :payload:
-            - fileId: int 💡 文件 id
+            - event: str = "recycleClear"
         """
-        if isinstance(payload, int):
-            payload = {"fileId": payload}
+        payload.setdefault("event", "recycleClear")
         return self.request(
-            "file/get_path", 
+            "file/trash_delete_all", 
             "POST", 
             json=payload, 
             base_url=base_url, 
@@ -4994,68 +6815,51 @@ class P123Client(P123OpenClient):
         )
 
     @overload
-    def fs_info(
-        self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
-        /, 
+    @staticmethod
+    def fs_video_play_conf(
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_info(
-        self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
-        /, 
+    @staticmethod
+    def fs_video_play_conf(
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_info(
-        self, 
-        payload: dict | int | str | Iterable[int | str] = 0, 
-        /, 
+    @staticmethod
+    def fs_video_play_conf(
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        request: None | Callable = None, 
         *, 
-        async_: Literal[False, True] = False, 
-        **request_kwargs, 
-    ) -> dict | Coroutine[Any, Any, dict]:
-        """获取文件信息
-
-        POST https://www.123pan.com/api/file/info
-
-        :payload:
-            - fileIdList: list[FileID]
-
-                .. code:: python
-
-                    FileID = {
-                        "FileId": int | str
-                    }
-        """
-        if isinstance(payload, (int, str)):
-            payload = {"fileIdList": [{"FileId": payload}]}
-        elif not isinstance(payload, dict):
-            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
-        return self.request(
-            "file/info", 
-            "POST", 
-            json=payload, 
-            base_url=base_url, 
-            async_=async_, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """获取视频播放列表的配置信息
+
+        GET https://www.123pan.com/api/video/play/conf
+        """
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("/api/get/server/time", base_url), 
             **request_kwargs, 
         )
 
-    @overload # type: ignore
-    def fs_list(
+    @overload
+    def fs_video_play_list(
         self, 
         payload: dict | int | str = 0, 
         /, 
-        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -5063,95 +6867,54 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_list(
+    def fs_video_play_list(
         self, 
         payload: dict | int | str = 0, 
         /, 
-        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_list(
+    def fs_video_play_list(
         self, 
         payload: dict | int | str = 0, 
         /, 
-        event: str = "homeListFile", 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取文件列表（可搜索）
-
-        GET https://www.123pan.com/api/file/list
+        """获取某个目录下的视频列表
 
-        .. note::
-            如果返回信息中，"Next" 字段的值为 "-1"，代表最后一页（无需再翻页查询）
+        GET https://www.123pan.com/api/file/video/play/list
 
         :payload:
-            - driveId: int | str = 0
-            - limit: int = 100 💡 分页大小，最多 100 个
-            - next: int = 0    💡 下一批拉取开始的 id
-            - orderBy: str = "file_id" 💡 排序依据
-
-                - "file_id": 文件 id，也可以写作 "fileId"
-                - "file_name": 文件名
-                - "size":  文件大小
-                - "create_at": 创建时间
-                - "update_at": 更新时间
-                - "share_id": 分享 id
-                - ...
-
-            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
-            - Page: int = <default> 💡 第几页，从 1 开始，可以是 0
-            - parentFileId: int | str = 0 💡 父目录 id
-            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
-            - inDirectSpace: "false" | "true" = "false"
-            - event: str = "homeListFile" 💡 事件名称
-
-                - "homeListFile": 全部文件
-                - "recycleListFile": 回收站
-                - "syncFileList": 同步空间
-
-            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
-            - OnlyLookAbnormalFile: int = <default>
+            - page: int = 1
+            - page_size: int = 100
+            - parent_file_id: int = 0
         """
-        if isinstance(payload, (int, str)):
-            payload = {"parentFileId": payload}
-        payload = dict_to_lower_merge(payload, {
-            "driveId": 0, 
-            "limit": 100, 
-            "next": 0, 
-            "orderBy": "file_id", 
-            "orderDirection": "asc", 
-            "parentFileId": 0, 
-            "inDirectSpace": "false", 
-            "event": event, 
-        })
-        if not payload.get("trashed"):
-            match payload["event"]:
-                case "recycleListFile":
-                    payload["trashed"] = "true"
-                case _:
-                    payload["trashed"] = "false"
+        if not isinstance(payload, dict):
+            payload = {"parent_file_id": payload}
+        payload.setdefault("page", 1)
+        payload.setdefault("page_size", 100)
         return self.request(
-            "file/list", 
+            "file/video/play/list", 
             params=payload, 
             base_url=base_url, 
             async_=async_, 
             **request_kwargs, 
         )
 
+    ########## Qrcode API ##########
+
     @overload
-    def fs_list_new(
-        self, 
-        payload: dict | int | str = 0, 
+    @staticmethod
+    def login_passport(
+        payload: dict, 
         /, 
-        event: str = "homeListFile", 
+        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -5159,211 +6922,141 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_list_new(
-        self, 
-        payload: dict | int | str = 0, 
+    @staticmethod
+    def login_passport(
+        payload: dict, 
         /, 
-        event: str = "homeListFile", 
+        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_list_new(
-        self, 
-        payload: dict | int | str = 0, 
+    @staticmethod
+    def login_passport(
+        payload: dict, 
         /, 
-        event: str = "homeListFile", 
+        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取文件列表（可搜索）
+        """使用账号和密码登录
 
-        GET https://www.123pan.com/api/file/list/new
+        POST https://www.123pan.com/api/user/sign_in
 
         .. note::
-            如果返回信息中，"Next" 字段的值为 "-1"，代表最后一页（无需再翻页查询）
+            获取的 token 有效期 30 天
 
         :payload:
-            - driveId: int | str = 0
-            - limit: int = 100 💡 分页大小，最多 100 个
-            - next: int = 0    💡 下一批拉取开始的 id
-            - orderBy: str = "file_id" 💡 排序依据
-
-                - "file_id": 文件 id，也可以写作 "fileId"
-                - "file_name": 文件名
-                - "size":  文件大小
-                - "create_at": 创建时间
-                - "update_at": 更新时间
-                - "share_id": 分享 id
-                - ...
-
-            - orderDirection: "asc" | "desc" = "asc" 💡 排序顺序
-            - Page: int = 1 💡 第几页，从 1 开始
-            - parentFileId: int | str = 0 💡 父目录 id
-            - trashed: "false" | "true" = <default> 💡 是否查看回收站的文件
-            - inDirectSpace: "false" | "true" = "false"
-            - event: str = "homeListFile" 💡 事件名称
-
-                - "homeListFile": 全部文件
-                - "recycleListFile": 回收站
-                - "syncFileList": 同步空间
-
-            - operateType: int | str = <default> 💡 操作类型，如果在同步空间，则需要指定为 "SyncSpacePage"
-
-                .. note::
-                    这个值似乎不影响结果，所以可以忽略。我在浏览器中，看到罗列根目录为 1，搜索（指定 `SearchData`）为 2，同步空间的根目录为 3，罗列其它目录大多为 4，偶尔为 8，也可能是其它值
-
-            - SearchData: str = <default> 💡 搜索关键字（将无视 `parentFileId` 参数）
-            - OnlyLookAbnormalFile: int = 0 💡 大概可传入 0 或 1
-            - RequestSource: int = <default> 💡 浏览器中，在同步空间中为 1
+            - passport: int | str   💡 手机号或邮箱
+            - password: str         💡 密码
+            - remember: bool = True 💡 是否记住密码（不用管）
         """
-        if isinstance(payload, (int, str)):
-            payload = {"parentFileId": payload}
-        payload = dict_to_lower_merge(payload, {
-            "driveId": 0, 
-            "limit": 100, 
-            "next": 0, 
-            "orderBy": "file_id", 
-            "orderDirection": "asc", 
-            "parentFileId": 0, 
-            "inDirectSpace": "false", 
-            "event": event, 
-            "OnlyLookAbnormalFile": 0, 
-            "Page": 1, 
-        })
-        if not payload.get("trashed"):
-            match payload["event"]:
-                case "recycleListFile":
-                    payload["trashed"] = "true"
-                case _:
-                    payload["trashed"] = "false"
-        return self.request(
-            "file/list/new", 
-            params=payload, 
-            base_url=base_url, 
-            async_=async_, 
-            **request_kwargs, 
-        )
+        api = complete_url("user/sign_in", base_url)
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(url=api, method="POST", json=payload, **request_kwargs)
 
-    @overload # type: ignore
-    def fs_mkdir(
-        self, 
-        name: str, 
+    @overload
+    @staticmethod
+    def login_qrcode_bind_wx_code(
+        payload: dict, 
         /, 
-        parent_id: int | str = 0, 
-        duplicate: Literal[0, 1, 2] = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_mkdir(
-        self, 
-        name: str, 
+    @staticmethod
+    def login_qrcode_bind_wx_code(
+        payload: dict, 
         /, 
-        parent_id: int | str = 0, 
-        duplicate: Literal[0, 1, 2] = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_mkdir(
-        self, 
-        name: str, 
+    @staticmethod
+    def login_qrcode_bind_wx_code(
+        payload: dict, 
         /, 
-        parent_id: int | str = 0, 
-        duplicate: Literal[0, 1, 2] = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """创建目录
+        """绑定微信号
 
-        :param name: 目录名
-        :param parent_id: 父目录 id
-        :param duplicate: 处理同名：0: 复用 1: 保留两者 2: 替换
-        :param async_: 是否异步
-        :param request_kwargs: 其它请求参数
+        POST https://login.123pan.com/api/user/qr-code/bind_wx_code
 
-        :return: 接口响应
+        :payload:
+            - uniID: str  💡 二维码 id
+            - wxcode: str 💡 微信码
         """
-        payload = {"filename": name, "parentFileId": parent_id}
-        if duplicate:
-            payload["NotReuse"] = True
-            payload["duplicate"] = duplicate
-        return self.upload_request(
-            payload, 
-            base_url=base_url, 
-            async_=async_, 
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("user/qr-code/bind_wx_code", base_url), 
+            method="POST", 
+            json=payload, 
             **request_kwargs, 
         )
 
     @overload
-    def fs_move(
+    def login_qrcode_confirm(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str, 
         /, 
-        parent_id: int | str = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_move(
+    def login_qrcode_confirm(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str, 
         /, 
-        parent_id: int | str = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_move(
+    def login_qrcode_confirm(
         self, 
-        payload: dict | int | str | Iterable[int | str], 
+        payload: dict | str, 
         /, 
-        parent_id: int | str = 0, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """移动
+        """确认扫码登录
 
-        POST https://www.123pan.com/api/file/mod_pid
+        POST https://login.123pan.com/api/user/qr-code/login
 
         :payload:
-            - fileIdList: list[FileID]
-
-                .. code:: python
-
-                    FileID = {
-                        "FileId": int | str
-                    }
-
-            - parentFileId: int | str = 0
-            - event: str = "fileMove"
+            - uniID: str 💡 二维码 id
         """
-        if isinstance(payload, (int, str)):
-            payload = {"fileIdList": [{"FileId": payload}]}
-        elif not isinstance(payload, dict):
-            payload = {"fileIdList": [{"FileId": fid} for fid in payload]}
-        payload = dict_to_lower_merge(payload, {"parentFileId": parent_id, "event": "fileMove"})
+        if not isinstance(payload, dict):
+            payload = {"uniID": payload}
         return self.request(
-            "file/mod_pid", 
+            "user/qr-code/login", 
             "POST", 
             json=payload, 
             base_url=base_url, 
@@ -5372,237 +7065,221 @@ class P123Client(P123OpenClient):
         )
 
     @overload
-    def fs_fresh(
-        self, 
-        payload: dict = {}, 
+    @staticmethod
+    def login_qrcode_deny(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_fresh(
-        self, 
-        payload: dict = {}, 
+    @staticmethod
+    def login_qrcode_deny(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_fresh(
-        self, 
-        payload: dict = {}, 
+    @staticmethod
+    def login_qrcode_deny(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """刷新列表和直链缓存
+        """更新扫码状态为：已取消（loginStatus=2）
 
-        POST https://www.123pan.com/api/restful/goapi/v1/cdnLink/cache/refresh
+        POST https://login.123pan.com/api/user/qr-code/deny
+
+        :payload:
+            - uniID: str 💡 二维码 id
         """
-        return self.request(
-            "restful/goapi/v1/cdnLink/cache/refresh", 
-            "POST", 
+        if not isinstance(payload, dict):
+            payload = {"uniID": payload}
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("user/qr-code/deny", base_url), 
+            method="POST", 
             json=payload, 
-            base_url=base_url, 
-            async_=async_, 
             **request_kwargs, 
         )
 
-    @overload # type: ignore
-    def fs_rename(
-        self, 
-        payload: dict, 
-        /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+    @overload
+    @staticmethod
+    def login_qrcode_generate(
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_rename(
-        self, 
-        payload: dict, 
-        /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+    @staticmethod
+    def login_qrcode_generate(
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_rename(
-        self, 
-        payload: dict, 
-        /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+    @staticmethod
+    def login_qrcode_generate(
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """（单个）改名
-
-        POST https://www.123pan.com/api/file/rename
+        """产生二维码
 
-        :payload:
-            - FileId: int | str
-            - fileName: str
-            - driveId: int | str = 0
-            - duplicate: 0 | 1 | 2 = 0 💡 处理同名：0: 提示/忽略 1: 保留两者 2: 替换
-            - event: str = "fileRename"
+        GET https://login.123pan.com/api/user/qr-code/generate
         """
-        payload = dict_to_lower_merge(payload, {
-            "driveId": 0, 
-            "duplicate": 0, 
-            "event": "fileRename", 
-        })
-        return self.request(
-            "file/rename", 
-            "POST", 
-            json=payload, 
-            base_url=base_url, 
-            async_=async_, 
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("user/qr-code/generate", base_url), 
             **request_kwargs, 
         )
 
     @overload
-    def fs_sync_log(
-        self, 
-        payload: dict | int = 1, 
+    @staticmethod
+    def login_qrcode_result(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_sync_log(
-        self, 
-        payload: dict | int = 1, 
+    @staticmethod
+    def login_qrcode_result(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_sync_log(
-        self, 
-        payload: dict | int = 1, 
+    @staticmethod
+    def login_qrcode_result(
+        payload: dict | str, 
         /, 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """获取同步空间的操作记录
+        """获取扫码结果
 
-        GET https://www.123pan.com/api/restful/goapi/v1/sync-disk/file/log
+        GET https://login.123pan.com/api/user/qr-code/result
+
+        .. note::
+            返回值中有个 "loginStatus" 字段，值为数字，分别表示的意思为：
+
+            - 0: 等待扫码
+            - 1: 已扫码
+            - 2: 已取消
+            - 3: 已登录
+            - 4: 已失效
 
         :payload:
-            - page: int = 1               💡 第几页
-            - pageSize: int = 100         💡 每页大小
-            - searchData: str = <default> 💡 搜索关键字
+            - uniID: str 💡 二维码 id
         """
         if not isinstance(payload, dict):
-            payload = {"page": payload, "pageSize": 100}
-        return self.request(
-            "restful/goapi/v1/sync-disk/file/log", 
+            payload = {"uniID": payload}
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("user/qr-code/result", base_url), 
             params=payload, 
-            base_url=base_url, 
-            async_=async_, 
             **request_kwargs, 
         )
 
-    @overload # type: ignore
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @overload
+    @staticmethod
+    def login_qrcode_scan(
+        payload: dict | str, 
         /, 
-        event: str = "intoRecycle", 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False] = False, 
         **request_kwargs, 
     ) -> dict:
         ...
     @overload
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @staticmethod
+    def login_qrcode_scan(
+        payload: dict | str, 
         /, 
-        event: str = "intoRecycle", 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_trash(
-        self, 
-        payload: dict | int | str | Iterable[int | str], 
+    @staticmethod
+    def login_qrcode_scan(
+        payload: dict | str, 
         /, 
-        event: str = "intoRecycle", 
-        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        base_url: str | Callable[[], str] = DEFAULT_LOGIN_BASE_URL, 
+        request: None | Callable = None, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """操作回收站
+        """更新扫码状态为：已扫码（loginStatus=1）
 
-        POST https://www.123pan.com/api/file/trash
+        POST https://login.123pan.com/api/user/qr-code/scan
 
         :payload:
-            - fileTrashInfoList: list[File] 💡 信息可以取自 `P123Client.fs_info` 接口
-
-                .. code:: python
-
-                    File = { 
-                        "FileId": int | str, 
-                        ...
-                    }
-
-            - driveId: int = 0
-            - event: str = "intoRecycle" 💡 事件类型
-
-                - "intoRecycle": 移入回收站
-                - "recycleRestore": 移出回收站
-
-            - operation: bool = <default>
-            - operatePlace: int = <default>
-            - RequestSource: int = <default>
+            - uniID: str 💡 二维码 id
+            - scanPlatform: int = 4 💡 扫码的平台代码，微信是 4
         """
-        if isinstance(payload, (int, str)):
-            payload = {"fileTrashInfoList": [{"FileId": payload}]}
-        elif not isinstance(payload, dict):
-            payload = {"fileTrashInfoList": [{"FileId": fid} for fid in payload]}
-        payload = dict_to_lower_merge(payload, {"driveId": 0, "event": event})
-        if payload.get("operation") is None:
-            match payload["event"]:
-                case "recycleRestore":
-                    payload["operation"] = False
-                case _:
-                    payload["operation"] = True
-        return self.request(
-            "file/trash", 
-            "POST", 
+        if not isinstance(payload, dict):
+            payload = {"uniID": payload}
+        payload.setdefault("scanPlatform", 4)
+        request_kwargs.setdefault("parse", default_parse)
+        if request is None:
+            request = get_default_request()
+            request_kwargs["async_"] = async_
+        return request(
+            url=complete_url("user/qr-code/scan", base_url), 
+            method="POST", 
             json=payload, 
-            base_url=base_url, 
-            async_=async_, 
             **request_kwargs, 
         )
 
     @overload
-    def fs_trash_clear(
+    def logout(
         self, 
-        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -5611,9 +7288,8 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    def fs_trash_clear(
+    def logout(
         self, 
-        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
@@ -5621,32 +7297,28 @@ class P123Client(P123OpenClient):
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    def fs_trash_clear(
+    def logout(
         self, 
-        payload: dict = {"event": "recycleClear"}, 
         /, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """清空回收站
-
-        POST https://www.123pan.com/api/file/trash_delete_all
+        """退出登录
 
-        :payload:
-            - event: str = "recycleClear"
+        POST https://www.123pan.com/api/user/logout
         """
-        payload.setdefault("event", "recycleClear")
         return self.request(
-            "file/trash_delete_all", 
+            "user/logout", 
             "POST", 
-            json=payload, 
             base_url=base_url, 
             async_=async_, 
             **request_kwargs, 
         )
 
+    ########## Offline Download API ##########
+
     @overload
     def offline_task_delete(
         self, 
@@ -5684,7 +7356,7 @@ class P123Client(P123OpenClient):
 
         :payload:
             - task_ids: list[int] 💡 任务 id 列表
-            - status_arr: list[0|1|2] = [] 💡 状态列表：0:等待 1:运行 2:完成
+            - status_arr: list[ 0 | 1 | 2 | 3 | 4 ] = [] 💡 状态列表：0:进行中 1:下载失败 2:下载成功 3:重试中
         """
         if isinstance(payload, int):
             payload = {"task_ids": [payload], "status_arr": []}
@@ -5739,12 +7411,12 @@ class P123Client(P123OpenClient):
         :payload:
             - current_page: int = 1
             - page_size: 100
-            - status_arr: list[0|1|2] = [0, 1] 💡 状态列表：0:等待 1:运行 2:完成
+            - status_arr: list[ 0 | 1 | 2 | 3 | 4 ] = [0, 1, 2, 3, 4] 💡 状态列表：0:进行中 1:下载失败 2:下载成功 3:重试中
         """
         if isinstance(payload, int):
-            payload = {"current_page": payload, "page_size": 100, "status_arr": [0, 1]}
+            payload = {"current_page": payload, "page_size": 100, "status_arr": [0, 1, 2, 3, 4]}
         else:
-            payload = {"current_page": 1, "page_size": 100, "status_arr": [0, 1], **payload}
+            payload = {"current_page": 1, "page_size": 100, "status_arr": [0, 1, 2, 3, 4], **payload}
         return self.request(
             "offline_download/task/list", 
             "POST", 
@@ -5911,6 +7583,8 @@ class P123Client(P123OpenClient):
             **request_kwargs, 
         )
 
+    ########## Share API ##########
+
     @overload
     def share_cancel(
         self, 
@@ -6687,6 +8361,8 @@ class P123Client(P123OpenClient):
             **request_kwargs, 
         )
 
+    ########## Upload API ##########
+
     @overload
     def upload_auth(
         self, 
@@ -7410,6 +9086,8 @@ class P123Client(P123OpenClient):
             )
         return run_gen_step(gen_step, async_)
 
+    ########## User API ##########
+
     @overload
     def user_device_list(
         self, 
@@ -7499,11 +9177,9 @@ class P123Client(P123OpenClient):
         )
 
     @overload
-    @staticmethod
-    def user_login(
-        payload: dict, 
+    def user_referral_info(
+        self, 
         /, 
-        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False] = False, 
@@ -7511,45 +9187,72 @@ class P123Client(P123OpenClient):
     ) -> dict:
         ...
     @overload
-    @staticmethod
-    def user_login(
-        payload: dict, 
+    def user_referral_info(
+        self, 
         /, 
-        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[True], 
         **request_kwargs, 
     ) -> Coroutine[Any, Any, dict]:
         ...
-    @staticmethod
-    def user_login(
-        payload: dict, 
+    def user_referral_info(
+        self, 
         /, 
-        request: None | Callable = None, 
         base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
         *, 
         async_: Literal[False, True] = False, 
         **request_kwargs, 
     ) -> dict | Coroutine[Any, Any, dict]:
-        """使用账号和密码登录
+        """用户拉人头信息
 
-        POST https://www.123pan.com/api/user/sign_in
+        GET https://www.123pan.com/api/referral/my-info
+        """
+        return self.request(
+            "referral/my-info", 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
 
-        .. note::
-            获取的 token 有效期 30 天
+    @overload
+    def user_report_info(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False] = False, 
+        **request_kwargs, 
+    ) -> dict:
+        ...
+    @overload
+    def user_report_info(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[True], 
+        **request_kwargs, 
+    ) -> Coroutine[Any, Any, dict]:
+        ...
+    def user_report_info(
+        self, 
+        /, 
+        base_url: str | Callable[[], str] = DEFAULT_BASE_URL, 
+        *, 
+        async_: Literal[False, True] = False, 
+        **request_kwargs, 
+    ) -> dict | Coroutine[Any, Any, dict]:
+        """用户推送消息配置
 
-        :payload:
-            - passport: int | str   💡 手机号或邮箱
-            - password: str         💡 密码
-            - remember: bool = True 💡 是否记住密码（不用管）
+        GET https://www.123pan.com/b/api/restful/goapi/v1/user/report/info
         """
-        api = complete_url("user/sign_in", base_url)
-        request_kwargs.setdefault("parse", default_parse)
-        if request is None:
-            request = get_default_request()
-            request_kwargs["async_"] = async_
-        return request(url=api, method="POST", json=payload, **request_kwargs)
+        return self.request(
+            "restful/goapi/v1/user/report/info", 
+            base_url=base_url, 
+            async_=async_, 
+            **request_kwargs, 
+        )
 
     @overload
     def user_use_history(
@@ -7599,9 +9302,31 @@ class P123Client(P123OpenClient):
             **request_kwargs, 
         )
 
-# TODO: 添加扫码登录接口，以及通过扫码登录的方法，特别是用已登录的设备扫描一个新的 token 出来
-# TODO: 添加 同步空间 和 直链空间 的操作接口
-# TODO: 添加 图床 的操作接口
-# TODO: 添加 视频转码 的操作接口
+
+with temp_globals():
+    CRE_CLIENT_API_search: Final = re_compile(r"^ +((?:GET|POST|PUT|DELETE|PATCH) .*)", MULTILINE).search
+    for name in dir(P123Client):
+        method = getattr(P123Client, name)
+        if not (callable(method) and method.__doc__):
+            continue
+        match = CRE_CLIENT_API_search(method.__doc__)
+        if match is not None:
+            api = match[1]
+            name = "P123Client." + name
+            CLIENT_METHOD_API_MAP[name] = api
+            try:
+                CLIENT_API_METHODS_MAP[api].append(name)
+            except KeyError:
+                CLIENT_API_METHODS_MAP[api] = [name]
+
+
 # TODO: 对于某些工具的接口封装，例如 重复文件清理
-# TODO: 开放接口有更新了，从此开始 https://123yunpan.yuque.com/org-wiki-123yunpan-muaork/cr6ced/xogi45g7okqk7svr
+# TODO: 同步空间
+# TODO: 直链空间
+# TODO: 图床
+# TODO: 视频转码
+# TODO: 移入保险箱
+# TODO: 申诉和申诉列表
+# TODO: 歌单（以及批量加入歌单）
+# TODO: 最近查看
+# TODO: 消息通知列表和操作