SuperAPI AI 工具集

fallback-python-shell

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途:作为备用执行路径。资料说明,当 execute_code_sandbox 返回“unknown error”,或 read_file 对受支持的格式返回“unknown error”,又需要以编程方式处理文档、分析数据或读取文件时,使用本回退模式。\n\n主要能力:通过 run_shell 使用 heredoc 运行 Python 代码,绕过沙箱执行问题,同时保留 Python 在文件 I/O 和数据处理方面的完整能力。资料提供的示例覆盖读取文本与 JSON、用 pandas 处理 Excel/CSV、用 PyMuPDF 读取 PDF、用 python-docx 读取 Word,以及基础统计分析、过滤与聚合。\n\n使用方式:基本形式为 python3 << 'EOF' 后接 Python 代码,最后以单独一行的 EOF 结束。要点包括:对 EOF 加引号以防止 heredoc 中的变量展开;Python 代码从第 0 列开始,不额外缩进;EOF 单独一行且前后无空白;将结果打印到 stdout 以便在工具响应中捕获。示例代码展示了读取文件、打印 JSON、读取表格与文档等写法。\n\n适用场景:沙箱执行失败但需继续处理文件与数据时;需要读取文本、JSON、Excel/CSV、PDF、Word 并输出内容或摘要时;需要做简单数据统计、分组聚合时。\n\n限制与注意事项:run_shell 在当前工作目录执行,需使用绝对路径或确认目录正确;部分包可能不可用,资料建议坚持标准库或常见预装包(如 pandas、numpy 常可用);文件可能位于受保护目录导致权限错误;字符编码需显式指定(如 utf-8);大文件应分块处理或输出摘要;超长代码可拆分为多个 heredoc 或先写入临时 .py 文件。资料还建议用 try/except 包裹文件操作以处理 FileNotFoundError 等异常。