From 5da8c6baf8c50cda200517bc82b13c9366ae8ceb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=BD=95=E5=86=A0=E5=B3=B0?= <hevinci@hotmail.com>
Date: Thu, 4 Dec 2025 21:12:49 +0800
Subject: [PATCH] =?UTF-8?q?perf=20:=20=E6=96=87=E4=BB=B6=E9=AA=8C=E8=AF=81?=
 =?UTF-8?q?=E5=92=8C=E6=96=87=E4=BB=B6=E4=B8=8B=E8=BD=BD=E5=B9=B6=E5=8F=91?=
 =?UTF-8?q?=E8=AE=BE=E7=BD=AE=E4=B8=BA=E5=90=88=E7=90=86=E7=9A=84=E9=BB=98?=
 =?UTF-8?q?=E8=AE=A4=E5=80=BC=EF=BC=8C=E5=B9=B6=E9=99=90=E5=88=B6=E5=8F=82?=
 =?UTF-8?q?=E6=95=B0=E4=B8=BA=E5=90=88=E7=90=86=E8=8C=83=E5=9B=B4=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../DefaultCacheFileSystem.cs                 | 35 +++++++++++++++----
 1 file changed, 29 insertions(+), 6 deletions(-)

diff --git a/Assets/YooAsset/Runtime/FileSystem/DefaultCacheFileSystem/DefaultCacheFileSystem.cs b/Assets/YooAsset/Runtime/FileSystem/DefaultCacheFileSystem/DefaultCacheFileSystem.cs
index 940a7d96..32238a59 100644
--- a/Assets/YooAsset/Runtime/FileSystem/DefaultCacheFileSystem/DefaultCacheFileSystem.cs
+++ b/Assets/YooAsset/Runtime/FileSystem/DefaultCacheFileSystem/DefaultCacheFileSystem.cs
@@ -73,8 +73,10 @@ namespace YooAsset
 
         /// <summary>
         /// 自定义参数：初始化的时候缓存文件校验最大并发数
+        /// 默认值：32（推荐范围 1-128）
+        /// 说明：过大的值可能导致线程池任务过多，影响系统稳定性 
         /// </summary>
-        public int FileVerifyMaxConcurrency { private set; get; } = int.MaxValue;
+        public int FileVerifyMaxConcurrency { private set; get; } = 32;
 
         /// <summary>
         /// 自定义参数：数据文件追加文件格式
@@ -88,13 +90,17 @@ namespace YooAsset
 
         /// <summary>
         /// 自定义参数：最大并发连接数
+        /// 默认值：10（推荐范围 1-32）
+        /// 说明：过大的并发数可能被服务器限流，也会增加本地资源消耗 
         /// </summary>
-        public int DownloadMaxConcurrency { private set; get; } = int.MaxValue;
+        public int DownloadMaxConcurrency { private set; get; } = 10;
 
         /// <summary>
         /// 自定义参数：每帧发起的最大请求数
+        /// 默认值：5（推荐范围 1-10） 
+        /// 说明：避免单帧发起过多请求导致卡顿 
         /// </summary>
-        public int DownloadMaxRequestPerFrame { private set; get; } = int.MaxValue;
+        public int DownloadMaxRequestPerFrame { private set; get; } = 5;
 
         /// <summary>
         /// 自定义参数：下载任务的看门狗机制监控时间
@@ -242,7 +248,14 @@ namespace YooAsset
             else if (name == FileSystemParametersDefine.FILE_VERIFY_MAX_CONCURRENCY)
             {
                 int convertValue = Convert.ToInt32(value);
-                FileVerifyMaxConcurrency = Mathf.Clamp(convertValue, 1, int.MaxValue);
+                if (convertValue > 256)
+                {
+                    YooLogger.Warning($"FILE_VERIFY_MAX_CONCURRENCY value {convertValue} is too large, clamped to 256. Recommended range: 1 - 128.");
+                }
+
+                // 限制在合理范围内：1-256                                                                             
+                // 超过 256 的并发数对于文件验证来说没有意义，反而会增加线程池压力  
+                FileVerifyMaxConcurrency = Mathf.Clamp(convertValue, 1, 256);
             }
             else if (name == FileSystemParametersDefine.APPEND_FILE_EXTENSION)
             {
@@ -255,12 +268,22 @@ namespace YooAsset
             else if (name == FileSystemParametersDefine.DOWNLOAD_MAX_CONCURRENCY)
             {
                 int convertValue = Convert.ToInt32(value);
-                DownloadMaxConcurrency = Mathf.Clamp(convertValue, 1, int.MaxValue);
+                if (convertValue > 64)
+                {
+                    YooLogger.Warning($"DOWNLOAD_MAX_CONCURRENCY value {convertValue} is too large, clamped to 64. Recommended range: 1 - 32.");
+                }
+
+                DownloadMaxConcurrency = Mathf.Clamp(convertValue, 1, 64);
             }
             else if (name == FileSystemParametersDefine.DOWNLOAD_MAX_REQUEST_PER_FRAME)
             {
                 int convertValue = Convert.ToInt32(value);
-                DownloadMaxRequestPerFrame = Mathf.Clamp(convertValue, 1, int.MaxValue);
+                if (convertValue > 20)
+                {
+                    YooLogger.Warning($"DOWNLOAD_MAX_REQUEST_PER_FRAME value {convertValue} is too large, clamped to 20. Recommended range: 1 - 10.");
+                }
+
+                DownloadMaxRequestPerFrame = Mathf.Clamp(convertValue, 1, 20);
             }
             else if (name == FileSystemParametersDefine.DOWNLOAD_WATCH_DOG_TIME)
             {