测试版功能特性 (Beta Features)

测试版功能 (Beta Features) 是指那些已经具备完整可用雏形、但尚未正式对所有创作者全量默认开启的前沿新特性。你可以自主选择开启它们提前尝鲜，并随时将其关闭。所有测试版功能均集中在编辑器设置中的 Beta Features 专属页面进行统一纳管。

Beta Features

开启与关闭测试版功能 (Turning a beta feature on or off)

在编辑器页眉顶部打开 Settings 菜单，选择 All Settings，点击左侧导航列表最下方的 Beta Features。每个特性都会清晰附带一段简要描述，解释其具体改变了哪部分界面的外观或逻辑，并配有独立的开启/关闭开关滑块。你的选择会与其余的编辑器全局偏好一同持久化保存，下次启动编辑器时依然有效。

所有功能特性严格按照来源进行归类呈现：

Editor (编辑器特性)：直接改变编辑器画布的前端视觉外观、面板排版或交互手势；
Engine (引擎特性)：改变幕后的底层计算机制，例如工作流的执行拓扑调度、并发模式等。这些特性直接由当前连接的 Engine 引擎注入，因此在不同的引擎实例或不同的引擎版本之间，列表内容会有所不同。

第三方扩展算子库同样可以向系统注入其自有的测试版功能。这些条目会归入 Engine 分组下，与引擎原生特性并列呈现。它们通常用于为该算子库的特定节点追加新实验性参数或调整计算逻辑。当该库被加载挂载时它们会自动呈现，当该库被卸载移除时会自动从列表中消失。

若希望全局恢复初始状态，点击右上角的 Reset all (重置全部) 按钮。所有特性将一键还原为其出厂默认值（默认通常均为关闭状态）。

画布上现存节点的热更新表现

如果某项算子库特性负责向某个算子节点动态追加或隐藏参数，在你切换开关后，该变动会立即反映在后续新添加到画布上的节点上。而此前已经存在于画布上的旧节点会继续保留其创建时的参数状态。若需更新画布上的旧节点，可以刷新节点、将其删除后重新添加，或者直接保存并重新打开当前工作流工程。

开关置灰被锁定时如何处理

如果某个特性的切换开关呈现灰色禁用状态，说明当前有一处优先级高于你本地用户偏好的配置源锁定了该特性的数值。这通常发生在当前工程项目 (Project)、工作空间 (Workspace) 配置，或者底层环境变量显式锁定了该键。开关下方会有一行提示文字明确告知是哪一级配置接管了权限。前往对应的配置文件中调整或删除该键值，即可重新恢复在当前图形化设置界面中自由切换的权限。

测试版功能的核心预期与稳定性承诺

功能特性可能会演进、定型或废弃：每一个测试版功能通常都会在数月内做出最终裁决——要么作为正式标准功能固化集成到 Griptape Nodes 主干中，要么被评估废弃移除。当这两种情况发生时，该条目会自然从测试版页面中剥离，你此前保存的开关配置也将自动安全失效；
无论开启与否，工作流工程绝对安全：测试版功能绝对不会破坏性篡改工作流工程文件的序列化存储规范。无论某个特性处于开启还是关闭状态，工作流工程都能以完全相同的方式被解析打开，因此你可以毫无顾虑地将工作流分享给开启了不同测试特性的团队成员；
允许存在未打磨的边缘缺陷：作为前沿尝鲜特性，偶发异常或边缘交互粗糙属于正常现象。如果遇到不可预期的非正常行为，随时在面板中关闭该开关即可瞬间恢复标准稳定逻辑。

离线与无界面配置 (Setting beta features without the editor)

你的所有图形化配置选择均会持久化保存在本地 griptape_nodes_config.json 配置文件的 beta_features 代码块中，以特性的唯一 ID 为键名：

{
    "beta_features": {
        "canvas_toolbar_placement_button": true
    }
}

针对第三方扩展算子库的特性，则集中记录在 library_beta_features 代码块中，键名为该库名称的全小写形式（空格与特殊标点符号统一转换为下划线）。例如针对名为 "Acme Image Tools" 的算子库：

{
    "library_beta_features": {
        "acme_image_tools": {
            "sharpen_after_upscale": true
        }
    }
}

注意：此处仅接受标准的布尔值 true 或 false。任何其他非法值（例如 "yes" 字符串）都会被引擎安全忽略，在引擎控制台日志中输出警告，并自动回退为默认值。配置笔误绝不会波及毁坏你的其他配置项。

环境变量单次会话覆盖

你也可以在终端中使用环境变量为单次运行会话临时强行激活某项特性。将特性 ID 转为全大写，追加在 GTN_CONFIG_BETA_FEATURES__ 前缀之后：

GTN_CONFIG_BETA_FEATURES__PARALLEL_BRANCH_RESOLUTION=true gtn

针对算子库特性，使用 GTN_CONFIG_LIBRARY_BETA_FEATURES__ 前缀，随后拼接全大写的算子库键名、双下划线 __，最后拼接全大写的特性 ID：

GTN_CONFIG_LIBRARY_BETA_FEATURES__ACME_IMAGE_TOOLS__SHARPEN_AFTER_UPSCALE=true gtn

上述使用的功能特性与库名称均为示例。若要在你自己开发的自定义算子库中暴露测试版特性，请参阅开发自定义算子库；有关配置文件与环境变量的多层级继承机制，请参阅引擎配置系统手册。