彻底卸载与数据清理 Griptape Nodes

请根据你的初始安装方式，选择对应的卸载操作指引：

Griptape Nodes 桌面端 (Desktop) —— 适用于从 griptapenodes.com 下载安装的一体化桌面客户端；
手动安装的计算引擎 (Engine) —— 适用于通过命令行 uv tool install griptape-nodes 手工部署的独立引擎。

完成核心程序卸载后，请务必参阅末尾的残留文件清理指南。

你的工作流与项目资产不会被自动删除

任何卸载程序均绝对不会擅自触碰你的工作区目录 (Workspace Directory)，因此你的所有项目工程文件、工作流拓扑以及生成的多媒体资产工件仍将完好地保留在磁盘中，直到你手动将其删除。在执行清理工作区目录之前，请务必将需要保留的重要资产提前备份或拷贝至安全位置。

Griptape Nodes 桌面端

桌面应用程序将计算引擎完整打包在内，并在专属应用数据文件夹中集中管理引擎的所有运行时目录。

macOS

退出 Griptape Nodes 桌面端；
在 Finder 中打开 Applications (应用程序) 目录，将 Griptape Nodes 拖入废纸篓；
清倒废纸篓。

此操作会将本地数据文件夹保留在原处。若需彻底清除，请继续查阅清理应用数据目录。

Windows

退出 Griptape Nodes 桌面端；
打开系统 设置 $\rightarrow$ 应用 $\rightarrow$ 安装的应用 (Installed apps)；
找到 Griptape Nodes，点击右侧的 ... 菜单并选择 卸载 (Uninstall)。

Windows 官方卸载向导会自动清理以下内容：

位于 %LOCALAPPDATA%\ai.griptape.nodes.desktop 的应用程序本体，包括随附下载的所有历史增量更新包；
“开始”菜单与桌面上的快捷方式图标；
系统的 安装的应用 注册表清单；
应用程序的双层数据文件夹：%APPDATA%\Griptape Nodes 与 %LOCALAPPDATA%\Griptape Nodes。这涵盖了应用配置、运行日志以及引擎写入的所有数据（包括已保存的 API Key）。

完成后，请继续参阅残留文件清理指南。

Linux

Griptape Nodes 桌面端在 Linux 上以 AppImage 独立包形式分发：它是一个便携式单文件，无需传统安装解压。

退出 Griptape Nodes 桌面端；
直接删除下载的 .AppImage 文件；
如果你曾通过 AppImageLauncher 等辅助工具注册过该 AppImage，请直接在辅助工具中将其卸载，以便一并清除位于 ~/.local/share/applications 下的桌面启动入口。

完成后，请继续执行清理应用数据目录。

清理应用数据目录 (macOS 与 Linux)

在 macOS 与 Linux 操作系统中，单纯删除应用程序二进制文件仍会在本地残留运行数据。你需要手动清理以下物理路径（Windows 卸载向导已自动处理对应路径）：

数据类别	macOS 物理路径	Linux 物理路径
应用运行时数据	`~/Library/Application Support/Griptape Nodes`	`~/.config/Griptape Nodes`
系统日志文件	`~/Library/Logs/Griptape Nodes`	`~/.config/Griptape Nodes/logs`
已下载的增量更新包	`~/Library/Caches/velopack/ai.griptape.nodes.desktop`	—

应用数据文件夹中保存了桌面端设置、用户登录凭证、激活的许可证密钥，以及由底层计算引擎生成的关键文件：包括 griptape_nodes_config.json、存储 API Key 与机密凭证的 .env 文件、智能体对话会话历史、模型下载记录，以及引擎为了视频预览自动下载的 ffmpeg 二进制组件。

需要说明的是，你的自定义节点库并不存放在此目录，它们直接驻留在本地工作区中，请参阅清理工作区目录进行处理。在 Linux 上，系统更新包直接暂存于系统临时目录中，无需额外手动清理。

在应用内部直接查验物理路径

在卸载应用之前，你可以直接进入 应用设置 (App Settings) 并滚动至应用数据物理路径 (App Data Locations)。该界面清晰展示了当前系统的应用数据存放路径，并提供了 Open 按钮支持在 Finder 或文件管理器中一键定位。由于系统日志与更新包未在界面中展示，针对它们请直接参考上表手动删除。

完成后，请继续查阅残留文件清理指南。

手动安装的计算引擎 (Engine)

在终端中执行官方内置的反安装命令：

gtn self uninstall

当终端输出 When done, press Enter to exit. 提示时，按下回车键（Enter）即可彻底完成可执行文件的移除。该命令将全自动清理：

