会话线程管理 (Threads)
在 Griptape Nodes 侧边栏中开展的每一次多轮对话都被称为一个会话线程 (Thread)。系统会自动使用会话初次创建的日期与时间戳为线程命名。
- 点击 + New 按钮即可清空当前上下文，开启一段全新的独立对话；
- 历史会话线程清晰罗列在底部消息输入区域的上方，方便随时回溯切换。
线程持久化物理存储结构 (Where threads are stored)
会话线程会自动落盘保存至你的本地文件系统中，完全具备跨会话持久留存能力。每个独立的线程在底层由三份协同文件组成：
| 文件物理名称 | 承载的具体数据内容与业务语义 |
|---|---|
thread_{id}.json |
完整消息历史记录（包含用户提问、大模型思考、回答及工具调用入参回包） |
thread_{id}.meta.json |
元数据描述文件（包含线程标题、创建与修改时间戳、累计交互消息轮次） |
thread_{id}.runs.json |
单次执行追踪详情（详细记录该线程中每一轮回复所调用的具体 AI 提供商、底层模型版本及挂载的 MCP 服务器快照） |
其中 runs.json 能够帮助创作者精确回溯特定历史答案是由哪一款大模型、何种温度以及哪个外部工具链计算推导得出的。
操作系统落盘物理路径规范
在标准环境下，会话线程的存储遵循业界通用的 XDG Base Directory 目录规范：
| 操作系统平台 | 标准物理落盘绝对路径 |
|---|---|
| macOS / Linux | ~/.local/share/griptape_nodes/threads/ |
| Windows | %USERPROFILE%\.local\share\griptape_nodes\threads\ |
若你使用的是打包分发的 Griptape Nodes Desktop (桌面安装版)，线程文件会被内聚存放在应用专有数据目录下的 xdg_data_home/griptape_nodes/threads/ 路径中。你可以通过顶部菜单栏进入 App Settings → App Data Locations 快捷定位该物理文件夹。
容错与损坏文件隔离机制
若某个会话 JSON 文件在非正常关机或写入冲突时发生数据损坏，Griptape Nodes 引擎具备健壮的自愈隔离机制：它会自动将损坏的文件追加 .corrupt-<timestamp> 扩展名后缀移至一旁隔离，确保其余健康的历史线程完全不受任何牵连干扰。