From 62908d3709eb6148976983002b98575ca3cf0111 Mon Sep 17 00:00:00 2001 From: Tang ZZ Date: Sat, 4 Apr 2026 07:18:21 +0800 Subject: [PATCH] docs(orion): add script compatibility note for Python version check Fixes #1534 Add a note explaining that the env_setup.sh script checks for Python 3.10 and may fail with newer Python versions. Provide manual installation instructions as a workaround. --- .../app-dev/artificial-intelligence/_env-setup.mdx | 6 ++++++ .../app-dev/artificial-intelligence/_env-setup.mdx | 6 ++++++ 2 files changed, 12 insertions(+) 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 +:::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 +:::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.