跳转至

桌面端应用设置 (App Settings)

Griptape Nodes Desktop 桌面客户端拥有独立的“应用设置 (App Settings)”面板，与编辑器顶部菜单栏的 Settings（设置）完全解耦。

应用设置专门用于管理桌面客户端应用程序自身的外观与底层行为：关闭应用时的确认策略、窗口主题外观、分配给底层引擎的工作区根目录、企业许可证管理、诊断审计日志落盘，以及客户端自身的软件更新升级策略。

唤起应用设置面板 (Opening App Settings)

点击窗口右上角的用户个人资料（你的姓名或头像），在下拉菜单中选择 App Settings。如果你是通过许可证密钥（License Key）激活的客户端而非个人账号，该按钮会显示为 Interactive license（交互型席位）或对应席位类型标识。

在个人账户菜单中选择 App Settings 唤起设置面板

配置完毕后，点击面板左上角的 Back to editor（返回编辑器）即可无缝切回工作流画布。面板中的绝大多数修改在点击后即时自动保存生效；少数需要重启引擎的配置在下文会有特别提示。

应用设置与编辑器设置的职责边界

应用设置（App Settings）并不等同于编辑器菜单栏中的 Settings。编辑器顶部的 Settings 面板负责配置引擎与画布运行时的行为——画布主题配色、自动保存周期、API 密钥与 Secrets、MCP 服务器、算子库参数等，详见 编辑器总览手册。

应用设置面板是 Griptape Nodes Desktop 桌面客户端所独占的；如果你是通过命令行单独运行引擎并在 Web 浏览器中打开在线编辑器，请参阅 系统配置完全手册。

常规设置 (General)

常规设置模块

  • Confirm before closing (关闭前弹窗确认)：在彻底退出桌面应用程序时弹出二次确认对话框。关闭桌面端会同时强行终止内置的执行引擎守护进程，进而导致所有正在执行的耗时计算被直接掐断。若经常运行长时渲染或深度推理工作流，强烈建议保持开启。

外观主题与系统监控 (Appearance)

外观主题设置模块

  • Theme (窗口主题)：设置桌面客户端主外壳的视觉主题：Light（浅色）、Dark（深色）或 System（跟随操作系统全局外观）；
  • Show system monitor (显示系统资源监控条)：在主导航栏下方追加一条实时硬件性能指示条，每秒高频刷新呈现 CPU、内存 (RAM) 以及独立显卡 (GPU) 的显存与负载占用率。当你脱机运行本地大型扩散模型（如 SDXL/FLUX）或大语言模型（如 Ollama）时，该监控条能帮助你即时洞察硬件显存是否已逼近极限。

工作区与扩展算子库 (Workspace & Libraries)

工作区与扩展算子库设置模块

  • Workspace Directory (工作区物理目录)：Griptape Nodes 在本地存储项目工程文件与生成的多媒体资产的根路径。点击 Browse 可以重定向到其他磁盘或网络挂载盘。修改工作区路径不会自动搬家移动现存的文件，因此请确保选择一个能够长久稳定访问的目录；
  • Import existing configuration (导入已有配置)：在系统中深度扫描查找本机可能曾经手动安装过的历史 Griptape Nodes 引擎配置，一键继承原有的工作区路径与历史设置，免去重复配置的麻烦；
  • Additional Libraries (扩展算子库一键装配)：
    • Install Griptape Nodes Diffusers Library：安装官方基于 Hugging Face Diffusers 的专业多媒体生成算子库（推荐具备强大 NVIDIA 独立显卡且正确安装了 CUDA 驱动的高性能机器配置）；
    • Install Griptape Cloud Library：安装用于直连 Griptape Cloud 各类云端能力的官方算子库。

重要提示：本模块中的各项修改在点击底部的 Apply Changes (应用变更) 按钮后才会真正生效！点击后客户端会自动安全重启底层执行引擎。请在应用前先保存好当前正在编辑的工作流。

执行引擎通信配置 (Engine)

引擎通信设置模块

仅在许可证激活模式下可见

本模块仅在客户端通过许可证密钥 (License Key) 激活时呈现（此时客户端处于与本地引擎 Direct WebSocket 直连模式）。若使用个人 Griptape 账号登录，该底层网络设置会被隐藏托管。

  • Direct Engine WebSocket URL：本地执行引擎监听并绑定的本地回环 WebSocket 通信地址。出厂默认值为 ws://127.0.0.1:18125，这是仅限本机安全访问的回环套接字。修改后必须重启引擎生效。

许可证授权管理 (License)

许可证管理模块

