用途:当 execute_code_sandbox 执行失败且报错不明或输出不完整时,用该调试模式定位根本原因并逐步恢复,尤其适合多文件输出的复杂脚本、音视频生成流程和依赖外部库的脚本。
主要能力与用法分为三阶段。阶段一捕获部分执行轨迹:在沙箱执行失败后,用 run_shell 重跑并重定向输出,例如 python your_script.py 2>&1 | head -100,借此看到哪些步骤已成功、失败点及被抑制的报错。阶段二隔离出错函数:把脚本拆成更小、可独立测试的单元,逐个执行函数或代码块,判断具体哪个组件失败。阶段三增量生成输出:一次只生成一个产物,写入后立即验证,例如用 assert os.path.exists('output_01.wav'), "File 1 not created",确认存在及大小、时长、格式等属性后再继续。
推荐流程:先整体运行;失败后用 run_shell 加 | head -100 查看部分输出;找到最后成功的位置即断点;按主要段落拆分脚本;逐段运行并验证;各段都通过后再合并为最终脚本。
最佳实践:写文件后立即用 os.path.exists 断言;假设成功前检查文件属性;多用 print 标记进度;保存中间输出以免失败后从头重来;音视频生成先用 1–2 秒短样本测试。
限制:资料未提供适用语言版本、沙箱环境差异或性能影响等信息;该模式针对 execute_code_sandbox 失败场景,不保证能解释所有错误。