用途:向已有文件追加文本内容,适用于更新文件、补充文字、添加诗歌段落、增加章节或收尾段落等请求。
主要参数:file_path(必填,目标文件路径,如 ~/Downloads/poem.txt);new_content(必填,要追加的文本内容);preserve_formatting(可选,是否保持原有换行与间距)。
处理流程:通过 find 命令定位目标文件,若未提供路径则询问用户;读取当前文件内容以理解上下文与格式;准备与现有风格格式匹配的新内容;使用 write_file 工具将原始内容与新内容合并写回;通过检查文件大小并展示追加部分来验证更新;向用户确认成功并展示新增内容。
输出:追加内容后的更新文件,并返回确认信息,包含追加前后的字节数变化以及新增文本的预览。
参考命令:cat {{FILE_PATH}} && echo '{{NEW_CONTENT}}' >> {{FILE_PATH}}
注意事项:追加前应始终读取并展示当前文件内容以理解上下文;确保新内容与现有格式、风格和语气一致;建议使用 write_file 工具而非 shell 追加(>>)以保证文件处理可靠;若文件包含多个部分,可询问用户以明确插入位置。