当企业采用许可证密钥统一纳管席位时，创作者在此处集中管理本地保存的各项授权凭据。每一个激活过的席位均呈现为一张卡片，清晰展示企业组织归属、License ID、席位类型（如 Interactive 交互席位）与截止过期时间，当前正在使用的席位会打标高亮 Active 徽标：

  • 点击铅笔图标可为许可证修改更友好的本地备注别名；
  • 点击 Remove 可在当前机器上注销解除该授权；
  • 点击切换另一个席位为活跃席位会自动重启引擎以刷新权限策略；
  • Griptape Server Endpoint：配置私有化部署时企业内网 Admin Server 管理服务器 的内网代理根地址（默认公网为 https://cloud.griptape.ai）；
  • 若需追加新授权，直接在输入框中粘贴管理员提供的 Token 并点击 Add & Activate。

详尽激活指导请参阅 使用企业管理服务器激活全流程。

日志审计与故障排查 (Logging and Diagnostics)

日志与诊断设置模块

在向 IT 管理员或官方社区反馈缺陷前，请提前开启以下日志开关以完整复现报错轨迹：

  • Write engine logs to file (将引擎日志落盘写入文件)：将底层执行引擎的标准输出流实时写入日志文件，单文件达到 10MB 时自动回滚轮转；
  • Write application logs to file (将应用与前端日志落盘)：持久化记录桌面外壳与前端编辑器的操作日志，达到 10MB 自动轮转。点击 Export 支持按当前会话或特定时间窗口导出整包日志；
  • Log Retention (日志保留生命周期)：设置过期日志文件的自动清理周期，支持按天 (Days)、月 (Months) 或年 (Years) 自动轮转淘汰（默认保留 7 天）。勾选 Don't delete log files 则永久保存不清理。

排错技巧详见 故障排错指南 (Troubleshooting)。

客户端自动升级管理 (Updates)

更新偏好设置模块

  • Current Version：显示当前正在运行的客户端版本号；点击 Check for Updates 能够即刻发起一次全量更新探测；
  • Update Behavior (更新行为偏好)：
选项设置 触发行为与更新逻辑
Auto-Update (全自动更新) 在客户端每次启动引导时，后台自动静默下载并平滑安装最新版本。
Prompt for Update (弹窗提醒) 出厂默认模式。当检测到可用更新时，在界面顶部呈现温和的横幅通知，由用户决定何时更新。
Silence Updates (静默免打扰) 完全关闭所有自动轮询与横幅提示。用户依然可以随时手动点击 Check for Updates 进行升级。
  • Show release notes after updates (升级后展示发行说明)：客户端自动升级重启后，自动弹窗呈现新版本的更新日志速览。

“Updates are disabled by your organization” 提示说明

如果你的界面上呈现该提示，说明企业 IT 管理员已通过操作系统级策略文件 policy.json 彻底接管并禁用了客户端的自动更新机制。此时 Check for Updates、Update Behavior 与 Release Channel 均会被强制置灰禁用，软件版本由企业 IT 集中统一部署。

发布通道切换 (Release Channels)

Release Channel 允许创作者自由选择桌面客户端接入哪一个软件发布轨道：

发布通道下拉菜单，包含 Stable 稳定版与 Nightly 每夜构建版

发布通道 适合人群与软件特性
Stable (正式稳定版) 出厂默认通道。经过全套自动化测试套件与安全审查的官方正式版本，推荐生产级工作流使用。
Nightly (每夜前沿版) 每日自动化编译发布的最新实验版本，内置最新的开发期引擎内核与前沿实验功能。版本号类似 0.22.0-nightly.20260611.123。官方仅保留最近 14 天的 Nightly 归档。

Nightly 通道的风险防范

Nightly 构建版直接切自分支的最新研发提交，未经完整的生产回归测试，可能包含未知的缺陷甚至中途被废弃的半成品特性。严禁在商业核心生产项目中盲目使用 Nightly 通道！使用该通道时请高频保存工作流快照。

通道切换在下一次触发更新检测时自动生效（下次冷启动、后台周期探测或手动点击 Check for Updates 时）。整个过程完全无需重新下载完整安装包，且从 Nightly 降级切回 Stable 同样原生平滑支持。切换通道绝对不会删除或破坏你的任何本地工作区工程、工作流或历史设置。

凭据、数据路径与环境快照

  • Griptape Cloud API Key：客户端自动为你申请绑定的云端 API 凭据（默认隐藏）。点击 Show 可明文查看，点击 Copy 可复制到剪贴板中供外部终端脚本复用；
  • App Data Locations：客户端自身运行时持久化数据的操作系统物理落盘目录（点击 Open 可直接在系统文件管理器中打开定位）；
  • Environment Information (系统环境信息快照)：一键抓取并汇编当前客户端的完整底层运行环境体检报告：包括应用版本与构建号、内置编辑器版本、内置 Python 解释器路径及其全量已装 Pip 依赖包、操作系统架构等。点击 Copy 或 Export... 可以导出该报告，在向社区提交 Bug 时附上该快照能大幅提升排障速度。