Merge 'feat/add-known-issue' into 'master'

feat: add known issue

See merge request: !1030

Author: sdk-liuzhaoliang

README.EN.MD

@@ -1,6 +1,28 @@
 English | [中文](README.md)
 
 # Volcengine SDK for Python
+## ⚠️ Known Issue (Historical Versions)
+
+In some historical versions of **volcengine-python-sdk** (**4.0.1 – 4.0.42**, inclusive), the SDK’s built-in retry mechanism has a defect.
+
+When a request encounters an exception (such as network instability or API errors), the SDK may trigger its retry logic internally; however, due to this defect, the retry does not take effect as expected. As a result, the client may still experience the exception from the initial request, and the retry mechanism cannot effectively improve request success rates.
+
+### Affected Versions
+
+- **SDK**: volcengine-python-sdk  
+- **Versions**: 4.0.1 – 4.0.42 (inclusive)
+
+### Impact
+
+For applications that rely on the SDK’s retry mechanism to handle transient failures or network instability:
+
+- Actual request availability may be lower than expected  
+- Retry configurations may not function as intended  
+
+### Resolution and Recommendation
+
+This issue has been fixed in **version 4.0.43 and above**.  
+**We strongly recommend all users upgrade to volcengine-python-sdk ≥ 4.0.43** to ensure the retry mechanism functions correctly in exception scenarios.
 
 ## Breaking Change Notice
 

README.md

@@ -2,6 +2,30 @@
 
 # Volcengine SDK for Python
 
+## ⚠️ 已知缺陷说明（历史版本）
+
+在 **volcengine-python-sdk** 的部分历史版本（**4.0.1 ～ 4.0.42，含**）中，发现 SDK 内置的重试机制存在缺陷。
+
+当请求过程中出现异常（如网络抖动、接口返回错误等）时，SDK 虽会触发重试逻辑，但由于该缺陷，重试未能实际生效，客户端仍可能直接感知到首次请求异常，导致重试机制无法有效提升请求成功率。
+
+### 影响范围
+
+- **SDK**：volcengine-python-sdk  
+- **受影响版本**：4.0.1 ～ 4.0.42（含）
+
+### 影响说明
+
+对于依赖 SDK 内置重试机制来应对瞬时异常或网络不稳定场景的业务：
+
+- 实际请求可用性可能低于预期  
+- 重试相关配置无法发挥应有的保障作用  
+
+### 解决方案与建议
+
+该问题已在 **4.0.43 及以上版本**中修复。  
+**强烈建议所有用户升级至 volcengine-python-sdk ≥ 4.0.43**，以确保请求重试机制在异常场景下能够正常生效。
+
+
 ## 非兼容升级通知
 
 Volcengine SDK for Python 非兼容升级通知