akshare-proxy-patch 0.4.2__tar.gz → 0.5.0__tar.gz

{akshare_proxy_patch-0.4.2 → akshare_proxy_patch-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: akshare-proxy-patch
-Version: 0.4.2
+Version: 0.5.0
 Summary: 针对 AkShare 和 efinance 的底层补丁，自动为东财等接口注入代理认证头，从而避免 `stock_zh_a_spot_em` 等方法报错。
 Home-page: https://github.com/helloyie/akshare-proxy-patch
 Author: cheapproxy.net
@@ -21,13 +21,14 @@ Dynamic: requires-python
 
 # AkShare Proxy Patch
 
-> 针对 [akshare](https://github.com/akfamily/akshare)、[efinance](https://github.com/Micro-sheep/efinance)、[yfinance](https://github.com/ranaroussi/yfinance) 的🐒插件补丁，解决 `stock_zh_a_spot_em`、`stock_zh_a_hist`、`get_realtime_quotes` 等接口报错问题和 Yahoo `YFRateLimitError` 问题。
+> 针对 [akshare](https://github.com/akfamily/akshare)、[efinance](https://github.com/Micro-sheep/efinance)、[yfinance](https://github.com/ranaroussi/yfinance) 的🐒插件补丁，解决 `stock_zh_a_spot_em`、`stock_zh_a_hist`、`get_realtime_quotes` 等接口报错问题和 Yahoo `YFRateLimitError` 问题。并对 `akshare` 部分接口进行多线程加速处理。
 
 ## ✨ 特性
 
-- 解决 `akshare` 接口报错问题
-- 解决 `efinance` 接口报错问题
-- 解决 `yfinance` Yahoo接口报错问题
+- 解决 `akshare` 的 `stock_zh_a_spot_em`、`stock_zh_a_hist` 接口报错问题
+- 解决 `efinance` 的 `get_realtime_quotes` 等接口报错问题
+- 解决 `yfinance` Yahoo接口国内无法使用问题
+- 加速 `stock_zh_a_spot_em`、`stock_individual_fund_flow_rank` 等 `akshare` 接口
 
 ## 📦 安装
 
@@ -36,7 +37,7 @@ Dynamic: requires-python
 2. 安装 `akshare-proxy-patch` 插件
 
 ```
-pip install akshare-proxy-patch==0.4.1
+pip install akshare-proxy-patch==0.5.0
 ```
 
 ## 🚀 使用方法（akshare / efinance / yfinance）
@@ -47,7 +48,7 @@ pip install akshare-proxy-patch==0.4.1
 
 ```
 # python 文件顶部添加如下代码
-# 一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
+# 插件引入和调用一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
 import akshare_proxy_patch
 
 akshare_proxy_patch.install_patch(
@@ -61,6 +62,7 @@ akshare_proxy_patch.install_patch(
       "push2his.eastmoney.com",
       "emweb.securities.eastmoney.com",
     ],
+    fast=True
 )
 
 # --------------------------
@@ -80,7 +82,7 @@ ef.stock.get_realtime_quotes()
 
 ```
 # python 文件顶部添加如下代码
-# 一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
+# 插件引入和调用一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
 import akshare_proxy_patch
 
 akshare_proxy_patch.install_yfinance_patch(
@@ -98,7 +100,9 @@ import yfinance as yf
 data = yf.download("AAPL", start="2017-01-01", end="2017-04-30")
 ```
 
-## 📖 install_patch 参数说明
+4. [尽量用 `efinance` 替代 `akshare` 的部分函数获取数据，效率更高，更省积分](https://github.com/Micro-sheep/efinance)
+
+## install_patch 参数说明
 
 - 参数1：网关
   - 默认为 `101.201.173.125` 不可修改
@@ -110,13 +114,34 @@ data = yf.download("AAPL", start="2017-01-01", end="2017-04-30")
   - 接口 `URL` 包含数组中的其中一条，就会走插件。
   - 可点击 `ak` 或 `ef` 函数查看接口源码对应的 `URL`，根据封控情况细化可以降低积分消耗。
   - 如只封控 `stock_zh_a_spot_em` 这个接口，`hook_domains` 可设置为 `["https://82.push2.eastmoney.com/api/qt/clist/get"]`。
+- 参数5：是否启用快速模式，加速列表如下：
+  - 所有包含 `fetch_paginated_data` 函数的接口，如 `stock_zh_a_spot_em`
+  - `stock_individual_fund_flow_rank`
+  - `stock_sector_fund_flow_rank`
+  - `fund_money_fund_info_em`
+  - `fund_graded_fund_info_em`
+  - `fund_etf_fund_info_em`
+  - `fund_fh_em`
+  - `fund_cf_em`
+  - `fund_fh_rank_em`
+
+## 如何在 aktools 内集成插件？
+
+- `aktools` 想要集成插件，需下载 [akt.py](https://github.com/HelloYie/akshare-proxy-patch/blob/master/examples/aktools/akt.py) 文件，并填入您的 `TOKEN`。
+- 然后执行 `python akt.py` 即可启动一个 `http://127.0.0.1:8080/` 服务。只是启动方式不同而已，使用请参考 [aktools 官方文档](https://github.com/akfamily/aktools)。
+
+## 如何多进程使用，快速拉取数据？
+
+- 尽量使用 `efinance` 替代 `akshare` 来获取数据， `efinance` 内置多线程，效率更高，更省积分。
+- 在大规模快速获取数据时，仍需要多进程来提升效率。 参考 `examples/并发获取股票行情/` 目录下的 `main.py` 和 `worker.py` 示例，修改 `worker.py` 中的 `auth_token`，执行 `python main.py` 即可。
+- `main.py` 负责分割任务和启动多个 `worker.py` 进程，`worker.py` 中引入插件并执行数据获取逻辑，最后将结果合并保存。
 
 ## 如何灵活禁用/启用插件？
 
 加入如下代码后插件就会被禁用：
 
 ```
-import importlib, requests;importlib.reload(requests)
+akshare_proxy_patch.uninstall_patch()
 ```
 
 下面是插件启用 --> 禁用 --> 再次启用的例子：
@@ -136,12 +161,13 @@ akshare_proxy_patch.install_patch(
       "push2his.eastmoney.com",
       "emweb.securities.eastmoney.com",
     ],
+    fast=True
 )
 import akshare as ak
 df =  ak.fund_etf_hist_em()
 
 ###### 2. 禁用插件
-import importlib, requests;importlib.reload(requests)
+akshare_proxy_patch.uninstall_patch()
 
 # 禁用后测试
 try:
@@ -152,51 +178,13 @@ except Exception as e:
 ##### 3. 再次启用插件，重复上述 1、2 的代码即可
 ```
 
-## 🛠️ 如何在 aktools 内集成插件？
-
-`aktools` 想要集成插件，需要新建一个 `akt.py` 替换官方的 `python -m aktools` 启动命令，下面是 `akt.py` 内容：
-
-```
-# 添加插件
-import akshare_proxy_patch
-
-akshare_proxy_patch.install_patch(
-    "101.201.173.125",
-    auth_token="你的TOKEN",
-    retry=30,
-    # 封控的域名列表，可自行调整
-    hook_domains=[
-      "fund.eastmoney.com",
-      "push2.eastmoney.com",
-      "push2his.eastmoney.com",
-      "emweb.securities.eastmoney.com",
-    ],
-)
-
-# 启动 aktools
-import uvicorn
-
-if __name__ == '__main__':
-    uvicorn.run(
-        "aktools.main:app",
-        host="0.0.0.0",
-        port=8080,
-        reload=False,
-        # 根据 CPU 核心数调整，推荐 2×核心数 + 1
-        workers=4,
-        log_level="info"
-    )
-```
-
-然后执行 `python akt.py` 即可启动一个 `http://127.0.0.1:8080/` 服务。只是启动方式不同而已，使用请参考 [aktools 官方文档](https://github.com/akfamily/aktools)。
-
-## ❓ 我没使用 akshare 或 efinance，能集成插件吗？
+## 我没使用 akshare 或 efinance，能集成插件吗？
 
 - 如果使用 Python 语言的 `requests` 库请求接口，插件能自动 hook 住请求，正常工作。
-- 如果您使用其他语言或 python 的其他库，可 [手动提取代理](http://101.201.173.125:47001/api/akshare-auth?token=XXX&version=0.4.1) 自行实现封控解除。
+- 如果您使用其他语言或 python 的其他库，可 [手动提取代理](http://101.201.173.125:47001/api/akshare-auth?token=XXX&version=0.5.0) 自行实现封控解除。
 
-## 💬 使用问题交流群
+## 使用问题交流群
 
 如使用时遇到问题，或对插件有什么意见或建议，可进群交流：
 
-![5TZKxn1xMXE84yE4Df8wmWC5a6BNy7gs.webp](https://cdn.nodeimage.com/i/5TZKxn1xMXE84yE4Df8wmWC5a6BNy7gs.webp)
+![HExHHHovkcq1Kt9TEEzc8OKtFV2O1BBp.webp](https://cdn.nodeimage.com/i/HExHHHovkcq1Kt9TEEzc8OKtFV2O1BBp.webp)

{akshare_proxy_patch-0.4.2 → akshare_proxy_patch-0.5.0}/README.md

@@ -1,12 +1,13 @@
 # AkShare Proxy Patch
 
-> 针对 [akshare](https://github.com/akfamily/akshare)、[efinance](https://github.com/Micro-sheep/efinance)、[yfinance](https://github.com/ranaroussi/yfinance) 的🐒插件补丁，解决 `stock_zh_a_spot_em`、`stock_zh_a_hist`、`get_realtime_quotes` 等接口报错问题和 Yahoo `YFRateLimitError` 问题。
+> 针对 [akshare](https://github.com/akfamily/akshare)、[efinance](https://github.com/Micro-sheep/efinance)、[yfinance](https://github.com/ranaroussi/yfinance) 的🐒插件补丁，解决 `stock_zh_a_spot_em`、`stock_zh_a_hist`、`get_realtime_quotes` 等接口报错问题和 Yahoo `YFRateLimitError` 问题。并对 `akshare` 部分接口进行多线程加速处理。
 
 ## ✨ 特性
 
-- 解决 `akshare` 接口报错问题
-- 解决 `efinance` 接口报错问题
-- 解决 `yfinance` Yahoo接口报错问题
+- 解决 `akshare` 的 `stock_zh_a_spot_em`、`stock_zh_a_hist` 接口报错问题
+- 解决 `efinance` 的 `get_realtime_quotes` 等接口报错问题
+- 解决 `yfinance` Yahoo接口国内无法使用问题
+- 加速 `stock_zh_a_spot_em`、`stock_individual_fund_flow_rank` 等 `akshare` 接口
 
 ## 📦 安装
 
@@ -15,7 +16,7 @@
 2. 安装 `akshare-proxy-patch` 插件
 
 ```
-pip install akshare-proxy-patch==0.4.1
+pip install akshare-proxy-patch==0.5.0
 ```
 
 ## 🚀 使用方法（akshare / efinance / yfinance）
@@ -26,7 +27,7 @@ pip install akshare-proxy-patch==0.4.1
 
 ```
 # python 文件顶部添加如下代码
-# 一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
+# 插件引入和调用一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
 import akshare_proxy_patch
 
 akshare_proxy_patch.install_patch(
@@ -40,6 +41,7 @@ akshare_proxy_patch.install_patch(
       "push2his.eastmoney.com",
       "emweb.securities.eastmoney.com",
     ],
+    fast=True
 )
 
 # --------------------------
@@ -59,7 +61,7 @@ ef.stock.get_realtime_quotes()
 
 ```
 # python 文件顶部添加如下代码
-# 一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
+# 插件引入和调用一定要放到最顶部！不能在 akshare 或 efinance 之后引入！
 import akshare_proxy_patch
 
 akshare_proxy_patch.install_yfinance_patch(
@@ -77,7 +79,9 @@ import yfinance as yf
 data = yf.download("AAPL", start="2017-01-01", end="2017-04-30")
 ```
 
-## 📖 install_patch 参数说明
+4. [尽量用 `efinance` 替代 `akshare` 的部分函数获取数据，效率更高，更省积分](https://github.com/Micro-sheep/efinance)
+
+## install_patch 参数说明
 
 - 参数1：网关
   - 默认为 `101.201.173.125` 不可修改
@@ -89,13 +93,34 @@ data = yf.download("AAPL", start="2017-01-01", end="2017-04-30")
   - 接口 `URL` 包含数组中的其中一条，就会走插件。
   - 可点击 `ak` 或 `ef` 函数查看接口源码对应的 `URL`，根据封控情况细化可以降低积分消耗。
   - 如只封控 `stock_zh_a_spot_em` 这个接口，`hook_domains` 可设置为 `["https://82.push2.eastmoney.com/api/qt/clist/get"]`。
+- 参数5：是否启用快速模式，加速列表如下：
+  - 所有包含 `fetch_paginated_data` 函数的接口，如 `stock_zh_a_spot_em`
+  - `stock_individual_fund_flow_rank`
+  - `stock_sector_fund_flow_rank`
+  - `fund_money_fund_info_em`
+  - `fund_graded_fund_info_em`
+  - `fund_etf_fund_info_em`
+  - `fund_fh_em`
+  - `fund_cf_em`
+  - `fund_fh_rank_em`
+
+## 如何在 aktools 内集成插件？
+
+- `aktools` 想要集成插件，需下载 [akt.py](https://github.com/HelloYie/akshare-proxy-patch/blob/master/examples/aktools/akt.py) 文件，并填入您的 `TOKEN`。
+- 然后执行 `python akt.py` 即可启动一个 `http://127.0.0.1:8080/` 服务。只是启动方式不同而已，使用请参考 [aktools 官方文档](https://github.com/akfamily/aktools)。
+
+## 如何多进程使用，快速拉取数据？
+
+- 尽量使用 `efinance` 替代 `akshare` 来获取数据， `efinance` 内置多线程，效率更高，更省积分。
+- 在大规模快速获取数据时，仍需要多进程来提升效率。 参考 `examples/并发获取股票行情/` 目录下的 `main.py` 和 `worker.py` 示例，修改 `worker.py` 中的 `auth_token`，执行 `python main.py` 即可。
+- `main.py` 负责分割任务和启动多个 `worker.py` 进程，`worker.py` 中引入插件并执行数据获取逻辑，最后将结果合并保存。
 
 ## 如何灵活禁用/启用插件？
 
 加入如下代码后插件就会被禁用：
 
 ```
-import importlib, requests;importlib.reload(requests)
+akshare_proxy_patch.uninstall_patch()
 ```
 
 下面是插件启用 --> 禁用 --> 再次启用的例子：
@@ -115,12 +140,13 @@ akshare_proxy_patch.install_patch(
       "push2his.eastmoney.com",
       "emweb.securities.eastmoney.com",
     ],
+    fast=True
 )
 import akshare as ak
 df =  ak.fund_etf_hist_em()
 
 ###### 2. 禁用插件
-import importlib, requests;importlib.reload(requests)
+akshare_proxy_patch.uninstall_patch()
 
 # 禁用后测试
 try:
@@ -131,51 +157,13 @@ except Exception as e:
 ##### 3. 再次启用插件，重复上述 1、2 的代码即可
 ```
 
-## 🛠️ 如何在 aktools 内集成插件？
-
-`aktools` 想要集成插件，需要新建一个 `akt.py` 替换官方的 `python -m aktools` 启动命令，下面是 `akt.py` 内容：
-
-```
-# 添加插件
-import akshare_proxy_patch
-
-akshare_proxy_patch.install_patch(
-    "101.201.173.125",
-    auth_token="你的TOKEN",
-    retry=30,
-    # 封控的域名列表，可自行调整
-    hook_domains=[
-      "fund.eastmoney.com",
-      "push2.eastmoney.com",
-      "push2his.eastmoney.com",
-      "emweb.securities.eastmoney.com",
-    ],
-)
-
-# 启动 aktools
-import uvicorn
-
-if __name__ == '__main__':
-    uvicorn.run(
-        "aktools.main:app",
-        host="0.0.0.0",
-        port=8080,
-        reload=False,
-        # 根据 CPU 核心数调整，推荐 2×核心数 + 1
-        workers=4,
-        log_level="info"
-    )
-```
-
-然后执行 `python akt.py` 即可启动一个 `http://127.0.0.1:8080/` 服务。只是启动方式不同而已，使用请参考 [aktools 官方文档](https://github.com/akfamily/aktools)。
-
-## ❓ 我没使用 akshare 或 efinance，能集成插件吗？
+## 我没使用 akshare 或 efinance，能集成插件吗？
 
 - 如果使用 Python 语言的 `requests` 库请求接口，插件能自动 hook 住请求，正常工作。
-- 如果您使用其他语言或 python 的其他库，可 [手动提取代理](http://101.201.173.125:47001/api/akshare-auth?token=XXX&version=0.4.1) 自行实现封控解除。
+- 如果您使用其他语言或 python 的其他库，可 [手动提取代理](http://101.201.173.125:47001/api/akshare-auth?token=XXX&version=0.5.0) 自行实现封控解除。
 
-## 💬 使用问题交流群
+## 使用问题交流群
 
 如使用时遇到问题，或对插件有什么意见或建议，可进群交流：
 
-![5TZKxn1xMXE84yE4Df8wmWC5a6BNy7gs.webp](https://cdn.nodeimage.com/i/5TZKxn1xMXE84yE4Df8wmWC5a6BNy7gs.webp)
+![HExHHHovkcq1Kt9TEEzc8OKtFV2O1BBp.webp](https://cdn.nodeimage.com/i/HExHHHovkcq1Kt9TEEzc8OKtFV2O1BBp.webp)

{akshare_proxy_patch-0.4.2 → akshare_proxy_patch-0.5.0}/akshare_proxy_patch/__init__.py

@@ -1,7 +1,24 @@
+import importlib
+import sys
 import time
 import random
 import threading
-import sys
+
+from .akshare_src.func import fetch_paginated_data as _patched_fetch_paginated_data
+from .akshare_src.stock.stock_fund_em import (
+    stock_individual_fund_flow_rank as _patched_stock_individual_fund_flow_rank,
+    stock_sector_fund_flow_rank as _patched_stock_sector_fund_flow_rank,
+)
+from .akshare_src.fund.fund_em import (
+    fund_money_fund_info_em as _patched_fund_money_fund_info_em,
+    fund_graded_fund_info_em as _patched_fund_graded_fund_info_em,
+    fund_etf_fund_info_em as _patched_fund_etf_fund_info_em,
+)
+from .akshare_src.fund.fund_fhsp_em import (
+    fund_fh_em as _patched_fund_fh_em,
+    fund_cf_em as _patched_fund_cf_em,
+    fund_fh_rank_em as _patched_fund_fh_rank_em,
+)
 
 # 1. 导入必要的库
 try:
@@ -13,7 +30,7 @@ except ImportError:
 
 import requests as std_requests
 
-__version__ = "0.4.2"
+__version__ = "0.5.0"
 
 # 授权接口固定使用标准 requests，避免干扰
 _auth_session = std_requests.Session()
@@ -24,6 +41,8 @@ target_browsers = [
     if isinstance(b, str) and (b.startswith("chrome") or b.startswith("edge"))
 ]
 
+origin_backup = {}
+
 
 class AuthCache:
     def __init__(self):
@@ -75,6 +94,7 @@ def install_patch(
     hook_domains=default_hook_domains,
     timeout=5,
     cookie="",
+    fast=True,
 ):
     # --- 核心改进：备份原始 Session 避开递归死循环 ---
     if not hasattr(std_requests, "_OriginalSession"):
@@ -160,6 +180,95 @@ def install_patch(
     curl_requests.get = patched_get
     curl_requests.post = patched_post
 
+    if fast:
+        install_fast_patch()
+
+
+def install_fast_patch():
+    """
+    一些函数使用多线程替代分页请求，提升效率
+    """
+    try:
+        akshare = importlib.import_module("akshare")
+        # 覆盖已加载的 akshare 模块的 fetch_paginated_data
+        for name, mod in list(sys.modules.items()):
+            if mod and name.startswith("akshare"):
+                if hasattr(mod, "fetch_paginated_data"):
+                    origin_backup[(name, "fetch_paginated_data")] = getattr(
+                        mod, "fetch_paginated_data"
+                    )
+                    setattr(mod, "fetch_paginated_data", _patched_fetch_paginated_data)
+
+        origin_backup[("akshare", "stock_individual_fund_flow_rank")] = getattr(
+            akshare, "stock_individual_fund_flow_rank"
+        )
+        setattr(
+            akshare,
+            "stock_individual_fund_flow_rank",
+            _patched_stock_individual_fund_flow_rank,
+        )
+
+        origin_backup[("akshare", "stock_sector_fund_flow_rank")] = getattr(
+            akshare, "stock_sector_fund_flow_rank"
+        )
+        setattr(
+            akshare,
+            "stock_sector_fund_flow_rank",
+            _patched_stock_sector_fund_flow_rank,
+        )
+
+        origin_backup[("akshare", "fund_money_fund_info_em")] = getattr(
+            akshare, "fund_money_fund_info_em"
+        )
+        setattr(
+            akshare,
+            "fund_money_fund_info_em",
+            _patched_fund_money_fund_info_em,
+        )
+
+        origin_backup[("akshare", "fund_graded_fund_info_em")] = getattr(
+            akshare, "fund_graded_fund_info_em"
+        )
+        setattr(
+            akshare,
+            "fund_graded_fund_info_em",
+            _patched_fund_graded_fund_info_em,
+        )
+
+        origin_backup[("akshare", "fund_etf_fund_info_em")] = getattr(
+            akshare, "fund_etf_fund_info_em"
+        )
+        setattr(
+            akshare,
+            "fund_etf_fund_info_em",
+            _patched_fund_etf_fund_info_em,
+        )
+
+        origin_backup[("akshare", "fund_fh_em")] = getattr(akshare, "fund_fh_em")
+        setattr(
+            akshare,
+            "fund_fh_em",
+            _patched_fund_fh_em,
+        )
+
+        origin_backup[("akshare", "fund_cf_em")] = getattr(akshare, "fund_cf_em")
+        setattr(
+            akshare,
+            "fund_cf_em",
+            _patched_fund_cf_em,
+        )
+
+        origin_backup[("akshare", "fund_fh_rank_em")] = getattr(
+            akshare, "fund_fh_rank_em"
+        )
+        setattr(
+            akshare,
+            "fund_fh_rank_em",
+            _patched_fund_fh_rank_em,
+        )
+    except Exception as e:
+        print("启动快速模式失败：", e)
+
 
 def install_yfinance_patch(
     auth_ip, auth_token="", retry=30, hook_domains=["finance.yahoo.com"]
@@ -167,3 +276,20 @@ def install_yfinance_patch(
     from .yfinance import install_yfinance_patch_main
 
     install_yfinance_patch_main(auth_ip, auth_token, retry, hook_domains)
+
+
+def uninstall_patch():
+    """
+    卸载插件，恢复原始状态
+    """
+    import requests
+
+    # 恢复 requests 模块到原始状态
+    importlib.reload(requests)
+    try:
+        # 还原 akshare 模块
+        for (mod_name, func_name), original_func in origin_backup.items():
+            if mod_name in sys.modules:
+                setattr(sys.modules[mod_name], func_name, original_func)
+    except Exception as e:
+        print("还原 akshare 模块失败：", e)

akshare_proxy_patch-0.5.0/akshare_proxy_patch/akshare_src/func.py

@@ -0,0 +1,90 @@
+# !/usr/bin/env python
+"""
+Date: 2025/3/10 18:00
+Desc: 通用帮助函数
+"""
+
+import math
+import random
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from typing import List, Dict
+
+import pandas as pd
+
+from akshare.utils.request import request_with_retry
+from akshare.utils.tqdm import get_tqdm
+
+
+def fetch_paginated_data(url: str, base_params: Dict, timeout: int = 15):
+    """
+    东方财富-分页获取数据并合并结果
+    https://quote.eastmoney.com/f1.html?newcode=0.000001
+    :param url: 股票代码
+    :type url: str
+    :param base_params: 基础请求参数
+    :type base_params: dict
+    :param timeout: 请求超时时间
+    :type timeout: str
+    :return: 合并后的数据
+    :rtype: pandas.DataFrame
+    """
+    # 复制参数以避免修改原始参数
+    params = base_params.copy()
+    # 获取第一页数据，用于确定分页信息
+    r = request_with_retry(url, params=params, timeout=timeout)
+    data_json = r.json()
+    # 计算分页信息
+    per_page_num = len(data_json["data"]["diff"])
+    total_page = math.ceil(data_json["data"]["total"] / per_page_num)
+    # 存储所有页面数据
+    temp_list = []
+    # 添加第一页数据
+    temp_list.append(pd.DataFrame(data_json["data"]["diff"]))
+    # 获取剩余页面数据
+    remaining_pages = list(range(2, total_page + 1))
+    if remaining_pages:
+        tqdm = get_tqdm()
+
+        def fetch_page(page: int) -> pd.DataFrame:
+            current_params = base_params.copy()
+            current_params.update({"pn": page})
+            time.sleep(random.uniform(0.5, 1.5))
+            r = request_with_retry(url, params=current_params, timeout=timeout)
+            page_json = r.json()
+            return pd.DataFrame(page_json["data"]["diff"])
+
+        with ThreadPoolExecutor(max_workers=min(8, len(remaining_pages))) as executor:
+            future_to_page = {
+                executor.submit(fetch_page, page): page for page in remaining_pages
+            }
+            for future in tqdm(
+                as_completed(future_to_page), total=len(remaining_pages), leave=False
+            ):
+                inner_temp_df = future.result()
+                temp_list.append(inner_temp_df)
+
+    # 合并所有数据
+    temp_df = pd.concat(temp_list, ignore_index=True)
+    temp_df["f3"] = pd.to_numeric(temp_df["f3"], errors="coerce")
+    temp_df.sort_values(by=["f3"], ascending=False, inplace=True, ignore_index=True)
+    temp_df.reset_index(inplace=True)
+    temp_df["index"] = temp_df["index"].astype(int) + 1
+    return temp_df
+
+
+def set_df_columns(df: pd.DataFrame, cols: List[str]) -> pd.DataFrame:
+    """
+    设置 pandas.DataFrame 为空的情况
+    :param df: 需要设置命名的数据框
+    :type df: pandas.DataFrame
+    :param cols: 字段的列表
+    :type cols: list
+    :return: 重新设置后的数据
+    :rtype: pandas.DataFrame
+    """
+    if df.shape == (0, 0):
+        return pd.DataFrame(data=[], columns=cols)
+    else:
+        df.columns = cols
+        return df