fix!: impersonate defaults to ""

Author: Nemo2011

README.md

@@ -158,11 +158,20 @@ if __name__ == '__main__':
 ``` python
 from bilibili_api import select_client
 
-select_client("curl_cffi") # 选择 curl_cffi
+select_client("curl_cffi") # 选择 curl_cffi，支持伪装浏览器的 TLS / JA3 / Fingerprint
 select_client("aiohttp") # 选择 aiohttp
 select_client("httpx") # 选择 httpx，不支持 WebSocket
 ```
 
+curl_cffi 支持伪装浏览器的 TLS / JA3 / Fingerprint，但需要手动设置。
+
+``` python
+from bilibili_api import request_settings
+
+request_settings.set("impersonate", "chrome131") # 第二参数数值参考 curl_cffi 文档
+# https://curl-cffi.readthedocs.io/en/latest/impersonate.html
+```
+
 # FA♂Q
 
 **Q: 关于 API 调用的正确姿势是什么？**

bilibili_api/clients/CurlCFFIClient.py

@@ -28,7 +28,7 @@ def __init__(
         timeout: float = 0.0,
         verify_ssl: bool = True,
         trust_env: bool = True,
-        impersonate: str = "chrome131",
+        impersonate: str = "",
         http2: bool = False,
         session: Optional[requests.AsyncSession] = None,
     ) -> None:
@@ -38,7 +38,7 @@ def __init__(
             timeout (float, optional): 请求超时时间. Defaults to 0.0.
             verify_ssl (bool, optional): 是否验证 SSL. Defaults to True.
             trust_env (bool, optional): `trust_env`. Defaults to True.
-            impersonate (str, optional): 伪装的浏览器，可参考 curl_cffi 文档. Defaults to chrome131.
+            impersonate (str, optional): 伪装的浏览器，可参考 curl_cffi 文档. Defaults to "".
             http2 (bool, optional): 是否使用 HTTP2. Defaults to False.
             session (object, optional): 会话对象. Defaults to None.
 
@@ -79,12 +79,12 @@ def set_verify_ssl(self, verify_ssl: bool = True) -> None:
     def set_trust_env(self, trust_env: bool = True) -> None:
         self.__session.trust_env = trust_env
 
-    def set_impersonate(self, impersonate: str = "chrome131") -> None:
+    def set_impersonate(self, impersonate: str = "") -> None:
         """
         设置 curl_cffi 伪装的浏览器，可参考 curl_cffi 文档。
 
         Args:
-            impersonate (str, optional): 伪装的浏览器. Defaults to chrome131.
+            impersonate (str, optional): 伪装的浏览器. Defaults to "".
         """
         self.__session.impersonate = impersonate
 
@@ -108,9 +108,9 @@ async def request(
         cookies: dict = {},
         allow_redirects: bool = False,
     ) -> BiliAPIResponse:
-        if headers.get("User-Agent"):
+        if headers.get("User-Agent") and self.__session.impersonate != "":
             headers.pop("User-Agent")
-        if headers.get("user-agent"):
+        if headers.get("user-agent") and self.__session.impersonate != "":
             headers.pop("user-agent")
         request_log.dispatch(
             "REQUEST",
@@ -184,9 +184,9 @@ async def download_create(
         url: str = "",
         headers: dict = {},
     ) -> int:
-        if headers.get("User-Agent"):
+        if headers.get("User-Agent") and self.__session.impersonate != "":
             headers.pop("User-Agent")
-        if headers.get("user-agent"):
+        if headers.get("user-agent") and self.__session.impersonate != "":
             headers.pop("user-agent")
         self.__download_cnt += 1
         request_log.dispatch(
@@ -220,9 +220,9 @@ def download_content_length(self, cnt: int) -> int:
     async def ws_create(
         self, url: str = "", params: dict = {}, headers: dict = {}
     ) -> int:
-        if headers.get("User-Agent"):
+        if headers.get("User-Agent") and self.__session.impersonate != "":
             headers.pop("User-Agent")
-        if headers.get("user-agent"):
+        if headers.get("user-agent") and self.__session.impersonate != "":
             headers.pop("user-agent")
         self.__ws_cnt += 1
         request_log.dispatch(

bilibili_api/clients/__init__.py

@@ -3,7 +3,7 @@
 """
 
 ALL_PROVIDED_CLIENTS = [
-    ("curl_cffi", "CurlCFFIClient", {"impersonate": "chrome131", "http2": False}),
+    ("curl_cffi", "CurlCFFIClient", {"impersonate": "", "http2": False}),
     ("aiohttp", "AioHTTPClient", {}),
     ("httpx", "HTTPXClient", {"http2": False}),
 ]

docs/README.md

@@ -158,11 +158,20 @@ if __name__ == '__main__':
 ``` python
 from bilibili_api import select_client
 
-select_client("curl_cffi") # 选择 curl_cffi
+select_client("curl_cffi") # 选择 curl_cffi，支持伪装浏览器的 TLS / JA3 / Fingerprint
 select_client("aiohttp") # 选择 aiohttp
 select_client("httpx") # 选择 httpx，不支持 WebSocket
 ```
 
+curl_cffi 支持伪装浏览器的 TLS / JA3 / Fingerprint，但需要手动设置。
+
+``` python
+from bilibili_api import request_settings
+
+request_settings.set("impersonate", "chrome131") # 第二参数数值参考 curl_cffi 文档
+# https://curl-cffi.readthedocs.io/en/latest/impersonate.html
+```
+
 # FA♂Q
 
 **Q: 关于 API 调用的正确姿势是什么？**

docs/request_client.md

@@ -10,7 +10,7 @@
 
 |           | 优先级 | request | stream | WebSocket | 额外网络请求设置                                                           |
 | --------- | ------ | ------- | ------ | --------- | -------------------------------------------------------------------------- |
-| curl_cffi | 3      | ✅      | ✅     | ✅        | - `impersonate` defaults to `chrome131` <br> - `http2` defaults to `False` |
+| curl_cffi | 3      | ✅      | ✅     | ✅        | - `impersonate` defaults to ` ` <br> - `http2` defaults to `False` |
 | aiohttp   | 2      | ✅      | ✅     | ✅        |                                                                            |
 | httpx     | 1      | ✅      | ✅     | ❌        | `http2` defaults to `False`                                                |