沙盒与本地环境

执行终端新增了 Python 运行环境切换能力。 Python 代码默认运行在 Pyodide 沙盒 中；可根据任务需求改为使用 本地 Python 解释器。

注意：本功能不常用，使用时需具备一定开发基础知识。

功能概览

赛博女娲的 Python 执行支持两种模式：

• 沙盒模式（Pyodide）
  • 浏览器/隔离运行，默认更安全
  • 依赖环境固定，适合快速数据清洗、基础分析、轻量脚本等通用任务
  • 不直接访问本机 Python 环境
  • 适用于对稳定性与隔离性要求较高、且不依赖本机第三方包的场景
• 本地模式（Local Python）
  • 使用终端所在设备的 Python 解释器执行
  • 可按本机环境安装依赖、访问本地资源
  • 适用于重依赖、长流程、与本地系统深度集成的场景（如特定 Python 版本/C 扩展、本地文件与数据库驱动、企业内网资源）

切换流程

1. 在执行终端左下角用户信息栏打开设置（卡片配图）。
2. 选择执行环境为「本地 Python」。
3. 指定解释器路径（自动检测/手动输入）。
4. 点击右侧「验证」按钮，显示 Python 版本则验证通过。
5. 点击「应用并切换」保存配置并完成切换。

如需回退，只需将模式切回「内置Pyodide」。

本地模式使用建议

• 为终端准备独立虚拟环境（如 venv / conda），避免污染系统 Python
• 固定关键依赖版本，减少“同任务不同机器结果不一致”
• 在团队内统一 Python 版本与依赖清单
• 对高风险脚本设置审核流程，避免误操作本地系统

常见问题

1) 切到本地模式后执行失败

重点检查：

• Python 可执行路径是否正确
• 当前账号是否有解释器与目标目录权限
• 依赖是否已安装到当前解释器环境

2) 为什么有的任务在沙盒能跑，在本地反而失败？

常见原因是本地环境缺少对应依赖，或系统权限/路径与沙盒行为不同。建议先做最小脚本验证，再逐步增加依赖与逻辑。

3) 如何保证团队内执行结果一致？

建议统一：

• Python 版本
• 依赖版本
• 环境变量与路径规范
• 任务输入/输出约定