用途:当写入较大文件内容时,write_file 或 shell_agent 可能因内部体积限制返回 unknown error,此技巧提供可靠的回退写入方式。
主要能力:通过 run_shell 执行 Python heredoc,把文件内容经由 stdin 送入 Python 的 open(),绕过其它工具的体积限制,适用于任何文本文件(TypeScript、Python、JSON、YAML、Markdown 等)。
使用方式:先用 write_file 尝试写入;若失败(尤其体积大导致报错或超时),不要再用 shell_agent 内联内容重试,而应改用 run_shell 的 heredoc 回退。模板为: python3 - << 'EOF' content = """<FILE CONTENTS HERE>""" with open("<TARGET PATH>", "w") as f: f.write(content) EOF 把该块作为命令传给 run_shell。写入后可用 wc -l <TARGET PATH> && head -5 <TARGET PATH> 验证。
注意事项:heredoc 内需要转义——文件中应为字面反斜杠的要写成双反斜杠;内容里的三引号需转义;分隔符 EOF 不能单独出现在内容的一行中,必要时改用 PYEOF 或 FILEEOF。二进制文件可在 Python 脚本内用 base64 解码。该方式也适合内容含大量需 shell 转义字符的场景。
限制与适用:仅作为写入失败后的回退方案;具体体积阈值、不同环境下报错表现等资料未提供明确数值。