diff --git a/docs/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx b/docs/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
index c642a6344..5ab2cb1d7 100644
--- a/docs/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
+++ b/docs/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
@@ -66,6 +66,12 @@ bash env_setup.sh
 
 </NewCodeBlock>
 
+:::note[脚本兼容性]
+`env_setup.sh` 脚本会检查 Python 3.10 版本。如果您使用更高版本的 Python（如 Python 3.13），脚本可能会报错。如果遇到此问题，您可以：
+1. 确保使用正确的 Python 3.10 环境：`conda activate noe`
+2. 或者手动安装依赖：`pip install -r requirements.txt CixBuilder-6.1.3407.2-cp310-none-linux_x86_64.whl`
+:::
+
 ### 验证编译环境
 
 在终端运行 `cixbuild -v` 验证编译环境。
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx b/i18n/en/docusaurus-plugin-content-docs/current/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
index 55f2dba76..e7f769fae 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
+++ b/i18n/en/docusaurus-plugin-content-docs/current/common/orion-common/app-dev/artificial-intelligence/_env-setup.mdx
@@ -66,6 +66,12 @@ bash env_setup.sh
 
 </NewCodeBlock>
 
+:::note[Script compatibility]
+The `env_setup.sh` script checks for Python 3.10. If you are using a newer Python version (e.g., Python 3.13), the script may report an error. If you encounter this issue, you can:
+1. Ensure you are using the correct Python 3.10 environment: `conda activate noe`
+2. Or manually install dependencies: `pip install -r requirements.txt CixBuilder-6.1.3407.2-cp310-none-linux_x86_64.whl`
+:::
+
 ### Verify the build environment
 
 Run `cixbuild -v` in the terminal to check the build environment version.