用途:当需要创建含多个工作表的复杂 Excel 工作簿、执行多步操作(创建、填充、格式化、保存),且 read_file 无法正确解析 XLSX,或 execute_code_sandbox 在持久化文件操作上失败时,可使用本模式。
核心用法:在 run_shell 中执行 cd /workspace && python3 << 'EOF' 形式的 heredoc 脚本,先切换到工作区目录以确保路径解析正确,使用单引号 'EOF' 防止 shell 变量展开,将导入、创建工作簿、填充数据、格式化与保存写入同一完整脚本,保存时使用绝对路径 /workspace/your_filename.xlsx,保存后打印确认信息。
主要能力:可创建多工作表工作簿(如 Summary、Data、Analysis、Settings),删除默认 Sheet,填充单元格数据,应用字体等格式,加载并修改已有工作簿(load_workbook),以及写入公式(如 =SUM(A1:A2))。
限制与注意:XLSX 为二进制格式,不应使用 read_file 读取;多步工作簿创建不宜使用 execute_code_sandbox;应避免将操作拆分到多个 heredoc 中;生产脚本需处理异常。资料称 openpyxl 已在环境中预装。
故障排查:文件未找到时确认所有路径含 /workspace/ 前缀;权限错误时确认工作区可写;模块缺失提示、heredoc 解析问题对应使用单引号 'EOF'。