QoderWake Python开发环境配置全流程（虚拟环境）
搭建QoderWake数字员工的Python开发环境，核心策略是：别把它当成常规Python环境来配置。绝大多数依赖冲突、版本不匹配、沙盒初始化失败，根源都在于Python解释器未正确关联、虚拟环境未绑定到QoderWake运行上下文、或pip源未适配其沙盒权限策略。以下流程可有效规避上述问题。
若你正被上述问题困扰，这套标准化操作可一次性解决。
一、确认QoderWake沙盒Python版本及基础工具链
QoderWake默认运行在独立沙盒Python环境，与宿主机完全隔离。必须主动验证沙盒内的Python版本和包管理器是否就绪，否则后续安装可能误写入系统Python，QoderWake无法加载。
验证流程共三步：
1. 启动Qoder CLI终端，输入qoder env python --version，返回版本应为3.9、3.10或3.11之一。若不符，说明沙盒初始化异常。
2. 执行qoder env pip --version，确认pip版本号不低于22.0且正常返回。若提示“command not found”，运行qoder env init重新初始化沙盒。
3. 输入qoder env python -c "import sys; print(sys.executable)"，记录输出的路径。该路径是QoderWake实际调用的Python解释器，后续配置IDE时需使用。
二、创建并激活专用虚拟环境（venv方式）
尽管QoderWake自带沙盒，但开发自定义爬虫脚本或扩展模块时，建议在沙盒内嵌套标准venv环境，实现项目级依赖隔离，避免跨项目冲突。
操作步骤：
1. 在Qoder CLI中进入目标项目目录，执行qoder env python -m venv ./venv_qw，生成名为venv_qw的虚拟环境。
2. 激活环境：macOS/Linux用户运行source ./venv_qw/bin/activate，Windows用户运行./venv_qw/Scripts/activate.bat。
3. 验证激活状态：运行which python（macOS/Linux）或where python（Windows），返回路径应为./venv_qw/bin/python或.\venv_qw\Scripts\python.exe。
三、使用qoder pip安装核心依赖库
QoderWake封装了专属qoder pip命令，自动指向沙盒内pip并内置权限红线校验机制。直接使用系统pip或venv原生pip install，可能导致安装的库不被QoderWake识别、API调用被拦截，甚至触发安全拒绝。
正确操作如下：
1. 在已激活的venv_qw环境中，执行qoder pip install requests beautifulsoup4 lxml，这是网页解析的标准三件套。
2. 需要处理高并发任务时，加装qoder pip install aiohttp httpx。
3. 涉及结构化数据处理，安装qoder pip install pydantic pandas openpyxl。注意openpyxl仅支持.xlsx读写，不支持.xls格式。
4. 若安装报错“Failed building wheel”，添加--only-binary=all参数强制使用预编译包，例如qoder pip install --only-binary=all cryptography。
四、配置Conda环境替代方案（多项目协同场景）
当需同时维护多个QoderWake项目，且各项目依赖不同Python版本或C扩展时，Conda的环境管理灵活性更高。QoderWake通过qoder env conda指令桥接到Conda环境，前提是Conda已全局可用且base环境可访问。
实施步骤：
1. 在系统终端执行conda create -n qw_api_v310 python=3.10，创建名为qw_api_v310的Conda环境。
2. 激活环境：conda activate qw_api_v310，然后安装协作库，例如pip install fastmcp qoderwake-sdk。
3. 回到Qoder CLI，执行qoder env conda use qw_api_v310，将当前QoderWake沙盒的Python解释器切换至该Conda环境。
4. 验证切换：qoder env python --version应返回3.10.x；再执行qoder env python -c "import fastmcp; print(fastmcp.__version__)"，若成功输出版本号，说明桥接成功。
五、验证环境连通性与权限红线合规性
QoderWake对第三方库调用实施细粒度权限控制。例如，requests库仅允许get和post方法，使用DELETE等方法会被拦截；openpyxl仅允许load_workbook和save，create_sheet等操作同样被拦截。
环境配置完成后，必须进行实测验证：
1. 测试requests的get方法：qoder env python -c "import requests; r = requests.get('https://httpbin.org/get'); print(r.status_code)"，应返回200。
2. 测试权限红线是否生效：qoder env python -c "import requests; r = requests.request('DELETE', 'https://httpbin.org/delete')"，应抛出PermissionError: Method 'DELETE' is prohibited by QoderWake permission redline。
3. 测试openpyxl写入限制：qoder env python -c "from openpyxl import Workbook; wb = Workbook(); ws = wb.active; ws['A1'] = 'test'; wb.sa ve('test.xlsx')"应成功保存；而wb.create_sheet('new')则会被拦截。
完成上述所有步骤并通过测试后，即可获得一个真正可用、合规、隔离的QoderWake Python开发环境。接下来，直接进入开发阶段。