python-sandboxlisted
Install: claude install-skill aiskillstore/marketplace
# 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
# 生成文件内容后