SuperAPI AI 工具集

large-file-write-heredoc

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途:large-file-write-heredoc 是一套大文件写入的回退方案,用于当 write_file 和 shell_agent 因为单次调用负载过大而返回“unknown error”时,可靠地把较大的文本内容写入目标文件。

主要能力:通过 run_shell 执行 Python heredoc(python3 - << 'EOF'),将文件内容放在三引号字符串中,再由 Python 的 open() 写入指定路径,从而绕开其他工具的内容大小限制。资料给出的模板为:python3 - << 'EOF',content = """<FILE CONTENTS HERE>""",with open("<TARGET PATH>", "w") as f: f.write(content),最后一行 EOF,整段作为 run_shell 的 command 参数。

使用方式:先尝试用 write_file 正常写入,成功即结束;若 write_file 失败(特别是大内容下的 unknown error 或超时),不要再用 shell_agent 传内联内容重试,因为很可能同样失败;改用 run_shell heredoc 回退:把完整内容嵌入 Python 三引号字符串,在 open() 中写明目标路径,整块作为 command 传给 run_shell。写入时要注意转义:文件中需要字面反斜杠时写成双反斜杠;内容中的三引号要转义;heredoc 结束符(EOF)不能单独出现在内容行中,必要时改名为 PYEOF 或 FILEEOF。

校验:写入后追加一次 run_shell 调用,例如 wc -l <TARGET PATH> && head -5 <TARGET PATH>。

适用场景:任何文本类文件,包括 TypeScript、Python、JSON、YAML、Markdown 等;当内容包含在普通 echo 或 printf 方式下需要大量 shell 转义的字符时,也适用。对于二进制文件,可按资料说明改为在 Python 脚本内做 base64 解码。

限制与注意事项:该方案是写入失败后的回退手段,资料建议小文件(约 2 KB 以下)优先用 write_file;转义与结束符选择需要谨慎,否则可能写入错误内容;资料未提供其他平台、收费或性能方面的信息。