引擎的全局配置与数据目录：~/.config/griptape_nodes 与 ~/.local/share/griptape_nodes（包括存储 API Key 与机密凭证的 .env 环境变量文件）；
调用 uv tool uninstall griptape-nodes，完全移除全局注册的 griptape-nodes 与 gtn 命令入口。

如果终端输出了 Caveats (注意事项) 警示区块，请务必仔细阅读。其中会罗列卸载程序刻意跳过的配置（例如保存在你本地工作区及各个项目工程内的配置文件），以及由于权限原因未能成功删除需要你手动清理的项目。

Windows 操作系统下的对应物理路径

计算引擎在所有操作系统平台中保持完全统一的目录布局规范，因此在 Windows 环境下，上述两个目录对应位于 %USERPROFILE%\.config\griptape_nodes 与 %USERPROFILE%\.local\share\griptape_nodes。它们直接驻留在当前用户主目录下，而非 AppData 隐藏目录中。

如果此时 gtn 已经损坏或无法运行（通常是由于先前的异常卸载导致虚拟环境损坏），你可以通过命令行手动执行上述清理：

=== "macOS / Linux"

```bash
uv tool uninstall griptape-nodes
rm -rf ~/.config/griptape_nodes ~/.local/share/griptape_nodes
```

=== "Windows (PowerShell)"

```powershell
uv tool uninstall griptape-nodes
Remove-Item -Recurse -Force "$env:USERPROFILE\.config\griptape_nodes"
Remove-Item -Recurse -Force "$env:USERPROFILE\.local\share\griptape_nodes"
```

完成后，继续参阅残留文件清理指南。

残留文件清理指南

清理你的本地工作区目录

你的工作区目录 (Workspace Directory)集中存放了你的所有项目工程、工作流拓扑、生成的多媒体工件以及节点算子扩展库。卸载程序绝不会全自动删除该目录。其默认路径为：

若使用桌面端：默认为 Documents/GriptapeNodes（文档目录下的 GriptapeNodes）；
若通过命令行手工安装引擎：默认为你首次执行 gtn 命令时所在的当前终端路径下的 GriptapeNodes 目录。

如果你在初始配置或后续设置中重定向了工作区路径，请在卸载前核对记下实际物理路径。

请务必先将其中需要长久保留的工作流与多媒体资产拷贝备份至外部安全磁盘，确认无误后方可直接手动删除该工作区文件夹。

清理已下载的深度学习模型权重

节点算子从 Hugging Face Hub 自动拉取下载的开源模型权重，统一缓存在 Hugging Face 的全局共享缓存目录中，而不会存入 Griptape Nodes 的私有目录内。

操作系统平台	全局模型缓存物理路径
macOS / Linux	`~/.cache/huggingface/hub`
Windows	`%USERPROFILE%\.cache\huggingface\hub`

如果你的计算机上还有其他 AI 程序或 Python 脚本共用 Hugging Face 权重，请切勿直接删除整个文件夹。若你采用的是命令行手动安装方式，可以在执行卸载引擎前，仅定向删除由 Griptape Nodes 所下载的模型：

gtn models list
gtn models delete <model_id>

你也可以在尚未卸载 Griptape Nodes 前，直接在图形化编辑器的 模型管理 (Model Management) 窗口中可视界面上一键删除。详见模型与节点库管理指南。

清理 Python 包管理器 uv

Griptape Nodes 依托现代 Python 包管理器 uv 为各个节点库全自动构建隔离的虚拟环境，uv 本身会维护一套专用的下载缓存与 Python 解释器版本。如果你的计算机仅为了运行 Griptape Nodes 而安装了 uv，可以在卸载完 Griptape Nodes 后，遵循 uv 官方卸载指引彻底清除 uv 及其运行时缓存。

需要说明的是，uv 官方卸载脚本不会主动修改你现有的系统环境变量 PATH。uv 安装时曾将可执行目录（macOS/Linux 下为 ~/.local/bin，Windows 下为 %USERPROFILE%\.local\bin）追加至系统环境变量中。在彻底卸载 uv 后，你可以在 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中删除 uv 追加的对应行；Windows 用户可在 系统属性 $\rightarrow$ 高级 $\rightarrow$ 环境变量 中将其干净移除。

重新安装

如果你未来需要重新使用 Griptape Nodes，只需按照安装与部署指南重新执行部署即可。只要你先前妥善保留了工作区目录，在重新安装后直接将工作区路径指向原有文件夹，你之前保存的所有工程项目和工作流都将毫发无损地原样恢复。