SaveText 文本持久化存储与磁盘写入节点
节点核心功能 (What is it?)
SaveText 是一个实用的文本 I/O 工具节点，允许创作者将工作流中生成的文本内容保存并写入到本地文件系统的指定文件中。它提供了直观简单的文件落地持久化接口。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 将大语言模型或智能体生成的长篇文案持久化保存至本地文件；
- 将工作流各个处理管线的最终结果或中间状态导出为文本文件；
- 归档存储对话历史日志（Conversation Logs）以便后续复盘；
- 作为自动化批处理管线中的文件生成终点；
- 在多次工作流执行之间进行数据持久化缓存。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 SaveText 节点。
- 将上游的文本数据源连接至
text输入插槽，或在节点面板中直接手动输入内容。 - 指定目标文件的输出路径（或保留默认设置）。
- 执行工作流，文本数据将自动写入并持久化至指定的物理路径。
参数输入插槽 (Parameters)
- text：待保存至本地文件的目标文本内容（支持多行富文本）。
- output_path：文本写入的目标物理文件路径（系统默认为
"griptape_output.txt"）。
输出引脚 (Outputs)
- output_path：成功写入的目标文件绝对/相对路径字符串（作为文件落地保存成功的确认凭证）。
典型工作流示例 (Example)
将 AI 智能体生成的回复完整保存至本地文件：
- 在画布中添加一个
Agent节点。 - 为 Agent 设定提示词以生成目标文案。
- 添加一个 SaveText 节点。
- 将
Agent节点的output引脚连接至 SaveText 的text参数插槽。 - 将
output_path设置为"my_agent_response.txt"。 - 执行工作流，智能体吐出的完整答复将被即刻保存至本地磁盘的
"my_agent_response.txt"文件中。
关键技术特性 (Important Notes)
- 智能覆盖机制：如果指定路径的文件不存在，节点会自动创建全新文件；若目标文件已存在，则会直接执行内容覆盖（Overwrite）。
- UI 原生文件选择器：节点面板的
output_path参数自带交互式保存按钮，支持一键调起操作系统的文件保存对话框。 - 支持绝对与相对路径：完全兼容操作系统的绝对路径（如
C:/docs/out.txt）与相对工作目录的相对路径（如./results/out.txt）。 - 目录自动递归创建：若指定的输出路径包含尚不存在的多级父级目录，底层会自动递归完成目录树创建。
- UTF-8 字符编码：所有文本均默认采用 UTF-8 编码写入，确保跨平台与全语言字符（包括中文字符）零乱码。
常见问题与排查 (Common Issues)
- 文件系统权限被拒绝 (Permission Errors)：请确保当前操作系统运行用户对目标文件夹拥有写权限。
- 路径非法或格式错误 (Invalid Path)：注意检查路径中的斜杠方向与特殊保留字符是否符合当前操作系统规范。
- 现有文件被意外覆盖 (File Already Exists)：注意 SaveText 节点覆盖现有同名文件时不会二次弹窗警告，建议在文件名中嵌入动态时间戳。