python-sandbox

# Python沙盒工具使用指南 v2.5 (与后端完全匹配版) ## 🎯 **核心能力概览** Python沙盒是一个**多功能的代码执行环境**，支持： | 功能领域 | 主要用途 | 关键库 | |---------|---------|-------| | **数据分析** | 数据清洗、转换、聚合 | Pandas, Polars | | **高性能计算** | 内存SQL、表达式加速 | DuckDB, Numexpr, Bottleneck | | **可视化** | 图表生成与自动捕获 | Matplotlib, Seaborn | | **文档自动化** | Excel/Word/PDF/PPT生成 | python-docx, reportlab, openpyxl | | **机器学习** | 模型训练与评估 | scikit-learn, LightGBM | | **符号数学** | 公式证明、方程求解 | SymPy | | **科学计算** | 优化、积分、信号处理 | SciPy | | **流程图生成** | 架构图、流程图 | Graphviz, NetworkX | | **文本分析** | HTML解析、数据提取 | BeautifulSoup4, lxml | | **性能优化** | 机械硬盘优化、异步IO | aiofiles, joblib | --- ## 📁 **文件处理指南 - 两种模式必须分清** ### **模式A: 工作区文件 (`/data` 目录)** **用途**: 数据分析、处理、持久化存储 **支持格式**: `.csv`, `.xlsx`, `.xls`, `.parquet`, `.json`, `.txt`, `.feather` **访问方式**: 绝对路径 `/data/文件名` ```python import pandas as pd df = pd.read_csv('/data/sales.csv') # ✅ 正确 ``` ### **模式B: 上下文文件 (Base64嵌入)** **用途**: 图片识别、PDF内容提取 **支持格式**: `.png`, `.jpg`, `.jpeg`, `.pdf`, `.txt`(小文件) **特点**: 文件内容直接嵌入对话，**不在 `/data` 目录** ```python # ❌ 错误：无法从/data读取上传的图片 # img = Image.open('/data/uploaded_image.png') # 会失败 ``` --- ## 🚀 **输出规范 - 后端实际支持的格式** ### **1. 图表输出 - 系统自动捕获** ```python import matplotlib.pyplot as plt plt.plot([1,2,3], [4,5,6]) plt.title('示例图表') plt.show() # 🎯 关键：自动捕获，无需手动处理 # 支持以下图表库的自动捕获： # - Matplotlib (使用 plt.show() 触发) # - Graphviz (创建 Digraph 对象自动捕获) # - NetworkX (通过 Matplotlib 渲染) ``` ### **2. 可下载文件 - 必须使用JSON格式** ```python import base64 import json # 生成文件内容后...